MexBS Additional Promotions v1.0.0 User Guide

Welcome to the MexBs family, and thank you for purchasing the "Additonal

Promotions v1.0.0" magento extension! In this document we will guide you through

the installation steps, and will show you how to use and get the maximum from your

extension.

Installation

Before we begin, please ensure that you have a backup of your data before proceeding

with the installation of the extension. This is because although we will make our best

to support you, we cannot take responsibility of any data loss that might occur during

the installation/adjustments of this extension.

[ 1 ] Unpack the Mexbs_AdditonalPromotions_v1.0.0.zip file.

[ 2 ] Go to Mexbs_ AdditonalPromotions _v1.0.0/extension_files.

Copy the content of this directory into your Magento installation directory.

[ 3 ] Connect via SSH and go to your Magento root directory

[ 4 ] Determine the mode that your Magento is running on, by running the following

command:

php bin/magento deploy:mode:show

[ 5 ] If you are in developer or default mode, run the following commands:

php bin/magento module:enable Mexbs_AdditionalPromotions --clear-static-content

php bin/magento setup:upgrade

php bin/magento setup:static-content:deploy

[ 6 ] If you are in production mode, run the following commands:

php bin/magento module:enable Mexbs_ AdditonalPromotions --clear-static-content

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

[ 7 ] Go to the admin panel – “System->Cache Management” and click “Flush

Magento Cache”.

Getting Started Before explaining every promotion and feature of the extension in detail (we will get

to it soon), let’s create a simple promotion together (1+1 on all bags), just to get the

basic “feeling” of how the extension works.

Promotion Creation Tutorial – 1+1 on all bags

In this tutorial we will create a promotion “1+1 on all bags” with coupon code

1plus1bags, that is the customer will get 1+1 on all products from category “bags”

after applying the coupon code 1plus1bags.

Step 1: creating the rule

1) Go to the Admin panel Marketing Cart Price Rules, and click “Add New

Rule”.

2) In the Rule Information tab, insert the following:

Rule name: 1+1 on all bags

Active: Yes

Websites: The websites which you want your coupon to be active in.

Customer Groups: The customer groups which you want your coupon to be

active for.

Coupon: Specific Coupon

Coupon code: 1plus1bags

3) In the Actions tab, in the Apply drop down, choose “Percent Discount”, under “N

+ M / Each N”, and wait until the “Please wait” message disappears.

4) After the loading is finished, you should see the following –

Fill in the data like the following –

Explanation:

- Since we want 1+1 on bags, we filled in “Buy 1 items” and we filled in “Get the

subsequent 1 items”.

- Since we want the second item (in 1+1) to be free, we fill in “with 100% discount”. (if for example instead of 1+1 we’d like to make “buy one bag, get the second with

50% discount”, we would fill in 50 instead of 100)

- We chose “ordered by most expensive“ because we want the 1+1 to start from the

most expensive bag, ie the customer will purchase the most expensive bag for full

price, and he will get the next cheaper bag for free, and so on.

- We leave “after … such items has been added” empty because we want the

promotion to start from the first bag.

(if for example we would like to enforce the customer to buy 3 most expensive bags

for full price and only then get the 1+1 promotion on the subsequent bags, we would

fill in 3 instead of leaving it empty)

5) Save the rule by clicking the “Save” button.

Step 2: testing the rule

1) Go to the front end of your site and add two bags to cart.

2) Go to the cart page and apply the coupon code 1plus1bags. You should get a

discount of the cost of the cheapest product between the two.

For example:

That’s it! You’ve got the “Buy bag, get watch” coupon all set up.

In the next sections of this manual we will explain and give an example for each one

of the new promotion types.

Afterwards we will explain how to use the new condition types (customer attribute,

customer order history and customer order subselection).

Afterwards we will explain how and where you can use custom option values in the

rule.

And finally we will explain about additional extension features and configurations –

discount breakdown types and ability to skip tier and special prices.

Promotion types explained

Discount Steps

Fields explanation

- For products, for which ALL of the following conditions are TRUE – the

condition on items in cart, for which the discount steps will apply. - First … items with …% discount – the first discount step. In “First … items”,

you fill the amount of items and in “with …% discount” you define which

discount percent will be applied on those items. - Next … items with …% discount – the next discount step. In “Next … items”,

