Plugin Name: Quiztest Builder Elite

If you find this plugin useful please donate or (Join our Premium Subscribers Group) Donate link: https://www.paypal.com/donate/?hosted_button_id=VNX6X44YVNXCW

Thank you for choosing netwebsystems: https://netwebsystems.com

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

== Support ==

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

send an email to tech.support@netwebsystem.com

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

Request Premium Subscriber Group - Premium Support and Premium Features - Please contact us at premium.support@netwebsystem.com

Version: 1.0.0.0 Requires at least: 6.0

Requires PHP: 7.4

Author: Ricardo Brown

License: GPLv2 or later

License URI: https://www.gnu.org/licenses/gpl-2.0.html

== 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, assign them to specific user groups, and watch the results roll in in real-time.

**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.

Quiztest Builder Elite is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version. Quiztest Builder Elite is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

== 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.

= 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.