Tag Archives: troubleshooting

When The %%CERTIFICATE%% Variable In WatuPRO Shows Nothing

If you think that the %%CERTIFICATE%% variable in the “Quiz Output” doesn’t work, please read this post. The variable works fine but is often misunderstood.

When the variable outputs a link to a certificate?

The variable will output a link only when certificate is earned. If the user did not earn certificate, then the variable will output nothing (blank).

When is a certificate earned?

There are 2 conditions to earn certificate and both should be satisfied.

1. You need to have the email of the user who takes the quiz. There are several ways to request the user’s email and choosing ONE of them is sufficient:

a) Select “Require user login” in the Edit Quiz page, User and Email Related Settings tab
b) Select “Send email to user with their results”. When this is selected, WatuPRO will make sure that email is requested
c) Request user contact details from the bottom of the same tab where you see the “Ask for user contact details” heading. Of course you must select to ask for email address.

2. User must achieve a grade that has the certificate assigned to it. This is very very important and often is the case of unnecessary support emails. A certificate is not, by default, earned just for taking the quiz. Certificates are always related to a grade. Only when the user achieves a grade that has certificate assigned to it, then the user earns the certificate. So here is what you need to do assuming you have created a certificate:

a) Create some grades for the quiz.
b) Assign the certificate to one or more of these quiz grades. This is done from the Manage Grades page – there  will be a certificate drop-down under each grade. It’s up to you which grades will allow certificate. Usually customers assign certificate to the grades that they consider to mean quiz success. If your quiz is not a knowledge-based quiz and you want everyone to earn a certificate, just assign the certificate to all the grades and make sure the user will always earn a grade (learn more)

Please also note that the certificate itself will not get attached in email etc. Only a link to it can be included in the quiz output or email contents.

Receiving Grade “None” Or Unexpected Grade [WatuPRO]

This issue is most often caused by:

  • You have not defined grades at all. “Grades” is not the same as score, % correct answer or points. Grades are textual result that you assign to the respondent depending on their performance on the test. For example Passed or Failed; A, B, C, D, F; and so on. If you want to use grades you have to create them first.
  • You have selected “Calculate grades by % correct answers instead of points collected” to calculate grades but your grades are created with points in mind (or vice-versus).
    I.e. if the following is checked, your grades must cover the whole range from 0% correct answers to 100% correct answers:
    grades-by-percent This checkbox is on the General Settings tab in the Add / Edit quiz page. This is a very common mistake so please triple-check it before contacting support.
  • Your grades do not cover the whole range of points or percentages user can collect. If you are using points for grade calculation, make sure that all possible points are covered from the defined grades. If your best grade has 20 points for “to” and the user collects 21 points they will not be assigned any grade (and will receive None). If you are using % correct answers for grade calculation make sure your grades cover the whole range between 0 and 100. Please check the “Watch out the decimals” item below too.
  • Watch out the decimals. If you have one grade A: from 0 to 9 points and another grade B: from 10 to 20 points, and your quiz allows decimal points what happens with user who collected 9.5 points? They’ll get no grade. So the grades in this example should be A: from 1 to 10 points and B: from 10 to 20 points. If they get exactly 10 points they’ll be assigned the higher grade. Note that percentages are rounded to the whole number so if your quiz calculates grades by % and not by points you will not need to worry about this.
  • Using category grades without knowing how they work. Please check this guide.
  • The from – to values of grades should always be entered from the lower to the higher number. This means the lower number goes in the left box “from”, the higher number goes in the right box – “to”. Be careful if you define grades with negative points: -100 is lower than -1 for example. So -100 goes in the “from” box at left, -1 goes in “to” box at right.

Grade calculations are fully tested and work fine. If you are receiving “None” as grade this can be only because of misconfiguration. Use the variables %%POINTS%% and %%PERCENTAGE%% in the “Final Page / Quiz Result” tab to get better idea why none of the defined grades matches the points you collected (or the percentage correct answers).

[WatuPRO] Quiz Not Showing in “My Quizzes” Page or Reports?

Update: from version 4.5.8 you can handle this easier: see here

Only quizzes that are published will be shown in “My Quizzes” page and the tabs from the Reporting module – for example the History tab.

What means a published quiz? This is a quiz whose shortcode is placed inside the content of a post, page, or custom post type. If you place the shortcode in some widget, custom field, via do_shortcode() call in your theme, or some other odd way, the system will not recognize the quiz as published and it will not be shown in these pages.

A very easy way to know if a quiz is published or not is by looking at your Quizzes page in admin (the first page when you click on WatuPRO menu). If the quiz title is not clickable, this means it’s not recognized as published.