Category Archives: CalendarScripts

WatuPRO 6.2

Version 6.2 of the quiz plugin WatuPRO is ready with lots of improvements and bug fixes:

  • Created ActiveCampaign bridge for automatically subscribing quiz takes to your ActiveCampaign mailing lists. You can find it at https://blog.calendarscripts.info/watupro-bridge-to-activecampaign/
  • Added option to not prompt the user when they are trying to submit a paginated quiz but are not on the last page.
  • Added option to discard negative points on a question so points collected are never below zero.
  • Added option to set maximum possible points on questions with multiple correct answers.
  • Replaced jQuery document.ready calls with vanilla JS alternative. Reason: some themes load jQuery in the footer and this causes errors. While we don’t encourage this behavior we’ll do our best to support all environments.
  • Changed the “Flag for review” icon with a flag. You can still choose the old icon from WatuPRO Settings page -> Theme and Design tab.
  • The dynamic CSS created by the Theme and Design preferences is moved to an external CSS file to avoid collisions with some themes and plugins.
  • Removed unwanted backslashes from flashcard questions (when apostrophes or quotes are used in them).
  • Added new variable for the field for sending quiz completion email which allows you to pull email address from user meta table. Learn more at https://blog.calendarscripts.info/using-dynamic-variables-in-watupro-email-field/
  • When “Don’t display questions that were previously answered” is selected together with “When no more attempts are available display the latest result” the quiz page will display the latest result along with the “all questions answered” message.
  • New mass-change option on Manage Questions page: exclude from showing on the final screen (%%ANSWERS%% variable).
  • Added {{{max-points}}} tag in the optional answer feedback area to allow showing the maximum possible points on a question.
  • Added button to delete all unfinished attempts on a quiz.
  • The timer of timed tests supports short format like 5:25 and the current long textual format. You can change this at the WatuPRO Settings page -> Theme and Design tab. The text “Time left:” is also configurable at the WatuPRO Text Settings page.
  • Added timestamp parameter to the URL after using watupro-retake shortcode to avoid loading the quiz page from cache.
  • Fixed smaller font for the percentage indicator of the progress bar on mobile screen so the text does not go outside of the colored area.
  • Added compatibility with Simple Designer plugin v 1.1 so “maximum selections” on multiple choice questions is also respected in quizzes using that addon.
  • The checkbox advanced setting “Don’t auto-scroll the screen when user moves from page to page “ is made visible for all pagination types.
  • When a timed quiz is started save the current state of questions in case the quiz is randomized – so the same questions are loaded in case of closing the page, back button, refresh etc.
  • [Intelligence module] Added option to charge for issuing a certificate. This way you can make a test which is free to take but the important results are stored in the paid certificate.
  • The contact field variables from Edit Quiz -> User and Email Related Settings tab -> Ask for user contact details section can now be used in certificates.
  • From Settings page -> User Settings tab you can choose whether the new users to be registered with “student” role or with the default role for your site. Till now all users registered from quiz pages were getting “student” role.
  • Custom quiz CSS themes can now be created from admin instead of dealing with files.
  • [Intelligence module]Added dynamic time stamp to the return URL of Paypal payments to prevent the quiz page from being cached and showing the payment button again.
  • [Intelligence module] Added sortable question color & design settings in the Theme and Design tab of WatuPRO Settings page.
  • [Intelligence module] Added variable {{{percent-answers}}} to the watupro-expand-personality-result shortcode.
  • [Reporting module] Added percent correct colun on the History report table
  • Fixed bug: when using checkbox groups the answer text and the {{{answerto-X}}} variable were showing only the answers on the last group.
  • Fixed bug: when there is “pull X random per category” selection and the questions are not grouped by category, important questions were not always included in the random selection with priority.
  • Fixed bug: When “show answer” button was used the user could not rate the question anymore (when ratings are enabled).
  • Fixed bug: when “pull max X answers per question” is selected even questions with “Don’t randomize answers” selection had their answers randomized.
  • Fixed issues with Twitter sharing when custom Twitter button is used.
  • Fixed bug: missing category grades information in admin.
  • Fixed edge case issues with calculating grades dependent on category performance when the Chained Logic addon is used.
  • Fixed bug [Intelligence module]: when a quiz is reusing question from multiple quizzes the option “Let user choose number of random questions” was using only the questions from the first quiz.
  • Fixed bug: performance per category should be calculated for all quizzes with grade dependent on category even if no category grade related variables are used in the final screen.
  • Added notice about outdated versions of Chained Logic addon. If you are using it, please install the latest.
  • Fixes to the visible on-screen timer: it should now be fully consistent with the back-end server and does not lag or go faster than real time even on very long tests.
  • Fixed problem with Theme adjustments: spacing between questions.
  • Fixed problem with bar_width attribute of watupro-basic-chart shortcode
  • Fixed bug: “Case insensitive” exact match on open-end questions and “Fill the gaps” questions did not work correctly with non-ASCII characters.
  • Fixed bug: new lines were getting lost in “Sahre by email” feature.
  • Fixed bug with displaying the first question when the quiz had stored in-progress snapshots of answered questions.
  • Fixed issue with HTML tags entered as answers in Visual mode of the rich text editor, used htmlspecialchars to allow re-saving them properly.
  • Fixed bug [Reporting module]: the shortcode watupror-user-cat-chart did not work properly in PDF.
  • Fixed bug: users with rights to manage only their own quizzes were not able to export questions.
  • Fixed bug [Intelligence module]: when manually editing quiz results from administration the certificates were not properly assigned.
  • Fixed bug [Reporting module] taken tests stats were not properly counting the number of tests when they were published in a non-standard way.
  • Fixed bug: “do not show checkmarks” was not working properly for “fill the gaps” questions.
  • Minor fixes to translation issues.

