=== QuizOut ===
Contributors: ekeretex
Tags: quiz, interactive content, content engagement, lead generation, education
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 0.1.0
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn published WordPress posts into playable quizzes while keeping quiz, play, answer, result, and lead data on your site.

== Description ==

QuizOut creates single-select quizzes from published posts. Authors review and edit each generated quiz in WordPress before approving it for readers.

QuizOut 0.1.0 is an Early Access release. Install it on a staging site first, keep a current backup, and expect features and workflows to change before 1.0.0.

Features include:

* Graded knowledge checks, weighted scorecards, and routed recommendations.
* Automatic placement plus a QuizOut block and `[quizout]` shortcode.
* Local scoring, play tracking, analytics, and optional consent-based lead capture.
* Configurable post types, placement, colour mode, accent colour, and compact layout.
* Cached approved quizzes that keep working if the generation service is unavailable.
* Optional “Powered by QuizOut” attribution, off by default and shown only when the current plan permits it.

QuizOut has two free GPL distribution channels. The self-hosted build from QuizOut checks a public, unauthenticated update feed and supports normal one-click WordPress updates. The WordPress.org directory build contains no custom updater and uses WordPress Core updates for the `quizout` slug. No account or API key is required to download or update either build.

== External service ==

QuizOut connects to the external QuizOut service at https://api.quizout.io/v1 for site setup and API-key verification, quiz generation, usage and entitlement refresh, and a site claim explicitly initiated by an administrator.

Site setup sends the site's home URL, WordPress version, timezone, and a short-lived verification proof. Quiz generation sends the post ID, post URL, title, article content, publication time, locale, and generation context. A site claim sends only the owner email supplied by the administrator.

Reader answers, plays, results, and leads are stored locally in WordPress and are never sent to QuizOut. Approved cached quizzes continue to work when the service is unavailable.

The self-hosted build also checks the public update metadata at https://releases.quizout.io/updates/quizout.json. That request is not authenticated and sends only the installed plugin version, PHP version, and WordPress locale added by the bundled update library. It never sends the QuizOut API key, site URL, article content, reader activity, or lead data. The directory build does not make this request.

Use of the external service is subject to the [QuizOut Privacy Policy](https://quizout.io/privacy) and [QuizOut Terms of Service](https://quizout.io/terms).

== Installation ==

1. Install and activate QuizOut from the WordPress Plugins screen.
2. Open **QuizOut** in wp-admin.
3. Choose **Start free** or paste a site API key from an existing QuizOut account.
4. Select the post types eligible for generation and choose whether generated quizzes require manual approval.
5. Publish or update a post, review its QuizOut panel, and approve the quiz.
6. Configure placement, display, and optional lead capture from the QuizOut settings page.

== Frequently Asked Questions ==

= Do readers need a QuizOut account? =

No. Readers play approved quizzes directly on your WordPress site.

= What data stays in WordPress? =

Generated quizzes, author edits, approval state, plays, answers, results, and leads stay in your WordPress database. Reader data is not sent to QuizOut.

= What happens if the QuizOut service is unavailable? =

Previously approved cached quizzes continue to render and score locally. New generation and usage refreshes wait until the service is available again.

= Is the “Powered by QuizOut” link required? =

No. It is disabled by default. It appears only when an administrator opts in locally and the current QuizOut plan permits attribution; block and shortcode attributes cannot override that choice.

= How are plugin updates delivered? =

The free build downloaded from QuizOut checks QuizOut's public update feed and offers updates on the normal Plugins and Updates screens. The WordPress.org build contains no custom updater and receives updates from WordPress Core. When the directory version is available, Core takes precedence so a self-hosted install can hand over to the directory build on a newer release.

= What happens when I uninstall QuizOut? =

QuizOut keeps local content by default. An administrator can explicitly select the purge option before uninstalling to remove QuizOut options, quiz metadata, tables, and scheduled jobs.

== Screenshots ==

1. Choose zero-signup Start free or connect an existing QuizOut account.
2. Review the connected plan, quota, and automatic-generation settings.
3. Edit, preview, approve, or regenerate a quiz from the post editor.
4. Readers answer one accessible, single-select question at a time.
5. Results appear instantly, with an optional consent-based lead form.

== Changelog ==

= 0.1.0 =
* Initial public Early Access self-hosted release with automatic updates.
* Includes a separate WordPress.org-ready directory artifact that is not yet published.

== Upgrade Notice ==

= 0.1.0 =
Early Access release. Test on a staging site and keep a current backup.
