Description

Sabkekar Quiz Maker is a lightweight plugin for building online quizzes in WordPress, with a fully Persian (Farsi) front-end user experience. Build a quiz, add questions of different types, show the result to the user immediately after submission, and display each user’s quiz history on their profile with a shortcode.

Features

Dedicated “Quiz” custom post type with categories
A reusable Question Bank with its own categories, independent of any single quiz
Random question pools: draw a set number of random questions from a bank category on each attempt
Image support for questions, via the WordPress Media Library
Four question types: multiple choice, multi-select (multiple correct answers), true/false, short text answer (supports multiple accepted answers)
Fill-in-the-blank questions with partial credit scoring
Matching questions (dropdown-based) with partial credit scoring
Ordering questions (drag-and-drop or up/down buttons) with partial credit scoring
Simple visual question builder in the admin panel
Per-question scoring
Optional quiz time limit with an automatic countdown timer and auto-submit
Configurable minimum passing percentage
Configurable maximum number of attempts per user
Optional reveal of correct answers after the quiz ends
Optional shuffling of question order per user
Scoring is fully calculated server-side (not exposed to or trusted from the client)
Quiz results are stored in a dedicated database table for performance
All dates are displayed using the Jalali (Persian) calendar
An admin results page with per-quiz filtering

Shortcodes

[azmoon id="123"]

Displays and runs a specific quiz. The user must be logged in.

[azmoon_natayej]

Displays a table of the logged-in user’s quiz history. Useful on a user profile page. (Alias: [azmoon_profile])

[azmoon_list]

Displays a list of all published quizzes.

Installation

Upload the plugin folder to wp-content/plugins, or install the zip file from Plugins > Add New > Upload Plugin.
Activate the plugin from the Plugins screen.
From the “Quiz Maker” admin menu, create a new quiz and add its questions.
Copy the quiz ID from the sidebar box on the quiz edit screen and place the shortcode [azmoon id="ID"] on any page or post.
To show a user’s quiz history, place the [azmoon_natayej] shortcode on the user’s profile page.

FAQ

Does the user need to be logged in?: Yes. A user must be logged in to take a quiz and have their result recorded.
Can I limit how many times a user can take a quiz?: Yes. Each quiz has a “maximum attempts” setting. A value of 0 means unlimited attempts.
Are the dates Gregorian or Jalali?: All dates shown by the plugin are Jalali (Persian calendar), calculated from your site’s timezone setting.
Can the score be manipulated by the user?: No. All scoring is calculated on the server after the answers are submitted; correct answers are never sent to the browser before submission.
Does this plugin work with any theme?: Yes. The plugin renders its content through shortcodes styled with its own CSS, so it works with most standard WordPress themes.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Sabkekar Quiz Maker” adalah perisian sumber terbuka. Orang-orang berikut telah menyumbang kepada pemalam ini.

sabkekar

Translate “Sabkekar Quiz Maker” into your language.

Berminat dalam pembangunan?

Layari kod, periksa repositori SVN, atau langgani log pembangunan dengan RSS.

Changelog

1.9.0

Added an “ordering” question type: arrange items into the correct order via drag-and-drop or up/down buttons (mobile-friendly)
Ordering questions are scored with partial credit based on how many items ended up in the correct position
Available both inside a quiz and in the Question Bank
This completes the full question-type set for this development phase: multiple choice, multi-select, true/false, short text, fill-in-the-blank, matching, and ordering

1.8.0

Added a “matching” question type: match left-column items to right-column items using dropdown selectors
Matching questions are scored with partial credit based on how many pairs were matched correctly
Available both inside a quiz and in the Question Bank
Fixed: syncing a multi-select question’s options to the Question Bank was previously skipped

1.7.1

Fixed: fill-in-the-blank result review incorrectly printed “Array” instead of the per-blank answers
Fixed: true/false questions created in the Question Bank before version 1.6.0 could be scored incorrectly due to a legacy-data decoding issue

1.7.0

Added a “fill in the blank” question type: write ___ in the question text to mark a blank, each blank has its own accepted answer(s)
Fill-in-the-blank questions are scored with partial credit based on how many blanks were answered correctly
Available both inside a quiz and in the Question Bank

1.6.0

Added a “multi-select” question type (checkboxes, multiple correct answers), scored as all-or-nothing
Available both inside a quiz and in the Question Bank
Refactored choice-type option saving to use a per-option “correct” flag for consistency with the new type

1.5.0

Added image support for questions (both in the Question Bank and inside a quiz), using the WordPress Media Library
Question images now display on the quiz-taking screen and on the result review screen

1.4.0

Added random question pools: pick a number of random questions from a Question Bank category for each quiz attempt
Fixed the quiz form and redirect to always return to the page where the shortcode is placed, instead of the quiz post’s own permalink

1.3.0

Added a Question Bank: reusable questions with categories, independent of any single quiz
Added an “add to question bank” checkbox on each question inside a quiz
Added an “add question from bank” picker to import existing bank questions into a quiz

1.2.2

Shortened the readme short description to fit the 150-character limit

1.2.1

Corrected the plugin folder, main file, and text domain to match the officially approved slug (sabkekar-quiz-maker)

1.2.0

Aligned the plugin folder and text domain with the reserved slug (sabkekar-online-exam-builder)
Sanitized nonce values before verification (wp_verify_nonce is pluggable and does not sanitize its input)
Added stronger validation of decoded JSON question data (type checks on every field, not just trusting json_decode output)
Hardened answer-submission handling against malformed/non-array input

1.1.1

Removed the Plugin URI header (it was identical to the Author URI)

1.1.0

Renamed the plugin (display name and slug) to be more distinctive
Translated the readme to English per WordPress.org guidelines
Fixed the Plugin URI
Corrected the Contributors list

1.0.1

Fixed a bug where the result redirect did not work when the shortcode was placed on a page other than the quiz post itself
Removed leftover debug code from a development build
Fixed a Persian character display bug in some situations

1.0.0

Initial release