=== Quiztest Builder Elite ===
Contributors: ricardobrown
Donate link: https://www.paypal.com/donate/?hosted_button_id=VNX6X44YVNXCW
Tags: quiz, exam, test, multiple choice, timer
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create timed multiple choice quizzes for signed-in users, limit attempts, save every result, and review error and results logs.

== Description ==

Quiztest Builder Elite adds a complete quiz system to WordPress. Build multiple choice quizzes in the dashboard, place them on any page with a shortcode, and track every attempt.
Whether you are running an e-learning platform or basic employee training, you can build customized quizzes

**Features**

* Dashboard menu managed by Administrators.
* Let specific roles or individual users create and manage quizzes. Non-administrators can only manage the quizzes they created.
* Users must be signed in to take a quiz.
* Add, edit, view, copy, delete and search quizzes.
* Multiple choice questions with one correct answer and an optional explanation.
* Per-quiz time limit with a countdown timer. The limit is enforced on the server, not only in the browser.
* Per-quiz maximum attempts per user. Starting a quiz counts as an attempt, so refreshing the page cannot grant extra tries.
* Optional restriction of a quiz to named users.
* Results saved for every attempt, with score, percentage, pass or fail, time taken, and a full answer review.
* Error log, results log and activity log, with search, filters and automatic clean-up.
* Quiz content is never exposed with the correct answers before submission.

**Shortcodes**

* `[quiztest_builder_elite id="123"]` shows one quiz.
* `[quiztest_builder_elite_list limit="20"]` lists every quiz available to the current user.

== Installation ==

1. Upload the `quiztest-builder-elite` folder to `/wp-content/plugins/`, or install the ZIP from Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins screen.
3. Open **Quiztest Builder Elite** in the dashboard menu and choose **Add New Quiz**.
4. Set the quiz to Published, then copy its shortcode into a page.
5. Optional: open **Users and Access** to allow other roles or users to create quizzes.

== Screenshots ==

1. Settings page.
2. Users and Access page.
3. Error logs page.
4. Results page.
5. Add New Quiz page.

== Support ==

If you encounter any issues or have questions, please use the following resources:

Visit our community https://netwebsystems.com/community/

Or, send an email to tech.support@netwebsystem.com

Or, Open a ticket at https://netwebsystem.com/helpdesk

== Frequently Asked Questions ==

= Do users need an account? =

Yes. Only signed-in users can take a quiz. Visitors see a link to sign in.

= Who can create quizzes? =

Administrators can manage everything. Under **Users and Access** an administrator can allow other roles or individual users to create quizzes. Those users can edit, copy, delete and view results only for quizzes they created.

= How is the timer enforced? =

The server records when an attempt starts. Answers submitted after the time limit plus a short grace period (Settings > Grace period) are rejected and the attempt is recorded with a zero score.

= What counts as an attempt? =

Starting a quiz. If a user leaves and returns before the timer ends, they resume the same attempt instead of starting a new one.

= What happens to results when I delete a quiz? =

Saved results are kept, along with the quiz title and a copy of the questions as they were taken.

= Does the plugin delete its data when removed? =

Only if you enable **Delete data** in the plugin settings before deleting the plugin. By default all data is kept.

= Does it work on multisite? =

Activate it on each site where it is needed.

== Changelog ==

= 1.0.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0.0 =
Initial release.
