...

...

...

Please use another web browser to view this document.

Sorry for the inconvenience.

...

...

Image Modified                                                                                                                                                       

Magento 2 Refer a Friend extension allows creating effective customer referral programs beneficial for all the sides, including Magento merchants, brand advocates, and newly attracted customers. The module includes multiple configuration and management options both on backend and frontend that make it possible to tailor programs to particular business needs, track and improve certain program aspects making it even more valuable for all the participants.

Compatibility: Magento Open Source 2.3.X - 2.4.X, Magento Commerce 2.3.X - 2.4.X

Product Page

Thank you for choosing Aheadworks!

Installing Refer a Friend

...

...

 4. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder

run the following command: :

php -f bin/magento module:enable  Aheadworks_Raf

then:

php -f bin/magento setup:upgrade

after:

php -f bin/magento setup:static-content:deploy

...

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

...

To install the extension:

2. Login to your ssh console and navigate to your store folder:

...

 3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-raf

if you need to install a specific version, run this command:

composer require aheadworks/module-raf:<version>

...

4. Enable the extension:

php -f bin/magento module:enable <Module_Name>

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

...

To upgrade the extension:

5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

composer update aheadworks/module-raf

composer require aheadworks/module-raf:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Installing ShareThis and AddThis

...

After the extension installation, you can add the AddThis or ShareThis social bookmarking services to your store in order to facilitate the whole process of sharing for your brand advocates.

Set up cron

The Refer a Friend extension uses cron for automatic balance checks and customer notifications.

...

If you have already configured cron jobs for your Magento installation, then you can skip this step. Read the following instructions on setting cron job for your Magento store: Magento user guide.

Generally, it will be enough to run in the SSH console of your server the following command: 

crontab -e

And insert the following line:  

*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento cron:run
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/update/cron.php
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento setup:cron:run

Don't forget to confirm saving request when exit.

Getting Around

...

Business Advantages

The business benefits of the extension are clear and straightforward. It adds new customers and generate more sales, including additional sales made by brand-new customers and purchases from existing ones who act like brand advocates within refer-a-friend programs.

What Makes It Different

In addition to the business advantages brought by the idea of customer referral programs, the module stands out from the bulk of the same solutions with:

• Rewards available for both brand advocates and new customers;
• Integration with AddThis and ShareThis;
• Rules explained in details for brand advocates and Magento staff;
• Statistics available for individual brand advocates and general data tracking for Magento admins;
• GDPR compliance (right to be forgotten).

Refer a Friend Frontend Use

Before to offer your customers to take part in the refer-a-friend program, you need to configure the extension according to your needs and preferences. The whole process is described in the Backend Configuration section below. When the configuration finished all the eligible shoppers are able to participate quite easily.

Refer a Frind Frontend Interface

Following the process workflow, Refer a Friend offers brand advocates the Referral Program section added to their customer accounts so they could track and manage their referral activity.

Image Removed

The section includes:

• Detailed refer-a-friend program term explanations, including discounts granted to new customers and rewards provided to brand advocates;
• Performance statistics, such as the number of invited friends, current reward balance, invitation block, and the checkbox to be notified about new rewards.

In case if a customer leaves the referral group or is excluded from it by Magento admins, the rewards earned can still be applied but the ability to invite new friends is revoked.

Backend Configuration

...

General Configuration

The Configuration section is the first step to take when you start using the Refer a Friend extension. Please enter it following Stores > Configuration > AHEADWORKS EXTENSIONS> Refer a Friend > Configuration.

The section consists of two blocks: General and Email Options. The General block makes it possible to set up general settings of the extension as follows below.

General Settings

Image Removed

• Who Can Invite Friends - determines customer groups eligible to act as brand advocates. There two options you can choose between: a) All Registered Customers and b) Only Registered Customers with Previous Purchases. This way, only registered customers are allowed to invite friends. If the first option is selected, all the registered visitors with or without purchases may participate. The second option allows only customers with orders to enter the program. Additionally, you can determine the type of orders they should have to fit the requirements.
• Order Status - flexibly manipulate with program accessibility for customers with particular order statuses. For example, you can make the program available for the customers who purchased physical products with the 'Processing' status (not yet shipped to them) and for those ones who purchased a virtual item, i.e. the products with the 'Complete' status.
• Customer Groups Which Can Join Referral Program - one more opportunity to shape and finalize the eligible circle of brand advocates is to select them among Magento customer groups. You can do this by using the Customer Groups Which Can Join Referral Program configuration option. This way, the groups that do not participate in the program are not distracted with unnecessary tabs in their customer accounts.

• Order Status to Give a Reward to Advocate - order statuses upon which advocates will receive rewards from the brought friends' purchases.

• Holding period - define whether advocates should get earned rewards instantly or after a particular number of days (specified as a numerical value in this field). It's recommended implementing holding period in order to avoid situations when advocated may get rewards for subsequently canceled orders.

