Tag Archives: watupro

Question Intros in WatuPRO

Leave a reply

From version 6.6.0.5 the quiz plugin WatuPRO supports question intros. They are most useful when you want to include some introduction content which is not technically a part of the question. Usually you’d use it in non-randomized quizzes to explain one or more following questions.

Create your intro content at the beginning of the question:

Creating the question intro

Use the {{{split}}} tag to separate the intro from the question itself. When the question is shown in the front-end,  the intro content will be displayed before it:

Intro on the front-end

What about randomized tests?

If you have to do this for quizzes that randomize questions you will need to ensure the group of questions stays together. To achieve this use question categories and place the groups in the same category. Enable the checkbox “Group questions by category” in Edit quiz -> General Settings tab.

Because in this case you don’t know which question will be first, use the category description for your introduction text instead of using the {{{split}}} tag explained above. The category description will be shown before the first question of that category similar to the question intro content.

Charts In WatuPRO Reporting Module: Types and Shortcodes

4 Replies

From version 6.5.6 there are 3 new charts in the Reporting module of the quiz and survey plugin WatuPRO.

Quick links: Basic performance chart | Question performance chart |Cumulative poll chart |Charts per question category |All respondents performance | Pie Chart from Correct / Wrong / Unanswered | Charts in My Quiz Reports pages

Basic Performance Chart

This is a simple chart showing your points collected vs. the maximum points that you could achieve in a single quiz attempt.  The chart can be used in the quiz final screen but for logged in users you can also use it elsewhere as long as you pass the attribute quiz_id as documented later below.

Chart shortcode: [watupror-performance-chart]

Attributes (all optional):

  • type – “bar” or “pie”. Defaults to bar (and generates a barchart)
  • mode – “js” (default) or “gd”. Used only if type is “pie”. Normally the chart is generated via the gRaphael javascript charting library. However if you plan to include it in email contents or allow PDF download of the final screen (using our PDF bridge), then you should set mode to “gd”. This will use the PHP GD library which must be installed on your server.
  • taking_id – use it if you want to show a chart for a specific quiz attempt. Usually you will display the chart on the final screen so taking_id is based on the current attempt. In this case the attribute should not be passed.
  • quiz_id  – used in case you want to show chart for the latest attempt of the currently logged in user on a specific quiz. Normally (showing chart on the final screen) you will skip this attribute.
  • your_color – the color of the bar or pie slice which displays the points you have collected. Pass a valid hex value like #FF0000 (no short syntax).
  • max_color – the color of the bar or pie slice which displays the maximum points that could be collected on that attempt. Pass a valid hex value like #FF0000 (no short syntax).
  • your_text – the text shown under your points bar or pie slice. Has default value for both chart types.
  • max_text – the text shown under the maximum points bar or pie slice. Has default value for both chart types.
  • bar_width – the width of each bar in pixels. Defaults to 100. Used only if type = “bar”.
  • height – the height of the highest bar in pixels. Defaults to 300. Used only if type = “bar”.
  • radius – the radius of the pie in pixels. Defaults to 100. Used only if type=”pie”.

Let’s see a couple of example usages so you get a better idea of this chart:

barchart without parameters

Shortcode used: [watupror-performance-chart] (all defaults, no parameters)

bar chart with parameters

Shortcode used: [watupror-performance-chart your_color="#f57e42" max_color="#038a05" height="250" bar_width="150" your_text="You got %d points" max_text="From %d max."]
Above is an example of the barchart with custom colors, text, and sizes.

Pie performance chart

Shortcode used: [watupror-performance-chart your_color="#2d5ba6" max_color="#a1a3ad" type="pie" radius=150]

Note that the pie chart is slightly different. The whole 360° represent the maximum points on the quiz. That’s why the two colors actually show points collected and points missed which is made clear by the default texts.

Questions Performance Chart

Similar to the above chart, this one shows your points as a percentage of the maximum points but for every question answered in the quiz.

It’s currently available only as a horizontal bar chart.

Chart shortcode: [watupror-questions-performance-chart]

Attributes (all optional):

  • taking_id – use it if you want to show a chart for a specific quiz attempt. Usually you will display the chart on the final screen so taking_id is based on the current attempt. In this case the attribute should not be passed.
  • quiz_id  – used in case you want to show chart for the latest attempt of the currently logged in user on a specific quiz. Normally (showing chart on the final screen) you will skip this attribute.
  • color – the color of the bars.
  • bar_width – the width of each bar in pixels. Defaults to 30. Note that because the chart is horizontal the “width” of the bar actually means it’s size vertically.
  • height – the height of the highest bar in pixels. Defaults to 300. Note that because the chart is horizontal this actually means the size of the bar horizontally.

Here is an example of this chart using a custom color:

performance per question in a single test attempt

Cumulative Poll Chart

cumulative poll chart, horizontal bars

This is a cumulative chart from everyone’s answers on a single question. By default it loads “correct/incorrect” chart on all question types except on “single answer” and “multiple answer” questions where it loads one bar per each answer.

You can force it to always show correct / incorrect by adding parameter to the shortcode: [watupro-poll question_id="X" mode="correct"].

You can also control the colors used in the chart like this: [watupror-poll question_id="X" correct_color="green" wrong_color="#FF0000"].

