=== UTSSites Auto FAQ Schema ===
Contributors:      uts0173
Donate link:       https://utssites.com/plugin/wordpress-faq-schema-plugin/
Tags:              faq schema, json-ld, rich snippets, seo, structured data
Requires at least: 5.5
Tested up to:      6.9
Requires PHP:      7.4
Stable tag:        2.1.6
License:           GPL-2.0+
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

🏆#1 Auto FAQ Schema detects & injects Google-ready JSON-LD automatically. Unlimited FAQs, zero manual work, instant rich snippets. Rank higher today!

== Description ==

**UTSSites Auto FAQ Schema** is the most intelligent, fully automatic FAQ schema plugin for WordPress. While other plugins make you manually enter every question and answer, this plugin **reads your existing content** — headings, paragraphs, bold text — and **automatically generates perfect Google-ready FAQPage JSON-LD schema** in seconds.

Install. Activate. Done. No shortcodes. No manual work. No coding required.

> ⚡ **Zero config. Auto detect. Unlimited FAQs. Google-ready schema. Instant rich snippets.**

= 🏆 Why Choose UTSSites Auto FAQ Schema? =

* ✅ **Zero manual work** — no questions to enter, no shortcodes to add
* ✅ **3 smart detection strategies** — headings, paragraphs, bold text
* ✅ **40+ question patterns** — detects any natural question format
* ✅ **Unlimited FAQs** — no artificial limits in the free version
* ✅ **100% Google compliant** — passes Rich Results Test every time
* ✅ **Zero performance impact** — no JS, no API calls, no slowdowns
* ✅ **Free forever** — GPL open source, no license keys needed

= ⚡ How It Works — Fully Automatic =

Every time a visitor loads your page, the plugin silently:

1. **Checks eligibility** — Is this post type enabled? Is this page excluded? Is schema active for this post?
2. **Scans your content** — Runs 3 detection strategies in priority order
3. **Deduplicates** — Removes duplicate questions found across strategies
4. **Applies limits** — Trims to your configured FAQ limit and answer length
5. **Injects schema** — Outputs valid FAQPage JSON-LD into your head
6. **Google indexes it** — Rich snippet dropdowns appear in search results

The entire process adds less than 1ms to page load. Truly invisible.

= 🔎 3 Smart Detection Strategies =

**Strategy 1 — H2 to H5 Heading Detection (Highest Priority)**

Scans all question-style headings in your content. Any H2, H3, H4, or H5 that ends with "?" or contains a question word is automatically detected. The paragraph immediately following becomes the answer. You choose which heading levels to include from Settings.

**Strategy 2 — Paragraph Tag Detection**

No heading structure needed. If any paragraph contains a sentence starting with a question word and ending with "?", the question is extracted automatically — and the next paragraph becomes the answer. Perfect for blog articles and natural prose.

**Strategy 3 — Bold / Strong Tag Detection**

Detects questions inside strong or b tags. Perfect for FAQ-style content where questions are bolded and answers follow in the next paragraph.

= ✨ Complete Free Feature List =

**Detection & Core**

* H2, H3, H4, H5 heading detection — choose levels individually
* Paragraph tag sentence detection
* Bold / Strong tag detection
* 40+ question word patterns — How, What, Why, When, Where, Who, Which, Can, Could, Is, Are, Was, Will, Should, Does, Did, Tell me, Explain, Define, Describe, Give me, Show me, and more
* Detect questions without "?" — detect question-word headings even without question mark
* Hash-based smart deduplication — identical questions appear only once
* Answer auto-extraction — next sibling element becomes the answer automatically

**Schema Output**

* Valid FAQPage JSON-LD schema — schema.org fully compliant
* Passes Google Rich Results Test — 100% validation
* Injected into head via wp_head hook
* Proper JSON encoding with special character escaping
* Configurable max and min answer length

**Settings & Control**

* Global enable / disable toggle
* Post type selection — Posts, Pages, Products, Custom Post Types
* Heading level toggles — H2, H3, H4, H5 individually
* Paragraph detection toggle
* Bold detection toggle
* **Unlimited FAQs per page** — no artificial cap
* Max answer length in characters
* Min answer length filter — skip very short answers
* Exclude specific post/page IDs
* Custom question patterns — add your own

