Advanced Promotion Suite

The plugin Advanced Promotion Suite allows you to create discounts and campaigns for various occasions in your online shop.

Bring classic and effective campaigns from stationary retail to your online shop, such as:

• “Buy 3 pay 2”
• “20% off everything – except for…”
• “For every purchase over XX € receive product Y for free”
• “Purchase 2 items and receive the second item 50% off”

The following documentation clarifies the possibilities of this plugin and how it works in practice.

Advanced Promotion Suite backend

The module can be found under the menu point Marketing > Advanced Promotion Suite.

When you open the module, you will first see an overview of all currently applied promotions. If this is your first time opening the module, the promotion list will appear empty.

In the promotion list, you have the following available parameters:

• Name: displays the assigned name of the particular promotion
• Priority: displays the priority setting of each promotion (the higher the priority, the more likely it is to be processed)
• Promotion mode: this indicates which setting has been selected for each promotion
• Active: shows whether or not the promotion is active 
• Value: the value assigned to the discount – depending on the mode selected, this is absolute or percentage
• Active from: the promotion's starting date
• Active to: the promotion's end date
• Orders: indicates the number of orders made for the promotion

Similar to other Shopware modules, these parameters can be sorted manually. To change the sorting, click on the parameter and drag to reposition it within the headline list. Using the search box, you have the option of searching for a specific promotion that has already been created.

Note: the following values can be edited directly in the overview simply by double-clicking on the entry in the list:

• Active
• Value
• Active from
• Active to

The following functions are available in the overview:

• Add item: click this button to add a promotion
• Delete a promotion: click this icon to delete a promotion completely from the overview
• Edit a promotion: this icon opens the corresponding promotion editor
• Duplicate a promotion: creates a copy of the respective promotion

Promotion configuration

You can define the conditions of your promotion in the configuration area (i.e. the discount or if the campaign offers free shipping, etc.). Note that several areas can be set within the range of modes. Some fields do not apply for every mode, and therefore are not displayed in particular configurations. Below is an example of the different modes and settings. Here you will find a helpful tutorial on how to create a promotion.

Promotion mode:

The promotion mode is the first setting required when creating a new promotion. The following modes are available:

• Shopping cart: absolute discount
• Shopping cart: percentage discount
• Products: absolute discount
• Products: percentage discount
• Buy X get Y for free
• Free items
• Free article bundle
• Free shipping

The following sections provide individual descriptions of each possible mode:

Shopping cart modes

There are two different shopping cart modes – absolute and percentage – and both have the following available options:

• Name of the Promotion: assigns a name to your promotion
• Active: placing a tick in the box activates the promotion, removing the tick deactivates it
• Order number: defines the order number that appears when placed in the shopping cart
• Show badge in listing: if set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• Badge text: If set, this text will be shown on the product badge in the listing
• Value: value of the discount – depending on the mode this will be absolute or percentage
• Free shipping: defines whether or not the promotion is offered with free delivery
• Max usage per user: determines how many times each customer can use the promotion, if he tries to use it more times than allowed, he'll get a message in the cart
• Allow no voucher: when active, no other voucher can be used in combination with this promotion. If inactive, a maximum of 1 voucher can be redeemed in parallel with this promotion in the shopping cart.
• Use only this promotion: when this option is activated, no other promotion can be used.
• Discount available for: here you select whether the promotion is valid globally or for main products/variants. This is important because in the product rules you cannot select a variant (see below).
• Short description: enter a description that will appear on the product detail page. Here you can also work with variables – the available variables are displayed directly below this field. At the tips & tricks we show you some examples
• Detailed description: depending on the device being used, this description will appear either off-canvas or in a modal box. This description can be used as a disclaimer.
• Activate promotion with existing voucher: defines that the promotion will activate with an assigned voucher.
  The voucher is used only for activation, the voucher conditions do not apply.
• Time based promotion activation: here you can define the specific time the promotion begins and ends.
• Exclude promotions with lower priority: when activated, promotions with a lower priority will be excluded from the shopping cart.
• Priority of this promotion: defines the priority of the promotion. The higher the priority, the more likely it will be considered.

