Purpose

This document is a User Guide for Grouped Product Promotions module for Magento. It describes how work with the extension.

This module is for creating promotions and special discounts for grouped products. It provides intuitive interface for setting rules when 2+ simple products in a grouped product are purchased.

It also displays promotions for customers so that they see directly on product pages which discounts they get for combination purchases.

System Requirements

The extension works under Magento from 1.4.x and higher.

The extension works with Apache 1.3.x and higher, PHP 5, Linux or IIS.

The extension’s correct work is guaranteed with the following browsers:

• IE7+
• FireFox 4.x+
• Google Chrome 15.x+
• Safari 5.x+

The correct work with other Magento versions, other browsers and Apache/PHP versions is not guaranteed.

Installation

All our Magento extensions and templates are installed via IToris Installer.

Download IToris Installer and un-pack to the root of your website. It will then appear in menu System –>IToris extensions –> IToris Installer.

Open it and you will see all our Magento Extensions and Templates, both installed and available. You can install, update and un-install them with one click now.

Find Groped Product Promotions in the list of extensions and press Install button. It will ask for the license key that you will receive after the purchase. Enter the key and submit. The extension will be installed. It will be available in menu System –>IToris extensions –> Grouped Product Promotions

License

Magento modules developed by IToris are provided with 3 license types - regular, premium and multi-host.

Regulal license is partially encrypted. This license is website-dependent. By ‘website’ here we understand the website in Magento terms. Under one Magento installation one license key of the extension can activate all stores/storeviews. within one website. If your configuration has several Magento websites - a separate license will be required for each.

One license also supports a number of sub-domains for development/testing purposes in addition to the live website. Please see the full list of available sub-domains and additional information about the license in our Terms and Conditions

Premium license activates one Magento installation. All websites, stores and storeviews under one installation are covered with one license. Premium license is 100% open-source and is recommended for customizations. Premium license is installed via IToris Installer.

Multi-host license provides ability to install the module to an unlimited number of hosts. It is 100% and is installed as an archive.

You can switch the license from one domain to another – login to IToris website using the credentials you will receive after the purchase. Go to My Downloads area, find your key there and reset it from the current website. Then use it again to activate another website.

The license also includes free life-time updates for the extension.

Activation

To enable the module select System –>IToris extensions –> Grouped Product Promotions

Extension Enabled - this setting activates the module

There is ability to activate/deactivate the module for selected stores/storeviews (use Current Configuration Scope drop-down).

Settings

Promotion Rules

Once the module has been enabled - create rules for your grouped products for special discounts to be applied.

Create or Edit Rules

To create a new rule open a grouped product. There will be a new tab - Promotion Rules. There rules can be created and managed.

To create a new rule press “Create New Rule” button. You will see a new area where settings of the rule can be added.

• Title - this is what your customers will see as promotion’s title
• Position - if there are several promotions created for this configurable product, this is the order of display
• Status - can be active or inactive. Only active promotions will be visible for customers
• Date From - Date To - promotions can be limited in time. To do this set the date range. If no dates are set - promotions will be displayed while they stay active
• Customer Groups - if you want promotion to be available for some customer groups only, then select these groups. Other customer groups as well as not logged in customers will not see the promotion then
• Minimum Quantity and Discount - in this area the rule is created. Please select (check) the products that will be included in the promotion. Set the minimal quantity for each of them to participate in the promotion. Set discount and select if it should be fixed (in the selected currency) or percent (set 0-100 range then)

Several Rules for the Same Product

The same grouped product can have several promotion rules created for it. All rules will be displayed one under another.

Only active rules will be applied and displayed on the front-end.

On the pages of simple products that participate in the rules the promotions will be shown as well.

A rule will not be displayed if any of its products is not in stock.

Settings

Promotions on Product Pages

Create Promotion Block

To add promotions’ block on the front-end on product pages please do the following:

1. Open catalog/product/view.phtml file for editing
2. Add there
   <?php echo $this->getChildHtml('itoris_promosets') ?>
   and save the file

A new PHTML block will be created.

Promotions on the Front-end

For example, let us create a rule that when ottoman and chair are purchased together - customers receive 10% discount for each of them.

This is what our customers will see on the front-end:

Here we see that the promotion is displayed on the product page in a separate block. Customers see it immediately.

Settings

Promotions in Shopping Cart

Promotions’ block will be displayed in shopping cart as well when a product included in the rule is added to the cart.

Sub-total and total in the cart will be calculated based on the rule. In case the combination in the cart allows several different rules to be applied - the one providing a larger discount to the customer will be applied.