Watu Quiz Plugin

PRO | DEMO

This plugin is constantly maintained and improved since 12 years!

Create exams, surveys, and quizzes and display the result immediately after the user completes the questionnaire. You can assign grades and point levels for every grade in the exam / quiz. Then assign points to every answer to a question and Watu Quiz will figure out the grade based on the total number of points collected.

Watu Quiz is a light version of Watu PRO. Check it if you want to run fully featured exams with data exports, student logins, elaborate grading system, categories, reports, data analysis, etc.

Very quick and easy to start: Watu Quiz pre-fills a simple demo quiz with 3 questions when you install it.

This plugin is mobile / touch – friendly. The quizzes will work on mobile devices and phones.

Please go to Watu Quizzes in your dashboard to start creating quizzes, exams or surveys.

Features

• Creates quizzes, surveys, tests, polls, questionnaires, and exams.
• Use shortcodes to embed quizzes in posts or pages or publish them automatically.
• Single-choice questions.
• Multiple-choice questions.
• Open-end questions (essays).
• Required questions.
• Survey questions (no correct / wrong state).
• Question categories & filter by category.
• Deactivate questions.
• Randomize questions.
• Pull random questions from a pool.
• Grades / personality types.
• Shows answers at the end of the quiz or immediately after selection.
• List of users who took the tests along with their results.
• Export results to a CSV file
• Import questions from a CSV file.
• Ajax-based loading of the quiz results. Optionally switch off to regular loading.
• Facebook and Twitter sharing of the quiz results.
• Mobile / touch – friendly user interface.
• Notify admin when someone takes a quiz.
• Send email to the quiz taker with their results.
• Schedule quizzes for a given date/time interval.
• You can connect to MailChimp using the Watu to MailChimp Bridge.
• A basic bar chart is available for showing user points vs. average points on a given quiz.
• GDPR compliance features: not storing IP addresses. Hooks a personal data eraser into the WordPress tools.
• Regularly supported and updated since 10 years.
• PHP 6, PHP 7, PHP 8 Compatible.

Attention WordPress Network (Multi Site) Users

When activating the plugin do it as blog admin and not as network admin.

Online Demo

Feel free to check the live demo here. It should answer most “pre-download” questions.
If you have more doubts just download the plugin and check out if it works for you. It’s free and takes a few seconds to install and activate.

Troubleshooting

When opening a support thread please provide URL (link) where we can see your problem.

A very common problem is not being able to submit the quiz, or the quiz does not displays at all. This is usually a fatal JavaScript error caused by other plugins or your them. If you are technical you can easily find the error yourself by checking the JavaScript error console in Chrome or Firefox. Disable the offending plugin and everything will start working normally.

Developers API

In order to allow other plugins to integrate better to Watu we have started working on developers API.
The following action calls are currently available:

= do_action(‘watu_exam_submitted’, $taking_id)
Called when exam is submitted, passes the attempt ID

= do_action(‘watu_exam_submitted_detailed’, $taking_id, $exam, $user_ID, $achieved, $g_id)
Same as above but passes also the full exam object, the user ID, points and grade ID

= do_action(‘watu_exam_saved’, $exam_id)
Called when you add or edit exam (after submitting the changes). Passes the changed exam ID.

Community Translations

• Persian (Farsi) translation provided by Reza: download zip with .po / .mo files

• German translation provided by Peter Baumgartner is available here

• Russian translation provided by @Nikon: .po / .mo

• The included Romanian translation is provided by Andrei Ciuculescu

• Portuguese translation provided by José Costa

• Spanish translation provided by Sebastian Cetrangolo / seeeba

• Turkish translation provided by Muhammet AVCI

This section describes how to install the plugin and get it working.

1. Upload the entire folder watu to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to “Watu Settings” to change the default settings (optional)
4. Go to “Watu Quizzes” under “Tools” menu to create your exams, add questions, answers and grades. On the “manage questions” page of the created exam page, above the questions table you will see a green text. It shows you the code you need to enter in a post content where you want the exam to appear.

1. 

   List of your exams with shortcodes for embedding in posts or pages

2. 

   The form for creating and editing an exam/test