you fill the amount of items and in “with …% discount” you define which

discount percent will be applied on those items. - After … such items have been added to cart for full price – the amount of

items that must be added to cart for full price, before the discount steps will

apply.

- Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion - Products ordered by – the product order by which the promotion will work.

Ie if the order is “cheapest” then the promotion will start applying the discount

steps from the cheapest product in cart.

Discount Steps – Percent Discount

Example

The rule in this example is – “Pay full price on the most expensive bag in cart and get

the next 2 bags with 10% discount and the next 3 bags with 20% discount”

Note: In our example, bag is any product that belongs to category 4.

Cart examples for this rule:

- Customer has 1 bag (10$) and 1 bag (20$) in cart. The discount amount is 1$.

(The most expensive bag (20$) was purchased for full price, the next one

(10$) got a discount of 10%. - Customer has 2 bags (10$ each), 3 bags (20$ each) and 2 bags (40$ each) in

cart. The discount amount is 16$. (The most expensive bag (40$) was

purchased for full price, next 40$ and 20$ bag got a discount of 10%, and next

2 20$ bags and 1 10$ bag got a discount of 20%).

Discount Steps – Fixed Discount

Example

The rule in this example is – “First 5 cheapest red or green products in cart get 2$

discount each, next 5 red or green products get 3$ discount each”

Cart examples for this rule:

- Customer has 3 red items and 8 green items. The discount amount is 25$. - Customer has 4 green items in cart. The discount amount is 8$.

Discount Steps – Fixed Price

Example

The rule in this example is – “Get the 4

th most expensive watch in cart for 20$”.

Maximum discount amount is 30$.

Note: In our example, watch is any product that belongs to category 6.

Cart examples for this rule:

- Customer has 2 watches (20$ each), 1 watch (30$) and 3 watches (40$) in cart.

The discount amount is 10$. (The 4th

most expensive watch (30$) was

purchased for 20$).

Get Y$ For Each X$ Spent

Fields explanation

- Get … $ for each … $ spent – number of store currency units (in our example

it’s dollars) that the customer will get per number of store currency units that

he will spend. - Up to … – maximum number of items that the rule can be applied to. - Cheapest (most expensive) items – the order of items by which the

promotion will be applied. - Items for which ALL of the following conditions are TRUE – the condition

on items in cart, for which the rule will apply. - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

Get Y$ For Each X$ Spent

Example

The rule in this example is – “Get 2$ for each 3$ spent on bags”. Maximum discount

amount is 10$.

Note: In our example, bag is any product that belongs to category 4.

Cart examples for this rule:

- Customer has 2 bags (10$ each) and 3 bags (23$) each in cart. The discount is

10$. (The total value of the bags in cart is 89$, if we get 2$ on each 3$ spent,

we get 58$, but since the “Maximum Discount Amount” is 10$, the discount

amount is 10$ and not 58$) - Customer has 1 bag (12$) in cart. The discount amount is 8$.

Get Y$ For Each X$ Spent – up to N items

Example

The rule in this example is – “Get 1$ for each 4$ spent on first 5 cheapest yellow

items in cart”

Cart examples for this rule:

- Customer has 3 yellow items (7$ each) in cart. The discount is 5$. - Customer has 2 yellow items (5$ each) and 4 yellow items (11$ each). The

discount is 10$. (The rule is applied on the first 5 cheapest yellow items)

BOGO: Buy X Get Different Y

Fields explanation

- Buy … items – number of X items that the customer needs to buy in order to

get the discount on Y items. - Items for which ALL of the following conditions are TRUE [top] – the

condition that defines the X items. - Get the … first – number of Y items that the customer gets discounted per X

items.

- First cheapest / most expensive items – the order of items by which the

discount is getting applied on the Y items. - Items for which ALL of the following conditions are TRUE [bottom] – the

condition that defines the Y items. - With …% discount – the discount percent that will be applied on the Y items. - Maximum Qty Discount is Applied To – maximum total quantity of Y items

that the discount can be applied to. - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

Important - the X items should be different than the Y items, that is, their conditions

shouldn’t collide.

BOGO: Buy X Get Different Y – Percent Discount

Example

The rule in this example is – “Buy a bag, get a watch for free”. The maximum

discount qty is 2, that is, the customer can get up to 2 free watches per order. The

items order type is “cheapest”, that is, the watches in cart will be discounted in the

order from cheapest to most expensive.

Note: In our example, bag is any product that belongs to category 4 and watch is any

product that belongs to category 6.

Cart examples for this rule:

- Customer has 1 bag and 1 watch (20$) in cart. The discount amount is 20$. - Customer has 3 bags, 1 watch (15$) and 2 watches (25$ each) in cart. The

discount is 40$. (Since the customer has 3 bags in cart, he can get up to 3

watches for free, but since the “Maximum Qty Discount is Applied To” is 2,

he gets only the two cheapest watches (15$ and 25$) for free)

BOGO: Buy X Get Different Y – Fixed Discount

Example

The rule in this example is – “Buy 2 T-Shirts, get pants with 10$ discount”. The

maximum discount quantity is 1, that is, the customer can get the 10$ discount only

one time per order.

Note: In our example, T-Shirt is any product that belongs to category 16 and pant is

any product that belongs to category 18.

Cart examples for this rule:

- Customer has 5 T-shirts and 3 pants in cart. The discount amount is 10$.

(Since the customer has 5 T-shirts, he can get the discount on up to 2 shorts,

but since the “Maximum Qty Discount is Applied To” is 1, he can only get the

discount on 1 short).

BOGO: Buy X Get Different Y – Fixed Price

Example

The rule in this example is – “Buy 2 red or green items, get 2 yellow items for 1$

each”. The maximum discount qty is 4 and the items order type is “most expensive”, that is the promotion can be applied on maximum 4 most expensive yellow items in

cart. Maximum discount amount is 10$.

Cart examples for this rule:

- Customer has 4 red items, 4 green items, 1 yellow item (3$), 2 yellow items

(4$) and 2 yellow items (5$) in cart. The discount amount is 8$. (Since the

customer has 4 red and 4 green items, he can get up 4 yellow items for 1$, but

since the “Maximum discount amount” is 10$, he only gets the first 2 most

expensive yellow items for 1$) - Customer has 6 red items, 7 green items and 5 yellow items (2$ each) in cart.

The discount amount is 4$. (Since the customer has 6 red and 7 green items,

he can get up two 6 yellow items for 1$, but since the “Maximum Qty

Discount is Applied To” is 4, he only gets the first 4 most expensive yellow

items for 1$)

Extended BOGO: Buy A + B + C Get Different D

Fields explanation

- Buy … sets – number of sets (A + B + C) of items that the customer needs to

buy in order to get the discount on D items. - Part#1: … items – number of items in part#1 (A) - Part#2: … items – number of items in part#2 (B) - Part#3: … items – number of items in part#3 (C) - Items for which ALL of the following conditions are TRUE [parts] – the

condition that defines the items of the specific part. - Get the … first – number of D items that the customer gets discounted per

number of sets (A + B + C) of items.

- First cheapest / most expensive items – the order of items by which the

discount is getting applied on the D items. - Items for which ALL of the following conditions are TRUE [bottom] – the

condition that defines the D items. - With …% discount – the discount percent that will be applied on the D items. - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

Important - the A, B, C, D items should be different, that is, their conditions

shouldn’t collide.

Extended BOGO: Buy A + B + C Get Different D – Percent Discount

Example

The rule in this example is – “Buy 2 T-shirts and a pant, get a short for free”. The

items order type is “cheapest”, that is, the shorts in cart will be discounted in the order

from cheapest to most expensive.

Note: In our example, T-Shirt is any product that belongs to category 16, pant is any

product that belongs to category 18 and short is any product that belongs to category

19.

Cart examples for this rule:

- Customer has 2 T-shirts, pant, 1 short (10$) and 1 short (20$). The discount

amount is 10$.

Extended BOGO: Buy A + B + C Get Different D – Fixed Discount

Rule Example

The rule in this example is – “For each 2 sets of 1 red, 1 green and 1 blue items, get 1

purple item with 2$ discount”. Maximum discount amount is 6$.

Cart examples for this rule:

- Customer has 2 red, 2 green, 2 blue items and 1 purple item in cart. The

discount amount is 2$. - Customer has 3 red, 3 green, 3 blue items and 5 purple items in cart. The

discount amount is 2$. - Customer has 10 red, 10 green, 10 blue items and 5 purple items in cart. The

discount amount is 6$. (The discount amount here is getting limited by

“Maximum discount amount” of 6$)

Extended BOGO: Buy A + B + C Get Different D – Fixed Price

Rule Example

The rule in this example is – “Buy a bag and 2 pieces of fitness equipment, get a

watch for 10$”.

Note: In our example, bag is any product that belongs to category 4, fitness equipment

and watch is any product that belongs to category 5 any product that belongs to

category 6.

Cart examples for this rule:

- Customer has 1 bag, 4 pieces of fitness equipment in cart and two watches –

watch #1 (30$) and watch #2 (40$). The discount amount is 20$. (The

customer got the cheapest watch in cart for 10$) - Customer has 2 bags, 4 pieces of fitness equipment in cart and a watch (40$).