If you let the "Badge Text" field empty, the default text "Campain" appears in the badges.

Discount available for works following a defined logic. To briefly explain: :
By variant > 3x the same variant, After master product > 3x the same product, regardless of variant, All products > products from the same campaign.

Product modes

There are two different product modes – absolute and percentage – and both have the following available options:

• Name of the Promotion: assigns a name to your promotion
• Active: placing a tick in the box activates the promotion, removing the tick deactivates it
• Order number: defines the order number that appears when placed in the shopping cart
• Show badge in listing: if set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• Badge text: If set, this text will be shown on the product badge in the listing
• Value: value of the discount – depending on the mode this will be absolute or percentage
• Free shipping: defines whether or not the promotion is offered with free delivery
• Discount display: Specifies how the discount is to be displayed in the shopping basket in the storefront. This can be grouped, position based or direct. Grouped means that another position is listed as a discount for all discounted articles. Position based displays an additional position for each discounted article. "Direct" does not add another item, but deducts the discount directly from the discounted article.
• Max usage per user: determines how many times each customer can use the promotion, if he tries to use it more times than allowed, he'll get a message in the cart
• Allow no voucher: when active, no other voucher can be used in combination with this promotion. If inactive, a maximum of 1 voucher can be redeemed in parallel with this promotion in the shopping cart.
• Refer promotion rules to product rules: With this option the product rules will referred to the cart rules. Example: You have a cart rule Total price > 50 and a product rule Supplier name = XY. When the option is disabled, these rules will be evaluated seperately, the cart must be > 50 and at least contain 1 product from supplier XY, no matter what it's price is. If you activate this option, Shopware checks that all products from supplier XY have a total price of > 50. Using this you can link both rulesets and start completely new types of promotions.
• Use only this promotion: when this option is activated, no other promotion can be used
• Discount available for: here you select whether the promotion is valid globally or for main products/variants. This is important because in the product rules you cannot select a variant (see below).
• Max usage per cart: defines how often this promotion may be used per shopping cart 
• Scaling: here you set how many products must be purchased in order to activate the promotion (i.e. “Buy 5, get 10% discount”).
• Short description: enter a description that will appear on the product detail page. Here you can also work with variables – the available variables are displayed directly below this field. At the tips & tricks we show you some examples
• Detailed description: depending on the device being used, this description will appear either off-canvas or in a modal box. This description can be used as a disclaimer.
• Activate promotion with existing voucher: defines that the promotion will activate with an assigned voucher.
  The voucher is used only for activation, the voucher conditions do not apply.
• Time based promotion activation: here you can define the specific time the promotion begins and ends.
• Exclude promotions with lower priority: when activated, promotions with a lower priority will be excluded from the shopping cart.
• Priority of this promotion: defines the priority of the promotion. The higher the priority, the more likely it will be considered.

Discount available for works following a defined logic. To briefly explain: :
By variant > 3x the same variant, After master product > 3x the same product, regardless of variant, All products > products from the same campaign.

Buy X get Y for free

In this mode, you can add an additional item to an order for free when a certain value is reached. For example, “Buy 6 candles, get the 6th for free” or “Buy 5 candles, get 6” – the customer places 6 candles in their basket, but only pays for 5. The following settings are available for this mode:

• Name of the Promotion: assigns a name to your promotion
• Active: placing a tick in the box activates the promotion, removing the tick deactivates it
• Order number: defines the order number that appears when placed in the shopping cart
• Show badge in listing: if set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• Badge bext: If set, this text will be shown on the product badge in the listing
• Buy X: defines how many items must be purchased in order for the promotion to activate
• Get Y for free: defines how many items are included as free
• Free shipping: defines whether or not the promotion is offered with free delivery
• Discount display: Specifies how the discount is to be displayed in the shopping basket in the storefront. This can be grouped, position based or direct. Grouped means that another position is listed as a discount for all discounted articles. Position based displays an additional position for each discounted article. "Direct" does not add another item, but deducts the discount directly from the discounted article.
• Max usage per user: determines how many times each customer can use the promotion, if he tries to use it more times than allowed, he'll get a message in the cart
• Allow no voucher: when active, no other voucher can be used in combination with this promotion. If inactive, a maximum of 1 voucher can be redeemed in parallel with this promotion in the shopping cart.
• Refer promotion rules to product rules: With this option the product rules will referred to the cart rules. Example: You have a cart rule Total price > 50 and a product rule Supplier name = XY. When the option is disabled, these rules will be evaluated seperately, the cart must be > 50 and at least contain 1 product from supplier XY, no matter what it's price is. If you activate this option, Shopware checks that all products from supplier XY have a total price of > 50. Using this you can link both rulesets and start completely new types of promotions.
• Use only this promotion: when this option is activated, no other promotion can be used
• Short description: enter a description that will appear on the product detail page. Here you can also work with variables – the available variables are displayed directly below this field. At the tips & tricks we show you some examples
• Detailed description: depending on the device being used, this description will appear either off-canvas or in a modal box. This description can be used as a disclaimer.
• Activate promotion with existing voucher: defines that the promotion will activate with an assigned voucher.
  The voucher is used only for activation, the voucher conditions do not apply.
• Time based promotion activation: here you can define the specific time the promotion begins and ends.
• Exclude promotions with lower priority: when activated, promotions with a lower priority will be excluded from the shopping cart.
• Priority of this promotion: defines the priority of the promotion. The higher the priority, the more likely it will be considered.

Free items

Use this mode to add a particular free item to an order (i.e. “Free x item for purchases made over 100 Euro). The following settings are available:

• Name of the Promotion: assigns a name to your promotion
• Active: placing a tick in the box activates the promotion, removing the tick deactivates it
• Order number: defines the order number that appears when placed in the shopping cart
• Show badge in listing: if set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• Badge text: If set, this text will be shown on the product badge in the listing
• Free shipping: defines whether or not the promotion is offered with free delivery
• Free item: here you can define the free items
• Max usage per user: determines how many times each customer can use the promotion, if he tries to use it more times than allowed, he'll get a message in the cart
• Use only this promotion: when this option is activated, no other promotion can be used
• Allow no voucher: when active, no other voucher can be used in combination with this promotion. If inactive, a maximum of 1 voucher can be redeemed in parallel with this promotion in the shopping cart.
• Refer promotion rules to product rules: With this option the product rules will referred to the cart rules. Example: You have a cart rule Total price > 50 and a product rule Supplier name = XY. When the option is disabled, these rules will be evaluated seperately, the cart must be > 50 and at least contain 1 product from supplier XY, no matter what it's price is. If you activate this option, Shopware checks that all products from supplier XY have a total price of > 50. Using this you can link both rulesets and start completely new types of promotions.
• Discount available for: here you select whether the promotion is valid globally or for main products/variants. This is important because in the product rules you cannot select a variant (see below).
• Max usage per cart: defines how often this promotion may be used per shopping cart
• Scaling: here you set how many products must be purchased in order to activate the promotion (i.e. “Buy 5, get 10% discount”).
• Short description: enter a description that will appear on the product detail page. Here you can also work with variables – the available variables are displayed directly below this field. At the tips & tricks we show you some examples
• Detailed description: depending on the device being used, this description will appear either off-canvas or in a modal box. This description can be used as a disclaimer.
• Activate promotion with existing voucher: defines that the promotion will activate with an assigned voucher.
  The voucher is used only for activation, the voucher conditions do not apply.
• Time based promotion activation: here you can define the specific time the promotion begins and ends.
• Exclude promotions with lower priority: when activated, promotions with a lower priority will be excluded from the shopping cart.
• Priority of this promotion: defines the priority of the promotion. The higher the priority, the more likely it will be considered.

Discount available for works following a defined logic. To briefly explain: :
By variant > 3x the same variant, After master product > 3x the same product, regardless of variant, All products > products from the same campaign.