3. 

   You can add unlimited number of questions in each quiz or exam, and each question can be of single-answer, multiple-answer, or open-end type.

4. 
5. 

Changes in 3.4.1

• Added variable %%TOTAL-ENTRIES%% – The total number of users who submitted this quiz. Multiple entries of the same user are counted as individual entries.

Changes in 3.4

• Added pagination and “per page” selector on the Manage Questions page.
• Removed default table borders from the basic chart table.
• Easier question reordering with drag and drop.
• Added question categories for better admin organization. You can filter by question category.
• Added option to schedule quizzes.
• Added option to limit the total (everyone’s) number of attempts on a quiz.
• Added variables %%TOTAL%% for the total number of questions given, and %%AVG-QPOINTS%% for the average number of points achieved on each question for the given quiz attempt.
• When the “live mode” of showing answers is selected, radio buttons checkboxes will become disabled after selecting the answer.
• Unset “autoload” on all options to improve site’s performance.
• Database improvements: added indexes for better performance and the tables will be created on the default DB engine and collation.

Changes in 3.3

• Added two more columns to the question import file: “Is required” and “Answer explanation”.
• Added filters on Manage Quizzes page to search quizzes.
• Added option to mark a question as a survey question. In this case it will not display correct / wrong checkmark at the end of the quiz. Also these questions will not be counted in correct/wrong/unanswered variables and not included in the percentage calculations.
• Fixed issues when questions contained new lines on the final screen.
• Handling of quotes in the message when sharing results on Facebook.
• Added personal data eraser and hooked to the WP tool.
• Replaced the rich text editor popup with a local instance to avoid JS errors on some installations.
• Added a new selectable quiz design: modern / buttons style. You can keep using the default one too.
• Added 2,3,4,5 columns style for the answers of single-choice and multiple-choice questions.
• Added default “no ajax” setting for new quizzes.
• Added parameters for ordering, sorting, and limit to the [watu-takings] shortcode. Documented how to hide columns. This way it can be used to create a basic leaderboard.

Changes in 3.2

• Added hook for third-party integrations right before outputting the final screen
• Fixed forced CSS rule to keep radios and checkboxes on the same line with the answer
• Added variable %%USER-NAME%% to show the logged in user name on final screen and email contents
• Added function to mass delete selected results on a quiz.
• The %%PERCENTAGE%% variable can be used to show the % correctly answered questions at the end of the quiz.
• Added option to deactivate questions. These will not be shown in the quiz and not counted but you will be able to re-activate them any time.
• Added options to use your own Twitter and Facebook social sharing buttons.
• The submit button on Ajax quizzes changes to “Please wait” to clearly show the data is processing.
• Added loading indicator for Ajax quizzes
• Added option to set email subject for the automated emails that go with the submitted quizzes.
• Email address included in exports when available.
• Added pagination on Manage Quizzes page.

Changes in 3.1

• Added buttons to Save & Reuse the current question (and Save & Add blank) to make adding multiple questions easier, especially when they have similar structure
• Added function to import questions from CSV file
• Added filters for question type, ID, and question contents on the Manage Questions page
• The plugin no longer stores IP addresses (GDPR compliance)
• Added option to mass delete questions
• Added rich text editor on answers to questions
• Removed the obsolete FB share dialog which did not work well and used the new SD kit
• Added option to mass update questions (currently change required status)
• Added option to switch off auto-scroll when user goes from page to page in the quiz. It is useful on some page designs.

Changes in 3.0

• The plugin will now count empty (unanswered) questions separately from wrongly answered. The variable %%EMPTY%% can be used at the Final screen to display the number of unanswered questions.
• Column “% correct” added to the takings page + information on the number of correctly answered, wrongly answered, and unanswered questions.
• The export file now includes information about % correct answers, num correct, num wrong, and num unanswered questions.
• Added parameters to the [watu-takings] shortcode that allow you to hide taker’s email and the columns for points and percent correct answers.
• Added option to select CSV delimiter and quotes around text fields in the CSV
• Added option to sort quizzes by name or number of questions.
• Improved integration with Namaste! LMS: you can restrict access to tests if they are required by lessons until the assigned lessons have been read.
• Improved integration with Namaste! LMS: you can now filter quiz results based on user’s course enrollment.
• Made the admin pages responsive to allow managing the quizzes in phones and other mobile devices
• Applied wp_login_url and wp_registration_url hooks for better integration with quizzes that enhance the login/registration process.

