Points and Rewards Systems

This documentation is for the WooRewards plugin

Points and Rewards Systems are the main feature of WooRewards. They allow users to earn points when performing various actions. As a result, they can unlock rewards with their points.

If you want to understand how points and rewards systems work or how you can Combine them, look at the following documentation :

• Points and Rewards Systems
• Combining Systems

In this section, we will see how to create a points and rewards system and what are the options available.

Points and Rewards Systems List

Go to WooRewards → Points and Rewards. As a result, you’ll see a list with your existing points and rewards systems.

List Columns

The list displays the following columns :

• Points and Rewards System : shows your Points and Rewards system’s title. You may click on the name to edit the Points and Rewards system.
• Status : shows the current status that can be :
  • OFF : the system is off, it will not deliver any points or let user chose any reward.
  • ON : the system is on, it will deliver points and user may get their reward.
  • SCHEDULED : the system will start later, no points available, no rewards available.
  • RUNNING : the system has started, points available, rewards available.
  • ENDED – REWARDS AVAILABLE : the system stopped giving points, but customers may still get their rewards.
  • ENDED : the system is now OFF, no more points available, no more rewards available.
• Event Dates : For event Points and Rewards systems, this will show you the start date and the end date of the event
• Type : shows the Points and Rewards type. This may be :
  • STANDARD : points will be used to unlock rewards, or used on Points on Cart to pay carts.
  • LEVELING : points will continuously be added, to reach some level floors. Each level floor will unlock specified rewards but points will remain.
• Shortcode Attribute : shows you a code used for shortcodes. When the shortcode description asks you to set the “system” key’s name, it refers to this information. To help you copy it, you have the copy button : Click on it and you will be able to paste it to the right place.
• Points Reserve : shows you the Points Reserve name. Combining multiple Points and Rewards system will require that they share the same Points Reserve. When it is the case, here you will see them on same color, same name.
• Action : click on the “…” to pop up a menu that can have following entries :
  • Edit : lets you enter the system to edit all system’s settings.
  • Turn ON : only available if the system’s status is OFF, lets you turn the system to ON without entering the settings.
  • Turn OFF : only available if the system’s status is ON, lets you turn the system to OFF without entering the settings.
  • Copy : lets you copy the system. It will open a new window, removing the system’s title, and setting it by default to status OFF. All other settings will remain from original one.
  • Delete : lets you delete a system. There will be a pop up to let you confirm “Do you really want to delete the line” where, if you confirm, will definitively remove the system’s line.

Filters