In the shopping cart, the free item will always appear with its full price plus a separate voucher of equal value.

Free article bundle

In contrast to the free article mode, where only one article can be selected as a free gift, it is possible to select several free gifts in the free article bundle. Example: "When buying article X, article Y gets a free addition. If article X is purchased more than once, the free article can be selected as many times as required".
The following settings can be made here:

• Name of the promotion: Assigns a name for the promotion
• Active: Switches the promotion active
• Order number: Defines the order number with which the promotion is placed in the shopping basket
• Show badge in the article listing: Activate this option to display the badge for this promotion
• Badge text: Here you can enter your own text for the article badge. This text will be displayed in the article listing, if the option is activated
• Show note in shopping cart: If you activate this option, a note will be displayed in the shopping cart with information about the conditions of the promotion
• Free article badge text: This text will be displayed as a badge on the free article in the shopping cart
• Listing view Buy button: Define how the button should be displayed in the listing. You can choose whether only the detail or buy button should be shown, or both buttons.
• Free shipping: Defines if the order is free of shipping costs when the promotion is started
• Free articles: Here you can define the free article(s)
• Max usage per customer: Determines how often a customer can take advantage of the promotion, if he tries to exceed this number, a corresponding note is displayed in the shopping cart
• Only use this promotion: If active, no further promotion will be allowed
• Do not accept a voucher: If active, no other voucher can be redeemed besides the promotion
• Refer promotion rules to product rules: With this option, product rules and shopping cart rules are linked together. Example: You have defined a shopping cart rule Total Price > 50 and a product rule Manufacturer Name = XY. If the option is deactivated, the rules are evaluated separately, so the shopping cart must be > 50 and there must be at least 1 product from manufacturer XY, no matter how much it costs. If this option is now activated, it is checked that all items from manufacturer XY exceed a total value of 50. So you can link these rules and start completely new actions again.
• Discount valid for: Here you can set whether your promotion should only apply to the regular articles/variants or globally. This is interesting because you cannot choose variants in the product rules (see below).  The selection works according to the following logic: All articles > 3 articles from the scope of the promotion, main article > 3x the same product, no matter which variant, variant > 3x the same variant.
• Graduation: Here you set how many products must be purchased for the promotion to take effect (example: buy 5, get 5% discount)
• Max. usage per shopping cart: Here you define how often this promotion may be used in a shopping cart (example: "Buy 5, get 5% discount" can only be used once per order)
• Short description: Here you can enter a description, which will be shown on the item detail page. You can also work with the available variables shown below the field. In the tips & tricks we show you some examples.
• Detailed description: This description is displayed in the frontend in a modal box or in the OffCanvas, depending on the device, and is intended for disclaimers, for example.
• Activate promotion with existing voucher: Defines that the promotion is activated with the voucher selected here. The deposited voucher is only used for activation, the set voucher conditions do not apply.
• Time-controlled activation: Here you can set when the promotion should start and end.
• Exclude promotion with lower priority: Here you can set that other promotions, even if they would apply, are excluded at lower priority.
• Priority of this promotion: Defines the priority of this promotion. The higher the priority, the more likely it is to be considered.

Please note: Free articles are always added to the shopping cart in the frontend with the full article price! The discount results from the fact that a voucher with the same value is placed in the shopping basket at the same time - the article is therefore free.

Free shipping

The Free Shipping mode gives you the opportunity to create a promotion that allows you to place free shipping orders. In contrast, the free shipping option from the other modes only works in combination with a product or shopping cart discount.