The optional parameter user_choice lets you show which is the current user answer when the shortcode is used in the “Final page”. You can pass any text or even HTML code (when using HTML make sure the rich text editor is in Text mode) and it will be shown next to the corresponding answer(s) or correct / incorrect stats. If you pass “CHECK” to the attribute we will generate a checkmark.
Example: [watupror-poll question_id=”X” user_choice=”CHECK”]

By default the shrotcode produces a horizontal bar chart. You can use the parameter “orientation” to make it a vertical one.
Example: [watupror-poll question_id="X" orientation="vertical"]

poll chart, vertical bars

Performance Per Categories

The chart showing user’s performance per question category in a single quiz attempt has several variations – a bar chart, a pie chart, multiple pie charts based on % correct  / % wrong answers in each question category.

Here is a basic example:

pie chart from user's performance per question category

You definitely need to read the whole article about this chart to find all the variations and possibilities it gives.

This same chart can show performance per question categories of a logged in user on all tests. To switch to this mode pass the attribute taking_id=”ALL” to the shortcode.

Everyone’s Performance Per Question Category

Bar chart showing everyone's performance per question category on a quiz

This chart works similar to user’s performance per question category but shows everyone’s. The chart can be used on a random post or page (does not need to be on the quiz final screen).

The shortcode accepts exactly the same parameters as the user category chart but requires the parameter quiz_id. Note that drawing the chart for a quiz that has been completed by tens of thousands of users may require a lot of server memory.
The parameter sum_subcategories=1 will sum up the subcategory performance into the parent categories and will not generate pies for the subcategories.

Here’s example shortcode usage:

[watupror-quiz-cat-chart quiz_id=X from="percent_max_points" colors="green, blue, yellow, black, orange"]

Your vs. Everyone’s Performance Per Question Category

Use the same shortcode as above but pass the parameter “compare=1”. It will produce two bars for each question category – one for you (current taking or passed parameter taking_id) and one for everyone’s performance.

Your vs everyone's result per category

With this shortcode you need to pass only two colors in the “colors” parameter. The color of your bar and the color of everyone’s bar.

Here is the shortcode that produced the above chart:

[watupror-quiz-cat-chart quiz_id=X from="percent_max_points" colors="crimson, blue" compare="1" width="30" orientation="horizontal"]

Available from WatuPRO 6.5.8.6.

Pie Chart from Correct / Wrong / Unanswered

This is a simple chart based on a single quiz attempt. It shares the same watupror-pie-chart shortcode which generates the performance per category chart above but with parrameter from=”questions”.

Example usage: [watupror-pie-chart from="questions" radius="160"]

Pie chart based on correct / wrong / unanswered questions

Charts Inside “My Quiz Reports” Page

Additionally the Reporting module provides several pages that contain detailed reports for each  registered test taker. Each user can see it’s own performance reports and charts. The admin can see everyone’s (see how).

These pages contain a couple of charts too:

charts from the user overview page

These charts are showing all time overview of taken tests per test category and questions answered per question category.

Skills / categories chart

The above simple bar chart shows proficiency per skill / question category from the Skills report page. It can be horizontal and limited further per test and filtered for desired proficiency level.

history of taken tests bar chart

The history bar chart shows the number of quizzes attempted in total for each month of the current year.

How To Conduct Surveys With WatuPRO

WatuPRO is a quiz plugin but it’s also perfect for running surveys. A survey is essentially a quiz that doesn’t give specific result / outcome to the user but presents the admin with the data of the user’s answers.

The most basic concepts are shown in the video and explained in more details in the post below.

Here is what you need to do to run a survey with WatuPRO:

  •  Mark the questions as “survey” questions. This is done with a checkbox on the Add / Edit Question page saying “This is a survey question. This will ensure no green / red checkmark will be shown if you decide to show user’s answers on the “final screen”. You can also use the mass-edit functions in your Manage Questions page to turn multiple questions into survey questions at once.
  • Don’t create grades. Nothing stops you to create grades but typically surveys do not grade the user’s performance.
  • View the results. You can then view, export, etc all the answers of the respondents. More information here.

The above is enough to run functional survey. However there are several tools that can make surveys created with WatuPRO even better:

The Reporting Module

See a short demo survey that uses the Reporting Module.

If you include the Reporting module with your WatuPRO purchase you’ll be able to see a lot more structured data and run data analytics on the survey responses.

The cumulative stats per question will show you how many respondents have selected each option of each question. If the question is not labeled as a survey type and has correct & incorrect states, you’ll also see this information.

stats per question

Cumulative stats per question

Follow the link to full details to get to the page that gives you detailed list of everyone’s answers, which can also be exported to CSV.

The stats per category and tag is very useful for quantitative questions because it will show cumulative points collected in each category, and again correct/incorrect percentages if the question has such characteristics:

Stats per category and tag

Stats per category and tag

The super powerful cross tabulation analysis turns WatuPRO into a real scientific tool for running insightful data analysis on any survey:

Cross tabulation analysis

Cross tabulation analysis

Learn more about cross-tabulation analysis here.

The poll-like shortcodes enabled by the Reporting module let you also present structured %-based data for every question to the user. Example here. Obviously you can use them to also run simple one-question polls.

poll shortcode example

The Likert Scale Survey Maker

If you want to run a likert scale survey we have a free helper plugin that will make your work so much easier. It makes adding a lot of survey questions at least ten time faster than via the standard way and predefines the quiz settings to be most appropriate for a survey. Don’t worry, all the questions and settings are then editable just like in any quiz made with WatuPRO.