Those Points can also be redeemed by users for a variety of extras or exclusive access to content you create. These are only a few quick examples. You can really get creative when deciding how you want to provide Points to users and how you want to allow Points to be redeemed.

You also have the option to incorporate additional CourseCure Add-ons with Points like Quizzes, Badges and Courses.

Details on installing and enabling CourseCure Add-ons are available Right Here.

This Knowledge base entry includes details and examples of the available Points features and functionality within CourseCure. The table of contents on the right can be used to jump to any section.

—

Points Setup

Point Rules can be created in the Setup > Points Rules section.

—

Each Rule will add/subtract the set number of Points based on how the Trigger is configured. “When this happens” “Then do this”

The green plus icon on the top of the Points Rules section can be clicked to begin the Points creation process.

—

Set a Name for the Points Rule and click the green Apply button.

—

Once the Points Rule has a Name, the Edit Setup Rules section will appear and the various settings can be configured for that specific Points Rule.

There is a variety of available Triggers available in the “When this happens” dropdown. Selecting a specific Trigger from the dropdown will result in showing the specific options for that Trigger.

Triggers can range from user login and comments to completing a Quiz or Course. There is a wide selection of available Triggers.

In the example shown below, Users will be issued 5 Points when they post their 50th comment on the site.

The blue Save or green Save & Close button can be clicked once all settings are configured.

—

Points Redemption

Redemption Rules can be created in the Redemption > Redemption Rules section.

—

Each Redemption Rule will set the Action that is Triggered when a User redeems the set number of Points.

The green plus icon on the top of the Redemption Rules section can be clicked to begin the Rule creation process.

—

Once the Redemption Rule has a Name, the Edit section will appear and the various settings can be configured for that specific Rule.

The Edit section includes the following sub tabs:

• Settings
• Actions
• Button
• Configuration
• Success

—

Settings

The Settings sub tab can be used to adjust the general settings for the Redemption Rule.

—

Points needed to redeem: This is the total number of Points a User needs to redeem

Set the number of times a user can redeem this offer: This is the maximum number of ties a User can redeem the specific offer.

Shortcode: This can be copied and pasted into any page/post on the site. It will display a button on the page/post that can be used to redeem. (More details on the button are included in the Button sub tab).

Redemption URL: This will display a pop up box with the redemption offer on the site when clicked.

The blue Save or green Save & Close button can be clicked once all settings are configured.

—

Example of the Shortcode displaying the Button on a live site. More information on styling the Button is included below.

—

Actions

A single or multiple Action can be set to happen after a successful Redemption.

The green plus icon on the top of the Actions section can be clicked to begin the Action creation process.

—

The “Select the Action that will happen after successful Redemption” pop up will appear and the desired Action can be selected from the dropdown. The selected Action will determine and display the available options in the pop up.

Some options include Send HTTP Post, Redeem Badges, etc.

—

In the example shown below, Users will be issued the Tick Tock Badge after a successful Redemption.

The blue Add Action button can be clicked once all settings are configured.

—

The newly created Action now appears on the Actions list. This process can be repeated to create additional Actions.

—

Button

A Button can be created to allow Users to redeem Points. The Shortcode located in the Settings sub tab can be added to any page/post on the site to display the Button.

The settings in the Button sub tab control the look of the Button.

—

Button Text: The [numberofpoints] mergecode will be automatically replaced with the number of points set in the “Points needed to redeem” field in the Settings sub tab.

The blue Save or green Save & Close button can be clicked once all settings are configured.

—

Confirmation

A Confirmation message appears when a User clicks to Redeem.

The settings in the Confirmation sub tab allow for adjustment the messaging that will appear to the User.

—

Title: The Title will be displayed on the top of the Confirmation pop up form when redeeming the offer.

Message: A Message asking for Confirmation to Redeem the set number of Points. The [numberofpoints] mergecode will be automatically replaced with the number of points set in the “Points needed to redeem” field in the Settings sub tab.

Button Text: This text will appear on the Button shown within the Confirmation pop up.

Show Remaining Points in the Pop up: If Enabled, the User’s remaining Points will be displayed in the Confirmation pop up after Redemption.

—

Example of the Confirmation pop up on a live site:

—

Success

A Success message appears when a User successfully completes a Redemption.

The settings in the Success sub tab allow for adjustment the messaging and potential redirection for the User.

—

Message to display after a successful redemption: The Message displayed to the User to indicate a successful Redemption.

Redirect after a successful redemption: Select if the User should be redirected to a Custom URL or an existing Page/Post after Redemption.The option of no redirection can also be set.