The discount amount is 30$.

Bundle: Buy A + B + C + D for …

Fields explanation

- Get the set of items consisting of the following parts, with … % discount –

the discount percent that one will get for the A + B + C set. - Part#1: … items – number of items in part#1 (A) - Part#2: … items – number of items in part#2 (B) - Part#3: … items – number of items in part#3 (C) - Items for which ALL of the following conditions are TRUE [parts] – the

condition that defines the items of the specific part. - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion - Products ordered by (cheapest / most expensive) – the items order by which

the promotion discount will get applied - Maximum number of sets – the maximum number of sets that the discount

will be applied on.

Important - the A, B, C items should be different, that is, their conditions shouldn’t collide.

Bundle: Buy A + B + C + D for … – Percent Discount

Rule Example

The rule in this example is – “10% discount on buying 2 T-shirts and 1 pant”. Maximum number of discounted sets per order is 3.

Note: In our example, T-Shirt is any product that belongs to category 16 and pant is

any product that belongs to category 18.

Cart examples for this rule:

- Customer has 1 T-shirt (10$), 2 T-shirts (20$ each), 1 T-shirt (25$), 1 pant

(30$) in cart. The discount amount is 6$ (10% out of 10$ + 20$ + 30$) - Customer has 8 T-shirts (10$ each) and 4 pants (20$ each). The discount

