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).

If you prefer watching a video, here’s a 3 minutes video tutorial that shows you the most important things. For full details please still read the documentation on this page.

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”.

On the same section you can select that subcategories will sum up their performance into their parent categories. If this is selected the subcategories will not be included in the %%CATGRADES%% loop variable.

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-WRONG-X%% (no. wrong answers given in the category, from WatuPRO 6.4.5.5)
%%CATEGORY-EMPTY-X%% (no. unanswered questions in the category, from WatuPRO 6.4.5.5)
%%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)
%%CATEGORY-ANSWERS-X%% (the %%ANSWERS%% variable only for this category, added in WatuPRO 6.6.9)
%%CATEGORY-UNRESOLVED-X%% (the %%UNRESOLVED%% variable only for this category, added in WatuPRO 6.6.9)

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

From WatuPRO version 5.8.4.5 the variables that you see in bold can also be used directly in certificates. The variables that are NOT bold will work only if you have explicitly selected the option “Store full category grades along with the results” at the Edit Quiz -> Advanced Settings tab, section “Advanced Workflow Settings”. Note that this selection can result in large database space usage.

 

Creating Charts

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.

Since version 6.2.2.5 the plugin with the Reporting module can also generate two pie charts:

The points based pie chart shows the points collected per question category:

The shortcode to display the above chart is [watupror-pie-chart radius=150 from="points"]. The “radius” parameter is optional and defaults to 100 (pixels).

The same shortcode but used with attribute from=”correct” will display one pie for each question category, showing percent correct vs. percent wrong answers:

When from=”correct” you can also pass draw_unanswered=1 to generate charts with 3 sectors – for correctly answered, wrongly answered, and unanswered questions. Example:

[watupror-pie-chart radius=150 from="correct" draw_unanswered=1]

(the above parameter is available from WatuPRO 6.4.6)

You can learn about all available charts in the Reporting module here.

Pie Charts in Email and PDF

Note that the pie charts shown above are JavaScript based and won’t be displayed in email sent to user neither in PDF output. There is a solution for this: if your server has the GD library installed (most web hosts have it), you can use the GD version which produces real images.

To use this mode you need to pass attribute mode=”gd” to the shortcode, for example like this:

[watupror-pie-chart radius=150 from="points" mode="gd"].

Myers-Briggs Personality Tests

A newer and probably better way of creating Myers-Briggs tests is explained here.

Using this feature with manually crafting the output is also a way to create Myers-Briggs personality tests. Here’s how to do it:

  • Place your questions in five categories (for example Mind, Energy, Nature, Tactics, Identity)
  • Create different category grades for each category.  For mind you can have grades Extraverted and Introverted (use only the letters for grade title: E and I), for Energy Intuitive and Observant etc.
  • In the final screen construct the 5 letter personality types by combining the grade titles of the 5 categories: %%CATEGORY-GTITLE-1%%%%CATEGORY-GTITLE-2%%%%CATEGORY-GTITLE-3%%%%CATEGORY-GTITLE-4%%-%%CATEGORY-GTITLE-5%%
  • Then if you wish you can construct the explanation text from the descriptions of all category grades similar to how you constructed the title above

Test Grade Based on Question Category Performance

From 5.5.8 you can define final test grade which depends on the performance of each question category. This is the best way to handle complicated and non-standard tests. Learn more about this feature here.

Troubleshooting

Problem: Not all categories appear on the final screen.

Solution: This happens because you have added questions from categories whose order is not yet defined.Simply re-save the quiz and everything will be fine. If you want to change the category order you can do it from the Advanced Settings tab of the quiz.

 

 

Personality Quizzes in WatuPRO

A personality quiz is a quiz where the results do not depend on from-to points collected (or % correct answers) but the answers are directly matched to the result. So with a classical example of Intorvert / Extrovert type of quiz answer A of question 1 could be giving 1 point to Introvert category and answer B might be giving 2 points for Extrovert category. Answer A on quesiton 2 could be giving 3 points for Extrovert etc. At the end of the quiz the result that collected the most point is the respondent’s personality.

Here is a really basic example.

And here is how you can create such a quiz:

1. You need the Intelligence module installed. When creating your quiz you need to check the following checkbox in the “Intelligence Module Settings” area:

 

2. It’s recommended to then go and create your Personality types:

personality-grade

 

Unlike Grades, the personality types do not have “from points” – “to points” setting. This is because they are directly matched to question answers (see below).
If you wish you can assign certificates just like in the knowledge quizzes.

