Affiliate System
Installation
Install the extension via Extensions > My Extensions. After installation, specify a Sales Channel to enable the app for. The default is All Sales Channels.
There are two aspects to the Affiliate System:
- Basic Configuration
- Admin Dashboard
Follow the steps in the section Basic Configuration first, then refer to the section Admin Dashboard for details on how to manage the app on an ongoing basis.
Basic Configuration
Before you enable the app, check the settings in this section and ensure they meet your requirements. Make any changes to individual fields as described below by selecting My extensions > Affiliate System > Configuration.
First specify a Sales Channel to enable the extension for. The default is All Sales Channels.
General properties
The general properties provide basic controls, such as enabling/disabling the extension.
| Field | Type | Description |
|---|---|---|
| Activate plugin | Toggle | Enable this setting to activate the Affiliate System on your store. |
| Partner can change partner code | Dropdown | Specify whether a partner is allowed to change his own partner code by selecting an option from the dropdown menu: • No: the partner code can only be changed by an admin • Yes, code is changed immediately: the new code is applied without further checks • Yes, code needs to be approved by admin: the requested code change has to be approved by an admin before it becomes active. |
Partner registration
The settings in this area are related to configure how customers can register as a partner.
| Field | Type | Description |
|---|---|---|
| New partner needs approval | Toggle | Enable this setting to check a customer before the can start as a partner. |
| Partner must write an application | Toggle | Enable this settings to force your customers writing an application. |
| Partner needs to confirm terms | Toggle | Enable this setting to require a new partner to accept the partner terms during registration. You need to edit the snippet partner-terms in Admin → Snippets and insert a link to your terms. |
| Partner can choose his affiliate code | Toggle | Enable this setting and your customer can choose his own affiliate code. Otherwise a random code will be generated. |
| Required days customer needed | Numerical input | Define number of days a customer needs to be registered before he can become a partner. |
| Required turnover in EUR | Numerical input | Define the number of turnover a customer must have before he can become a partner. |
| Allowed customer groups | Multi select | Choose all customer groups for which the partner registration should be possible. If no group is selected the partner system is not acessible. |
Provision collect
The settings in this area are related to how partner can collect provision.
| Field | Type | Description |
|---|---|---|
| Partner can poach customers from other partner | Toggle | Enable this setting when a customer can be transfered to another partner if they are already assigned to a partner and create a new order by clicking on another affiliate partner link. |
| Lifertime of a partner cookie in days | Numerical input | If a customer clicks on a partner affiliate link a cookie is created. Define the number of days of cookie lifetime. |
| Order provision activation event | Dropdown | Specify how provision is activated activated by selecting an option from the dropdown menu: • Always manual: via admin module |
| Order provision activation condition | Dropdown | Detemine if condition “Order provision activation event” OR “Credit provision n days after ordering” needs to be meet or if it is a AND combination |
| Credit provision n days after ordering | Numerical input | Enter the number of days that must elapse before bonus points are credited. |
| Deduct provision on order canceled | Toggle | Activate this option to automatically deduct any credited provision associated with a cancelled order. |
Provision deduct
| Field | Type | Decriptio |
|---|---|---|
| Deduct provision on delivery state: Returned | Toggle | Activate this option to automatically remove a previously credited provision as soon as the delivery state of the related order is set to Returned. |
| Deduct provision on delivery state: Returned (partially) | Toggle | Activate this option to automatically remove a previously credited provision as soon as the delivery state of the related order is set to Returned (partially). |
Provision redeem
| Field | Type | Description |
|---|---|---|
| Individual voucher code pattern | Text | Define the pattern that is used to generate individual voucher codes when a partner redeems his provision. Each %s is replaced by a random character. The default value %s%s%s%s%s produces a five-character code. |
Technical properties
| Field | Type | Description |
|---|---|---|
| Affiliate link parameter | Text (required) | Specify the URL parameter used inside affiliate links. By default the parameter is partner, so a link looks like https://your-shop.com/?partner=affiliate1001. Please do not change this value if you already have active partners — otherwise existing affiliate links will no longer be valid. |
| Set affiliate cookie as technical required on cookie consent | Toggle | Enable this setting to register the affiliate cookie as a technically required cookie at the cookie consent. If disabled, the affiliate cookie is treated as an optional cookie — visitors who do not accept it will not be assigned to a partner. |