amount is 12$. (10% out of 6x10$+3x20$). The “Maximum number of sets” limited the number of sets here to 3 (otherwise the number of sets would be 4

and the discount amount would be 10% out of 8x10$+4x20$).

Bundle: Buy A + B + C + D for … – Fixed Discount

Rule Example

The rule in this example is – “Get 5$ discount for each pair of T-shirt + Short”.

Note: In our example, T-Shirt is any product that belongs to category 16 and short is

any product that belongs to category 19.

Cart examples for this rule:

- Customer has 1 T-shirt (10$), 1 short (15$). The discount amount is 5$ - Customer has 2 T-shirts (10$), 1 short (15$) and 2 shorts (20$ each). The

discount amount is 10$. (There are 2 sets of T-shirt + short)

Bundle: Buy A + B + C + D for … – Fixed Price

Rule Example

The rule in this example is – “Get T-shirt + pants or shorts for 10$”. Maximum

discount amount is 20$.

Note: In our example, T-Shirt is any product that belongs to category 16, pant is any

product that belongs to category 18 and short is any product that belongs to category

19.

Cart examples for this rule:

- Customer has 1 T-shirt (10$), 1 short (15$). The discount amount is 15$.

(Because it cost the customer 10$ instead of 25$) - Customer has 2 T-shirts (10$ each), and 2 shorts (15$ each). The discount

amount is 15$ (Because it costs the customer 10$ instead of 25$). (The

“Maximum discount amount” is 20$, therefore the discount only applied to

one set of T-shirt+shorts).

Category Tier: Get Each Group of N items for …

Fields explanation

- Get every group of … items – the number of items in the group for discount

to be applied. - Items for which ALL of the following conditions are TRUE – the condition

that defines the items of the group - With … % discount – the discount percent which the customer will get for the

group of items - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

- Products ordered by (cheapest / most expensive) – the items order by which

the promotion discount will be applied - Maximum number of groups – the maximum number of groups that the

discount will be applied on.

Category Tier: Get Each Group of N items for …

– Percent Discount

Rule Example

The rule in this example is – “Get 10% discount on buying 2 bags”. This discount can

be applied once per order, because the “Maximum Number of Groups” is 1.

Note: In our example, bag is any product that belongs to category 4.

Cart examples for this rule:

- Customer has 1 bag (10$), 1 bag (15$) in cart. The discount amount is 2.5$. - Customer has 1 bag (10$), 2 bags (20$ each), 2 bags (30$ each) in cart. The

discount amount is 3$. (Since the “Maximum Number of Groups” is 1 and the

“Products ordered by” is “Cheapest” – the rule is only applied on the 2 first

cheapest bags).

Category Tier: Get Each Group of N items for …

– Fixed Discount

Rule Example

The rule in this example is – “Get 2$ discount on buying 3 T-shirts”.

Note: In our example, T-shirt is any product that belongs to category 16.

Cart examples for this rule:

- Customer has 2 T-shirts (10$ each), 2 T-shirts (15$ each) in cart. The discount

amount is 2$. - Customer has 2 T-shirts (10$ each), 2 t-shirts (15$ each), 1 T-shirt (18$) and 1

T-shirt (20$) in cart. The discount amount is 4$. (There are 2 groups of 3 T-

shirts)

Category Tier: Get Each Group of N items for …

– Fixed Price

Rule Example

The rule in this example is – “Get 2 shorts for 40$”. Maximum discount amount is

50$.

Note: In our example, short is any product that belongs to category 19.

Cart examples for this rule:

- Customer has 1 short (30$) and 1 short (15$) in cart. The discount amount is

5$. (Because the customer paid 40$ instead of 45$) - Customer has 2 shorts (30$ each), 1 shorts (40$ each) and 1 short (50$). The

discount amount is 20$. (Because the customer paid 40$ instead of 60$. Also,

since the “Maximum Discount Amount” is 50$, the rule hasn’t been applied on

the next two T-shirts, because then the discount amount would exceed 50$).

N + M / Each N

Fields explanation

- Buy … items – N - the number of items to buy in order to get the subsequent

M items with discount. - Items, for which ALL of the following conditions are TRUE – the

condition on items in cart which define the items on which the N + M rule

applies. - Get the subsequent … items – M – the number of items that get the discount - With … % discount – the discount percent on the M items - After … such items has been added to cart for full price - number of items

that the customer must pay a full price on, before the N + M rule is applied - Ordered by (cheapest / most expensive) – the items order by which the

promotion discount will get applied

- Maximum Qty Discount is Applied To – maximum quantity of items the

discount can be applied to - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

N + M / Each N – Percent Discount

Rule Example

The rule in this example is – “1 + 2 on watches”.

Note: In our example, watch is any product that belongs to category 6.

Cart examples for this rule:

- Customer has 1 watch (10$), 1 watch (20$) and 1 watch 30$ in cart. The

discount amount is 30$. (The 30$ watch is N (since the order is starting from

the most expensive), and the next two are M). - Customer has 2 watches (10$), 2 watches (20$ each), 1 watch (30$). The

discount amount is 40$. (30$ is N, 2x20$ is M (for free), 10$ is N, 10$ is M)

N + M / Each N – Fixed Discount

Rule Example

The rule in this example is – “Get 20$ discount on each second bag (when buying at

least two bags for full price)”.

Note: In our example, bag is any product that belongs to category 4.

Cart examples for this rule:

- Customer has 3 bags (30$ each) in cart. There is no discount. (2 bags are

added for full price and the third one is N, therefore we didn’t get to M (the

bag which gets the discount)) - Customer has 2 bags (30$ each) and 2 bags (40$ each) in cart. The discount

amount is 20$. (2 30$ bags are added for full price, 1 40$ bag is N and the

next 40$ bag is M that gets the 20$ discount)

N + M / Each N – Fixed Price

Rule Example

The rule in this example is – “Each third bag for 1$”

Note: In our example, bag is any product that belongs to category 4.

Cart examples for this rule:

- Customer has 3 bags (30$ each) in cart. The discount amount is 29$. - Customer has 6 bags (30$ each) in cart. The discount amount is 29$. (Since

the “Maximum discount amount” is 50$, the rule cannot be applied on the next

3 bags, because then the discount will be 2x29$ = 58$)

All after M added

Fields explanation

- Items, for which ALL of the following conditions are TRUE – the

condition on items in cart on which the rule will be applied. - With … % discount – the discount percent on the items - After … such items has been added to cart for full price - number of items

that the customer must pay a full price on, before the discount is applied - Maximum Qty Discount is Applied To – maximum quantity of items the

