=== WiVi Quiz Maker – Create Quizzes, Exams & Online Test ===
Contributors: infothemecom, omkritindia
Donate link: https://infotheme.net/wivi-quiz-builder/
Tags: quiz, quiz maker, exam, education, assessment
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.12.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Quiz Maker with advance features for WordPress. Create quizzes, exams, assessments and knowledge tests with scoring, timers and results on your site.

== Description ==

WiVi Quiz Maker helps you create interactive quizzes, online exams, and knowledge tests in WordPress. Build questions, choose question types, pick a theme, set scoring rules, and publish engaging quizzes anywhere on your website with a shortcode, Gutenberg block, Elementor widget, or classic sidebar widget.

This WordPress quiz plugin is built for educators, trainers, bloggers, and businesses who need a clear quiz maker without complexity. Create scored quizzes, true-or-false tests, multiple-choice exams, fill-in-the-blank questions, and more — then track attempts from your WordPress dashboard.

### WordPress Quiz Maker plugin

* [WiVi Quiz Builder](https://infotheme.net/wivi-quiz-builder/)
* [Quiz plugin Documentation](https://infotheme.net/docs/wivi-quiz-builder/)

> **Quiz shortcode**
> **[wivi_quiz id="123"]**

**Question types**

* **Multiple Choice (Single)** — one correct answer (MCQ)
* **Multiple Choice (Multi)** — more than one correct answer
* **True / False** — classic exam-style questions
* **Dropdown** — choose one answer from a list
* **Short Text** — type-in answers with accepted responses
* **Fill in the Blank** — complete missing words
* **Number** — numeric answers with optional tolerance
* **Date** — pick a date as the answer
* **Info / Content** — informational slides that do not affect the score

**Quiz types you can build**

Use this quiz maker to create trivia quizzes, scored exams, knowledge tests, IQ-style quizzes, yes-or-no / true-or-false quizzes, training assessments, and survey-style quizzes (hide or de-emphasize scoring with info questions and result messages). Score-band result messages let you show different outcomes based on the user’s percentage.

= Creating a simple quiz =

1. Go to **WiVi Quiz → Questions** and add questions to your question bank (or create them inside the quiz builder).
2. Go to **WiVi Quiz → Quizzes** and click **Add New**.
3. Add a title, select questions, choose a theme, and configure scoring or timer options.
4. Copy the shortcode from the Publish tab and paste it into a page or post.

That’s it. Your WordPress quiz is ready.

= Customizable questions =

Each question supports points, explanations, hints, correct/wrong messages, categories, tags, and optional media. Add a question image, answer images, a background image, or a YouTube / uploaded video. Mark questions as “no influence to score” when you want survey-style items inside a quiz.

= Quiz settings =

This WordPress exam and test plugin includes practical options for real quizzes:

* Randomize questions
* Randomize answers
* Quiz timer with auto-submit behavior
* Pass score with pass / fail messaging
* Score-band / interval result messages
* Show correct answers and explanations
* Instant right / wrong feedback
* One question per page or all questions on one page
* Progress bar
* Redirect users after quiz completion
* Schedule quiz start and end times
* Require login, role allowlist, or password / access codes
* Max attempts (by user, IP, cookie, or email)
* Max number of quiz takers
* Negative marking

= Quiz with timer =

Enable a countdown timer for timed exams and online tests. When time runs out, the quiz can be submitted automatically — useful for classroom tests, certifications practice, and competitive quizzes.

= Quiz results, scores and reports =

After a quiz is completed, attempts are stored in your WordPress database. From **WiVi Quiz → Results** you can review scores, pass rates, averages, attempt details, and a leaderboard. Export results to CSV for analysis, email marketing, or offline reporting.

Frontend results can show percentage or correct-count scoring, pass/fail messages, score-band messages, answer review / solutions, rank among attempts, restart, social share, and an optional printable certificate for passed users.

= Quiz themes, styles and live preview =

Six designed quiz themes are included: Aurora, Strand, Pulse, Orbit, Bloom, and Scroll. Customize colors, width, buttons, progress, timer, and animations to match your site. Use live draft preview from the builder while you edit.

= Question bank =

Reuse questions across quizzes with a dedicated question bank. Organize questions with categories, insert them into any quiz, and import or export questions via CSV.

= User data form =

Collect name, email, and phone before or after the quiz. Use the data for follow-up, lead capture, or admin notifications. Optionally email results to the user and the admin with `wp_mail`.

= Embed anywhere =

* Shortcode: `[wivi_quiz id="123"]`
* Gutenberg block
* Elementor widget
* Classic sidebar widget
* Pretty URL: `/quiz/{id}/`

**Additional shortcodes**

* `[wivi_quiz_results id="123"]` — recent results for a quiz
* `[wivi_quizzes limit="10"]` — list quizzes
* `[wivi_quiz_category slug="trivia"]` — list quizzes in a category
* `[wivi_leaderboard]` — site-wide leaderboard

= Quiz social sharing =

Let users share their quiz result via WhatsApp, Facebook, X (Twitter), LinkedIn, Telegram, or Email to grow traffic and engagement.

= Integrations =

Optional integrations (only when you enable them and add your own credentials):

* Google reCAPTCHA (spam protection)
* Mailchimp
* Zapier webhook
* Slack incoming webhook
* ActiveCampaign (webhook-style)
* Google Sheets via Apps Script webhook

**Features**

* Unlimited quizzes
* Unlimited questions
* 9 question types
* Question bank with categories
* CSV import / export for questions
* Scoring, pass score, and negative marks
* Score-band result messages
* Quiz timer
* Randomize questions and answers
* Access codes / password protection
* Login and role restrictions
* Attempt limits and scheduling
* Results dashboard with statistics
* CSV export of attempts
* Leaderboard shortcode
* Six quiz themes and style controls
* Live draft preview
* Gutenberg block, Elementor widget, and sidebar widget
* Social sharing on results
* Printable certificate on pass
* Email results to user and admin
* Opt-in “Powered by” branding only (off by default)
* No account or external license required to use the plugin

**A free WordPress quiz maker to create quizzes, exams, and tests — give it a try!**

In case of questions or suggestions, visit the [plugin page](https://infotheme.net/wivi-quiz-builder/) or check the [documentation](https://infotheme.net/docs/wivi-quiz-builder/).

== External services ==

This plugin can optionally connect to third-party services that you configure. Nothing is sent until you enable the related setting and provide your own credentials (or a visitor completes a protected form).

= Google reCAPTCHA =

Used only when you enable reCAPTCHA in settings and provide site/secret keys. It helps reduce spam quiz submissions.

* Data sent: reCAPTCHA response token and server IP on verification
* Service: Google reCAPTCHA — [Terms](https://policies.google.com/terms) · [Privacy](https://policies.google.com/privacy)

= Mailchimp =

Used only when you enable the Mailchimp integration and save an API key/list. On quiz submission, subscriber details may be synced to your Mailchimp list.

* Data sent: name/email (and other form fields you collect) when a quiz is submitted
* Service: Mailchimp — [Terms](https://mailchimp.com/legal/terms/) · [Privacy](https://www.intuit.com/privacy/statement/)

= Zapier =

Used only when you enable Zapier and provide a webhook URL you control. Submission payloads can be posted to that webhook.

* Data sent: quiz attempt summary / fields you map when a quiz is submitted
* Service: Zapier — [Terms](https://zapier.com/legal) · [Privacy](https://zapier.com/privacy)

= ActiveCampaign =

Used only when you enable ActiveCampaign and provide your own API URL and key. Quiz attempt data is posted to your ActiveCampaign account.

* Data sent: quiz attempt summary (name, email, score) when a quiz is submitted
* Service: ActiveCampaign — [Terms](https://www.activecampaign.com/legal/terms-of-service) · [Privacy](https://www.activecampaign.com/legal/privacy-policy)

= Google Sheets (Apps Script webhook) =

Used only when you enable the Google Sheets integration and paste a Google Apps Script web app URL that you created and control.

* Data sent: quiz attempt summary when a quiz is submitted
* Service: Google — [Terms](https://policies.google.com/terms) · [Privacy](https://policies.google.com/privacy)

= Slack =

Used only when you enable Slack and provide an Incoming Webhook URL for your workspace.

* Data sent: notification text about a quiz submission
* Service: Slack — [Terms](https://slack.com/terms-of-service) · [Privacy](https://slack.com/privacy-policy)

= Social share =

Share buttons open WhatsApp / Facebook / X / LinkedIn / Telegram / Email using the visitor’s browser. No analytics are sent to InfoTheme.

This plugin does not phone home for analytics or licensing. Quiz attempts are stored in your WordPress database.

== Installation ==

There are two easy ways to install this WordPress quiz plugin:

* Log in to your WordPress dashboard.
* Go to **Plugins → Add New**.
* Search for **WiVi Quiz Builder**.
* Click **Install Now**, then **Activate**.

Or install from a zip file:

* Download the plugin zip from [wordpress.org](https://wordpress.org/plugins/wivi-quiz-builder/) (when available) or from the [product page](https://infotheme.net/wivi-quiz-builder/).
* Go to **Plugins → Add New → Upload Plugin**.
* Choose the zip file and click **Install Now**, then **Activate**.

After activation, open **WiVi Quiz → Quizzes** and create your first quiz. Use the shortcode, block, or Elementor widget to embed it on any page or post.

== Frequently Asked Questions ==

= How do I create a quiz? =

Go to **WiVi Quiz → Quizzes**, click **Add New**, add a title, insert questions from the question bank or create them in the builder, choose a theme, set your scoring options, and save. Copy the shortcode from the Publish tab.

= How do I create a question? =

Go to **WiVi Quiz → Questions**, click **Add New**, enter the question text, choose a question type, add answers and mark the correct ones, then save. You can also create questions directly inside a quiz.

= How do I insert a quiz into a page or post? =

Copy `[wivi_quiz id="Your_Quiz_ID"]` from the quiz Publish tab (or Quizzes list) and paste it into the editor. You can also use the Gutenberg quiz block, Elementor widget, or sidebar widget.

= How many question types are available? =

Nine: Multiple Choice (Single), Multiple Choice (Multi), True/False, Dropdown, Short Text, Fill in the Blank, Number, Date, and Info/Content.

= Is there a limit on quizzes or questions? =

No plugin-imposed limit. You can create unlimited quizzes and unlimited questions. Very large quizzes may still be limited by your hosting PHP settings (for example `max_input_vars`).

= Can I create a timed exam? =

Yes. Enable the quiz timer in quiz settings. When time expires, the quiz can submit automatically — ideal for online exams and tests.

= Where are quiz results stored? =

Attempts are saved in a custom database table on your site. View them under **WiVi Quiz → Results**, including statistics and CSV export.

= Can I protect a quiz with a password? =

Yes. Use access codes / password protection in the Limitations settings. You can also require login, restrict by role, schedule availability, and limit attempts.

= Does the plugin show “Powered by” branding? =

No, not by default. Frontend attribution appears only if you enable the “Show Powered by branding” checkbox in **WiVi Quiz → Settings**.

= Does this plugin require an account or external license? =

No. The plugin works on your site without connecting to InfoTheme for licensing.

= Can I translate this plugin? =

Yes. Strings use the standard WordPress translation API with the text domain `wivi-quiz-builder`. You can translate them with tools such as [Loco Translate](https://wordpress.org/plugins/loco-translate/).

== Screenshots ==

1. Dashboard
2. Quiz builder
3. Front-end theme
4. Results screen
5. Reports

== Changelog ==

= 1.12.3 =
* All bundled integrations (Mailchimp, Zapier, Slack, ActiveCampaign, Google Sheets, reCAPTCHA) are fully enabled — no Pro gating anywhere in the plugin.
* Integrations that are not implemented yet are clearly labeled "Coming soon" and disabled for everyone equally.
* "Powered by" frontend branding is now off by default and strictly opt-in via an explicit settings checkbox.
* Renamed all functions, classes, constants, options, hooks, post types, and script handles to the unique `wivi_` / `WIVI_` prefix (4+ characters).
* Documented ActiveCampaign and Google Sheets external services in the readme.

= 1.12.2 =
* Updated Plugin URI to the live product page.

= 1.12.1 =
* Final display name and slug: WiVi Quiz Builder / wivi-quiz-builder.

= 1.12.0 =
* WordPress.org uniqueness and ownership clarity rename.
* Unlocked bundled features for free directory compliance (no locked local features).
* Removed arbitrary custom CSS/JS fields.
* Stopped loading Google Fonts from third-party CDNs.
* Documented optional external services (reCAPTCHA, Mailchimp, Zapier, Slack).
* Enqueued view/admin CSS via WordPress style APIs instead of raw style tags.

= 1.11.2 =
* Previous We Quiz Maker packaging release.

== Upgrade Notice ==

= 1.12.3 =
Guideline compliance: all features unlocked, opt-in branding, unique wivi_ prefix.

= 1.12.2 =
WiVi Quiz Builder — WordPress.org review update.

= 1.12.1 =
Renamed to WiVi Quiz Builder (slug: wivi-quiz-builder).