Programmatically Add User in Arigato PRO & Arigato Lite

If you have custom function that wants to subscribe user in Arigato PRO or Arigato Lite mailing list, here is the code that you need to use.

For Arigato PRO:

if(!class_exists('BFTProUser')) return false; // avoid fatal errors in case Arigato PRO is not activated

$_user = new BFTProUser();
$_user->ignore_redirect = true;

// array with user data:
$vars = array(
"name" => "John Smith", // required
"email" => "john@my-domain.com", // required
"list_id" => 5, // the ID of the mailing list, required
"source" => "my custom function", // optional
);

try {
   // the function returns the newly inserted subscriber ID
   $message = '';
   $subscriber_id = $_user -> subscribe($vars, $message, true);
}
catch(Exception $e) {
   echo $e->getMessage();
}

 

Essentially this is all you need. The function will ignore list redirect and captcha requirements.

For Arigato Lite:

This is even simpler:

if(!function_exists('bft_subscribe')) return false;
bft_subscribe("john@my-domain.com", "John Smith", true, true);

Running A/B Tests in Arigato Gozaimasu

A/B testing is a great way to figure out which of different subscribe form designs perform best by attracting most subscribers per impression. And since the visual designer in Arigato Gozaimasu provides you a lot of possible designs – regular inline forms, responsive pop-ups, sticky top or bottom bars, or animated slide-ins – it’s great to know what works best for you. Now you can do it, with the A/B testing tool that the module provides.

Creating A/B Tests

To create A/B tests for a mailing list you need to create at least 2 form designs for that list using the Gozaimasu visual designer. You can access the visual designer through your Mailing Lists page under column Subscribe Form. The link is just under the simple subscribe form shortcode:

Once you have created and saved at least two designs you will see the A/B tests link next to the Save Design button:

It will also be shown on the Mailing Lists page next to the Visual designer link:

Clicking on the link will take you to the page with A/B tests created for that mailing list. A/B tests are always specific to a mailing list. Initially you will see no tests (because you have to create them first). Creating a test is very simple, it just requires name and selecting which of the existing designs you want to test. Include at least two designs:

That’s it. Save your test and when you go to the previous page you will see it along with its shortcode:

The shortcode of the test is what you need to publish on a page or inside a widget on your site to get the test running. Important: stats will not be recorded for the A/B if you use the individual design shortcodes provided on the Visual designer page. You should use the A/B test shortcode.

It ensures equal rotation of all the designs included in it and calculates stats that will show you which design performs best.

Viewing and Interpretation of Results

Once your A/B test start getting impressions you will see a table showing the performance of the different designs tested:

Since the tool ensures equal number of impressions for each tested design, the most important metrics you need to look at are the percentages – signups / impressions and active / impressions. Here “active” means the subscribers who have confirmed their email addresses so it’s probably correct to assume it the most important stat you need to know. The design that has the highest percentage of active / confirmed subscribers per 100 impressions is the best performing design.

We would recommend waiting for at least few hundred impressions per design before making conclusions. Once you decide on the best design you can replace the A/B test shortcode on your pages with the specific design shortcode.