—

Example of the Success message on a live site:

—

Logs

The Logs section is available to display a list of Users and the Points they have earned/redeemed.

An advanced search is available with options to Select the Trigger type and/or Select how the Points were processed (Added or Subtracted).

—

Import/Export

The Import/Export section includes the following sub tabs:

• Import Points
• Export Points

—

Import Points

A .CSV file can be used to Import Points. A sample file is provided to ensure the correct format is used.

—

Authentication/Match: The data to be used to match the Users from the .CSV file with the Users in the site. (User ID, Username or Email Address).

Log Details: The message to be displayed in the Transaction Details column in the Logs section.

—

Export Points

A .CSV file can be Exported with User Points.

—

Select which users to export: The .CSV file can contain all Users or only Users with Points.

—

Settings

There is a General Settings section that covers a few Settings for Points.

—

The “Click here to view instructions…” API KEY link directs to a page on your site with more details on using the CourseCure Points API. An example screenshot is included below.

—

Back to Top

We are going to address the following question:

How Do I Assign Points to a User when a Course is Completed?

Related: Click Here for info on assigning a Badge to a User when a Course is Completed.

—

CourseCure provides the ability to add a set number of Points to a User based on Triggers. In this example, we are going to run through the steps to assign 50 Points to a User who completes the “Learning to Skydive” Course.

The first step is to create a Course. (Details on Course creation can be found in the Course Setup Overview and Course Builder articles)

—

Once you have your Course created, you can set it to assign Points to Users when they complete that Course. This will be done by setting up a Points Rule in the Points > Setup section.

The Points Rule will handle the adding of the Points.

—

The green plus icon on the top of the Points Rules section can be clicked to begin the Points creation process.

—

Set a Name for the Points Rule and click the green Apply button.

—

We have set the Rule name as “50 Points for Completing Course” in this case.

The Points Rule has a Name so the Edit Setup Rules section will appear and the various settings can be configured for this specific Points Rule.

We want this rule to assign 50 Points when a Course is completed, so the settings can be adjusted accordingly.

In the example shown below, Users will be issued 50 Points when they mark the “Learning to Skydive” Course as complete.

The blue Save or green Save & Close button can be clicked once all settings are configured.

—

The Points Rule has now been created and any Users who complete the “Learning to Skydive” Course will be issued 50 Points.

—

More details on Points can be found in the Points – Setup Overview article.

—

Back to Top

Information like their Lifetime Points, Points Redeemed, Points Remaining and more.

—

There is a corresponding shortcode for each option. Each can be used to display one Points Total or multiple shortcodes can be used together to display a Points section for Users.

In the example below, four shortcodes has been inserted into a page named “Points”.

These shortcodes will each display their corresponding info for the User.

—

The shortcodes can be inserted into any page or post and they will display the corresponding information to Users.

Lifetime Points: [wlpts_lifetime_points] – Displays the total number of Points the User has earned.

Remaining Points: [wlpts_remaining_points] – Displays the total number of Points the User has remaining.

Points Redeemed: [wlpts_redeemed_points] – Displays the total number of Points the User has redeemed.

User Points Logs: [wlpts_user_logs] – Displays a table showing the Points transactions for the User.

—

The look of the page or post can be designed based on your site theme.

—

Back to Top

We are going to address the following question:

How Do Users Redeem Points?

—

The first step is to setup Point Rules. (Details on Points Rules setup creation can be found in the Points Redemption section of the Points Setup Overview article).

—

Once you have your Points Rules created, you can allow Users to redeem their Points for items.

In this example, we are going to run through the steps to create a Redemption button for a Badge named “Night Sky”.

—

A page/post can be created on the site and Shortcodes can be inserted to display the Redemption buttons.

The Shortcodes that will display the Redemption option on the live site can be found in the Points Redemption section in the Shortcodes column.

—

Note: The Redemption URL can also be used to allow for Redemption. The Redemption URL can be found in the Points > Redemption > Click to edit Rule > Settings section.

—

Inserting the Shortcode or using the Redemption URL on a page/post will allow the User to click the button or link and run through the Redemption process.

The example below shows the Shortcode inserted into a WordPress page.

Click the blue Save/Update button and the page is all set.

—

The button will now appear on the live site and the Users can redeem their Points to be issued the corresponding Badge.

—

Back to Top

==========

