=== Mevabi Shortest – Fast Test & Quiz Generator ===
Contributors: mevabien22
Tags: quiz, test, questionnaire, shortcode, education
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create interactive scored tests, quizzes, questionnaires and assessments in WordPress using a simple shortcode and an easy visual builder.

== Description ==

Mevabi Shortest is a lightweight test and quiz generator for WordPress that lets you create interactive scored tests, quizzes, questionnaires and assessments without writing shortcode code manually.

Create your test from the visual builder, configure questions, answers, points and result ranges, and then insert the generated shortcode into any post or page.

The plugin is suitable for educational activities, knowledge tests, self-assessments, questionnaires, personality-style tests, vocational tests and other interactive quizzes where answers can have different point values.

All test information is stored directly in the shortcode attributes. The plugin does not require custom database tables to store tests.

**Main features**

* **Visual test and quiz builder:** Create tests and quizzes from the WordPress admin panel without manually writing shortcode syntax.
* **Shortcode-based tests:** Insert your tests into posts and pages using the `[mevabishortest]` shortcode.
* **Edit existing tests:** Paste an existing shortcode into the "Edit Test" screen and modify it using the visual builder.
* **Custom answer scoring:** Assign a different point value to every answer, allowing more flexible tests and assessments.
* **Negative scores:** Use negative, zero or positive points for answers and create result ranges that include negative values.
* **Custom result messages:** Define different messages based on the visitor's total score, such as beginner, intermediate, advanced or custom assessment results.
* **Optional final score:** Show or hide the numeric score above the final result. This is useful when the score itself is not meaningful, such as in vocational or personality-style tests.
* **Retake option:** Add a "Take the test again" button so visitors can reset and complete the test again.
* **Two display modes:** Show all questions on one screen or display one question at a time with a progress bar.
* **Global styling options:** Customize colors and text size for the tests displayed on your website.
* **Lightweight and self-contained:** No external API calls, third-party services, custom database tables or external dependencies are required.

**Create tests with a shortcode**

A basic test can be created using the following shortcode:

`[mevabishortest title="Test title" description="Optional description" button="Next" display="all" score="yes" repeat="Take the test again" q1="Question 1|Answer A;10|Answer B;5|Answer C;0" q2="Question 2|Answer A;0|Answer B;10|Answer C;5" result="Beginner;0;10|Intermediate;11;20|Advanced;21;25|Expert;26;50"]`

The visual builder generates this shortcode for you, so you do not need to write the syntax manually.

**Flexible scoring and result ranges**

Each answer can have its own point value. Result messages are displayed according to the total score obtained.

Use the following format:

`result="Text;minimum;maximum|Text2;minimum;maximum"`

Negative scores are supported. For example:

`result="Insufficient;-10;-5|Very low;-4;2|Great student;3;20"`

This makes the plugin suitable for tests where incorrect answers can subtract points or where different answers have different levels of value.

**Display modes**

Choose between two ways of presenting your test:

* **All questions:** Display all questions on the same screen.
* **One question at a time:** Display questions individually with a progress bar for a more focused quiz experience.

**Score and retake options**

You can decide whether visitors see their final numeric score.

For example:

`score="yes"`

displays the score, while:

`score="no"`

hides the numeric score and displays only the corresponding result.

You can also add a retake button:

`repeat="Take the test again"`

This allows visitors to restart the test after seeing their result.

**Shortcode characters**

The characters `|`, `;` and `"` are used as internal separators in the shortcode and cannot be used directly inside question, answer or result text.

The visual builder automatically removes these characters from entered text to help prevent shortcode conflicts.

== Installation ==

1. Install Mevabi Shortest from the WordPress admin or upload the `mevabi-shortest` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin from the "Plugins" menu.
3. Go to "Mevabi Shortest → Create Test" to create your first test and generate its shortcode.
4. Go to "Mevabi Shortest → Edit Test" to paste and visually modify an existing shortcode.
5. Go to "Mevabi Shortest → General Settings" to customize global colors and text size.
6. Copy the generated `[mevabishortest]` shortcode and paste it into any WordPress post or page.
7. Preview or publish the page to display your interactive test.

== Frequently Asked Questions ==

= Does the plugin store answers submitted by visitors? =

No. Test results are calculated entirely in the visitor's browser. The plugin does not store visitor answers or test results on the server.

= Does the plugin create custom database tables? =

No. Test content is stored directly in the shortcode attributes, so the plugin does not need custom database tables for your tests.

= Can I use the same test more than once on the same page? =

Yes. You can insert the same shortcode, or several different test shortcodes, multiple times on the same post or page.

= Can I create a test without knowing how to code? =

Yes. The visual builder lets you create questions, answers, scores and result ranges without manually writing the shortcode.

= Can I edit an existing test? =

Yes. Open "Mevabi Shortest → Edit Test", paste the existing `[mevabishortest]` shortcode and edit the test using the visual builder.

= Can answers have negative points? =

Yes. Answers can have negative, zero or positive point values. Result ranges can also contain negative numbers.

= Can I hide the numeric score? =

Yes. Disable "Show the final numeric score" in the visual builder, or use `score="no"` in the shortcode.

This is useful for assessments where the numeric score is not meaningful, including vocational, personality-style or self-assessment tests.

= Can visitors take the same test again? =

Yes. Add the `repeat` parameter to display a button that allows visitors to reset and retake the test.

= Can I use the characters "|", ";" or '"' in questions and answers? =

No. These characters are used internally to separate fields in the shortcode. The visual builder automatically removes them from entered text.

== Screenshots ==

1. Visual test builder for creating questions, answers, points and result ranges.
2. Edit Test screen for loading and modifying an existing shortcode.
3. General settings page for customizing test colors and text size.
4. Example of an interactive test displayed on the frontend.

== Changelog ==

= 1.1.3 =

* Improved plugin documentation.
* Expanded the Description section with additional information about test creation, scoring and display options.
* Improved installation instructions and usage examples.
* Expanded the Frequently Asked Questions section.
* Added clearer documentation for negative scores, result ranges and shortcode parameters.
* Improved documentation of the visual builder and Edit Test workflow.

= 1.1.2 =

* Renamed the shortcode tag from the generic `[shortest]` to the unique, prefixed `[mevabishortest]`.

= 1.1.0 =

* Added an optional final score display (`score="yes|no"`), shown above the result text.
* Added an optional "Take the test again" button (`repeat="..."`) shown after the result.
* Added an "Edit Test" screen to load and modify an existing shortcode.
* Translated the whole plugin interface to English.

= 1.0.0 =

* Initial release.

== Upgrade Notice ==

= 1.1.3 =
This release improves the plugin documentation with expanded feature descriptions, usage examples, installation instructions and FAQs.

= 1.1.2 =
Important: the shortcode tag changed from `[shortest]` to `[mevabishortest]` to comply with WordPress.org's unique naming requirements. If you published tests using `[shortest]`, update them to `[mevabishortest]`.
