=== MasterQuiz AI ===
Contributors: elearningevolve
Donate link: https://link.elearningevolve.com/self-pay
Tags: quiz, ai-quiz, quiz-generator, learndash, trivia
Requires at least: 5.8
Tested up to: 6.9.4
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free AI quiz plugin for WordPress. Auto generate quizzes from PDFs — AI quiz maker with LearnDash, trivia, and assessment tools.

== Description ==

**Dedicated Support**
For quick support and assistance, please contact us here
[https://elearningevolve.com/contact/](https://elearningevolve.com/contact/)

**MasterQuiz AI – Free AI Quiz Plugin for WordPress**

Looking for the best quiz plugin for WordPress to build assessments without manual question writing? MasterQuiz AI is an AI quiz generator WordPress plugin that lets you create quiz with AI WordPress workflows — upload a PDF and auto generate quiz WordPress content in minutes.

Use it as a WordPress quiz plugin for classrooms, training, or trivia nights. This AI quiz maker plugin produces multiple choice, true/false, and essay questions with answers, explanations, and Bloom's taxonomy tags. It also works as a WordPress interactive quiz plugin and AI assessment tool WordPress sites can embed on any page.

Built for UK educators, corporate trainers, and LMS administrators, MasterQuiz AI integrates with LearnDash LMS or runs standalone. Export to 9 industry-standard formats for Moodle, Canvas, or any LMS platform.

**Who Is It For?**

* **Teachers & Professors** — Convert lecture notes and textbook chapters into classroom quizzes.
* **Corporate Trainers** — Turn training manuals and SOPs into employee assessments with this AI assessment tool WordPress teams can deploy quickly.
* **LearnDash Course Creators** — Auto-build quizzes inside your WordPress LMS.
* **Trivia & Pub Quiz Hosts** — Use as a WordPress trivia plugin to generate quiz rounds from any text-based PDF source.

== How It Works ==

1. Upload a text-based PDF (course notes, textbook chapter, training manual, or trivia source material).
2. Choose question types, difficulty, and generation mode (Fast or Quality).
3. MasterQuiz AI extracts the text and sends it to your configured AI provider to build a complete quiz.
4. Preview questions, export to 9 LMS formats, or create a LearnDash quiz with one click.

== Key Features ==

**AI Quiz Generation**

* **Auto Generate Quiz WordPress** — Upload any text-based PDF and get a complete quiz with questions, answers, and explanations.
* **Create Quiz with AI WordPress** — No manual question writing. AI builds MCQ, true/false, and essay questions automatically.
* **Bloom's Taxonomy Tags** — Questions are tagged with cognitive levels (Remember, Understand, Apply, Analyze, Evaluate, Create).
* **Points System** — AI assigns points to each question, normalized to 100 total.
* **Background Processing** — Quiz generation runs in the background so you can continue working.

**LearnDash LMS Integration**

* **One-Click LearnDash Quiz Creation** — Automatically create LearnDash quizzes and questions when LearnDash is active.
* **LearnDash Export Formats** — Export as LearnDash CSV or LearnDash XML for manual import.
* **Shortcode Support** — Display the quiz generator on any page with `[masterquiz_ai]`.

**LMS Export & Compatibility**

* **9 Export Formats** — Export quizzes as JSON, XML, CSV, Plain Text, Moodle GIFT, QTI 1.2, Aiken, LearnDash CSV, or LearnDash XML.
* **WordPress Interactive Quiz Plugin** — Embed the generator on any page or post for students and trainees to use directly.
* **Page Builder Friendly** — Works with Gutenberg, Elementor, and other WordPress page builders via shortcode.

**AI Providers:**

This plugin connects to external AI services to generate quiz questions. You need at least one API key:

* Google Gemini (primary) — [Get API key](https://aistudio.google.com/apikey)
* OpenRouter (fallback) — [Get API key](https://openrouter.ai/keys)
* Groq (fallback) — [Get API key](https://console.groq.com/keys)

The plugin tries providers in cascade order for maximum reliability.

**Optional RAG Service:**

For improved quiz quality with large PDFs, you can connect an optional RAG (Retrieval-Augmented Generation) microservice for intelligent text chunk selection.

**Generation Modes:**

* **Fast Mode** — 2-call generation for quick results. Produces questions with options, points, hints, and cognitive level tags.
* **Quality Mode** — 3-phase generation for deeper analysis. Adds option rationales, model answers for essays, and rubric criteria.

**Shortcode Attributes:**

`[masterquiz_ai title="My Quiz" show_header="true" show_learndash="auto" max_questions="12"]`

* `title` — Quiz generator heading (default: "PDF to Quiz Generator").
* `show_header` — Show/hide the header section (default: "true").
* `show_learndash` — Show LearnDash button: "true", "false", or "auto" (default: "auto" — auto-detects LearnDash).
* `max_questions` — Maximum questions allowed (default: from settings).

== Installation ==

1. Upload the `masterquiz-ai` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **MasterQuiz AI** and enter at least one AI provider API key.
4. Add the shortcode `[masterquiz_ai]` to any page or post.

== External Services ==

This plugin relies on third-party external AI services to generate quiz questions from PDF documents. No AI processing happens locally — the extracted PDF text must be sent to an external API for quiz generation.

= Google Gemini API =

This plugin connects to the Google Gemini API to generate quiz questions using AI.

* **What it does:** Generates quiz questions (multiple choice, true/false, essay) from text content.
* **When data is sent:** Each time a user clicks "Generate Quiz" and Gemini is the selected or fallback provider.
* **What data is sent:** The extracted text content from the uploaded PDF document, along with quiz generation instructions (number of questions, question types, difficulty preferences). No personal user data is sent.
* **Service provider:** Google LLC
* **Service URL:** [https://generativelanguage.googleapis.com/](https://generativelanguage.googleapis.com/)
* **Google Gemini API Terms of Service:** [https://ai.google.dev/gemini-api/terms](https://ai.google.dev/gemini-api/terms)
* **Google Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy)
* **Google Generative AI Additional Terms:** [https://ai.google.dev/gemini-api/terms](https://ai.google.dev/gemini-api/terms)

= OpenRouter API =

This plugin connects to the OpenRouter API as a fallback AI provider for quiz generation.

* **What it does:** Generates quiz questions using various AI models available through OpenRouter.
* **When data is sent:** Each time a user clicks "Generate Quiz" and OpenRouter is the selected or fallback provider (used when the primary provider fails or is not configured).
* **What data is sent:** The extracted text content from the uploaded PDF document, along with quiz generation instructions. No personal user data is sent.
* **Service provider:** OpenRouter Inc.
* **Service URL:** [https://openrouter.ai/](https://openrouter.ai/)
* **Terms of Service:** [https://openrouter.ai/terms](https://openrouter.ai/terms)
* **Privacy Policy:** [https://openrouter.ai/privacy](https://openrouter.ai/privacy)

= Groq API =

This plugin connects to the Groq API as a fallback AI provider for quiz generation.

* **What it does:** Generates quiz questions using Groq-hosted AI models.
* **When data is sent:** Each time a user clicks "Generate Quiz" and Groq is the selected or fallback provider (used when higher-priority providers fail or are not configured).
* **What data is sent:** The extracted text content from the uploaded PDF document, along with quiz generation instructions. No personal user data is sent.
* **Service provider:** Groq Inc.
* **Service URL:** [https://api.groq.com/](https://api.groq.com/)
* **Terms of Service:** [https://groq.com/terms-of-use/](https://groq.com/terms-of-use/)
* **Privacy Policy:** [https://groq.com/privacy-policy/](https://groq.com/privacy-policy/)

= Optional RAG Microservice =

This plugin can optionally connect to a user-configured RAG (Retrieval-Augmented Generation) microservice for intelligent text chunk selection from large PDFs.

* **What it does:** Selects the most relevant text chunks from a PDF for quiz generation.
* **When data is sent:** Each time a user generates a quiz with RAG enabled in the plugin settings.
* **What data is sent:** The extracted text chunks from the uploaded PDF document. No personal user data is sent.
* **Service provider:** Self-hosted or user-configured. The URL is set by the site administrator in the plugin settings.
* **This service is disabled by default** and must be explicitly enabled and configured by the site administrator.

== Frequently Asked Questions ==

= Is MasterQuiz AI a free AI quiz plugin? =

Yes. MasterQuiz AI is a free AI quiz plugin for WordPress. The plugin itself is free to install from WordPress.org. You only need a free or paid API key from Google Gemini, OpenRouter, or Groq to power quiz generation.

= What is the best quiz plugin for WordPress with AI? =

MasterQuiz AI is built for educators who need to auto generate quiz WordPress content from PDF documents. Unlike basic quiz plugins, it uses AI to create questions, answers, explanations, and Bloom's taxonomy tags — then exports to 9 LMS formats or creates LearnDash quizzes with one click.

= How do I create quiz with AI WordPress? =

Install MasterQuiz AI, add your AI provider API key in the settings, then place the `[masterquiz_ai]` shortcode on any page. Upload a PDF, choose your options, and click Generate Quiz. The AI quiz maker plugin builds your assessment in minutes.

= Can I use this as a WordPress trivia plugin? =

Yes. Upload any text-based PDF with trivia source material and MasterQuiz AI will generate multiple choice and true/false questions suitable for trivia nights, pub quizzes, or team training games.

= Is this a WordPress interactive quiz plugin? =

Yes. Embed the quiz generator on any page using the shortcode. Visitors can upload a PDF and generate quizzes directly on your site without accessing the WordPress dashboard.

= What is MasterQuiz AI? =

MasterQuiz AI is a WordPress quiz plugin and AI assessment tool WordPress sites use to automatically create quizzes from PDF documents. It generates multiple choice, true/false, and essay questions with answers, explanations, and Bloom's taxonomy tags.

= Do I need LearnDash? =

No. The plugin works standalone as a quiz generator with 9 export formats. LearnDash integration is optional — when LearnDash is active, you get the added ability to auto-create LearnDash quizzes.

= Can I create LearnDash quizzes from a PDF automatically? =

Yes. When LearnDash is installed and active, MasterQuiz AI can create a complete LearnDash quiz with all questions in one click after generation. You can also export as LearnDash CSV or LearnDash XML for manual import.

= What export formats does MasterQuiz AI support? =

Nine formats: JSON, XML, CSV, Plain Text, Moodle GIFT, QTI 1.2, Aiken, LearnDash CSV, and LearnDash XML. This covers Moodle, Canvas-compatible QTI, and LearnDash LMS workflows.

= Which AI provider should I use? =

Google Gemini is recommended as the primary provider. It offers free API access and high-quality quiz generation. OpenRouter and Groq serve as fallbacks.

= What PDF formats are supported? =

The plugin supports text-based PDF files. Scanned/image-based PDFs are not supported as the plugin cannot extract text from images (no OCR).

= How many questions can I generate? =

Between 3 and 12 questions per quiz, configurable from the settings page or shortcode interface.

= What question types does the plugin generate? =

Multiple choice (MCQ), true/false, and essay questions. Quality Mode also adds option rationales, model answers for essays, and rubric criteria.

= Is my PDF data secure? =

Uploaded PDFs are stored temporarily on your server and automatically deleted after quiz generation. The PDF text is sent to the configured AI provider for quiz generation — no data is stored externally.

= Does MasterQuiz AI work on shared hosting? =

Yes. The plugin runs on standard WordPress hosting with PHP 7.4+. AI processing is handled by external API providers, so no GPU or special server hardware is required on your WordPress host.

== Screenshots ==

1. Free AI quiz plugin interface with drag-and-drop PDF upload.
2. AI quiz generator WordPress preview with question navigation and Bloom's taxonomy tags.
3. Export options with 9 LMS-compatible formats.
4. Admin settings page with API key management and generation defaults.

== Our Other Plugins ==

1. [WPZoomy](https://wpzoomy.com/)
2. [Virtual Classroom for WordPress (Free)](https://elearningevolve.com/products/virtual-classroom-wordpress-free/)
3. [Virtual Classroom for WordPress (Pro)](https://elearningevolve.com/products/wp-virtual-classroom/)
4. [LearnDash Student Voice](https://elearningevolve.com/products/learndash-student-voice/)
5. [Simple Email Scheduler](https://wordpress.org/plugins/simple-email-scheduler/)
6. [UpdateGuard](https://wordpress.org/plugins/updateguard/)
7. [Topbar Buddy](https://wordpress.org/plugins/topbar-buddy/)
8. [Add From Server Reloaded](https://wordpress.org/plugins/add-from-server-reloaded/)

== Changelog ==

= 1.0.3 =
* Updated: Readme optimised with UK SEO keywords for WordPress quiz plugin, AI quiz generator, trivia, and assessment tool searches.

= 1.0.2 =
* Updated: Plugin readme with professional SEO-optimized content, expanded FAQs, How It Works section, and improved WordPress.org discoverability.

= 1.0.1 =
* Fix: LearnDash quiz creation failure on newer LearnDash versions where `WpProQuiz_Model_QuizMapper::save()` no longer returns the saved object. The mapper return value is now handled defensively so the code works on both older and newer LearnDash versions.
* Fix: Google Gemini calls failed with a 400 "Unknown name 'thinkingConfig'/'responseMimeType'/'responseSchema'" error because the plugin tried the `v1` endpoint first. Switched to `v1beta` exclusively (the only endpoint that supports these fields).
* Fix: Refreshed OpenRouter free-model list. Removed three models that returned 404 "No endpoints found" (`google/gemma-3-27b-it:free`, `mistralai/mistral-small-3.1-24b-instruct:free`, `qwen/qwen3-4b:free`) and replaced them with currently available free models.
* Fix: Removed Groq model `llama-3.1-70b-versatile` which has been decommissioned by Groq, and added current production models (`llama-4-scout-17b-16e-instruct`, `qwen/qwen3-32b`, `llama-3.1-8b-instant`).

= 1.0.0 =
* Initial release.
* AI-powered quiz generation from PDF documents.
* Support for MCQ, True/False, and Essay questions.
* LearnDash integration for auto-quiz creation.
* 9 export formats.
* Admin settings page with API key management.
* Background processing with progress tracking.

== Upgrade Notice ==

= 1.0.3 =
Readme update only. No code changes — adds UK SEO keyword optimisation for WordPress.org discoverability.

= 1.0.2 =
Readme update only. No code changes — improves plugin description and SEO on WordPress.org.

= 1.0.1 =
Bug-fix release. Restores LearnDash quiz creation on the latest LearnDash versions and fixes AI provider failures caused by upstream model and endpoint changes (Gemini API endpoint, OpenRouter free-model availability, decommissioned Groq model).

= 1.0.0 =
Initial release.