3. Create your questions

When creating them, directly match the possible answers to the possible results:

If you wish you can use “Correct answer” and “points” fields but they usually don’t make sense in personality quizzes. Only the “Assign to grade” selection will be taken into account when calculating the result of the quiz.

From WatuPRO version 5.0.3.2 and above points actually matter. Quizzes work as they used to when you enter 0 or 1 point. We will count one point for the associated personality type(s) in both these cases (because adding zero when you have selected that personality type makes no sense). But this and future versions allow you to enter more points and they will be calculated to the associated personality type(s). So you can give some question  or answer more weight by assigning 2 or more points to it.

Sortable questions are special case. Learn more about them here.

4. Setup your Final screen:

fina-screen-personality

This is not too different than the final screen on knowledge quizzes and exams. Except that most probably you won’t use tags for number of points and correct answers (although you can include this information if you wish).

That’s it.

Elaborating Quiz Results

You can also elaborate this by including information how the different personality types rank for the given quiz taker. The information below is also available in the internal Help page of the plugin:

The following shortcode can be used only in the “Final Screen” and email box to improve the content shown to the user on personality quizzes. Many personality quizzes work better when displaying not just the assigned personality type but also information how many answers the user gave for the other types. Here is how to use it with an example:

[watupro-expand-personality-result sort="best" limit=3 empty="false"]
For personality type {{{personality-type}}} you gave {{{num-answers}}} answers ({{{percent-answers}}}% of all).
<p>{{{personality-type-description}}}</p>
[/watupro-expand-personality-result]

Inside this shortcode you can use ONLY the 3 curly-braced variables shown above, exactly the way you see them. Don’t use %%GRADE%%, %%GDESC%%, or %%GTITLE%% or other of the global variables inside the shortcode.

The text inside the shortcode will be repeated for every personality type. All the arguments in the shortcodes are optional:

  • sort defines how the types are sorted. You can sort by “best” (most answers collected type on top), “worst” (least on top), “alpha” (alphabetically by type title). If you don’t specify the parameter the types will be sorted by the order you created them.
  • limit can be used to limit the number of personality types shown after sorting. Will be useful if you have tens of personality types and want to show only the ones that user gave most answers for. Or set to “1” to display information only for the type they received as result. If you don’t include this parameter all the existing types will be shown.
  • empty defines whether the personality types that got 0 answers will be shown. When the parametter is skipped, they will be shown. When set to “false” they will be excluded.

Multiple Personality Types

From WatuPRO 5.3 in case several personality types rank first with the same number of “points” they will all be displayed to the quiz taker.

If you have assigned certificates they won’t be issued in these cases (this may change in a future version).

Note the option “Assign only one personality” in the Intelligence module tab (just under the “This is a personality quiz” checkbox). If you select it, you will have the quiz work the “old” way – in case of a tie only one personality type will be assigned instead of multiple personalities.

Personality Chart

From version 6.1.4 you can use the shortcode watupro-personality-chart to print a bar chart from the performance on each personality type. This shortcode can be used on the “Quiz output / Final page” box (or in the email contents sent right after completing the quiz).

Supported shortcode parameters:

  • bar_width is the width of each bar in pixels. Defaults to 200.
  • label is the text shown under each bar. It supports the variables {{personality-type}} and {{points}}
  • colors is comma separated string of desired colors of the bars.  You can skip the parameter, then default set of colors will be used.

Here is an example chart and the shortcode used to display it:

[watupro-personality-chart bar_width=250 label="{{personality-type}}" colors="#AA0070, #B91ACC, #C0FA9F"]

The chart will display up to 10 bars.

To pass associative colors (so you can attach a color to a personality) use the attribute assoc_colors instead of colors. Each color will consist of the numeric personality ID (visible in your Manage Personality Types page), a colon, and the color. Example:

[watupro-personality-chart bar_width=250 label="{{personality-type}}" assoc_colors="1:#AA0070, 3:#B91ACC, 4:#C0FA9F"]

This way each personality bar will have the specified color for that personality regardless how they rank.

Myers – Briggs Personality Tests

These are very specific and usually are not created using this feature. Learn how to create Myers-Briggs tests here.

Sample Personality Quiz: What is The Best Fruit For You?

The sole purpose of this quiz is to demonstrate how personality quizzes in WatuPRO + Intelligence module work. Please don’t take the result too seriously 🙂

1. What is your favorite color?
2. Do you like soft or hard fruits?
3. Where do you leave?