=== Plugixa FAQ ===
Contributors: plugixa, zakaria04, freemius
Tags: faq, accordion, questions, schema, seo
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern FAQ plugin with React admin panel, accordion display, categories, and Schema markup for SEO.

== Description ==

Plugixa FAQ is a powerful and user-friendly FAQ plugin for WordPress. It features a modern React-based admin panel, beautiful accordion displays, and built-in SEO optimization with FAQ Schema markup.

= Key Features =

* **Modern Admin Interface** - React-powered admin panel with Material UI
* **Accordion Display** - Beautiful, animated accordion with multiple styles
* **Categories** - Organize FAQs into categories
* **Schema Markup** - Automatic FAQ Schema (JSON-LD) for Google rich results
* **Shortcode** - Flexible `[plugixa_faq]` shortcode with many options
* **Widget** - Display FAQs in sidebars and footers
* **Search** - Live search functionality
* **Fully Responsive** - Works great on all devices
* **Accessible** - WCAG 2.1 compliant

= Shortcode Usage =

Basic usage:
`[plugixa_faq]`

With options:
`[plugixa_faq category="general" limit="5" style="accordion"]`

= Shortcode Parameters =

* `category` - Filter by category slug
* `ids` - Show specific FAQ IDs (comma-separated)
* `limit` - Number of FAQs to show (-1 for all)
* `style` - Display style: accordion, list, or toggle
* `orderby` - Sort by: menu_order, date, title, or rand
* `order` - Sort order: ASC or DESC
* `schema` - Enable FAQ schema: true or false
* `search` - Show search box: true or false
* `group_by_category` - Group FAQs by category: true or false

== Installation ==

1. Upload the `plugixa-faq` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to 'Plugixa FAQ' in the admin menu to add your FAQs
4. Use the `[plugixa_faq]` shortcode on any page or post

== Frequently Asked Questions ==

= How do I add FAQs? =

After activating the plugin, go to Plugixa FAQ in the WordPress admin menu. Click "Add FAQ" to create your first FAQ.

= How do I display FAQs on my site? =

Use the `[plugixa_faq]` shortcode on any page, post, or widget area.

= Does this plugin support Schema markup? =

Yes! FAQ Schema (JSON-LD) is automatically added to help your FAQs appear in Google's rich results.

= Can I customize the appearance? =

Yes! Go to Plugixa FAQ > Settings to customize colors, icons, animations, and more. You can also add custom CSS.

= Is this plugin compatible with page builders? =

Yes, the shortcode works with all major page builders including Elementor, Divi, and Gutenberg.

= What shortcode examples can I use? =

Show all published FAQs: `[plugixa_faq]`

With a search box: `[plugixa_faq search="true"]`

Filter by category slug: `[plugixa_faq category="general"]`

Group by category: `[plugixa_faq group_by_category="true"]`

Limit the number of FAQs: `[plugixa_faq limit="5"]`

Choose a style: `[plugixa_faq style="accordion"]`, `[plugixa_faq style="list"]`, or `[plugixa_faq style="toggle"]`

Show specific FAQs by ID: `[plugixa_faq ids="1,2,3"]`

Full example: `[plugixa_faq category="general" limit="10" search="true" style="accordion" schema="true"]`

== External services ==

The free plugin connects to only one external service: Freemius, for licensing and
plugin updates. No other third-party service is contacted by the free version.

= Freemius =

We use Freemius to handle licensing, software updates, and — only if you opt in — anonymous usage diagnostics. On activation you are shown an opt-in screen; if you skip it, no identifiable data is sent. When you opt in, or when you manage a license or purchase, data such as your site URL, WordPress and PHP versions, active theme/plugins, and the email address used at opt-in may be transmitted. This occurs on activation, plugin updates, and license actions.
Provided by Freemius, Inc. — Terms: https://freemius.com/terms/ — Privacy: https://freemius.com/privacy/

The premium version adds optional features that, only when you enable and configure
them, connect to their own providers: AI FAQ generation (OpenAI — https://openai.com/policies/privacy-policy/ — or Google Gemini — https://policies.google.com/privacy) and reCAPTCHA for the feedback form (Google — https://policies.google.com/privacy). These providers are not contacted by the free version.

== Source Code ==

The compiled JavaScript and CSS in this plugin are built from human-readable source,
published as a versioned archive:

https://plugixa.com/source/plugixa-faq-source-1.0.0.zip

The archive contains the complete buildable source with pinned dependencies
(package.json + package-lock.json) and a README with build instructions:

* Admin app — assets/backend/app/ (React 19, Material UI, TanStack Query; Vite 5)
* Frontend styles — assets/frontend/app/ (Tailwind CSS 4; Vite 5)
* Gutenberg block — assets/blocks/faq-block/ (@wordpress/scripts)

Build with Node.js 20+: from each app directory run `npm install` then `npm run build`.
Module Federation shared singletons: react, react-dom, react-router-dom,
@tanstack/react-query, @emotion/react, @emotion/styled.

== Screenshots ==

1. Dashboard with statistics
2. FAQ management list
3. FAQ editor
4. Category management
5. Settings page
6. Frontend accordion display

== Changelog ==

= 1.0.0 =
* Initial release
* React admin panel
* FAQ management with categories
* Accordion, list, and toggle display styles
* FAQ Schema (JSON-LD) support
* Widget for sidebars
* Live search functionality
* Full customization options

== Upgrade Notice ==

= 1.0.0 =
Initial release of Plugixa FAQ plugin.