Changes in 2.9

• You can now specify sender email address which is different than the address in your global WP Settings page. You can also use the suggested format to specify sender’s name which is different than the default “WordPress”.
• Manage questions page now shows question type and whether it’s a required question.
• Added user email in the taking details & takings list pages when email is available
• Points to answers and grades can contain decimals. The total in the “Final screen” will also show decimals when available.
• Added option to save and filter by source URL when taking a quiz. This can be useful if you have published the same quiz in different pages on your site.
• Added configuration for the submit button value. It can be different for every quiz.
• Various security improvements
• Added shortcode to display information from user’s profile. Check the internal Help page for more details.
• The plugin is integrated to MoolaMojo so when quiz is taken user can be awarded or charged virtual credits of their balance
• New option lets you define the word used for “quiz” in the system – for example “test”, “exam” etc.

Changes in 2.8

• Added option “Do not alert the user when skipping a non-required question”.
• The optional answer feedback will now be shown in “Show the answer of a question immediately” mode. Please note again this is not secure and shouldn’t be used for real knowledge tests.
• Added CSS overrides for themes that put radios and checkboxes on their own lines
• Added shortcode [watu-takings] to display a simplified version of the “View results” page on the front end.
• You can enable non-admin WP roles to manage the plugin so you don’t have to share your admin login with staff that has to manage quizzes.
• Added sortable columns on the “view results” page and the associated shortcode.
• Added honeypot option to prevent spam (it’s not obtrusive like captchas and almost as efficient)
• Added debug mode to display SQL errors
• Added variable %%EMAIL%% for quizzes that require login or request user’s email
• You can now specify URL to redirect the user to upon achieving a given grade
• The question feedback can be split into different content for correct and incorrect responses.

Changes in 2.7

• Added option to limit the number of logged in user attempts for quizzes that require login.
• You can specify one or more email addresses that will receive user’s results (instead of just using the admin email from your WP Settings page)
• You can now specify different content for the email sent to you when someone takes a quiz
• New option lets you to send email to user with their results. If user is not logged in this will generate a required field to enter email on the quiz page.
• You can specify different email contents of the email sent to user than the contents of the email sent to admin
• All views / templates can now be overriden by placing their copy under a folder called “watu” in your theme folder.
• Added option to switch off Ajax submitting for certain quizzes. This is useful if you are embedding javascript via shortcodes from other plugins in the final screen of the quiz as some javascripts won’t work when loaded by Ajax.
• Fixed security exploit
• Created main level menu for Watu to arrange the submenus better
• Added short Help page
• Added a basic bar chart for showing user points vs. average points on a given quiz. Use the shortcode [watu-basic-chart] in the Final Screen to display it.

Changes in 2.6

• Added optional text-based “captcha” to prevent spam bot submissions on quizzes which do not require user login
• Option to reoder the questions. Of course this takes effect only when you have not chosen “Randomize questions” in the quiz settings.
• Removed the hardcoded text “your answers are shown below” and the setting “display answers at the end of the quiz”. Instead of this use the variable %%ANSWERS%% which gives far more flexibility.
• Added option to not store takings in the database. Will be useful to save DB space when you have a quiz whose resutls you don’t need to know.
• Added two new variables – %%AVG-POINTS%% and %%BETTER-THAN%% to compare your results to others who completed the quiz
• Added option to enable previous button
• Added option to automatically publish the quiz in a post at the time of saving
• Added question numbers + option to not display them (old quizzes default to it for consistency with the previous behavior)
• Added social sharing option. Currently supports Facebook sharing. You’ll need Facebook app ID.
• Added Twitter sharing option. As above, use the shortcode [watushare-buttons] to enable all sharing buttons accordingly to your sharing options.

Changes in 2.5

