=== FAQ ZYREX ===
Contributors: zyrexpl
Donate link: https://paypal.me/zyrexpl?country.x=PL&locale.x=pl_PL
Tags: faq, accordion, faq schema, rich snippets, gutenberg block
Requires at least: 6.3
Tested up to: 7.0
Stable tag: 2.1.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Lightweight FAQ accordion that boosts your SEO with Google rich snippets. 6 languages, full styling control, zero bloat.

== Description ==

**FAQ ZYREX** turns a messy "Frequently Asked Questions" section into a clean accordion that ranks in Google. One shortcode, one admin screen, zero JavaScript, zero tracking, zero external dependencies.

### Why FAQ ZYREX is different

* **Native Gutenberg block.** Insert your FAQ visually in the block editor — pick which entries to show with checkboxes, see live preview. Or keep using the classic shortcode `[zxfaq]`, whichever you prefer.
* **Semantic HTML5.** Uses native `<details>`/`<summary>` elements — zero JavaScript required, perfect accessibility, perfect SEO signal for Google.
* **Google rich snippets built in.** Every FAQ you publish is automatically marked up with `FAQPage` JSON-LD schema — the same markup that makes competitor pages appear with expandable questions right in the search results. More SERP real estate, higher CTR, more traffic.
* **Under 100 KB total.** No bloated page builder dependency, no jQuery, no CDN calls. Works on any theme, any cache plugin, any hosting.
* **Ships with 6 translations.** Polski, English, Deutsch, Français, Español, Italiano — fully translated admin and frontend. No "help wanted" message, no half-done strings.
* **Style it your way.** Colors (6 variables), font size, border radius, padding and your own custom CSS — all from one settings screen. Match any theme in under a minute.
* **Privacy-safe.** Zero third-party calls, zero tracking, zero fonts from Google. GDPR-friendly out of the box.

### Features at a glance

* **Gutenberg block** with live preview and FAQ picker
* Shortcode `[zxfaq]` — drop anywhere (post, page, widget, template)
* Display only selected entries: `[zxfaq ids="1,3,5"]` or via block checkboxes
* Multi-line answers with basic HTML (links, bold, lists)
* Reorder entries with one click
* FAQPage JSON-LD schema (optional, on by default)
* Appearance panel: 6 colors, font size, border radius, padding, custom CSS
* 6 built-in translations + .pot template for more
* CSRF-protected admin (nonces + capability checks)
* No external dependencies, no tracking, no CDN
* Pure-CSS accordion — works everywhere

### Ideal for

* E-commerce product pages that need FAQ for SEO
* Service businesses answering repeated customer questions
* Knowledge bases, help centers, landing pages
* Anyone who wants an FAQ section without installing a page builder

### About

Built and maintained by [Zyrex](http://zyrex.pl) — keep it simple, keep it fast.

== Installation ==

1. In WordPress admin: **Plugins → Add New**, search for "FAQ ZYREX", click Install and Activate. Or upload the ZIP via **Plugins → Add New → Upload Plugin**.
2. Go to **FAQ Zyrex** in the admin menu and add your first question.
3. Optional: under **FAQ Zyrex → Appearance** customize colors and typography.
4. Paste `[zxfaq]` into any post, page or widget.

== Frequently Asked Questions ==

= How do I display the FAQ on a page? =

Paste the shortcode `[zxfaq]` anywhere on a post, page, or in a text widget.

= Can I show only some entries? =

Yes. Use `[zxfaq ids="1,3,5"]` — IDs are visible in the admin table.

= Does this plugin add schema for Google? =

Yes, that's the main reason to use it. Any page containing `[zxfaq]` automatically outputs `FAQPage` JSON-LD in the footer. You can disable this in the appearance settings.

= Can I change colors and fonts? =

Yes. **FAQ Zyrex → Appearance** lets you set question/answer background and text colors, hover color, border color, font size, border radius, padding and your own custom CSS.

= Which languages are supported? =

Polski, English, Deutsch, Français, Español, Italiano. All translations ship with the plugin — no separate download needed.

= Can I translate it into another language? =

Yes. Use the included `/languages/faq-zyrex.pot` template with Poedit (or similar) to create your translation.

= Does it work with page builders (Elementor, Divi, WPBakery)? =

Yes, use the shortcode widget/block in any builder.

= Is JavaScript required on the frontend? =

No. The accordion uses native HTML5 `<details>`/`<summary>` — it works without JavaScript, without jQuery, and loads instantly.

= How do I use the Gutenberg block? =

In the block editor, click `+`, search for "FAQ Zyrex" and insert. The block preview appears immediately. Open the sidebar panel on the right to pick specific entries, or leave empty to show all.

== Screenshots ==

1. Admin list of FAQ entries with reorder, edit and delete controls.
2. Appearance settings — customize colors, font size, border radius and custom CSS.
3. Frontend accordion — one of many possible color schemes.

== Changelog ==

= 2.1.1 =
* Compatibility: Tested with WordPress 7.0.
* Fixed: Block editor styles now load inside the iframed editor canvas (WP 7.0 serves the editor in an iframe by default).
* Changed: Minimum requirements raised to WordPress 6.3 and PHP 7.4, in line with WordPress 7.0 dropping PHP 7.2/7.3 support.

= 2.1.0 =
* New: Native Gutenberg block with live preview and FAQ picker (select specific entries via checkboxes, or leave empty to show all).
* New: Semantic HTML5 accordion using native `<details>`/`<summary>` — better SEO signal, better accessibility, zero JavaScript.
* New: REST API endpoint `/wp-json/zxfaq/v1/list` (auth required) for the block editor.
* Improved: Styles are now properly loaded in the block editor for accurate preview.
* Tested with WordPress 6.8.

= 2.0.1 =
* New: Plugin assets — icon and banner for wordpress.org page.
* Improved: readme description focused on key benefits (SEO schema, speed, translations).
* Improved: Tag optimization for plugin directory search.

= 2.0.0 =
* New: Appearance settings panel — colors, font size, border radius, padding, custom CSS.
* New: Built-in translations for Polish, English, German, French, Spanish, Italian.
* New: FAQPage JSON-LD structured data (Google rich snippets) — on by default.
* New: Multi-line answers with basic HTML support (links, bold, italic, lists).
* New: Reorder entries using up/down buttons.
* New: `ids` shortcode attribute — display specific entries only.
* New: Replaced Font Awesome CDN with inline SVG (faster, GDPR-friendly, no external dependency).
* Security: Added WordPress nonces and capability checks to all admin forms.
* Tested with WordPress 6.7.

= 1.1 =
* Initial public release.

== Upgrade Notice ==

= 2.1.1 =
Compatibility release for WordPress 7.0. Block editor preview now renders correctly in the iframed editor. Requires WordPress 6.3+ and PHP 7.4+.

= 2.1.0 =
Major update: native Gutenberg block, semantic HTML5 accordion, zero JavaScript needed. All existing entries and settings preserved.

= 2.0.1 =
Minor update: refreshed plugin assets and readme. No code changes to the plugin itself. Safe upgrade.

= 2.0.0 =
Major update: new appearance settings, 6 languages, JSON-LD schema, security hardening. Existing questions and answers are preserved.
