=== KD Quiz – Interactive Quiz ===
Contributors: nkonstas
Tags: quiz, education, engagement, shortcode, ajax
Requires at least: 5.4
Tested up to: 6.8
Stable tag: 1.4.0
Requires PHP: 7.2
License: GPLv3 or later
License URI: https://github.com/nkonstas/wordpress-quiz/blob/main/LICENSE

Embed a lightweight, card-style quiz with AJAX rotation and scoring to boost engagement anywhere on your site.

== Description ==
KD Quiz adds an admin-friendly custom post type for quiz questions, plus a front-end shortcode that renders an animated flash card interface. The plugin includes:

* Four default styles with a custom option for bespoke theming.
* AJAX-powered question rotation, view tracking, and scoring without page reloads.
* Optional automatic insertion based on content headings so you can drop quizzes into long-form articles without shortcodes.
* JSON import/export to seed quizzes in bulk from external systems.

All user inputs are sanitized, escaped, and routed through WordPress nonces to protect your admin users and visitors. No third-party services are contacted.

== Installation ==
1. Upload the `kd-quiz` folder to `wp-content/plugins/` or install it via the WordPress dashboard.
2. Activate **KD Quiz – Interactive Quiz** through the **Plugins** menu.
3. Visit **Quiz Questions → Add New Question** to create your first question and mark the correct answer.
4. Configure global behaviour under **Quiz Questions → Settings** (question count, styles, auto-insert rules, and text replacements).
5. Place the `[kdquiz]` shortcode in any post or page, or enable automatic insertion to let the plugin place quizzes after targeted headings. (The legacy `[kd-quiz]` shortcode continues to work for existing content.)

== Frequently Asked Questions ==
= How do I change the quiz styling? =
Use **Quiz Questions → Settings** to pick one of the bundled styles or choose **Custom** and enqueue your own CSS targeting `.kdquiz_style_custom`.

= Can I import questions from another system? =
Yes. Head to **Quiz Questions → Import Questions**, paste a JSON payload with `questionText`, `options`, `correctOptionId`, and `explanation`, then submit the form.

= Does the plugin track personal data? =
No. The plugin stores aggregate view and answer counts per question only.

= 1.4.0 =
Switches the Edit Question page to enqueue its JavaScript through WordPress core, adds a reusable admin helper script, and rebuilds the packaged assets for 1.4.0.

== Screenshots ==
1. Manage questions and see engagement metrics in the WordPress admin.
2. Configure button text, grades, and auto-insert settings.
3. Import a batch of questions from JSON.
4. Front-end quiz card with score summary.

== Changelog ==
= 1.4.0 =
* Replaces the inline `<script>` block on the Edit Question screen with a proper admin enqueue that loads a dedicated asset (`includes/kd-quiz-editing.php`, `assets/kd-admin-answer-sync.js`).
* Adds a minified build of the new admin helper and updates the npm build chain to regenerate it along with the existing bundles (`assets/kd-admin-answer-sync.min.js`, `package.json`).
* Ensures `build-release.sh` installs dependencies when needed, runs `npm run build`, and then packages the freshly compiled assets into the release ZIP.

= 1.3.5 =
* Escapes any optional `disabled`/`aria-disabled` attributes emitted by the auto-insert settings UI so the markup stays PHPCS-compliant (`includes/kd-quiz-settings.php`).
* Documents the reviewer feedback follow-up in `ReviewFixes.txt` and bumps the plugin version metadata to 1.3.5.
* Recompiles the front-end/admin assets so the distributed package advertises version 1.3.5.

= 1.3.4 =
* Adds an inline JSON example below the importer textarea so editors can copy the expected payload shape (`includes/kd-quiz-import.php`).
* Adds concise help text under each Quiz Settings control so site owners know how auto-insert and styling options behave (`includes/kd-quiz-settings.php`).
* Switches the minimum-distance control to pixels, introduces a container selector, and disables the placement fields unless auto insertion is active so automatic quizzes stay within the main content area (`includes/kd-quiz-settings.php`, `assets/kd-quiz.js`).
* Replaces the single heading selector with dedicated “insert before”, “insert after”, and “never insert inside” lists so auto placement follows predictable priorities (`includes/kd-quiz-settings.php`, `assets/kd-quiz.js`).
* Adds a toggle to enable verbose console logging so you can trace heading selection and offsets while debugging auto placement (`includes/kd-quiz-settings.php`, `assets/kd-quiz.js`).
* Documents all security/prefix fixes in `ReviewFixes.txt` for easy reviewer handoff (e.g. `ReviewFixes.txt:1`).
* Rebuilds scripts and metadata so the distributed bundles advertise version 1.3.4.