• Name of the promotion: Assigns a name for the promotion
• Active: Switches the promotion active
• Order number: Defines the order number with which the promotion is placed in the shopping basket
• Show badge in the article listing: Activate this option to display the badge for this promotion
• Badge text: Here you can enter your own text for the article badge. This text will be displayed in the article listing, if the option is activated
• Show note in shopping cart: If you activate this option, a note will be displayed in the shopping cart with information about the conditions of the promotion
• Listing view Buy button: Define how the button should be displayed in the listing. You can choose whether only the detail or buy button should be shown, or both buttons.
• Free articles: Here you can define the free article(s)
• Max usage per customer: Determines how often a customer can take advantage of the promotion, if he tries to exceed this number, a corresponding note is displayed in the shopping cart
• Only use this promotion: If active, no further promotion will be allowed
• Do not accept a voucher: If active, no other voucher can be redeemed besides the promotion
• Refer promotion rules to product rules: With this option, product rules and shopping cart rules are linked together. Example: You have defined a shopping cart rule Total Price > 50 and a product rule Manufacturer Name = XY. If the option is deactivated, the rules are evaluated separately, so the shopping cart must be > 50 and there must be at least 1 product from manufacturer XY, no matter how much it costs. If this option is now activated, it is checked that all items from manufacturer XY exceed a total value of 50. So you can link these rules and start completely new actions again.
• Discount valid for: Here you can set whether your promotion should only apply to the regular articles/variants or globally. This is interesting because you cannot choose variants in the product rules (see below).
• Graduation: Here you set how many products have to be purchased for the promotion to take effect (example: Buy 5, get 5% discount)
• Max. usage per shopping cart: Here you define how often this promotion may be used in a shopping cart (example: "Buy 5, get 5% discount" can only be used once per order)
• Short description: Here you can enter a description, which will be shown on the item detail page. You can also work with the available variables shown below the field. In the tips & tricks we show you some examples.
• Detailed description: This description is displayed in the frontend in a modal box or in the OffCanvas, depending on the device, and is intended for disclaimers, for example.
• Activate promotion with existing voucher: Defines that the promotion is activated with the voucher selected here. The deposited voucher is only used for activation, the set voucher conditions do not apply.
• Time-controlled activation: Here you can set when the promotion should start and end.
• Exclude promotion with lower priority: Here you can set that other promotions, even if they would apply, are excluded at lower priority.
• Priority of this promotion: Defines the priority of this promotion. The higher the priority, the more likely it is to be considered.

 

Promotion rules

The conditions that must be met in order to activate the promotion are defined in the promotion rules (i.e. a promotion activates when a certain shopping cart value is met / there is a particular item in the cart). Here you can select between promotional rules (shopping cart or user rules) and product rules – you are also able to combine rules for even more specific promotions. The promotion will only be active when all of the rules are met, therefore if you do not want to define product rules, select “Always true”. The rules can be branched as a tree structure or combined using “AND” and “OR”.

1: You can create a new rule here

2: Here you can delete and existing rule – simply select the rule and click Delete

Promotion rules

In the promotion rules, you can set shopping cart and user rules by selecting nodes or a definition. When you select a rule, you can adjust the Rule settings on the right side of the window. If you change the rule of a node, the left side of the tree will be displayed accordingly. You can define the following rules:

• AND: when all sub-rules are met – if you choose this, all rules under the node must be met in order for the node to apply.

• OR: if one of the sub-rules are met – if you choose this, it’s enough if only one of the entered sub-rules are met.

• Always true - when selected, this is usually always true. When only one shopping cart or product rule is defined, all of the other rules will also apply.

• Shopping cart rules - when selected, you can define the following shopping cart rules:
  • Total price
  • Total net price
  • Number of products
  • Free shipping

• User rule - when selected, you can define the following rules for users:
• Customer Stream
• Customer number
  • Customer ID
  • Payment ID
  • Customer group
  • Customer email
  • Customer: account mode
  • Customer: validation
  • Payment present
  • Customer shop
  • Internal comment
  • Salutation
  • Title
  • First name
  • Last name
  • Birthday
  • Address company 
  • Address department
  • Address salutation
  • Address first name
  • Address last name
  • Address Tile
  • Address street
  • Address zip code
  • Address city
  • Address phone
  • Address tax ID
  • Billing address tax ID
  • Address additional line one
  • Address additional line two
  • Address county
  • Address state