/**
* Fires after points has been successfully added to a user
*
* @param integer $id – User Id
* @param integer $points – Number of points.
*/
do_action( ‘wl_points_points_added', $id, $points );

/**
* Fires after points has been successfully deducted from a user
*
* @param integer $id – User Id
* @param integer $points – Number of points.
*/
do_action( ‘wl_points_points_subsctracted', $id, $points );

—

More info on Hooks can be found in the following articles:

Hooks – Badges
Hooks – Quizzes
Hooks – Courses

—

Back to Top

That can be controlled in the Widgets > Points Leaderboard section of WordPress.

If you want to exclude a User from being displayed on the Leaderboard, you can use the following field:

ID of users to exclude on this list (separated by comma)

This is located in the Widgets > Points Leaderboard section of WordPress:

—

A User ID can be found by hovering your mouse over the Username for the User in the WordPress Users section. The User ID appears after user_id=

—

This allows for even more opportunities for User engagement and interaction.

Points and Badges can be issued to Users based on set Triggers and Actions. Additional Triggers will be available for Points and Badges if any of the plugins listed below are installed and activated on the same site.

There is a variety of available Triggers available in the “When this happens” dropdown for both Points and Badges. Selecting a specific Trigger from the dropdown will result in showing the specific options for that Trigger.

This can be found in the following sections of CourseCure:

Badges > Setup > *Click Rule Name* (or Create a New Rule)

—

OR

Points > Setup > *Click Rule Name* (or Create a New Rule)

—

Related: Additional info on setting up Triggers (“When this happens”) and Actions for Points and Badges.

—

The available Integration options and their Triggers:

• bbPress
• BuddyBoss
• LearnDash
• Lifter LMS
• Presto Player
• SimplePress
• Tutor LMS
• WishList Member
• WooCommerce

—

bbPress

• User creates a discussion
• User replies to a discussion
• User subscribes to a forum
• User subscribes to a topic

—

BuddyBoss

• User creates a discussion
• User replies to a discussion
• User subscribes to a forum
• User subscribes to a topic

—

LearnDash

• Completed a Course
• Completed a Lesson
• Completed a Quiz
• Enrolled in a Course

—

Lifter LMS

• Completed a Course
• Completed a Lesson
• Completed a Quiz
• Enrolled in a Course

—

Presto Player

• Completed a Video

—

SimplePress

• Creating a Forum Thread
• Replying to a Forum Thread

—

Tutor LMS

• Completed a Course
• Completed a Lesson
• Completed a Quiz
• Enrolled in a Course

—

WishList Member

• Added to Level
• Cancelled from Level
• Removed from Level
• Uncancelled from Level
• Added to Pay Per Post

—

WooCommerce

• Purchased a Product
• Refunded a Purchase

—

Back to Top

These are only a couple examples. They are plenty of reasons to create a point rule and many options to customize the process.

We are going to address the following question:

Points – How Do I Setup a Point Rule?

Related: Click Here for info on assigning Points to a User when a Course is Completed.
Related: Click Here for more details in the Points Overview

—

Point Rules can be created in the CourseCure > Setup > Points Rules section.

—

Each Rule will add/subtract the set number of Points based on how the Trigger is configured. “When this happens” “Then do this”

The green plus icon on the top of the Points Rules section can be clicked to begin the Points creation process.

—

Set a Name for the Points Rule and click the green Apply button.

—

Once the Points Rule has a Name, the Edit Setup Rules section will appear and the various settings can be configured for that specific Points Rule.

There is a variety of available Triggers available in the “When this happens” dropdown. Selecting a specific Trigger from the dropdown will result in showing the specific options for that Trigger.

Triggers can range from user login and comments to completing a Quiz or Course. There is a wide selection of available Triggers.

The Screenshot below displays a configuration for a Point Rule named “Pass Quiz” that will add 15 points to anyone who passes the Skydiving quiz.

The blue Save or green Save & Close button can be clicked once all settings are configured.

—

The above is just one example of a Point Rule. There are various triggers that can be set to apply actions. We recommend checking out the “When this happens” dropdown to see the various options available. Selecting a trigger will show even more actions that can be used.

—

Back to Top

These Shortcodes cover a variety of topics like Quiz Results, Point Totals, Course Details, Badge List and much more.

—

The CourseCure Shortcode Inserter can be accessed using either of the following Gutenberg Blocks:

• Paragraph Block
• Shortcode Block

Paragraph Block

The Paragraph Block can be added to any page or post using the Gutenberg editor.

—

Once the Paragraph Block is inserted, the CourseCure icon can be used to access the library of CourseCure Shortcodes.

—

—

Note: The Shortcodes for each of the Add-ons that have been activated in the CourseCure Setup section will appear. In the screenshot example below, all Add-ons are enabled.

The desired Shortcode(s) can be selected and inserted from the list.

—

Shortcode Block

The Shortcode Block can be added to any page or post using the Gutenberg editor.

—

A Shortcode can be pasted into the field, or the CourseCure icon can be used to view the list of available CourseCure Shortcodes.

—

The CourseCure Shortcodes option will appear.

—

Note: The Shortcodes for each of the Add-ons that have been activated in the CourseCure Setup section will appear. In the screenshot example below, all Add-ons are enabled.

The desired Shortcode(s) can be selected and inserted from the list.

—

More details on each Shortcode can be found in the Summary of CourseCure Shortcodes article.

Back to Top

CourseCure Shortcodes:

Courses
Quizzes
Badges
Points

—

Courses

• Course ArchiveShortcode: Displays the selected Courses on the site. There is a variety of additional settings that can be configured using the available dropdowns within the Shortcode Creator.
  
  • Course Access. Select if All Users can view the Archive or only Users With Access to the Courses can view the Archive.
  • Course Category. Select if Courses within All Categories are displayed or only Courses within the selected Category are displayed.
  • Course Difficulty. Select if Courses within All Difficulties are displayed or only Courses within the selected Difficulty are displayed.
  • Columns. Select the number of Columns to be displayed. If Default is selected, the number of Columns is 3.
  • Display Search Bar. Select if the Search Bar should or should not be displayed on the Archive. If Default is selected, the setting in the Courses > Settings > Layout section will determine if the Search Bar is displayed or not.
  • Preview. The Shortcode is automatically adjusted based on the selected settings.

Shortcode: [wishlist_courses_archive access="all" category="0" difficulty="0" column="default" searchbar="default"]

—

Note: The example screenshot below shows the Course Archive Shortcode configured to display to All Users, Courses in the Overall Category, Courses in All Difficulties using the Default Columns and Default Search Bar settings.

[wishlist_courses_archive access="all" category="65" difficulty="0" column="default" searchbar="default"]

—

Quizzes

• Quiz Codes: Inserts the selected Quiz onto the page or post.
  
  • Select Quiz: Select the desired Quiz to insert. The fully configured Quiz will be inserted and displayed on the live site.

Shortcode: [WLQuiz id="1"]

—

• Quiz Name: Displays the name of the Quiz on the page or post. The Quiz Name will be displayed on the live site.

Shortcode: [WLQuiz_Name]

—

• Quiz Score: Displays the Quiz Score to the User. The specific Quiz Score for the User viewing the page or post will be displayed on the live site.

Shortcode: [WLQuiz_Score]

—

• Passing Score: Displays the Score needed to Pass the Quiz. The set Quiz Score required to Pass the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Passing_Score]

—

• Perfect Score: Displays the Perfect Score for the Quiz. The set Quiz Perfect Score will be displayed on the live site.

Shortcode: [WLQuiz_Perfect_Score]

—

• Total Questions: Displays the Total Number of Questions for the Quiz. The set Total Number of Questions within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Questions]