discount can be applied to - Maximum Discount Amount – maximum discount amount that customer can

get in his cart using this promotion

- Products ordered by (cheapest / most expensive) – the items order by which

the promotion discount will get applied

All after M added – Percent Discount

Rule Example

The rule in this example is – “Get 10% discount on bags and watches, after

purchasing 3 most expensive of them for full price”.

Note: In our example, bag is any product that belongs to category 4 and watch is any

product that belongs to category 6.

Cart examples for this rule:

- Customer has 2 watches (10$), 2 watches (20$) and 1 bag 30$ in cart. The

discount amount is 2$. (The 3 most expensive items (30$ bag and 2 20$

watches) are purchased for full price, and the following 2 10$ watches get

10% discount). - Customer has 3 watches (60$) and 2 bags (70$ each) in cart. The discount

amount is 6$. (The 3 most expensive items (2 70$ bag and 1 60$ watch) are

purchased for full price, and the following 60$ watch gets 10% discount. The

next 60$ watch is not getting discounted, because then the discount will

exceed its limit (10$) and will be 12$).

All after M added – Fixed Discount

Rule Example

The rule in this example is – “Buy 2 XS products for full price, and get 5$ discount

for every subsequent one”.

Cart examples for this rule:

- Customer has 1 XS item (10$), 2 XS items (20$ each) and 3 XS items (30$

each) in cart. The discount amount is 20$. - Customer has 2 XS items in cart. No discount is applied.

All after M added – Fixed Price

Rule Example

The rule in this example is – “Buy 4 T-shirts for full price, and get every subsequent

one (up to 10) for 5$”.

Note: In our example, T-shirt is any product that belongs to category 16.

Cart examples for this rule:

- Customer has 2 T-shirts (10$ each), 3 T-shirts (20$ each) and 1 T-shirt (30$)

in cart. The discount amount is 10$. (First 4 most expensive T-shirts are

purchased for full price, the next 2 10$ T-shirts are purchased for 5$ each) - Customer has 12 T-shirts (15$ each) and 4 T-shirts (20$ each) in cart. The

discount amount is 100$. (First 4 most expensive T-shirts are purchased for

full price, the next 10 15$ T-shirts are purchased for 5$ each, 2 last T-shirts

didn’t get discount because “Maximum Qty Discount is Applied to” is 10)

Extended Conditions explained The extension adds new condition types to the promotion rules – customer attributes,

customer sales history, customer orders sub selection and ability to use custom

options in products sub selections.

You can see the new condition types in the conditions drop down. To see the

conditions drop down, go to the condition tab in the cart rule backend and click the

plus button –

Customer Attribute

Rule Example

The rule in this example is – “Customers with email from gmail.com gets 20%

discount on buying 3 bags”. That is, a logged in customer test1@gmail.com will be

able to get the discount, while a not logged in customer or a customer with non gmail

email (eg: test2@hotmail.com) won’t be able to get the discount.

Note: In our example, bag is any product that belongs to category 4.

Customer Sales History

Completed Orders Count

The “Completed Order Count” is the number of customer’s orders with state

“complete”, ie – shipped and non-fully refunded orders. (For more information about

order states, see https://www.mexbs.com/magento-blog/magento-order-statestatus-

flow/)

Lifetime Paid Amount

The “Lifetime Paid Amount” is the sum of (total_paid – total_refunded) on all

customer’s orders, in other words – lifetime paid amount (in store currency) of

customer’s orders, excluding refunded amount.

Customer Orders Subselection

Using this functionality, you can create a condition based on customer orders.

Fields Explanation

- If (number of created orders / average order grandtotal / sum of

grandtotals) is – the aggregator on the orders matching the sub condition - Is … - the aggregator value - For a subselection of orders matching ALL of these conditions – condition

that defines the matching orders, on which the aggregator will be applied.

Condition Example

This condition will only apply to customers who placed at least 2 orders that have

status “Complete” or “Processing” in the last 10 days. (Another way to read this

condition is – customers who have at least 2 paid orders from the last 10 days).

Custom Options in Product Sub Selection

You now have the ability to use custom options of an item within the condition

products sub selection, Magento core actions and Additional Promotion actions –

Custom Options in Condition Products Sub selection

Custom Options in Magento core action

