Magento 2 Reward Points Manual

reward points mageworx

Introduction

Magento 2 Reward Points allows the store owner to manage customers credit funds so that they can make purchases using the reward points.

These reward points can get added to the customer account balance for completing such actions as placing an order, leaving a review or subscribing for newsletters, as well as assigned on special occasions. Additional conditions can be applied so that the customer gains points only if they are met.

The extension supports different methods of assigning the reward points, such as:

  • fixed number of points;

  • number of points for a specific amount spent;

  • number of points for a specific qty of items;

  • number of points for a specific amount/qty of items starting with a certain amount/qty.

The customers can check their reward points balance on the special tab of their customer account. These points can be easily applied or canceled during the checkout.

Requirements and Installation

Reward Points supports both Community and Enterprise edition of Magento starting from version 2.2. The current version of Magento installed on your website can be found in the lower right corner of any backend page.

Magento 2 Version

Reward Points extension has 2 separate ways of installation: via Composer or by copying the code.

Installation Via Composer

  1. Create a folder anywhere on your server (preferably not in the Magento installation directory). Put the zip archive into this folder.

  2. Use any SSH client to connect to your server. Navigate to the root Magento folder. Bear in mind that the user should write permissions to this folder and its subfolders.

  3. Add the folder with the extension's archive as a repository. For this, run the Composer command:

    composer config repositories.mageworx artifact {/ABSOLUTE/PATH/TO/FOLDER}
    

    like

    composer config repositories.mageworx artifact /mageworx/extensions/zip
    

    This command will add these lines to your composer.json file

    "mageworx": {
        "type": "artifact",
        "url": "/mageworx/extensions/zip"
    }
    
  4. Perform the command:

    composer require mageworx/module-rewardpointsmeta
    
  5. Clear the compiled code and the cache:

    php bin/magento setup:upgrade
    php bin/magento cache:flush
    php bin/magento setup:static-content:deploy
    
  6. To update the extension via composer perform the command:

    composer update mageworx/module-rewardpointsmeta
    

Installation by copying the code

  1. Download the extension's package from your customer account, unzip it.

  2. Use any SSH client to connect to your server. Bear in mind that the user should write permissions to this folder and its subfolders.

  3. Upload all the files and folders from the extension's package to the root Magento folder.

  4. Via SSH, navigate to the root Magento folder and perform the command:

    php bin/magento module:enable MageWorx_RewardPoints
    
  5. Clear the compiled code and cache:

    php bin/magento setup:upgrade
    php bin/magento cache:flush
    php bin/magento setup:static-content:deploy
    

Extension Configuration

Backend Setup

Log into the Magento Admin panel and go to STORES ⟶ Configuration ⟶ MAGEWORX ⟶ Reward Points. The extension configuration has 2 tabs: Main Settings and Email Settings.


Main Settings


reward points mageworx

The Enable setting provides the possibility to temporary disable/re-enable the extension functionality from the backend.

Static Block for "My Reward Points" Section sets a selected static block to be shown at My Reward Points tab in the customer’s account. It supports all the blocks that are shown on the CONTENT ⟶ Elements ⟶ Blocks grid.

Cover with the points allows applying credits to an order’s subtotal and/or shipping and/or tax. The system analyses this selection and applies credits to what is chosen. For example, if the store owner doesn't want to allow customers to pay shipping costs using credits, you need to remove the selection ‘Shipping & Handling’. Thus, customers will need to pay for shipping using other payment methods.

Points Exchange Rate provides the possibility to change the cost of 1 Reward Point in the Website Base Currency.

Assign to Customer Groups sets customer credit functionality to the selected customer groups. If not selected, the customers won’t be able to use internal credits.

If the Annul the received points upon the full order refund is enabled, the reward points will be removed from the customer account in case they were applied for the order that was refunded afterward.

The Time of Day for Birthday Greetings specifies the time when the reward points will be added in case it's the customer's birthday.


Email Settings


reward points mageworx

The Email Sender configuration provides the possibility to select the desired sender of the emails that the customer receives when the reward points are added to the account. These emails can be modified in STORES ⟶ Configuration ⟶ GENERAL ⟶ Store Email Addresses

