The quiz plugin WatuPRO has been updated to version 6.5 with lot of new features and bug fixes as usual. Here’s the full changelog:

• A new shortcode allows you to display cumulative stats on all user’s logged in attempts on multiple quizzes. You can also include conditional content based on the achieved results from all the quizzes.
• Added option to pull X random question categories in the quiz. This will work together with other randomization and pull random settings.
• Added option to not display the optional answer explanation if the question is left unanswered.
• The checkbox for MathJax and LaTeX problems on import was not working for Aiken imports.
• Improved handling of WP emojis entered by mobile phones.
• Added optional parameters show_id=0 show_delete=0 show_details=0 to the watupro-takings shortcode to allow hiding these columns.
• Added shortcode “watupro-leaderboard-position” to return the position of the currently logged in user in the global leaderboard by points.
• Added new columns to the WatuPRO Simple import format: “is required?” and “answer explanation”.
• Part of the question contents can be hidden on the final screen if you place them betwneen HTML comments: <!–watupro-hide-start–> and <!–watupro-hide-end–>. The rich text editor should be switched to Text mode when entering the comments.
• When submitting a quiz (or going to a next page) with unanswered required questions the error message will show which of the questions exactly should be answered.
• Added name of logged in users in the email sent to admin.
• Added 5-columns style for questions showing their answers in columns.
• Two versions of the question compact format are now available, see the link next to the selector for more information.
• You can set individual quiz schedules for logged in users.
• Timer allowance for timed quizzes is now configurable from WatuPRO Settings page.
• Added variables %%CATEGORY-WRONG-X%% and %%CATEGORY-EMPTY-X%%  for the manual category based output.
• Changed the JS alerts on the required contact fields at start/end of a quiz to inline messages.
• Added option to use respondent’s email address as a reply-to address when sending quiz results to admin or managers.
• Added option to exclude the default “Details of …” line when sending quiz email to admin. The option is in WatuPRO Settings page, section Defaults.
• Added a counter on the Manage questions and Reuse specific question page to show how many questions are selected for mass updates or reusing.
• Added variable %%UNIQUE-ID%% for the final screen – a unique identifier of the submitted quiz attempt.
• Added option to hide the following columns from “View details” pop-up -> table format: ID, No., Points, Result. The option is in WatuPRO Settings page -> User Settings tab.
• From WatuPRO Settings page -> Theme and Design tab you can switch off browser’s autocomplete feature on the quiz form.
• Added option to store contact data for logged in users if the quiz requests contact data. In this case it will be pre-filled for other quizzes or new attempts on the same quiz.
• [Intelligence module] Added option to restart limits for quiz attempts after payment. More information at https://blog.calendarscripts.info/watupro-intelligence-module-restart-quiz-attempts-when-payment-is-made/
• [Intelligence module] When a manager’s role is permitted to access quizzes with “Apply user group / user role category restrictions” they will see only the results of users within the same user groups they have + the results of the non-logged users. This applies only when you are using WatuPRO user groups.
• Added shortcode attribute require_login for overwriting quiz settings.
• [Intelligence module] Added user email address in the list of payments for a paid test.
• [Reporting module] The shortcode watupror-poll that produces a poll chart on individual quesitons can now accept paremeter orientation=”vertical” to create a vertical bar chart.
• [Reporting module] Added parameter draw_unanswered to the watupror-pie-chart shortcode. It will generate a pie sector for the unanswered questions in each category.
• [Reporting module] Added paremeter sum_subcategories to watupror-pie-chart and watupror-quiz-cat-chart shortcodes. The parameter will sum the subcategory performance into the parent category and will not draw the subcategories in the charts.
• WooCommerce integration: you can now select a WooCommerce product directly in the Edit quiz -> Intelligence module tab and let the plugin automatically set the required attributes for you. Note that only Virtual AND Downloadable products will be shown in the drop-down.
• Improvement to the WooCommerce integration: unlinking the product will remove the custom attribute
• Fixed issue with counting multiple-choice questions answers in “Stats per question” page when those contained commas.
• Fixed issue with scheduled timed tests when the scheduled end time is sooner than the timer end time.
• Fixed bug: the watupro-result shortcode will now load the WatuPRO CSS and scripts so details are properly displayed.
• Fixed bug [Intelligence module]: when role setting to “view/approve results” with “apply user group permissions” checked, the option “Do not allow sending email with the edited results” was getting ignored.
• Fixed bug [Intelligence module]: sometimes deselecting an item in one box of match/matrix questions was making a value that’s reserved in another box available for selection.
• Fixed bug in flashcard questions: a card stopped flipping after 3-4 flips.
• Fixed database bug: when users entered emojis in answers to open-end questions their results were not stored. Note there may still be issues with using emojis across the plugin: this is a bug in the built-in WordPress database handler. We are applying a conversion function on all places manually.
• Added attribute “pagination” to the watupro shortcode to overwrite the quiz pagination setting.
• Added option to set header and footer for PDF results printing. This feature requires PDF bridge version 1.7.
• Removed sessions usage from the core plugin. They are now replaced with cookies to avoid loopback issues on some installations.
• Fixed bug [Intelligence module]: no new lines in “fill the gaps” questions.
• Fixed bug [Reporting module]: Analytics integration did not work on Ajax quizzes.
• Fixed bug: when drop-down fields were used for asking contact details at the beginning of a quiz, they were still shown on the next pages.
• Fixed bug: captchas should not be required when auto-submitting timed quiz with expired time.
• Fixed bug: restricting access to specific list of users should be case-insensitive for email addresses.
• Fixed bug in the new watupro-leaderboard-position shortcode.
• Because of problems with WP auto paragraphs function reverted to using our own function when displaying questions. Added configuration option to use wpautop().
• Fixed bug [Reporting module]: the pie chart per category should always show green for correct answers and red for wrong (unless colors are specified by the user)
• Fixed bug [Intelligence module]: when the new “View and edit/approve results” setting was set for a role the user group / category restrictions were not applying.
• Fixed issue with category paginator highlighting when using next page / previous page buttons.
• Fixed bug: sometimes the limit for number of attempts per email address was remaining active even when we are not asking for user email address.
• Fixed bug in “Don’t display questions that were previously answered by the user” option.
• Fixed issue with blank space showing on top of the user menu.
• Fixed bug: if “ask for contact details” contained a required checkbox there was no visible error message when it’s missed.
• Fixed column titles mismatch on “Export with details” function in View Results page.
• [Intelligence module] Fixed display issues with horizontal sortable questions on the final screen.