Custom Options in Additional Promotion action

Custom Option title and value - Example

Product Backend Configuration –

Product Frontend View –

Rule Example –

In this rule, the customer will get first cheapest 5 items with 10% discount if their Zip

type is Gold.

Custom Option SKU - Example

Product Backend Configuration –

Rule Example –

In this rule, the customer will get first cheapest 5 items with 10% discount if their

Custom Option SKU (that is, the regular SKU (in our example 24-WB02), followed

by “-“, followed by SKU of the chosen custom option (in our example G1)) is 24-

WB02-G1.

Discount Breakdown Type

The extension allows you to choose the breakdown type for every rule –

For Magento core rules, you can choose between “Rule Labels” and “Rule Labels and

Product Names”.

For Additional Promotion rules, you can choose between “Rule Labels”, “Rule Labels

and Product Names” and “Comprehensive Description”.

You can also choose to inherit the configuration from “Stores Configurations”. (Read more about “Stores Configurations” settings in “Stores Configurations” section)

Explanation of breakdown types:

- Rule Labels – this shows only the rule label in the breakdown. (If the label is

empty, it will display the coupon code and if there is no coupon code it will

display the rule name).

- Rule Labels and Product Names – this will show the rule label and the

products names that the rule was applied on.

- Comprehensive description – this will display a comprehensive description

of the discount applied. (Eg: “Got Endurance Watch for buying Impulse

Duffle”).

Rule Example

This rule is “Buy 1 bag, get 1 watch for free”. (The rule label is “Bag + Watch

promo”, the coupon code is “bagpluswatch”)

Note: In our example, bag is any product that belongs to category 4 and watch is any

product that belongs to category 6.

Now let’s see how the discount breakdown will look using different “Discount

Breakdown Type” configuration values –

“Discount Breakdown Type” Rules Labels –

“Discount Breakdown Type” Rule Labels and Product Names –

“Discount Breakdown Type” Comprehensive description –

Skip items that have tier price

The extension allows you to tell the rule to skip items that have tier price –

You can choose Yes/No, or “Use Config Value” to inherit the value from “Stores

Configuration”. (Read more about “Stores Configurations” settings in “Stores

Configurations” section)

Skip items that have special price / catalog rule price

The extension allows you to tell the rule to skip items that have special price or

catalog rule price -

You can choose Yes/No, or “Use Config Value” to inherit the value from “Stores

Configuration”. (Read more about “Stores Configurations” settings in “Stores

Configurations” section)

Stores Configurations

Extension’s stores configurations are located at “Stores Configurations Sales

Additional Promotions”

- Show Breakdown – Yes/No – Yes will show the discount breakdown, No

will act like Magento core behavior (ie: not showing breakdown). Example to

how the cart looks when “No” is chosen.

- Breakdown is collapsed by Default –Yes/No - Example to how the cart looks

when “No” is chosen.

- Breakdown type - “Rule Labels”/“Rule Labels and Product Names” – (For

explanation of the breakdown types, see “Discount Breakdown Type” section).

This defines the default breakdown type, which will be used when the rule has

“Use Config Value” in “Discount Breakdown Type”.

- Skip items that have tier price – Yes/No -

This defines the default value which will be used when the rule has “Use

Config Value” in “Skip items that have tier price”.

- Skip items that have special price – Yes/No -

This defines the default value which will be used when the rule has “Use

Config Value” in “Skip items that have special price / catalog rule price”.

That’s it!

You finished reading the manual about the features of Additonal Promotions

extension. We hope that it was helpful and easy to understand, and that now you will

start creating awesome promotions for your customers and boost your sales!

If you still have any questions, we are here to help -

Get Support!

We are here and we will do our best to help. Contact us on support@mexbs.com and

we will get back to you ASAP with help!

Free software updates

From time to time we are going to release some cool updates for your extension. And

you will get those updates for free! Currently we are working on upgrading our

website, in order to make the software updates appear directly in your customer

account. But for now, you will get the software updates by email on demand (because

we don’t want to spam you), or every time there is new release (if it’s ok for you to be

spammed by good software ;)).

Don’t forget to send your feedback! Every feedback is good for us! Please send us your feedback to

support@mexbs.com or write it directly in the reviews section on the product page. It

will be a pleasure for us to hear your opinion!

Enjoy your extension!

MexBS Team