Store Email Addresses

Templates provide the possibility to change the default email templates. For this, go to MARKETING ⟶ Communications ⟶ Email Templates

reward points mageworx

Click the Add New Template button.

reward points mageworx

In the Template dropdown, select the desired template and click the Load Template button. Edit the Template Content and preview the changes by the Preview Template button at the top of the page. Once the template is saved, it will be visible in the Templates Dropdown.

reward points mageworx

Reward Points Rules

To add, delete or modify the Reward Points rules, log into the Magento Admin panel and go to MARKETING ⟶ MageWorx Reward Points ⟶ Rules.

reward points mageworx

Please note that during the initial setup this grid will be empty.

To create a new reward points rule click the Add New Rule button.

The rule configuration consists of 4 sections.

Rule Information

reward points mageworx

Rule Name is the name of the rule. It will be visible in the back-end.

The Description field provides the possibility to add the rule decription. It will be visible only in the back-end.

The store owner can temporarily disable or re-enable the rule using the Active toggle.

The Websites setting specifies the website where the rule should be applied to.

The Customer Groups configuration allows applying the rule to the specific customer groups only.

The store owner can restrict the usage of the rule by date intervals using the From and To date pickers.

If several rules can be applied and their priority needs to be handled, it can be managed by the Priority setting. The bigger the value, the higher the rule will be in the order of priority.

If Allow Notification is enabled, then the email will be sent to the customer when the reward points are added to the balance.

Personal Email Template adds the possibility to use the template that meets exactly this particular rule. If the Use Config setting is selected, the one in the extension configuration will be picked.


Actions

reward points mageworx

The extension supports several events, such as placing an order, leaving a review, subscribing for newsletters or in case of the client's birthday. The last 3 settings provide the possibility to add the X Points when the condition is met. The order placing configuration is more complicated and needs to be explained.

Placed Order

reward points mageworx

If the Placed Order event is selected, the Give Points setting shows. It can be further configured depending on the desired condition.

  1. The Get X Points setting allows adding the specific (X) number of reward points to any order.

  2. The Get X Points for every Y spent adds the specific (X) number of reward points to the order that is bigger than Y threshold.
    So, for instance, the X is set to 10 and Y to 50.

    Grand Total Reward Points
    $49 0
    $52 10
    $99 10
    $101 20

    If the grand total is $49, then the customer doesn't receive any reward points, for the grand total $52 the customer receives 10 reward points. The customer gets 10 points as well if the grand total is $99. For $101, the customer receives 20 reward points, and so on.

  3. The Get X Points for every Y spent starting from Z spent adds the specific (X) number of reward points to the order that is bigger than Z threshold for every Y sum.
    So, for instance, the X is set to 10, Y to 20 and Z to 100.

    Grand Total Reward Points
    $99 0
    $119 0
    $139 10
    $141 20

    If the grand total is $99, then the customer won't receive the reward points as it is smaller than Z ($100). If the total is $119, then the customer won't receive the reward points as well, because 10 points are added for every $20 starting from $100 and $119 is less then $120. If the total is $139, then 10 reward points will be added to the account. 20 reward points will be added for the $141 grand total, and so on.

  4. The Get X Points for every Y quantity adds the specific (X) number of reward points to the order that has more than Y products in sum.
    So, for instance, the X is set to 10 and Y to 5.

    T-shirts Quantity Bags Quantity Pencils Quantity Total Quantity Reward Points
    3 1 0 3+1=4 0
    5 4 0 5+4=9 10
    7 3 1 7+3+1=11 20

    If the customer buys 3 T-shirts and 1 bag, then no reward points will be added as the total quantity 4 is less than Y. If the customer buys 5 T-shirts and 4 bags, then 10 reward points will be added (total quantity is 9). For the order with 7 T-shirts, 3 bags and one pencil 20 points will be added (total quantity is 11).

  5. The Get X Points for every Y quantity starting from Z quantity adds the specific (X) number of reward points to the order that has more products than Z threshold for every Y products.
    So, for instance, the X is set to 10, Y to 5 and Z to 10.

    T-shirts Quantity Bags Quantity Pencils Quantity Total Quantity Reward Points
    4 5 0 4+5=9 0
    4 5 5 4+5+5=14 0
    4 4 8 4+4+8=16 10
    7 9 5 7+9+5=21 20

    If the customer buys 4 T-shirts and 5 bags, then no reward points will be added as the total quantity 9 is less than Z (10). If the customer buys 4 T-shirts, 5 bags and 5 pencils, then the customer won't receive the reward points as well, because 10 points are added for every 5 products starting from 10 and the total quantity (14) is less than 15. If the customer purchases 16 products in total, then 10 reward points will be added to the account. 20 reward points will be added for the 21 products in total, and so on.

