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
- Three question types: multiple choice, true/false, short text answer (supports multiple accepted answers)
- 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” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Sabkekar Quiz Maker” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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