Here is a new super power of the WordPress quiz plugin WatuPRO, available from version 6.4.8.5: a shortcode to calculate the performance of a logged in user on multiple quizzes. It can display:

• The total points collected
• The average percent correct answers on all quizzes.
• The average percent achieved points from maximum points in every quiz.
• The total number of correct answers.
• The total number of wrong answers.
• The total number of unanswered questions.
• The total maximum points that could be collected.

The stats are based on all attempts of the logged in user of the quizzes whose IDs are passed in a shortcode attribute.

The new feature also allows you conditionally display any content based on the total points collected, average percent correct answers, or average percent from maximum points.

Let’s see how this all works.

The Shortcode and The Variables

Note: from version 6.6.7.3 you can pass the parameter use_only_latest_attempts=1 to base the calculations only on the latest attempt of the user instead of all attempts.

It is a content-enclosing shortcode and will not produce any output by its own. You need to enclose the content that you want to use along with variables that you want calculated. The shortcode has a required parameter quiz_ids which should contain the ID of the quizzes that will be used, separated by comma. Example:

[watupro-multiquiz quiz_ids="2,3,25"]

On the 3 quizzes you collected a total of %%MULTI_POINTS%% points and you gave average of %%MULTI_PERCENTAGE%%% correct answers.

[/watupro-multiquiz]

Here are all the available variables for this shortcode:

• %%MULTI_POINTS%% – the total points collected
• %%MULTI_PERCENTAGE%% – the average percent correct answers
• %%MULTI_PERCENTAGEOFMAX%% – the average percent points collected from maximum points possible (the stat is calculated for each quiz attempt and then dividied. It’s NOT an average of all collected points vs all possible points).
• %%MULTI_CORRECT%% – the total number of correct answers given
• %%MULTI_WRONG%% – the total number of wrong answers given
• %%MULTI_EMPTY%% – the total number of unanswered questions
• %%MULTI_MAX-POINTS%% – the total maximum points possible from all quizzes and all attempts

If the user is not logged in or if the quiz_ids attribute is not passed, the shortcode will not display anything.

The Conditional Parameters

This shortcode can be used also to conditionally display some content based on how the user has performed on the selected tests. You can use conditions for point range, percentage range and range for percent from maximum points. All conditions can be used at the same time.

The content enclosed between such shortcode will be shown only if all the conditions are met. This is a very useful way to display something only when the conditions are met. It’s almost like the standard quiz grading except that the grade will not be stored anywhere and cannot trigger certificates or other actions.

Here’s how to use it:

[watupro-multiquiz quiz_ids="2,3,25" condition_points="10-25" condition_percent_correct="50-100" condition_percent_max="50-100"]

Congratulations you did extremely well and earned a discount code: BIGDISCOUNT

On the 3 quizzes you collected a total of %%MULTI_POINTS%% points and you gave average of %%MULTI_PERCENTAGE%%% correct answers.

[/watupro-multiquiz]

You can skip any of the condition attributes to use only one or two of them.