When you have several systems running, you may use filters to find the one you(re looking for. Choices are set on statuses. By default, it is set to “All”, but if you click on “On”, you will only see Points and Rewards systems that have their status to “ON”.

Add a new Points and Rewards System

On the bottom of the screen, you will see these two button:

• ADD A STANDARD POINTS AND REWARDS SYSTEM : will create a new Standard Points and Rewards System. This will consume points to unlock rewards
• ADD A LEVELING POINTS AND REWARDS SYSTEM : will create a new Leveling Points and Rewards System. This will let you set Levels and set rewards to each levels.

 

Points and Rewards Systems screen

When you create a new Points and Rewards System, you will see 6 different groups :

• Points
• Rewards
• General Settings
• Points Expiration
• Points Currency
• Advanced Settings

We’ll look at the different groups available and explain what you can do with the different options.

 

Points

Use this section to define what actions users or customers have to perform in order to earn points in this points and rewards system.

You can define as many actions as you want by clicking the ‘Add’ button. You will see a popup presenting all available options. Select the one you want and click on the Next button.

Here are the links to each available points actions :

• Spend Money
• Place a first order
• Place an order
• Buy a Product
• Buy in a Category
• Product Review
• User Registration
• Recurrent Visit
• Post a Comment
• Publish a Post
• Click an Image
• Visit a Post, Page or URL
• Send a Sponsorship Email
• Sponsored User Registration
• Share on Social Networks
• Sponsored Spends Money
• Sponsored Places an Order
• Visitor Clicks a Social Share
• Birthday
• Registration Anniversary
• Receive Badges
• Become WooVIP Member
• Lose WooVIP Membership

Some of the Points Action listed may require the WooVIP plugin.

 

Rewards and Levels

Standard Points and Rewards systems

In a Standard Points and Rewards system, you have to choose how customers will spend their points. They can either spend them directly on the cart to get an immediate discount or you can setup various rewards they buy with their points.

 

Points on cart

If you set the reward type to points on cart, you’ll have access to the following options :

• Point Value in € : Each point spent on the cart will decrease the order total of that value. The € symbol here is the current site currency symbol, you may see your own on your settings.
• Max percentage of cart : The maximum amount a customer can spend in a single cart will be limited to the percentage of the payable total. Leave blank for no limit or set it to 100.
• Lower Cart Limit : If set, customers can’t use their points to discount the cart below that limit. Leave empty for no limit.
• Minimum Cart Amount : Set a minimum cart amount under which customers can’t use their points on the cart. Once the cart total is above that value, customers will be able to use their points. Leave empty for no minimum.

Read more about the required settings to display the Points on Cart tool clicking this link.

 

Automatic Rewards Redeem

If you don’t use the points on cart feature, you’ll see the Automatic Rewards Redeem option. On a standard points and rewards system, users have to manually unlock the rewards by spending their points. With this option, you can change that behavior. Select one of the 4 options :

• Off : Default value. Rewards need to be redeemed manually.
• Unlock best reward only : Automatic reward redeem. When customers earn points, this will unlock the most expensive reward available with the user’s points.
• Unlock best reward first : Automatic reward redeem. When customers earn points, this will unlock the most expensive reward available with the user’s points. If the user still has enough points to unlock another rewards, it will unlock other rewards until the user doesn’t have enough points to unlock a reward.
• Unlock best reward and reset points : Automatic reward redeem. When customers earn points, this will unlock the most expensive reward available with the user’s points. The remaining user’s points are lost and the points total is set to 0.

 

Rewards

After setting the redeem option, you can add the different rewards. You’ll get more information about that in the next section of the documentation.

 

Leveling Points and Rewards systems

In a Leveling Points and Rewards system, you must create levels first. After creating a level, you can add one or more rewards to the level. You will get access to the following options

• Level Title : Give a title to the level.
• Points Threshold : Set the points amount required to unlock this level.
• Level Validation button : click this button to register the level.
• Add : Once the level registered, click on this Add button to add rewards attached to this level. Remember, each level unlocks ALL rewards set inside the level, without removing any points. See available rewards in the next section.
• + Add level : once all rewards set, you will need to add more levels.

You can define as many levels and rewards as you want

 

Available Rewards

Here are the links to each available rewards :
Some rewards are not available on both options Standard and Leveling
Available rewards for Standard and Leveling :

• Fixed Discount Coupon
• Percentage Discount Coupon
• Free Product coupon
• Free Shipping coupon
• Assign a Badge
• Assign a Role
• Generate Points
• User Title
• Fixed Amount of Wallet Money → Requires WooVirtualWallet in currency mode
• Fixed Amount of Wallet Gems → Requires WooVirtualWallet in gem mode
• Grant WooVIP membership → Requires WooVIP
• Custom Reward

Available rewards for Standard only

• Variable Discount Coupon
• Automatic Amount of Wallet Money → Requires WooVirtualWallet in currency mode
• Automatic Amount of Wallet Gems → Requires WooVirtualWallet in gem mode

 

General Settings

The General Settings group lets you enable or disable the system. In addition, it lets you turn your system into an event.

• Status : enables you to turn the system ON / OFF
• Title : set the Points and Rewards System title.
• System Type : enables you to turn the system from Permanent to Event

Turning the System Type into Event will add new fields on the screen :

• Start date : Before that date, the points and rewards system is disabled but customer can see it.
• Point earning end : After that date, customers can no longer earn points. But they still can spend them for rewards.
• End date : After that date, the points and rewards system will be disabled but customer can see it. Customers keep their remaining points but cannot use them anymore.

 

Points Expiration

For each points and rewards system you create, you can set an expiration for the points. In this section, we’ll see the different points expiration possibilities. Finally, we’ll see how it impacts leveling points and rewards systems.

 

Expiration for inactivity

If you use this method, customers will lose their points if they have no loyalty activity for a set period of time.

To enable the expiration, check the box and set the period of inactivity after which the points will expire. The following rules will apply :

• Every time a customer earns or spends points, he is counted as active and the period resets.
• If the customer has absolutely no activity for the set period, he will lose all his points.

 

Transactional expiration

If you enable this method, customers will lose their points if they don’t use them within a certain period of time.
You can compare this method to a first in → first out stock management rule. Customers always spend their oldest points and will lose them if they didn’t use them in time.
To enable the expiration, check the box and set the period after which the points will expire. The following rules will apply :

• Customers only lose the points they haven’t used during the period.
• For this method to work, you mustn’t set the date field which is used for the periodical expiration.

 

 

Periodical Expiration

If you enable this method, customers will lose unused points periodically. To enable the expiration, check the box and set the period after which the points will expire and the starting date.

 

The following rules will apply :

• Customers only lose the points they haven’t used during the previous period.
• For this method to work, you must set a value in the date field.

 

 

Points Currency

For each points and rewards system you create, you can set your own currency. In this section, we’ll see the different options to create and display your points currency on the website.

Set the following values :

• Point display name : The word that will replace “Point” for front-end display. If you don’t use the plural option, this is the word that customers will see for both singular and plural.
• Point display name (plural) : If you want to have a different name for singular and plural forms, you can specify the plural name here.
• Point symbol : If you want to use an image instead of a word, you can select an image here. The image should be small (max height : 25px).
• Point name position : Defines if you want the point name or symbol to be placed before or after the number.
• Thousand Separator : If customers have more than 1000 points, this character will be used as a thousand separator.

If you set a Point symbol, it will replace the values set on Point display name options.
 

Advanced Settings

For each points and rewards system you create, you can setup a special behavior by using the advanced settings group. In this section, we’ll see the different options you can use to change the system’s behavior.

 

Standard Points and Rewards Systems

 

Let’s review the different options at your disposal.

Points Reserve

Every time you create a new points and rewards system, it will by default use its own points reserve. Users will earn points in that reserve and be able to use these points to unlock rewards in this points and rewards program.

However, you can also share a points reserve between different systems. This is further explain in our 11.2 – Combining Systems documentation.

Select the points reserve you want to use in the dropdown list. Below each reserve, you’ll see which points and rewards systems are currently using it.

Allowed Roles

You can restrict the access to your points and rewards system to a set list of user roles. If you select at least one role, all users who don’t have that role won’t be able to earn and spend points in that system.

Denied Roles

Like for the previous option, you can select user roles in that option. However, unlike the previous option, users with at least one of the selected roles won’t have access to the system.

 

Leveling Points and Rewards Systems

Let’s review the different options at your disposal.

Points Reserve

Every time you create a new points and rewards system, it will by default use its own points reserve. Users will earn points in that reserve and be able to use these points to unlock rewards in this points and rewards program.

However, you can also share a points reserve between different systems. This is further explain in our 11.2 – Combining Systems documentation.

Select the points reserve you want to use in the dropdown list. Below each reserve, you’ll see which points and rewards systems are currently using it.

Allowed Roles

You can restrict the access to your points and rewards system to a set list of user roles. If you select at least one role, all users who don’t have that role won’t be able to earn and spend points in that system.

Denied Roles

Like for the previous option, you can select user roles in that option. However, unlike the previous option, users with at least one of the selected roles won’t have access to the system.

Lose rewards with points expiration

If you’ve set up points expiration you can decide to revoke the levels and the associated rewards (roles, titles, permanent discounts) when points expire with this option.

One level at a time

If set, customers can’t earn more than one level each time they earn points. Points will be added up to that level and all excess points will be lost.

Unlock Best Level Only

On a leveling points and rewards system, users have to manually unlock the rewards by spending their points. With this option, you can change that behavior. Select one of the 2 options :

• Off : Default value. Users will unlock all levels and their rewards, even if they earn enough points to progress through multiple levels at a time.
• On : Users will only unlock the best level reached when earning points. If they earn enough points to progress through multiple levels at a time, they will only unlock the higher level and its rewards.