• Added optional answer explanation / feedback that can be shown along with the correct answers on the quiz
• Added filter / search on the “view results” page
• Added feature to andomize the answers to the questions. Works together or independent from the question randomization.
• Added compatibility with WP QuickLaTeX
• You can now be notified by email when someone takes a quiz
• Made the quiz more user-friendly by auto-generating a demo quiz for the new users
• Improvements to open end quesitons: now any special characters are handled and matching is case INSENSITIVE
• Moved the grades management out of the main quiz form for better user interface, data integrity and rich text editor for the grade descriptions
• Added “grade” filter in the “View results” page
• Added option to pull number of random questions from the quiz
• Fixed number of wpautop() issues. Now the filter is applied manually only where it’s needed
• Fixed bug with calculating points on open-end question (the bug was caused by the latest “randomize answers” feature)

Changes in 2.4

• Quizzes can now require user login. Depending on whether “Anyone can register” is selected in your main settings page, a register link will also be shown when non-logged in user tries to access such quiz
• You can now use “the_content” filter instead of “watu_content” to handle nasty problems with plugins like qTranslate. It’s not recommended to use this setting unless you have experienced such problems.
• The full details of the user answers are now recorded and can be seen via popup in the list of results page
• Added uninstall script and changed the settings regarding deleting data. Now you have to double confirm deleting your exam. This is to avoid accidential data loss.
• Removed wpframe and other obsolete code
• Made small change to the display of radio and checkbox questions to allow easier formatting on one line with CSS
• Fixed for compatibility with 3.8
• Quiz description, if entered, shows up on top of the quiz
• Option to delete single taking and delete all submitted data on a quiz
• Changed current_user_can(‘administrator’) to current_user_can(‘manage_options’) so you can allow a non-administrator role to use the quizzes
• Open-end questions can also have answers and be matched to them
• Replaced wpautop in favor of nl2br to avoid adding

<

p> tags in unexpected places like hidden fields
– Did some small styling adjustments
– Fixed the %%MAX_POINTS%% calculation to take into account the quesiton type

Changes in 2.3

• Export quiz results as CSV file (semicolon delimited)
• The exam shortcode is now easier to copy
• Animate back to top when submitting exam, and when clicking “next” after long question. This prevents confusion when user has to see the next screen.
• Fixed bug with “Question X of Y total” showing even for single-page quizzes
• Each exam / quiz has its own setting about how the answers will be shown
• As many themes started showing the choices under radio buttons or checkboxes, added explicit CSS to keep them on the same line
• Fixed new bug with missing answers when adding question
• Fixed bug with skipping “0” answers
• Changed %%TOTAL%% to %%MAX-POINTS%% for clarify and consistency. The old tag will keep working.
• Further code improvements
• Tested in multisite
• Fixed “headers already sent” message caused by premature update statement

Changes in 2.2

• Replaced ‘the_content’ filter with custom filter to avoid issues with membership plugins
• Cleanup the root folder from show_exam.php
• Another method added to the API, see the new docs
• The answers field changed to TEXT so you can now add long choices/answers to the questions
• Fixed bug in the list of taken exams
• Fixed issues with correct/wrong answer calculation
• Added %%CORRECT%% answers variable to display number of correct answers
• Watu scripts and CSS are now loaded only when you have exams on the page avoiding unnecessary page overload
• Other code fixes and improvements

Changes in 2.1

• Displaying “Question X of Y” so the user knows where they are
• Fixing incompatibility with Paid Membership PRO
• Shortcodes on the final screen
• Starting API (Not yet documented)
• Code fixes and improvements

Changes in 2.0

• Required questions (optional)
• A list of users who took an exam along with their results
• Localization of the strings in the javascript
• More flexible function to add new DB fields on update
• Code fixes and improvements

Changes in 1.9

• Grade title and description are now separated
• Shortcodes will be executed in questions and final screen
• Code fixes and improvements
• Localization issues fixed

Changes in 1.8

• the exam title links to the post with this exam if exam is already published
• “show all questions on single page” is now configurable for every exam
• Improving code continued (more to come)

Changes in 1.7

• You can now randomize the questions in a quiz
• Fixed issues with the DB tables during upgrade
• Removed more obsolete code, fixed code issues. More on this to come.

Changes in 1.6

• Removed obsolete rich text editor and replaced with wp_editor call
• Added “Essay” (open-end) question
• Resolved possible Javascript conflicts
• Internationalization ready – find the .pot file in langs/ folder