= 1.3.3 =
* Escapes the “Correct choice” status pill output and adds a nonce check to the reset notice flow to address WordPress.org review feedback.
* Replaces the legacy direct SQL migration with `wp_update_post()` to respect object caching and coding standards.
* Rebuilds the front-end metadata so the packaged assets report version 1.3.3.

= 1.3.2 =
* Refreshes the Edit Question admin UI with a clear “Mark as correct” pill and row highlight so the chosen answer stands out.
* Adds helper text and status chips to reinforce which answer will be saved as correct.
* Rebuilds admin styles and the bundled JavaScript for the 1.3.2 release package.

= 1.3.1 =
* Improves the JSON import UX by redirecting back to the import screen with contextual error messaging when the payload is missing or invalid.
* Adds nonce-protected status flags so both success and error notices render in the proper admin screens.
* Rebuilds all assets for the 1.3.1 maintenance release.

= 1.3.0 =
* Hardened admin reset/import handlers by routing through `admin-post.php` with nonce and capability checks to satisfy the WordPress.org review.
* Standardised on the `kdquiz` prefix across CPTs, AJAX, styles, and shortcodes while keeping legacy identifiers compatible for existing installs.
* Normalised stored style slugs and added a `[kd-quiz]` shortcode alias so upgrades require no manual content changes.

= 1.2.2 =
* Random fetch fallback to ensure a full question set even when all are marked viewed (keeps VIP-safe query semantics).
* Packaging and i18n: include `/languages` in release; remove discouraged `load_plugin_textdomain()` call.

= 1.2.1 =
* Change plugin name to “KD Quiz – Interactive Quiz” to align with the desired WordPress.org slug `kd-quiz`.
* Maintenance: rebuild minified assets and package script updates.
= 1.2.0 =
* Addressed WordPress Plugin Checker feedback: added translators comments for placeholder strings, ensured proper escaping in admin UI, and sanitized/validated AJAX and form inputs with nonce checks.
* Replaced direct SQL in import duplicate checks with core APIs; tightened import notice handling.
* Removed error_log usage; added `kdquiz_include_failed` hook for observability.
* Updated "Tested up to" to 6.8 and refreshed front-end metadata; minor copy polish in short description.
= 1.1.0 =
* Updated option, meta, and function prefixes to the `kdquiz_` namespace to avoid conflicts.
* Hardened nonce checks, request sanitization, and output escaping across AJAX handlers and admin forms.
* Refreshed readme to pass the WordPress.org validator and declared testing up to WordPress 6.5.

== Upgrade Notice ==
= 1.4.0 =
Required for WordPress.org review parity: admin scripts now load through `wp_enqueue_script()` and the build/release tooling regenerates every asset before packaging.

= 1.3.5 =
Security tidy-up to satisfy the WordPress.org review: auto-insert settings now escape their `disabled` attributes and the bundled assets were rebuilt for 1.3.5.

= 1.3.4 =
Quality-of-life release: new JSON example in the importer, inline quiz-setting help, auto-insert scoped by container with pixel distances, updated review checklist, and rebuilt bundles for the 1.3.4 package.

= 1.3.3 =
Update to align with the latest WordPress.org security review feedback and ensure migrations honour object caching.

= 1.3.2 =
Update for a clearer “Mark as correct” workflow inside the question editor, plus refreshed admin styling.

= 1.3.1 =
Maintenance release focused on the JSON importer UX: failed imports now return you to the admin screen with clear messaging, plus refreshed assets.

= 1.2.0 =
Compatibility and security hardening release. Please update to ensure translator hints, escaping, nonce verification, and import checks match current WordPress guidelines.
= 1.1.0 =
Please clear any cached assets so the updated JavaScript receives the latest option keys and security improvements.