• Maximum RAF Discount Which Can Be Applied to Subtotal, % - the most active brand advocates can earn significant rewards and use them as discounts for their own purchases. So, you can limit its use during the checkout by providing the maximum discount allowed per one order.
• If Unused, Earned Discount Expires in, days - use this configuration option to motivate brand advocates to actively spend their rewards. The expiration date is calculated since the last positive balance update. Hence, it is updated each time a brand advocate attracts a new customer.
• Allow Applying Subsequent Discounts - in case you use other loyalty programs in your store together with the refer-a-friend program, discount application from several programs at once might negatively impact your profit margin. To avoid this, you can limit discount application by disallowing discounts other than refer-a-friend program-related.
• Static Block for Welcome Popup - if you want to facilitate the process of inviting new customers and allow brand advocates to show their attitude towards their friends, you can set up a welcome popup to be displayed for newly attracted visitors. The configuration option makes it possible to determine its content selecting among the Magento static blocks. The popup is not displayed if none of the static blocks are selected.
• Sandbox mode - enable this mode to disable IP validation. Still, it is recommended to use different browsers for testing Advocate and Friend's journeys.

Email Options

Image Removed

Email Options allow you to сonfigure the notification system of the extension.

...

Rules

As soon as the general settings of the extension are configured we can proceed to set refer-a-friend program rules. The main thing is that rules define the rewards earned by brand advocates and the discounts provided for new customers. The Rules section is located along the following path: Marketing > Refer a Friend by Aheadworks > Rules.

Rules Grid

Image Removed

Each refer-a-friend rule is applied to one Magento website. So, in case if you manage one website, the module doesn't display the Rules page and grid. Instead, it redirects your immediately to the rule editing page. But, if you have several websites in one Magento installation, you can create a separate rule for each of them.

The Rules grid contains 4 columns:

• Rule name. A custom rule name implied to distinguish it from other rules;
• Rule Status. The column shows whether the rule is enabled or disabled;
• Website. The website a particular rule is assigned to;
• Action. The column allows you to delete or edit rule right on the spot.

The Rules grid is a Magento 2 grid so it allows you to sort and filter grid attributes, customize its view, etc. On this page, you can also create a new rule using the Add Rule button.

Rule Editing

Image Removed

The rule editing page contains the following configuration options:

• Rule Name. The text field to be filled with a rule name;
• Rule Status. The box allows you to enable or disable the rule;
• Website. The multi-selector to assign the rule to a particular Magento website;
• Apply to Shipping Amount. The toggle switch button that allows you to choose either applying rewards and discounts to shipping charges or not.

Rule Conditions

Rule conditions are provided on the same page in a human-readable form. The conditions of the rule can be changed by clicking on the words highlighted with bold font:

Image Removed

• Customer Registration. Set whether friends registration is mandatory to get the discount on their first purchase. We recommend you to set it mandatory in order to avoid the chance that one customer receives several discounts.
• Friend Discounts. Set the discount amount and choose whether it is fixed or % of its first order (see the image above).
• Brand Advocate Rewards. As in the case with friend discounts, these discounts can be either fixed of %. In the case of a percent discount, it is recommended to set the option "Maximum RAF Discount Which Can Be Applied to Subtotal, %" in the General configuration to a reasonable amount, for example to 15%. In this case, even if an advocate has a lot of friends and earned a huge discount, they will not be able to apply more than 15% at a time.

That's it. The rules are configured. Now their terms are clearly displayed in the customer accounts of brand advocates on the frontend.

Advocates

As soon as the rule configuration is finished, the extension is ready to work and invite new customers. So, the next backend section is mostly intended to provide you with additional options to track and manage the program more consciously.
The Advocates section can be found as follows: Marketing > Refer a Friend by Aheadworks > Advocates.

Advocates Grid

Image Removed

The main page of the section contains the Advocates grid and referral program performance statistics.

The Performance area of the page contains two indicators. Quantity of Orders Made by Friends displays the share of orders made by friends in % out of the total number of orders in the store for last 30 days. Total Amount Made by Friends is the same indicator related to the monetary value of friends' and all website orders.

The Advocates grid comprises the following columns:

• Advocate Name. Contains customer names;
• Email. Contains customer emails;
• Web Site. Displays the web site a customer operates in;
• Invited Friends, Total. Shows the number of invited friends by this particular customer;
• Current Balance. Balances of rewards earned by brand advocates;
• Nearest Expiration Date. Displays the dates of reward expirations.
• Action. Contains active links to Advocate Information pages.

Advocate Information Page

Image Removed

The Advocate Information Page contains two distinct areas: Summary and Transactions History.

Summary

This area allows you to track the performance of individual brand advocates, including their number of invited friends, current reward balances, and nearest expiration dates.

Transactions History

The Transactions History section area shows the history of all transactions in a dedicated grid. The grid contains the following columns:

• Date. Displays the date when the transaction occurred;
• Action. Describes the essentials of the transaction;
• Amount. Displays balance increments or decrements in green and red accordingly;
• Comment for Admin. Comments to the transactions available to admins;
• Reward Balance. The balance available after the transaction.

The same as any Magento grid, this one makes it possible to sort and filter data and customize the view.

The greatest benefit and value brought by this section is that it allows you to manually update particular reward balances. You can use this opportunity in case of order refunds or in order to additionally award particular brand advocates for their prominent achievements. Each such transaction can be accompanied by comments visible to admins only.

Other Features

...

Product Page

Thank you for choosing Aheadworks!

...