Monthly Archives: December 2013

Practice Mode Exams in WatuPRO

The “Practice mode” which is available in the Intelligence module of WatuPRO sometimes causes a bit of confusion. Let’s clear it all here by outlining some important points.

The purpose of practice mode is to let user train themselves on the matter – not to calculate grade or show them the right answers. Because of this “Practice mode” exams work this way:

  • Grade and result is not calculated
  • The user performance is not stored anywhere
  • Answers to the questions are not shown – it only shows if the answer is correct or not. If you want to display the answer you can use the “optional answer explanation” field. It’s shown even in practice mode.
  • Questions are always shown one per page
  • Many settings like payment required, timers, grouping, and so on are disregarded in practice mode.

So if you want all your settings to be taken into account, answers to be revealed and so on, please use “Live mode” exam.

Alternative of Practice Mode

From version 4.9.0.7 WatuPRO supports one option that in many cases will be more suitable for practice. It’s available on the Advanced Settings tab of the Edit Quiz page:

dont-store-takingSuch quizzes will work exactly as live quizzes except that the results achieved here will not affect reprots, user points balance, stats, anything. And on top of this, the data from such quizzes won’t fill your database which is important for customers with thousands of quiz takers that don’t need to run reports.

 

WatuPRO Troubleshooting: Emailing Quiz Results

This post will address some of the most common questions / support requests we get about emailing results:

Results are not mailed at all

In this case please check:

  • Have you selected them to be mailed at all
  • Please have in mind that our plugin only instructs your WordPress installation to send emails. It doesn’t handle the technical side of sending them. So if you have problems sending emails you most likely have to talk to your hosting support or server admin. But here is a super-short guide that will most probably help you resolve your issue:Install WP Mail SMTP or Postman SMTP, set the sender name and email and select “PHP Mail” as sending mode. Try to send a test mail to yourself. If this email is sent properly, please contact us to have a look. If this email is not sent or goes to junk box, the problem is in your installation. You have two options:
    • Contact your hosting support for help
    • Switch to SMTP email sending and enter SMTP details. If emails start going out, you are all set – WatuPRO mailing will also work. If even SMTP test email does not get sent you absolutely should talk to your hosting support. Please do not contact us in this case until your mailing issue is resolved.
  • Note that some email servers may block outgoing emails if the sender email address is different than the SMTP account email. Make sure both are the same and test again.

I don’t see the correct / incorrect checkmarks in the email

  • You can disable showing correct/incorrect checkmarks from the “Advanced settings” page for the quiz. Please make sure you have not done this.
  • Many email client programs by default do not show graphics in emails. For example in Gmail you have to click “Show graphics from xyz@xyz.com” to make the graphics show. From version 5.3.8.5 you can choose to use textual symbols instead of graphical checkmarks on emailed results. You can do this from the WatuPRO Settings page, section Design Theme and Adjustments
  • Microsoft Outlook 2010 (and maybe other versions) has bug and doesn’t show .png images so it won’t show the correct/incorrect checkmarks. This is a bug in Outlook, not in our software. More info here.

There are “funny” characters in the email

WatuPRO emails are generated and sent in UTF8 which is the modern international format for email. Some old email programs are not configured for UTF8 by default. To reduce the number of users who experience problems with their email clients you’d better avoid pasting text from Word. Its weird apostrophes and dashes will often come as “funny” characters when UTF8 is not supported.

If you are using the quiz in a non-English language that uses special charactes (like German, or entirely non-Latin languages) then having UTF8 enabled client is a must. Most non-English users have that anyway.

For problems that are not listed above or not resolved after following the instructions you are welcome to contact support.

Using Category Grades or Showing Performance Per Category in Watu PRO

This short visual guide will clarify the common misconceptions about using “category grades” in WatuPRO.

Note: Creating category grades is optional. You can show category performance with points and percent correct answers even without creating category grades. Just skip step 2 and don’t use the grade variables in step 3 (but feel free to use any other variables).

Here is the procedure step-by-step:

Step 1. Make sure you have question categories.

Category grades make sense only if you have categorized the questions in your test. Typically you will have at least two question categories.

Step 2. Create your grades.

Creating category grades is optional. You can show category performance with points and percent correct answers even without creating category grades.

Go to the Grades page for the exam and select the desired question category you want to create grades for. The page will reload and then you can create and manage the grades for the category.

category-grade-dropdown

 

The category grades look just like the “whole exam” grades. If you use points and not % good answer don’t forget to consider only the possible sum of points within the category, not the total points of the whole exam.

Step 3. Create the category grade output

Under the drop-down selector there is a link “Design the common category grade output for this quiz”. Click on it to open a box like the one shown below:

gradecat-design

Note the variables listed below. Some of them are the same as on the “Final screen”, but not all.

On the same page under that box you can control how the categories are ordered and how many of them to show:

This whole design will be repeated once for each category when you use the %%CATGRADES%% variable on the “Final screen”.

Step 4. Display category grades on the Final screen.

You simply need to include the %%CATGRADES%% variable as shown below:

catgrades-final

 

The variable will be populated with the output you designed in step 2, and it will be repeated once for each question category used in the quiz.

Here is how the output would look like:

catgrades-output

Manually Craft The Output

As you see, by default %%CATGRADES%% is automatically replaced by your content in a loop.
Sometimes you may want to manually design this output so you can arrange the categories in different way. You can do it this way:

1. Ignore the %%CATGRADES%% variable and the “category grade output” (steps 3 and 4 above).

2. Instead of this use the following variables directly in the “Final page / Quiz output” box:

%%CATEGORY-NAME-X%%
%%CATEGORY-DESCRIPTION-X%%
%%CATEGORY-CORRECT-X%% (no. correct answers given in the category)
%%CATEGORY-TOTAL-X%% (total number of questions answered in the category)
%%CATEGORY-POINTS-X%% (points collected in the category)
%%CATEGORY-PERCENTAGE-X%% (% correct achieved)
%%CATEGORY-GTITLE-X%% (grade title of the assigned grade, if any)
%%CATEGORY-GDESCRIPTION-X%% (grade description, if any)
%%CATEGORY-PERCENTAGEOFMAX-X%% (% from maximum points in that category collected, variable available from WatuPRO v. 5.0.8.1)

Note that X is the Category ID. You can see all category IDs at the “Question categories” page.

Create a Chart

If you have the Reporting Module installed you can create a chart like this:

Simply embed the shortcode watupror-user-cat-chart. It accepts some parameters explained in the internal Help page of the plugin.