Watu Quiz

Description

Create exams and quizzes and display the result immediately after the user takes the exam. 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 will figure out the grade based on the total number of points collected.

Watu for WordPress is a light version of Watu PRO. Check it if you want to run fully featured exams with data exports, student logins, categories etc.

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

A basic bar chart is available for showing user points vs. average points on a given quiz

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.

Screenshots

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

Installation

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

Upload the entire folder watu to the /wp-content/plugins/ directory

Activate the plugin through the ‘Plugins’ menu in WordPress

Go to “Watu Settings” to change the default settings (optional)

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.

FAQ

How are grades calculated?

Watu computes the number of points in total collected by the answers given by the visitor. Then it finds the grade. For example: If you have 2 questions and the correct answers in them give 5 points each, the visitor will collect either 0, or 5 or 10 points at the end. You may decide to define grades “Failed” for 0 to 4 points and “Passed” for those who collected more than 4 points. In reality you are going to have more questions and answers and some answers may be partly correct which gives you full flexibility in assigning points and managing the grades.

Can I assign negative points?

Yes. It’s even highly recommended for answers to questions that allow multuple answers. If you just assign 0 points to the wrong answers in such question the visitor could check all the checkboxes and collect all the points to that question.

How do I show the quiz to the visitors of my blog?

You need to create a post and embed the exam code. The exam code is shown in the green text above the questions table in “Manage questions” page for that exam.

Please do not place more than one code in one post or page. Only one exam will be shown at a time. If you wish more exams to be displayed, please give links to them!

How does it handle user accounts?

Watu uses the WordPress user registration / login system. So if you want to allow users to register for quizzes simply select “Require user login” in the Edit Quiz page and make sure “Anyone can register” is selected in your WordPress Settings page.

Is it compatible with BuddyPress or membership plugins?

Since it uses the standard WordPress user login system, it is compatible with BuddyPress and all membership plugins that we know about. Of course, some odd membership plugin that uses its own user login system might be incompatible with Watu.

How to translate the plugin interface in my language or just change some of the texts

You can use the standard WordPress way of translating plugins (via Poedit and .po / .mo files) or use plugin like Loco Translate.
If using Poedit, your file names should start with “watu-“. For example: watu-de_DE.po / watu-de_DE.mo. They should be placed in wp-content/languages/plugins folder.

Can I override the templates / views without modifying the plugin code? (For advanced users)

Yes. You can create a folder called “watu” under your active WP theme folder. Then create a copy of the view file you want to modify, keep the original name, and place it in the “watu” folder there. (Do not create “views” folder). Then the copy of the template will be used instead of the original one.

I’m getting “Error Occured” message after submitting the quiz

If you get “Error Occurred” when submitting a quiz, this is usually because there is too much data to be sent through Ajax. Watu normally uses Ajax to submit quizzes to make the user experience more pleasant. If your server cannot handle the data by Ajax for some reason (too much data, improper configuration, etc), you can switch off Ajax from Watu Settings page. Navigate near the bottom of the page and you will see heading “Ajax in quizzes”. Select the problematic test(s) and save.

Reviews

We've been using various versions of Quiz plugins for an online educational website (non profit organization). For a few years we had a good one, but not perfect. Especially after the authors stopped updating it and it didn't work correct anymore with later versions of WordPress.
After testing various plugins, we found that this one was the best available. Even the free version is great! You can create quizzes, send people email notifications if they passed the quiz/exams, you can set random questions from a pool of questions. Multiple choice, include images.. amazing, especially considering this is all to be found in the free(!) version. As soon as we get some funding we'll register the paid for version.

Watu Quiz is a lifesaver for me. While I found other so-called popular plugins very complicated to use, this is so easy and without much fuss does the job excellently.
I required user login to take quizzes and I found this feature nowhere in the plugin description page, but still I installed it to test a bit and wow! it's got that feature too. I request the plugin author to update the description page with all of its features. Thanks a lot.
Edit: I now found it mentioned in the FAQ section though.

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

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.

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.