Monthly Archives: February 2020

WatuPRO 6.3

The quiz and survey plugin WatuPRO is updated to version 6.3. Here are the improvements and fixes:

  • Added option to store quiz results / data only when the quiz is taken from a logged in user. The option is on Edit quiz / Advanced Settings tab.
  • Added option to limit the number of words on open-end questions. When limiting the words, a word counter will appear under the text box.
  • Added option to accept free text entry on one of the options of single choice and multiple choice questions. This is useful mostly for surveys where you want to collect additional information on “other” selection not listed in the pre-defined answers.
  • The WordPress “embed” shortcode can now be used in questions to embed videos and other objects.
  • The design adjustment for mobile devices (distance between question choices) now supports px and em and defaults to 0.5 em.
  • Added option to make choices in single-choice and multiple-choice questions checked by default. Mostly useful for survey questions.
  • Added filter to allow custom plugins modify the collected points on a quiz.
  • New option lets you define that the grade-based restriction for allowed test re-attempt (on Edit Quiz -> User and Email tab, options for logged in users) is also time-limited and expires after a defined period of days.
  • When copying quiz you can now filter questions by category.
  • When copying quiz you can now filter questions by tags.
  • Added tags to quizzes for filtering in the administration.
  • Added parameter “cat_id” to the watupro-result shortcode. It lets you show the result for a specific question category.
  • Filters used on the “View results” page will now apply if you blank out  or cleanup taking data (instead of blanking out or deleting all quiz results).
  • Added setting for min/max points and percent correct answers on the “automatically cleanup/blankout” setting so you can have better control.
  • Added compatibility with the latest bridge to BuddyPress (https://blog.calendarscripts.info/watupro-bridge-to-buddypress/).
  • When selecting “Don’t display questions that were previously answered by the user” or “Hide only correctly answered questions “ you can choose to restart over once all questions are used.
  • Added “Quiz category” filter when viewing all quiz submissions.
  • From “Advanced Settings” tab of the quiz you can now limit the total number of allowed submissions. After that number of users have submitted the quiz it will no longer be available.
  • Optional parameter “category_id” added to the watupro shortcode. It allows you to limit questions in the quiz to only a given category via the shortcode.
  • Added optional quiz thumbnail. It can be used in the “watuprolist” shortcode to display quizzes with thumbnail. More information at https://blog.calendarscripts.info/list-quizzes-in-watupro
  • [Intelligence module and WooCommerce bridge] Paid certificates as now supported as WooCommerce products.
  • When the final grade in this quiz will depend on the performance on different question categories: added option to ignore specific category requirements if questions from that category were not present in the quiz. This may happen if you pull random questions etc.
  • Added configuration to not scroll the screen when pressing “start quiz” button.
  • Added “records per page” selector on the View results page.
  • In the condition “Re-submitting is allowed only if some of the following grades is achieved” we have also added None (no grade achieved) as option.
  • Added “date range” filter on the View results page.
  • Added check for corrupt file uploads (0 bytes) on questions that accept file uploads as answer.
  • [Intelligence module] When teacher edits student answers they can now change the uploaded file to questions that allow uploading files.
  • [Intelligence module] Added permission type “View and edit/approve results” for the multi-user role configuration for “quizzes access”.
  • [Intelligence module] “Fill the gaps” questions can now accept placeholder attribute. Learn more at https://blog.calendarscripts.info/turn-multiple-answer-gaps-into-drop-downs-watupro-intelligence-module-v-5-0-2/
  • [Intelligence module] Added “% of max. Points” as new dependency type for Dependencies.
  • [Intelligence module] You can optionally set URL where the user will be redirected to pay for the quiz instead of using the default payment buttons. This is useful if you are selling the quiz as a part of a bundle or through the WooCommerce bridge, etc.
  • [Intelligence module] When role setting for quizzes access is set to “only view and approve results” you can restrict the access to the emailing feature in editing results.
  • [Reporting module] New shortcode watupro-pie-chart lets you generate pie charts from user’s performance per question category on a single quiz attempt.
  • Various improvements to the main CSS and theme CSS files for compatibility with different plugins and themes.
  • Added option to show full snapshot of user answer in the table view, along with the optional answer feedback.
  • [Reporting module] Added “size” attribute to the watupro-chart-by-grade shortcode.
  • Fixed problems with handling images in “flashcard” questions.
  • Fixed bug: the feature “treat this question as a whole” was working only with the Intelligence module installed.
  • Fixed CSS issue: global normalization removed.
  • Fixed bug: when custom field 1 from “Ask for contact details” was marked as drop-down, custom field 2 was also displayed as drop-down.
  • Fixed bug with Twitter social sharing URL.
  • Fixed issue: on some installations user session was getting lost in Ajax causing results not to be saved.
  • Fixed issues with missing properties and answers when copying quizzes.
  • Fixed bug: the condition “maximum number of points” required on checkbox questions did not work correctly on some installations.
  • Fixed issue [Reporting module]: On Stats per question page match/matrix questions were also listed with all their choices. Only percentage correct answer is suitable for stats on this question type.
  • Fixed bug [Intelligence module]: personality quizzes were not properly copied with the “copy quiz” feature.
  • Fixed bug [Intelligence module]: managing coupon codes was not accessible to allowed non-admin user roles.
  • Fixed bug: “max selections” on multiple choice questions did not work in some edge cases.
  • Fixed bug [Intelligence module]: some variables were not processed when emailing edited taking details. Other variables cannot be processed so they were removed from the list.
  • Fixed bug [Intelligence module] time limited bundles were wrongly redirecting to the selected URL even if a payment has expired.
  • Fixed bug with rich text editor on question answers.

The update is distributed in the dashboard of eligible cusotmers. If your free upgrades subscription has expired, don’t worry – you can renew with 60% discount. See the discount code in the dashboard or contact us to get it.

List Quizzes in WatuPRO

The shortcode watuprolist lets you output a dynamic list of quizzes in a given category or all categories. Here’s how to use it to show the quizzes in one category:

[watuprolist cat_id=X]

Replace X with the actual quiz category ID. For example [watuprolist cat_id=3].

To show the quizzes from all categories use the shortcode this way: [watuprolist cat_id=”ALL”]

Ordering the quizzes

You can order the quizzes by title or by date of creation (latest on top or first on top). To do this add the attribute “orderby” to the shortcode.

Example: [watuprolist cat_id=”ALL” orderby=”latest”] or [watuprolist cat_id=5 orderby=”title”] or [watuprolist cat_id=1 orderby=”created”]

Note that all these shortcodes will display only the published tests. A quiz which is not published inside a post or page, or is deactivated will not be shown.

Design the list

By default the shortcode returns a simple list with <p> tags for each quiz. You can however pass your own HTML design enclosed by the shortcode using some variables:

  • {{{quiz-name}}} for the quiz name.
  • {{{quiz-url}}} for the quiz URL so you can link to it (this will return just the URL and NOT a clickable link. So use “<a href” tag.
  • {{{quiz-description}}} for the quiz description (if any)
  • {{{quiz-thumbnail}}} for the quiz thumbnail if any. It will generate an “<img src” tag with class “watupro-quiz-thumbnail” in case there is an image. In case there is no image it will return nothing. Note that the image size will not be specified in the img tag. You can use the CSS class if you wish to fix the image size.
  • {{{quiz-thumbnail-url}}} will return the URL of the quiz thumbnail. This variable could be useful in case you want to use your own “<img src” tag with some extra attributes. Use it only if all your quizzes have thumbnails – otherwise you’ll get some broken images displayed.
  • {{{quiz-category}}} for the quiz category – useful if you list tests from all categories.

Here is an example how to use the shortcode with your own design. Since this example uses WatuPRO’s built-in flex class it will nicely align the quizzes into responsive floating rectangles:

<div class="watupro-flex">
[watuprolist cat_id="ALL"]
<div class="watupro-quiz-item">
<h3>{{{quiz-name}}}</h3>
<a href="{{{quiz-url}}}"><img src="{{{quiz-thumbnail-url}}}" /></a>
<div class="description">
<p>{{{quiz-description}}}</p>
<p><a href="{{{quiz-url}}}">Take quiz</a></p>
</div>
</div>
[/watuprolist]
</div>

Here’s how this looks for example on our demo site:

Open Quiz

Personality Quiz

New Open Quiz

Flashcards Quiz

Likert Survey

Of course you may use your own completely different design with CSS classes from your site theme.