**Per-Post Control**

* Sidebar meta box in every post and page editor
* Per-post schema disable toggle
* Per-post custom FAQ limit override
* Live FAQ preview — see detected questions before publishing
* Full JSON-LD preview per post

**Live Schema Preview**

* Bulk preview of recent posts in Settings page
* FAQ List tab — human-readable question and answer list
* JSON-LD tab — exact raw schema code injected into page head
* FAQ count badge

**Compatibility**

* WordPress 5.5 to 6.9
* PHP 7.4+
* Gutenberg Block Editor
* Classic Editor
* Elementor, Divi, WPBakery, Beaver Builder
* WooCommerce product pages
* Rank Math SEO — conflict-safe
* Yoast SEO — conflict-safe
* WPML, Polylang — multilingual ready
* All major caching plugins
* Multisite compatible
* No external dependencies — zero external API calls
* GPL-2.0+ open source

= 📈 Why FAQ Schema Matters for Your SEO =

Google displays FAQ rich snippets for content with valid FAQPage schema. These expandable dropdowns appear directly below your search listing:

* 2 to 5x more SERP visibility — your listing dominates the page
* Higher Click-Through Rate — more screen space means more clicks
* Lower bounce rate — users who click already know what to expect
* Competitive advantage — most sites still don't use FAQ schema

= 💎 Pro Version — For Serious SEO Professionals =

