Adding some healthy and friendly competition amongst members can be an effective way to encourage interaction. The Points Add-on includes a Leaderboard widget you can use to display a variety of standings related to points. This can include daily or monthly points leaders and you can also include an “All Time” list of points leaders.

The Leaderboard widget can be added to your site and your members can watch the standings dynamically update based on the actions of members. Perhaps you have the Points Add-on configured to award a set number of points each time a member login. Or maybe you provide points to members when they leave a comment. Whatever the case may be, if members know they can rise up the leaderboard based on actions they complete within the site, they are often more inclined to engage in those actions.

Enable the Points Leaderboard Widget

You can access your available widgets in the Appearance > Widgets section in WordPress.

—

In the example screenshot below, the Main Sidebar widget has been selected and searching for the “Points Add on” will display the Leaders in Points widget. Click the widget and it will be added to the selected sidebar.

—

The default settings will display three leaderboard sections:

• All Time Leaders. This list will display the users with the highest overall points total.
• Monthly Leaders. This list will display the users with the highest overall points total for the current month.
• Daily Leaders. This list will display the users with the highest overall points total for the current day.

The ID of users to exclude on this list option allows you to prevent specific users from appearing on the leaderboard. This can be helpful if you have test accounts or internal team members you want to exclude from appearing on the list.

You can also select the number of top users to show for each of those sections. The default number is 3 but you can show more or less users on the lists you display.

Each of the three sections includes an enable/disable feature so you can select which sections you want to be seen.

—

The name of the Leaderboard and the names of the three sections can all be edited. This means you can adjust these names to fit your membership site.

The example screenshot below shows the Leaderboard widget set with “Top Member Points” as the title and to only display the All Time Leaders points total. 5 top users will be displayed and no users will be excluded from the list. The Sidebar Title has also been left blank so a title for the overall Leaderboard widget won't appear on the live site.

A Sidebar Title can be useful in keeping everything clear if you display multiple sections in the widget or if you display multiple widgets on your site.

—

View the Points Leaderboard Widget on the Site

Once you've configured the Points Leaderboard widget, you can see how that appears on the live site.

The screenshot example below shows what members will see based on the settings mentioned earlier in this article.In this case, a list of the top 5 users for all time points can be seen.

—

You can easily display a list of dynamically driven point totals that your members can see whenever they visit your site. This bit of visual encouragement can help increase member engagement as they strive to make the list and climb it.

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 WishList Member Add-ons with Points like Quizzes, Badges and Courses.

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

This knowledge base entry includes details and examples of the available Points features and functionality within WishList Member. 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 section that covers a few Settings for Points.
Navigate to WishList Member > Points > Settings

—

The “Click here to view instructions…” API KEY link directs to a page on your site with more details on using the WishList Member 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.

—

With WishList Member, you can 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

This includes information such as 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 have been inserted into a page named “Points”.

—

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

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:

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

—

OR

WishList Member > 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 Points > 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

CourseCure includes a number of helpful shortcodes that can be used to display various pieces of information to users. These shortcodes cover a variety of topics ranging from Quiz Results and Point Totals to Course Details, Badge Lists and much more. You can easily insert a shortcode onto any page of your site and the corresponding information will be automatically displayed to your members.

—

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

• Paragraph Block
• Shortcode Block

You can also create and access any WishList Member or CourseCure shortcodes using the Shortcode Creator.

CourseCure Shortcode Inserter – Gutenberg 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.

—

The CourseCure Shortcodes selector appears and you can choose any available shortcode to insert into the page.

—

The shortcodes for each of the Add-ons that have been activated on the site will appear in the categorized list. The screenshot example below shows the Courses, Points, Badges and Quizzes Add-ons are activated.

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

—

The example below shows the Lifetime Points shortcode has been selected. The shortcode is displayed in the Preview section and the blue Insert button can be clicked to insert the shortcode into the page.

—

The Lifetime Points shortcode has now been inserted into the page. Once the page has been saved, the corresponding information for that shortcode will appear on the live site.

—

CourseCure Shortcode Inserter – Gutenberg Shortcode Block

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

—

A shortcode can be manually pasted into the field. You can also use the CourseCure icon to view the list of available CourseCure shortcodes and select one from the list.

—

The CourseCure shortcodes option will appear.

—

The shortcodes for each of the Add-ons that have been activated on the site will appear. In the screenshot example below, the Courses, Points, Badges and Quizzes Add-ons are activated.

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

—

The example below shows the Quiz Score shortcode has been selected. The shortcode is displayed in the Preview section and the blue Insert button can be clicked to insert the shortcode into the page.

—

The Quiz Score shortcode has now been inserted into the page. Once the page has been saved, the corresponding information for that shortcode will appear on the live site.

—

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

Back to Top