—

• Total Correct Questions: Displays the Total Number of Correct Answers to the User. The set Total Number of Correct Answers within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Correct_Answers]

—

• Total Incorrect Questions: Displays the Total Number of Incorrect Answers to the User. The set Total Number of Incorrect Answers within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Incorrect_Answers]

—

Badges

• Badges: Inserts the list of Badges onto the page or post.
  
  • Badge Size: Select the desired size of the Badges
  • Sort Badges by: Select if Badges should be Sorted by Newest or Oldest.
  • Type of Badge: Select if displayed Badges are Earned or Unearned (or Combined)
  • Badges Column #: Set the number of Columns to be displayed.

Shortcode: [wl_badges size="medium" sort="newest" type="showall" col="3"]

—

Points

• Lifetime Points: Displays the total number of all Points ever earned by the User.

Shortcode: [wlpts_lifetime_points]

—

• Remaining Points: Displays the number of available Points the User has Remaining.

Shortcode: [wlpts_remaining_points]

—

• Redeemed Points: Displays the total number of Points ever Redeemed by the User.

Shortcode: [wlpts_redeemed_points]

—

• User Points Logs: Displays a table showing the full Logs of Points Transactions by the User.

Shortcode: [wlpts_user_logs]

—

• Redemption Buttons: Select and insert a Button Users can use to Redeem Points.
  
  • Select Redemption Rule: Select the desired Redemption Rule for the Button.

Shortcode: [points_addon_redeem id="4"]

—

Back to Top