You can create and combine any number of rules in order to perfectly control your campaign.

Product rules

The product rules behave similar to the shopping cart rules, as they can be used to more accurately control your promotion. Nevertheless, you can still use just one standalone product rule.

• AND: when all sub-rules are met – if you choose this, all rules under the node must in order for the node to apply.

• OR: if one of the sub-rules are met – if you choose this, it’s enough if only one of the entered sub-rules are met.

• Always true – when selected, this is usually always true. When only one shopping cart or product rule is defined, all of the other rules will also apply.

• Is in a Product Steam – here you can choose the Product Stream that the product must be assigned to in order for the rule to apply

• Product rule – the following rules can be defined for your product:
  • Order number
  • Scale price from
  • Price
  • Scale price to
  • Product name
  • Supplier name
  • Product ID
  • Main details ID
  • Manufacturer ID
  • Tax ID
  • Price group ID
  • Filter group ID
  • Short description
  • Description
  • Product is active
  • Product is a topseller
  • Product keywords
  • Product meta title
  • Product price group active
  • Attribute 1-20
  • Variant ID
  • Variant kind
  • Variant active
  • In stock
  • Min. in stock
  • Stock clearance
  • Weight
  • Width
  • Length
  • Height
  • EAN
  • Purchasing price
  • Puchase unit
  • Shipping free
  • Price ID
  • Pseudo price
  • Percentage discount
  • Category ID
  • Category name
  • Category meta title
  • Category meta keywords
  • Category meta description
  • Category title
  • Category description
  • Category is active
  • Category external target

The price filter is always stated net since the result would almost never be “true” by rounding the price!

Restrictions

In the restrictions section, you can determine whether your promotion should be restricted to specific customer groups or shops. Enter the customer groups/shops the promotion should be restricted to here.

Settings in the Plugin Manager

Price presentation

Here you can set how the price of the promotion product appears in the listing and on the detail page. You can choose from the following options:

• Don’t change displaying – no other price will be displayed
• Set old price as new pseudo price – this sets the old price as a pseudo price and displays the discounted price.
• Only highlight new price – this setting displays only the new price; the pseudo price will be hidden.

Note: this setting is always global for active promotions. You have to make sure that your promotions fulfill the legal requirements for displaying prices with a strikethrough.

Step-by-Step Tutorials

“20% off all items except…”

In this example, we will show you how to create a temporary “20% off all items except…” promotion. In the two screenshots below, you can see the various settings required to create such a promotion:

 

 

