Category Archives: CalendarScripts

Test Grade Based on Question Category Performance [WatuPRO]

From version 5.5.8 the quiz/survey plugin WatuPRO supports yet another interesting option for grading the user’s performance: a grade based on the performance in each question category /  theme.

What Does It Mean?

This is different than showing grade/performance per category. It’s a method to grade the whole test (and typically determine whether it’s passed or failed) based on how the user did in the different topics in the test.

For example for a traffic law test you may have a “Passed” grade with the following requirements:

For category “General rules” require at least 90% correct answers.
For category “Street Signs” require between 80% and 100% correct answers.
For category “Priority” require between 70% and 100% correct answers.

On top of this you can also set a general requirement for the test, for example min. 85% correct answers on average for all categories.

The requirements can be based on points, percent correct answer, or percentage points achieved from the maximum points possible in the test.

How Does It Work?

  1. Go to the Grades or Manage Grades page for a selected quiz. Make sure “Manage grades / results for the [Whole test]” is selected and check the option “The final grade in this test will depend on the performance on different question categories” as shown below:
  2. The page will refresh and will show you the grade forms for adding or editing grades with new options – from/to fields for each question category (topic) that contains questions in the selected quiz:
  3. You can skip any of the categories by leaving both fields blank – this means there will be no specific requirement for that category. You can optionally set a requirement for the whole test (in the above example it’s min. 80% correct answers) or use only category based requirements.
  4. A setting in the Edit Quiz -> General settings tab defines what will be the type of criteria to check:
    a) By default all tests are graded based on number of points collected.
    b) If you check the above checkbox and save your quiz will be graded based on % correctly answered questions from total questions given to the test taker.
    c) If you check the above option but select “% from maximum points” from the drop-down menu, it will be graded based on the % achieved points from the maximum possible points in the quiz.This setting defines grading the quiz as a whole, grading based on category performance, and category grades if any.

This feature is also the best way of creating Myers-Briggs personality quizzes.

WatuPRO 5.5

The new version of the quiz plugin WatuPRO is now ready. Here are the changes between version 5.4 and 5.5:

  • Multiple choice questions can allow groups of checkboxes. More info at https://blog.calendarscripts.info/group-checkbox-questions-in-watupro/
  • You can now limit quiz attempts per email address requested in “Ask for user contact details” section.
  • Integration to MoolaMojo – you can award virtual currency for taking tests. Learn more at https://blog.calendarscripts.info/watupro-integration-with-moolamojo/
  • When setting an email address to receive the quiz results at the admin end you can now use variables from “Ask for user contact details” section. This gives the possibility to specify receiver of these emails who is different for each quiz taker.
  • Tin Can / Experience API integration through WP Experience API plugin. Learn more at https://blog.calendarscripts.info/xapi-tin-can-integration-in-watupro/
  • Displaying test results can be delayed for a future date. In such case you can define what text to be shown at the end of the quiz and in the user’s dashboard before the date arrive. This feature is useful for logged in users.
  • When the PDF Bridge is installed and enabled to generate certificates we will also generate PDF files when “Download” link is clicked on “View results” popup (instead of .doc file which is the behavior when the bridge is not installed)
  • When displaying “performance per category” you can now limit to the top X categories depending on your sorting preference
  • The shotcode watupro-result can now work without “quiz_id” parameter. In this case it will show the latest attempt for the user on any quiz. This can be useful if you redirect to the same page from several quizzes.
  • Added filter by question content on the Manage Questions page.
  • Added filter by internal comments in Manage Quizzes page. Note that if you have comments saved before this version they may need to be re-saved to be searchable, as this change required a DB update.
  • Sorting category grades is now also possible by number of absolute points collected instead of the default criteria (percent correct answers).
  • Improvements to timer: you can specify that it turns red when less than X seconds remain. When results are auto-submitted the user will get a message making it clear that they ran out of time and results were automatically submitted.
  • Added “view details” link when the list of quiz takings is published via shortcode.
  • Added “time spent” column to the test result exports.
  • The watupro-result shortcode should now work for non-logged in users too when you have to show the result of the last completed test
  • Import / export questions function now supports and shows question subcategories
  • Added final screen variable %%EMPTY%% for empty (unanswered) questions which will no longer be shown as wrong-answered questions in the %%WRONG%% variable.
  • WatuPRO can now be used in the LMS LearnPress through this free bridge.
  • For Namaste! LMS users: the WatuPRO user groups (when available) will be shown on the Namaste! LMS Students page.
  • [Intelligence module] A paid test can be access for free from selected WatuPRO user groups or WP user roles.
  • [Intelligence module] The plugin is integrated with MoolaMojo so you can sell access to quizzes for virtual credits earned by performing actions in your blog.
  • [Intelligence module] Slider questions can directly transfer the slider selection as question points. In this case you can still define correct / wrong answers but the points on them will be disregarded.
  • [Intelligence module] The user control mode (when you allow user to choose what questions to answer) now can be configured which of the selection modes to include.
  • [Intelligence module] You can now set the width of fields in Fill the gaps questions at a question level.
  • Added option to allow “unfiltered_html” to the roles you enable to manage quizzes.
  • Fixed bug: taker’s name was missing in download doc when single quiz taking is downloaded in .doc file.
  • Fixed bug: when WP roles were used instead of user groups, saving a test category was not saving the role based restrictions.
  • Fixed bug with “user chooses” mode. When a quiz is in this mode but the user has stored progress from a quiz attempt, visiting the page should load their stored test instead of showing the choice form again.
  • Fixed bug, Intelligence module: when editing quiz attempt from the administration, only the grade title was saved in the “results” column while when user takes the quiz we store both title + description.

As usual eligible customers have received a newsletter with free upgrade. If your free upgrades subscription has expired you’ll receive 60% renewal discount code.

Improvements to WooCommerce and EDD Bridges for WatuPRO

A new setting available from version 0.7 of the EDD Bridge and version 1.2 of the WooCommerce Bridge lets you help the user follow the payment process easier. if they visit the paid quiz page directly, before a payment is made, they can either:

  • Be automatically redirected to the respective EDD or WooCommerce product page
  • See a text with a link to the respective EDD or WooCommerce product page

Often users will visit paid quiz pages from their dashboards or other links so these settings will be very useful and will make the whole flow more logical.

Note that the changes require a recent version of WatuPRO as well.