Monthly Archives: January 2014

Request Email and Name to Submit a Quiz (WatuPRO)

Note: while this still works, it’s no longer cool. Check the new options instead.

When you select “Send email to the user with their results” in the quiz settings, an auto-generated field for collecting email appears on top of the quiz. (This is for non-logged in users – when user is logged in, this field does not appear).

Now, from version 4.1.1.5 we have a more elegant solution. You can add “name” and “email” fields yourself in the quiz description area. And more, if you use these fields with combination with the {{{button}}} tag, the user will have to fill them even before starting the quiz.

Here is how to use them:

In the exam description field simply enter any of the following two codes at the places where you want the fields to appear:
{{{name-field}}}
{{{email-field}}}
You can of course use only one of the fields if you wish. You can add any content around them, for example:
Your name: {{{name-field}}} (please enter your full name)
You can use the fields with or without a start button (the {{{button}}} tag), that’s up to you.
By default these fields are required and the user cannot submit the exam (when no “start” button is used) or reveal the exam contents (when “start” button is used) without filling the fields.
However you can make any of these fields optional if you add class “optional” to them. Like this:
Your name: {{{name-field class=”optional”}}} (so this is optional and won’t display an alert if left empty)
Your email (required): {{{email-field}}} (and this remains required)
You can also pass any HTML attributes if you want to style the fields beyond the default style. For example
{{{email-field size=”100″ onclick=”someJavascriptFunction();”}}} 
and so on.

In Certificates:

From version 4.1.4.6 exactly the same codes can be used to display the entered information in certificates. What if you use the same certificates for quizzes that use these codes and for quizzes that don’t use them? Don’t worry. The code {{{name-field}}} will then default to the behavior of the %%USER-NAME%% variable, and the {{{email-field}}} will be populated with the email from the user’s profile.

In the Final Screen / Email Contents

To display the user name there please use the %%USER-NAME%% variable.

WatuPRO to Arigato PRO Bridge

Do you want the users who take your WatuPRO quizzes to get signed up to a mailing list or an auto-responder marketing campaign?
This is now easy with the new bridge that connects WatuPRO to Arigato PRO (a.k.a. BroadFast PRO). It will let you specify a relation between quizzes and mailing lists so when someone completes a specified quiz, they are automatically subscribed in the corresponding mailing list. The plugin will work even for non-logged in users as long as email is provided (which will be if you select “Email user their results” in the quiz settings).

From version 0.8 (updated in June 2014) you can also specify desired grade and thus have users achieving different grades be subscribed in different mailing lists.

The bridge is absolutely free and can be downloaded here.

Install and activate it. Then under your WatuPRO menu you’ll see a new page called “Bridge to Arigato PRO”. Download and enjoy it.

wbbridge

User Info Shortcodes from WatuPRO Version 4.1.1

From WatuPRO version 4.1.1 and above you no longer need additional plugins to display data from user profile of the logged in user (if you want to display data for another user read the section “Passing User ID” at the bottom). WatuPRO defines own shortcodes that are super easy to use.

If you are using the light version – the free Watu plugin, the shortcode [watu-userinfo] works exactly the same way.

Here is what you need:

[watupro-userinfo profile_field] where “profile field” is the field from the user profile you want to display. For example:

[watupro-userinfo display_name] will display the user display name

[watupro-userinfo first_name] and [watupro-userinfo last_name] will display respectively the first and last name and so on. The full list of default user fields is here:

ID
user_login
user_pass
user_nicename
user_email
user_url
user_registered
display_name
first_name
last_name

But this is not all. You can also display ANY value from the user_meta table as long as you know the key, even if it’s created by another plugin. For example [watupro-userinfo namaste_points] will display the points collected in Namaste! LMS and so on.
One great plugin for managing user_meta is Advanced Custom Fields.

Showing Defaults (and handling non-logged in users)

You can prepare a default value to be shown if the user is not logged in, or simply if the value is empty. You just need to pass the default as second argument to the shortcode. Here is example:

Hello [watupro-userinfo first_name "Friend"]!

Passing User ID

This feature requires min. WatuPRO version 4.9.1.4.

By default this shortcode displays data for the currently logged in user. However you can pass user ID by adding “user_id” attribute after the other attributes. The user_id attribute can contain fixed number  (the ID of the user). In certificates it can contain “certificate” in which case the user ID will be figured out from the certificate owner (please don’t use “certificate” outside of the certificate contents, it will not work).

Examples:

[watupro-userinfo first_name "Friend" user_id="5"]
[watupro-userinfo user_url user_id="certificate"]

The user_id attribute can contain “quiz-taker” in the page that lets you configure email for manually edited results (Intelligence module). Example:

[watupro-userinfo first_name "Friend" user_id="quiz-taker"]

That’s it. Use the new shortcodes in the final screen, in certificates, in the email contents, anywhere. You can use them even in areas outside of WatuPRO – for example in post or pages, in the sidebar, etc.