{"id":604,"date":"2023-05-18T11:51:23","date_gmt":"2023-05-18T10:51:23","guid":{"rendered":"https:\/\/www.prestafusion.com\/blog\/?page_id=604"},"modified":"2024-07-30T18:42:32","modified_gmt":"2024-07-30T17:42:32","slug":"free-product-gifts","status":"publish","type":"page","link":"https:\/\/www.prestafusion.com\/blog\/documentation\/free-product-gifts","title":{"rendered":"Free Product Gifts"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"introduction\">Introduction<\/h2>\n\n\n\n<p>Free Product Gifts for Prestashop is a module which allows you to reward your customer with a free add-on gift based on the products they purchase from your store. The module allows you to define the free gifts associated with individual products, categories and \/ or products with specific attributes and allows you to assign multiple free gifts to each product while also allowing your customers to select which they would like. An excellent module which will increase conversions by offering your customers an attractive incentive to complete their purchase, both on the product page and in the cart.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"installation\">Installation<\/h2>\n\n\n\n<p>The installation procedure is very much similar to most other Prestashop modules. No core changes required therefore installation is straight forward, be sure to follow the instructions below to ensure a successful installation.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Upload the module folder to your stores <code>{root}\/modules<\/code> folder<\/li>\n\n\n\n<li>Once uploaded, login to your Prestashop Back Office and head over to the <strong>Modules<\/strong> section<\/li>\n\n\n\n<li>Search for the module and click <strong>Install<\/strong><\/li>\n\n\n\n<li>After a successful installation, the module configuration screen is presented to you. More details on this in the next section.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"configuration\">Configuration<\/h2>\n\n\n\n<p>Open the module configuration and you will be presented with the first screen which lists existing gift packs.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/configuration-installation.webp\" alt=\"Configuring the module\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"configuration-general\">Creating Gift Packs<\/h3>\n\n\n\n<p>To get started we\u2019ll need to create a gift pack. A gift pack is either a gift or a set of gifts associated with certain products in your store. To get started click the Add gift pack button in the top right corner of the page.<\/p>\n\n\n\n<p>You should now be presented with the following form:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/configuration-new-gift-pack.webp\" alt=\"Creating a new gift pack\"\/><\/figure>\n\n\n\n<p>Let\u2019s take a look at the form options:<\/p>\n\n\n\n<p><strong>Pack Name<\/strong><\/p>\n\n\n\n<p>Enter a pack name which helps identify the pack.<\/p>\n\n\n\n<p><strong>Pack Type<\/strong><\/p>\n\n\n\n<p><strong>Product<\/strong> &#8211; Gifts in the gift pack will be rewarded based on the product or products the customer purchases<br><strong>Cart Value<\/strong> &#8211; Gifts in the gift pack will be rewarded based on the customer cart total<\/p>\n\n\n\n<p><strong>Display gift pack for<\/strong><\/p>\n\n\n\n<p>This allows you to choose how to restrict which products the gift pack is available for. Therefore the gift pack will only be displayed on those product pages which match the criteria you will specify shortly. In the cart, gift packs will only be displayed if the products in the cart match the criteria specified. You may choose from one of the following options:<\/p>\n\n\n\n<p><em>Category<\/em><br><br>You can choose to display the gift pack for all products in the categories you select. You can also further restrict it to product with certain<br>attributes only and which also exist in the categories you select.<\/p>\n\n\n\n<p><em>Specific Product<\/em><\/p>\n\n\n\n<p>This will allow you to associate the gift pack with a single specific product in your store.<\/p>\n\n\n\n<p><em>Source of gift products<\/em><\/p>\n\n\n\n<p>You can individually choose which products will be offered as gifts. The following options are available<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Category: All products from the specified will be offered as gifts for the the customer to select from.<\/li>\n\n\n\n<li>Static Product List: Manually specify which products should be offered as a gift(s) for this pack.<\/li>\n<\/ul>\n\n\n\n<p>Depending on the option you select above when creating a new gift pack, you will be presented with a variation of a form which allows you to specify additional properties for the gift pack. The form contains the following fields:<\/p>\n\n\n\n<p><em>From Cart Total <\/em>(for cart value pack type)<\/p>\n\n\n\n<p>For Cart Value based pack types, this value determines the amount the customer must spend (excluding shipping and other fees) for the customer<br>to be eligible for the gifts<\/p>\n\n\n\n<p><strong>Reward gift(s) for every X quantity of Parent Product purchased<\/strong><\/p>\n\n\n\n<p>This requires the customer to purchase at least this quantity of the main \/ parent product for the customer to be eligible for the gift. For example Reward the gift for every 2 purchases of Product A, or products from Category X.<\/p>\n\n\n\n<p><strong>Number of free gifts awarded for each of the parent product purchased<\/strong><\/p>\n\n\n\n<p>This will determine how many gifts can be awarded when the parent product is purchased. This also takes into account the value of the above field. For example, reward 2 gifts for every 3 products purchased from Category X<\/p>\n\n\n\n<p><strong>Max Free Gifts that can be awarded for this pack<\/strong><\/p>\n\n\n\n<p>This puts a limit on the number of gifts that can be awarded for a pack, regardless of the quantity of parent products in the cart.<\/p>\n\n\n\n<p><strong>Show packs for these categories Category Restricted Packs<\/strong><\/p>\n\n\n\n<p>Select which products from these categories qualify the customer for the free gift(s)<\/p>\n\n\n\n<p><strong>Assign Gift Pack to the following product Specific Product Restricted pack<\/strong><\/p>\n\n\n\n<p>Search for the specific product you wish to assign this gift pack to by typing the name and selecting one of the products in the results dropdown.<\/p>\n\n\n\n<p><strong>Restrict to these attributes<\/strong><\/p>\n\n\n\n<p>This will limit the gift availability only to those products with the attributes selected here. This is combined with the category rule or specific product rule above. Therefore the customer must select a combination containing one of the attributes you select here for the gift to become available. Leave all unselected to disable this restriction<\/p>\n\n\n\n<p><strong>Gift products from these categories<\/strong> Gift Source Categories<\/p>\n\n\n\n<p>All products from the categories you select here will be offered as gifts for the user to select from.<\/p>\n\n\n\n<p><strong>Pack Products<\/strong> Gift Source Static Product List<\/p>\n\n\n\n<p>Here you can manage a static list of products which will be offered as a gift(s). Click the cog icon to launch the form to add a new product. After adding some products, you should see something similar to the following:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/configuration-pack-products.webp\" alt=\"Products in a gift pack\"\/><\/figure>\n\n\n\n<p>You can add additional products, edit or delete existing products in the grid. You can also rearrange the products by dragging the drag handle which appears when you hover over a product.<\/p>\n\n\n\n<p>Options<\/p>\n\n\n\n<p>The global options tab allows you to modify the general behaviour of the module with the options described below.<\/p>\n\n\n\n<p><strong>Extra Gifts Behaviour<\/strong><\/p>\n\n\n\n<p>When a gift is added to the customer cart, it is added as a standard line item. Therefore this makes it possible for the customer to increase the quantity of the gift product in the cart. This option allows you to decide whether to prevent the gift quantity from being increased any higher than what the customer is eligible for (based on the products in the cart) or simply charge for the additional quantities.<\/p>\n\n\n\n<p><strong>Show Free Gifts Flag<\/strong><\/p>\n\n\n\n<p>This will display a Free gift flag on the product lists and product pages for all products which have gift packs associated with them. Below is an example of how this appears.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/configuration-product-gift-flag.webp\" alt=\"Free gift flags on product lists\"\/><\/figure>\n\n\n\n<p><strong>Display Locations<\/strong><\/p>\n\n\n\n<p>Select the locations where you\u2019d like the gift pack displayed. You can display Gift pack directly on the product for all the products the gift pack is available for and also in the cart. When displaying in the cart, the module will display a gift pack based on which products present in the cart<br>have an associated gift pack.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"front-end\"><strong>Front End<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/front-end-product-gift-pack.webp\" alt=\"Gift Packs presentation on the product page\"\/><\/figure>\n\n\n\n<p>In the above example, the customer qualifies for the gift if they purchase a single quantity of the parent product therefore when they click \u201cAdd<br>to Basket\u201d for the parent, the gift they have selected will also be added.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"\/blog\/wp-content\/uploads\/documentation-images\/freeproductgifts\/front-end-cart-gift-pack.webp\" alt=\"Gift Packs presentation in the cart\"\/><\/figure>\n\n\n\n<p>In the above example, the gift pack requires that at least 2 products are purchased from the clothes category, but the customer has only 1 in the<br>cart. The module therefore effectively communicates this to customer making it easy for them purchase the additional item to be eligible for the<br>gift.<\/p>\n\n\n\n<p>This concludes the user guide for the Free Gift Products module for Prestashop.<\/p>\n\n\n\n<p><a href=\"https:\/\/addons.prestashop.com\/en\/promotions-gifts\/19646-free-product-gifts.html\" class=\"btn-cta-primary btn-full-width\">Get Free Product Gifts on Prestashop Addons site<\/a><\/p>\n<p><a href=\"https:\/\/www.prestafusion.com\/prestashop-modules\/33-free-product-gifts-prestashop.html\" class=\"btn-cta-primary btn-full-width\">Get Free Product Gifts on Prestafusion<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction Free Product Gifts for Prestashop is a module which allows you to reward your customer with a free add-on gift based on the products they purchase from your store. The module allows you to define the free gifts associated with individual products, categories and \/ or products with specific attributes and allows you to [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":792,"parent":59,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"templates\/template-documentation.php","meta":{"footnotes":""},"class_list":["post-604","page","type-page","status-publish","has-post-thumbnail","hentry"],"_links":{"self":[{"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/pages\/604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/comments?post=604"}],"version-history":[{"count":13,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/pages\/604\/revisions"}],"predecessor-version":[{"id":838,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/pages\/604\/revisions\/838"}],"up":[{"embeddable":true,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/pages\/59"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/media\/792"}],"wp:attachment":[{"href":"https:\/\/www.prestafusion.com\/blog\/wp-json\/wp\/v2\/media?parent=604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}