The Placed order event shows the additional field, the Calculation Type so that the quantity of reward points can be calculated as the fixed value or as the percent of the grand total.

The last, Discard subsequent rules configuration stops any other reward points rules from being processed in case several rules conditions are met.

Conditions

reward points mageworx

The statement has two bold links (ALL and TRUE - see above), which, when clicked on, suggest the list of options for the chosen statement part.

Tap the ALL link, to choose between ALL or ANY.

Tap the TRUE link and choose either TRUE or FALSE.

If you save the condition without making additional selections, the rule applies to all products.

Tap the Add button at the beginning of the next line and select the desired part

reward points mageworx

The selected condition appears in the statement, followed by two more bold links.

reward points mageworx

Click is to select the desired condition and the ellipsis (three dots) to specify the end of the condition.

To add another line to the statement, tap the Add button one more time and repeat the process until the condition is complete.

If at any time you want to delete a part of the statement, tap the Delete button at the end of the line.

Blank Condition Section

Some conditions can be left blank. Mageworx Option Template Custom Options This makes the whole condition false.

Labels

reward points mageworx

The Labels Section is designed for different frontend names of the reward points rule on different store views. Some rules may need to be translated and, for this matter, this section allows specifying the appropriate name. Please note that if the string is empty, the Default Rule Label for All Store Views will be used.

Backend Experience

The extension is implemented into the base Magento backend workspaces extending the standard functionality.

Order Page and Credit Memo

If the customer purchases some products using the reward points, this information is available on the order totals block.

reward points mageworx

This feature provides the possibility to detect whether the reward points were used for this order or not.

If the store owner wishes to give the reward points back for the refunded order where the points had been used, it can be done on the refund totals block on the credit memo page.

reward points mageworx

The max value for the refunded reward points equals the quantity of the points spent when this order was made.

Customer Information

The customer reward points are shown on the special Reward Points tab on the customer information page.

reward points mageworx

The workspace consists of three tabs.

Reward Points Balance

reward points mageworx

This tab shows the grid with the customer's reward point balance on any website within one Magento installation.

Update Reward Points Balance

reward points mageworx

This tab provides the possibility to manually add or subtract the reward points.

The Store configuration provides the possibility to add the points to the customer on the specific store view.

The Update Points supports both positive (to add) and negative (to subtract) values.

If the Send Notification is set to Yes, the customer receives the email with the default email template.

The Comment for Customer allows the store owner to write some particular text for the customer to be visible in the customer account.

Reward Points Transaction

reward points mageworx

This tab shows the grid with the customer's reward points transactions history.

Frontend Experience

The extension is implemented into the base Magento frontend workspaces extending the standard functionality.

Customer Account

The customer reward points are shown on the special Reward Points tab on the customer information page.

reward points mageworx

Here, the customer can observe the exact quantity of the reward points and the reward point transactions history. The comment for сustomer from the backend is shown in the Message column.

Checkout

reward points mageworx

The extension shows the Reward Points block on the checkout with the possibility to apply them to get the discount.

reward points mageworx

The customer can cancel the usage of the reward points usage if necessary.

If the customer doesn't have any reward points at all, this block will be hidden.

Got Questions?

MageWorx offers FREE lifetime support and updates for any extension developed for Magento. Need help with the extensions? Feel free to submit a ticket from http://www.mageworx.com/support/

MageWorx offers outstanding services developing custom-tailored solutions for Magento platform to attain your eCommerce objectives. Our professional impassioned team provides profound and custom oriented development of your project in a short timeframe.