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.