• 1. First define the type of promotion. In this case, you need a percent discount on a product basis.
• 2. Enter the name of the promotion. This will be issued in the backend but also appear in the header of the extended description modal box in the frontend.
• 3. Set the promotion to active
• 4. Define the order number that appears when an order is placed. Please pay attention to Shopware’s order number specifications.
• 5. If set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• 6. Enter the text that should be displayed on the badge. For this example "20% off for nearly all items!".
• 7. Define the value of the promotion. In this case, it is set to 20.
• 8. Write a brief description, which will be displayed on the product detail page as a small box under the “Add to cart” button.
• 9. If necessary, write a detailed description. In the frontend, the short description will be clickable – should the customer click the short description, the detailed description will appear in a modal box.
• 10. Set the time limit of the promotion. In this example it is set for 24 hours.
• 11. Save your promotion.
• 12. Switch to the “Promotion rules” tab.
• 13. Define a product rule and switch to the tab “Promotion rules”.
• 14. Now define the rule itself. Here it is: Manufacturer is not from the Deli Garage | Feinbrennerei Sasse. You can fill in the individual values themselves (divided by "|" or click on a selection and pick out the desired entry from a list.
• 15. Finally, you save your promotion. After saving it will appear in the frontend.

The promotion appears in the frontend as follows:

 

The duration of the promotion will be displayed in a footnote, so that the offer period is clearly evident. When your customer clicks on the promotional box, a modal box will appear with the detailed description:

When the customer completes their purchase, the discounts for the products that aren’t from the defined brands will appear as separate items in the shopping cart.

 

“Buy 3 pay 2” 

In this example, we will show you how to create a promotion based on the classic formuler “Buy 3 pay 2”. The two screenshots below show the settings required to create such a promotion:

 

• 1. First define the type of promotion. For this example you need the mode “Buy X get Y free”.
• 2. Define the name of the promotion. This will appear in the backend as well as in the header of the modal box of the detailed description in the frontend.
• 3. Set the promotion to active.
• 4. Define the order number that appears when an order is placed. Please pay attention to Shopware’s order number specifications.
• 5. If set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• 6. Enter the text that should be displayed on the badge. For this example "Buy 3, pay only 2".
• 7. Define how many items need to be purchased so that the promotion activated. In this example, we need 3 items to make the promotion valid.
• 8. Define how many items should be counted as free gift. Here one item is free when three are purchased, so one is entered.
• 9. Write a brief description, which will be displayed on the product detail page as a small box under the “Add to cart” button.
• 10. Save your promotion.
• 11. Switch to the “Promotion rules” tab.
• 12. Define a product rule, which appears in the definition mask below.
• 13. Now define the rule itself. In this example it is: Product name = Putty. You can fill in the individual values themselves (divided by "|" or click on a selection and pick out the desired entry from a list.)
• 14. Finally save your promotion. After saving it will appear in the frontend.

This is how your promotion appears in the frontend:
 

Once three of the defined items are placed in the basket, the promotion is activated:

 

“Buy 2 get the 50% off the second item”

In this example we will show you how to create a promotion based on the idea “Buy 2 get 50% off the second item”. In the two screenshots below, you can see the various settings required to create such a promotion:

 

• 1. First define the type of promotion. In this example we need to set the mode to “Products: percentage discount”.
• 2. Define the name of the promotion. This will appear in the backend as well as in the header of the modal box of the detailed description in the frontend.
• 3. Set the promotion to active.
• 4. Define the order number that appears when an order is placed. Please pay attention to Shopware’s order number specifications.
• 5. If set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• 6. Enter the text that should be displayed on the badge. For this example "Buy 2 items and get the cheapest 50% off!".
• 7. Define the value of the discount on the second product. It’s 50% in this example.
• 8. Define how many items need to be purchased so that the promotion activates in the shopping cart, which is 2 in this example.
• 9. This setting means that this promotion can only be used once per shopping cart.
• 10. Write a brief description, which will be displayed on the product detail page as a small box under the “Add to cart” button.
• 11. Save your promotion.
• 12. Switch to the “Promotion rules” tab.
• 13. Define a product rule, which appears in the definition mask below.
• 14. Now you define the rule itself. In this example it is: Category: Name = Teas and Accessories. You can fill in the individual values themselves (divided by "|" or click on a selection and pick out the desired entry from a list.
• 15. Finally save your promotion. After saving it will appear in the frontend.

The promotion appears as follows on the detail page:

 

 

The scaling of the price was registered >1 – for this reason, it is not overwritten because we do not know if the customer wants to buy the second product. However, if the customer does, the promotion will be credited in the shopping cart.

Promotion with a minimum value in the shopping cart

In this example we will show you how to create a minimum order value promotion (i.e. “Buy for 100 Euro or more and receive a 5% discount off your total order”). The two screenshots below show the settings required to create such a promotion:
 

   

• 1. First you need to define the type of promotion. In this case, it needs to be set to “Shopping cart: percentage discount”.
• 2. Define the name of the promotion. This will appear in the backend as well as in the header of the modal box of the detailed description in the frontend.
• 3. Set the promotion to active.
• 4. Define the order number that appears when an order is placed. Please pay attention to Shopware’s order number specifications.
• 5. If set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• 6. Enter the text that should be displayed on the badge. For this example "5% discount from 100 Euro".
• 7. Define the value of the discount, which is 5% in this example.
• 8. Write a brief description, which will be displayed on the product detail page as a small box under the “Add to cart” button.
• 9. Save your promotion.
• 10. Switch to the “Promotion rules” tab.
• 11. Define a basket rule, which appears in the definition mask below.
• 12. Now define the rule itself. Here it will be: Total >= 100.
• 13. Finally save your promotion. After saving it will appear directly in the frontend.

Your promotion appears as follows in the frontend:

Once the minimum shopping cart value of 100 Euro is met or exceeded, the promotion will automatically activate:

Promotion with a free item

In this example, we will show you how to assign a free item to an order. This is based on the popular sale “Get a free item when 5 or more items are in the shopping cart”. The two screenshots below show the settings required to create such a promotion:

 

 

• 1. First you need to define the type of the promotion. In this case we need to choose “Free items”.
• 2. Define the name of the promotion. This will appear in the backend as well as in the header of the modal box of the detailed description in the frontend.
• 3. Set the promotion to active.
• 4. Define the order number that appears when an order is placed. Please pay attention to Shopware’s order number specifications.
• 5. If set, the products in the listing are displayed with a badge, if the products are valid for this promotion
• 7. Here you can search for your free item that will be offered in the frontend. In this example we are choosing Merhzwecknudeln and an oil change.
• 8. Write a brief description, which will be displayed on the product detail page as a small box under the “Add to cart” button.
• 9. Save your promotion.
• 10. Switch to the “Promotion rules” tab.
• 11. Define a shopping cart rule, which appears in the definition mask below.
• 12. Define the rule itself. In this example it is: Number of products >= 5.
• 13. Finally save your promotion. After saving it will appear directly in the frontend.

If your customer meets the number of required items in the shopping cart (which is 5 in this example), the free item will automatically appear as follows:

As an alternative, if there is a selection of free items, the selection can be displayed below in a slider:
 

The slider uses the same styling as the “Premium items” slider. When “Premium items” is being used, it will affect the free items slider!

Create a linked promotion

This example is uses the possibility of referring the product and cart rules to create a rule like this: Buy products from the supplier Feinbrennerei Sasse for at least 50 GBP and get 10% off. How this works is described in this example:

 

 

• 1: Choose the promotion mode, in this example use "Products: percentage discount".
• 2: Choose a name for your promotion, this name will also be used in the cart.
• 3: Activate this checkbox, when you want to tease this promotion in the listing using a badge.
• 4: Activate the promotion.
• 5: Choose a order number for your promotion.
• 6: Write a text for your teasing badge.
• 7: Set the value of the promotion, for this example we use 10.
• 8: Activate the option "Refer promotion rules to product rules".
• 9: Write a description for your promotion, this will be displayed at the items detail page.
• 10: Save your promotion.
• 11: Switch to the tab "Promotion rule".
• 12: Create a shopping cart rule.
• 13: Configure your shopping cart rule, for the example we use Total price >= 50.
• 14: Now create the product rule.
• 15: Configure your product rule, for the example we use Supplier name = Feinbrennerei Sasse.
• 16: Save your promotion.

At the detail page the promotion gets displayed like this:

In the shopping cart you can see, that if you're under 50 GBP, the promotion will not activate, but over 50 GBP:

 

Tips & tricks

Formatting using Smarty variables

Here you can find some examples how you can affect using smarty commands the output in the summary and the detailed description.

• {$promotion->validTo} -> Date and time in english format
• {$promotion->validTo|date:dates} -> Formatting of the year according to localization
• {$promotion->validTo|date:times} -> Formatting of the year according to localization
• {$promotion->validTo|date:"dd.MM.yy"} -> Fix format: Day, Month, Year
• {$promotion->validTo|date:"HH:mm"} Uhr -> Fix format: 12 hours format
• {$promotion->validTo|date:"hh:mm"} Uhr -> Fix format: 24 hours format

Inheritance of the badge text

If you leave the "Badge text" empty, Shopware will fallback to "Campaign" for english and "Aktion" for german.

The language variants will only fallback to their own snippet, so english will only fallback to "Campaign" and german will always fallback to "Aktion"!