User Tools

Site Tools


Sidebar

magento_2:freegift_pro

Free Gift Pro

User Guide

1. Quick Note

In general, programs for free gifts can be set based on 2 main types of rules:

Catalog Rule: Admin will be the one managing which products will be free gifts and gifts will be added to shopping cart automatically when the order meets the rule’s condition (The customer can NOT CHOOSE their free gift with this rule.)

Note: Be careful when selecting 'Yes' in configuration to 'Show free gift on category'

Shopping Cart Rule: Customer can select which gift(s) to add to their cart from the list of gifts pre-set by the admin. The list of gift options will be shown on the Shopping Cart page.

2. Configuration

2.1. General

The administrator can easily configure the Free Gift module in 2 ways:

MarketingFree Gift ProConfiguration

StoresConfigurationMage WorldFree Gift Pro

Note:

- In Enable Module field, select YES to enable the module

- It is optional to display promotion information on the cart page or checkout page. You can manage the rule by choosing a value from the Show Free Gift Promotion field.

- The Free Gift Label is shown together with products that have free gifts. If you don’t upload your own label image, it will be set as default.

When you select YES for Show Free Gift on Category, on the catalog page (both grid and list), free gifts appeared under Add to compare section as small icons.

- Size Promotion Banner: Set height and width for Promotion Banner

2.2. Social

This function will be updated soon.

3. Manage Catalog Rules

3.1 Add new catalog rule

To create a new catalog rule, firstly please go to Admin sidebar and follow steps below:

Open MarketingFree Gift ProCatalog Rules.

Click button ‘Add New Rule

There are 3 tabs in catalog rules setting page: Rule Information, Condition and Gift Items.

- Rule Information: Allows admin to insert general information for one catalog rule such as name, description, active time, priority, customer group and website view.

+ Uses Limit: Insert a value to limit the number of overall purchases in which customers are rewarded free gifts.

For example: The first 100 orders receive a free mouse.

After that, the system will automatically update the Times Used field. Leave the field blank if there is no limitation.

- Conditions: Create conditions of rules on this tab.

+ Minimum Qty (buy X): Set minimum quantity of items to get free gift.

+ Gift Quantity (get Y): Set quantity of gifts.

- Gift Items: Select free gifts for the rule on the tab.

This page will list all products on your site. Click the check-box to choose gift products and then Save.

Currently, gifts are available for simple product and configurable product.

After inputting data, click button ‘Save’ and then ‘Apply Rules

Note:

- Always remember to press “Apply Rules” after making any changes in catalog rules.

- Multiple rules: The rules are processed by priority. If you set “Stop further rules processing” to YES, the next rules (with lower priority) will not be processed. In case all the rules don’t discard subsequent rules, they will be processed.

- Free gifts that matched catalog rules are shown on the catalog and product detail page and automatically added to the cart when customers purchase for their order.

3.2. Display Free Gift on the catalog page

In Free Gift configuration, turn the Show Free Gift on Category field to Yes.

If the site uses other theme, please follow below guide:

In magento, please go to file list.phtml in your theme:

 app\design\frontend\<your_package>\<your_theme>\Magento_Catalog\templates\product\list.phtml

Insert this code:

<?php 
<!—start code add label free gift --> 
<?php include ($block->getTemplateFile(‘MW_FreeGift::gift_label_0n_catalog.phtml’)) ?> 
<!-- end code add label free gift -->
?>

Inside the <a> tag of product image:

<a href="<?= /* @escapeNotVerified */ $_product->getProductUrl() ?>" class="product 
photo product-item-photo" tabindex="-1">

3.3. Display Free Gift label on the catalog page

If the site uses other theme, please follow below guide:

In magento, please go to file list.phtml in your theme:

app\design\frontend\<your_package>\<your_theme>\Magento_Catalog\templates\product\list.phtml

Insert this code:

<!--start add code list Free gift-->
<?php include ($block->getTemplateFile('MW_FreeGift::list_gift_on_catalog.phtml')) ?>
<!--end add code list Free gift-->

End of the <div> tag of product item inner:

<div class="product-item-inner">

4. Manage Shopping Cart Rules

4.1. Add new Shopping Cart Rule

To create a new shopping cart rule, open admin sidebar, access MarketingFree Gift ProShopping Cart Rules. Click button ‘Add New Rule

The shopping cart rules page has 4 tabs named Rule Information, Condition, Gift Items and Manage Coupon Codes.

- Rule Information: Allows admin to insert general information for a shopping cart rule such as name, description, promotion message, promotion banner, active time, priority, customer group, website view and priority.

+ Uses per Customer: Insert a value to limit the total number of overall purchases per customer are rewarded free gifts. Then, the system will automatically update the Times Used field. Leave this field blank if there is no limitation.

4.2. Create and use Coupon Codes

If you don’t want to use coupon codes, leave it “No” as default. If you want to provide coupon for your promotion, change field Coupon to ‘Specific Coupon’.

The ‘Coupon Code’ and check box ‘Use Auto Generation’ will be shown below ‘Coupon’ field.

To use only one coupon code for shopping cart rule, please insert coupon code to the field ‘Coupon Code’.

If you want to release multiple coupons, please ignore field ‘Coupon Code’ and click the check-box ‘Use Auto Generation’ ⇒ press ‘Save and Continue Edit’.

Go to ‘Manage Coupon Codes’, insert information for generate coupon code and click button ‘Generate’.

After generating, the list of coupon code will appears on grid below.

4.3. Apply Shopping Cart rules

To apply rules successfully, remember to flush cache after saving your rules.

Go to Admin sidebar: SystemToolsCache Management. In this section, click button ‘Flush Magento Cache’.

On Front-end page, if customers buy product and are gifted, they will insert coupon code to add free gift to cart.

After applying coupon code, free gift will be added to cart.

5. Report

From Admin sidebar, enter MarketingFree Gift ProReport.

On report page, you can select ‘Date Range’ to choose time period that you want report to be shown. The chart report will be updated as soon as the date range was changed.

6. Support

If you have any issues, please contact us via link.

magento_2/freegift_pro.txt · Last modified: 2018/08/17 03:15 by blanka