[👉 View All Pro Plans & Pricing](https://utssites.com/plugin/wordpress-faq-schema-plugin/#pricing)

**FAQ Management (Pro)**

* Manual FAQ Builder with Drag & Drop Reorder
* Custom Answer Override per FAQ
* Export / Import FAQs in JSON format
* Broken FAQ Detector
* Answer Length Optimizer
* Smart FAQ Score — Excellent / Good / Fair / Poor rating
* FAQ Templates Library — 6 niche templates

**AI-Powered Features (Pro)**

* AI FAQ Suggestions — Google Gemini
* AI FAQ Suggestions — Groq (Llama)
* AI FAQ Suggestions — OpenAI GPT-4
* Tone-Aware AI — Medical, Legal, Tech, eCommerce
* AI FAQ Quality Check
* PAA Suggester — Google Autocomplete
* Long-tail Question Suggester

**Advanced Schema Types (Pro)**

* HowTo Schema with HowToStep support
* QAPage Schema
* Video FAQ Schema — YouTube integration
* Article + FAQ Combined Schema
* Schema Expiry Date
* Conditional Schema Rules per category or tag
* One-Click Google Rich Result Test
* Schema Validator in-plugin
* Rank Math / Yoast Conflict Handler

**Integrations & Analytics (Pro)**

* Google Search Console Integration
* Analytics Dashboard + CSV Export
* FAQ A/B Testing
* Gutenberg FAQ Accordion Block
* Elementor FAQ Widget
* FAQ Shortcode + Widget
* WooCommerce Advanced Integration
* REST API (4 endpoints)
* Zapier / Webhook
* White Label — Full Rebrand
* Client PDF Reports
* Multi-site Network Support
* Priority Support + All Future Updates

**Pricing**

* Starter — $19/yr — 1 site
* Pro — $49/yr — 3 sites (Most Popular)
* Agency — $99/yr — Unlimited sites
* Lifetime — $199 one-time — Unlimited sites, all future features forever

[👉 Get Pro Today](https://utssites.com/plugin/wordpress-faq-schema-plugin/#pricing)

== Installation ==

= Automatic Installation =

1. Go to Plugins > Add New Plugin in WordPress admin
2. Search for UTSSites Auto FAQ Schema
3. Click Install Now then Activate Plugin
4. Done — plugin works automatically with zero configuration

= Manual ZIP Upload =

1. Go to Plugins > Add New Plugin > Upload Plugin
2. Choose the ZIP file, Install Now, then Activate
3. Optionally visit Settings > Auto FAQ Schema to configure

= FTP Upload =

1. Extract the ZIP and upload utssites-auto-faq-schema folder to /wp-content/plugins/
2. Activate from the Plugins menu in WordPress admin

== Frequently Asked Questions ==

= Does this require any manual FAQ entry or shortcodes? =
No. Zero manual work. The plugin automatically detects questions from your existing content — headings, paragraphs, bold text. No shortcodes, no custom fields, no manual input of any kind.

= Is the FAQ limit really unlimited in the free version? =
Yes. The free version has no FAQ limit — you can detect and inject as many FAQs as your content contains. You can also set a custom cap from Settings if you prefer.

= Will this slow down my website? =
No. The plugin outputs a single tiny JSON-LD script tag in your page head. There is no frontend JavaScript, no external HTTP requests, no database queries on the front end. Performance impact is zero.

= Can I exclude specific posts or pages? =
Yes. Add post/page IDs to the Exclude IDs field in Settings, or use the sidebar meta box in the post editor to disable schema for that specific post.

= Does it conflict with Rank Math or Yoast SEO? =
No. The plugin outputs a separate JSON-LD block for FAQPage schema only. Multiple JSON-LD blocks are fully supported by Google.

= Does it work with Gutenberg, Elementor, Divi, and page builders? =
Yes. Works with all major page builders that use WordPress native the_content filter.

= Is this plugin GDPR compliant? =
Yes. No external HTTP requests, no user data stored, no cookies, no tracking of any kind. Fully GDPR compliant.

= Is there a Pro version? =
Yes. Pro adds Manual FAQ Builder, AI Suggestions (Gemini/GPT-4/Groq), HowTo Schema, QAPage Schema, Analytics Dashboard, White Label, REST API, and much more. [View pricing](https://utssites.com/plugin/wordpress-faq-schema-plugin/#pricing).

= What WordPress and PHP versions are required? =
WordPress 5.5 or higher and PHP 7.4 or higher. Tested up to WordPress 6.9.

== Screenshots ==

1. Settings page — Full configuration panel with General Settings, Detection Sources, FAQ Limits, and JSON Schema Preview sidebar. Enable/disable toggles, post type selection, heading levels H2-H5, paragraph and bold detection.
2. Per-post meta box in the WordPress block editor — shows Schema Active status, disable toggle, FAQ Limit override (Unlimited — Free), and Preview FAQ Schema button alongside Yoast SEO panel.
3. Question Detection Patterns — all 40+ built-in patterns (How, What, Why, When, Where, Who...) with checkboxes, plus custom patterns textarea for adding your own question words.
4. FAQ & Answer Limits panel — Max FAQs, answer length settings, exclude IDs, Detection Sources with live toggle status, and full JSON-LD schema preview with FAQ list and raw code output.

== Changelog ==

= 2.1.6 =
* Fixed FAQ limit reset — default now correctly set to 8 per page on fresh install
* Improved activation redirect to Welcome page on first install
* Optimized schema injection hook priority for better compatibility
* Code cleanup and minor performance improvements

= 2.1.4 =
* Renamed plugin to UTSSites Auto FAQ Schema
* Removed all external SDK dependencies — fully self-contained
* Improved admin UI — all assets loaded via wp_enqueue system
* All outputs properly escaped — full WordPress security compliance
* Proper UTSAFS_ function and constant prefixes — zero naming conflicts
* Performance improvements and code cleanup

= 2.0.0 =
* Added paragraph tag detection — questions inside p tags auto-detected
* Added Bold / Strong tag detection
* Smart auto-deduplication across all three detection strategies
* 15 new question patterns added
* Improved admin UI with tabbed schema preview
* Richer per-post meta box with live JSON-LD preview
* Min answer length filter added
* Custom question pattern management

= 1.0.0 =
* Initial release
* H2 to H5 heading detection with 25+ question patterns
* FAQPage JSON-LD schema injection
* Global enable / disable toggle
* Post type selection and heading level toggles
* Max FAQ limit and answer length settings
* Exclude specific post/page IDs
* Per-post disable toggle via editor meta box
* Live JSON-LD preview in Settings

== Upgrade Notice ==

= 2.1.6 =
Recommended update. Fixes FAQ limit default and improves activation flow. Upgrade immediately.

= 2.1.4 =
Recommended update for all users. Improves security, removes external dependencies, and fixes function naming conflicts. Upgrade immediately.
