Free Product Gift Module Documentation

Introduction

  • The Free Product Gift Module is designed to help Magento store owners boost sales and customer satisfaction by adding a free product automatically to the cart when certain criteria are met, such as cart value or custom thresholds. The module ensures a seamless checkout process and maintains proper inventory relationships.

Key Benefits

Core Features

  • Automatic Free Product Assignment: Assigns free products to the cart based on order value or predefined conditions.
  • Event-Based Integration: Listens to Magento checkout events like add to cart, update cart, andsave shipping information
  • Efficient Inventory Management:Automatically removes previous free products if new conditions apply.

Overview

  • The Free Product Gift module is a robust Magento solution designed to increase sales engagement by offering free products to customers based on their order value or cart criteria. It integrates smoothly with Magento's checkout process and automatically adds gifts to a customer's cart when predefined conditions are met. The module includes support for gift rules, inventory management, and robust logging for troubleshooting.

Installation

Preparation:

  • Before starting the installation, ensure that your Magento environment meets the following prerequisites:
System Requirements:
  • PHP Version: 7.4 or higher is recommended.
  • Composer: Must be installed for dependency management.
  • Database Backup: Backup your database and files to prevent data loss during installation..

Magento 2 module installation. Here's a detailed guide on how to proceed:

Magento 2 module Installation

Step 1:Extract the Zip File:
  • Extract the contents of the zip file to a temporary directory on your computer.
Step 2: Copy Files to Magento Root Directory:
  • Copy all files and folders from the extracted zip file.
  • Paste the copied files into the Upload the extracted files to the app/code/Letscms/Faq directory in your Magento root.
Step 3: Open Terminal or CMD:
  • Change your working directory to the Magento root directory using the following command:
  • you need to run the following commands to install and activate the module:

    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f
    php bin/magento cache:clean

Verify Installation:

  • php bin/magento module:status

Configuration


Free Product Gift

General Settings

  • Go to Stores → Configuration → Free Product Gift to configure general settings for the Free Product Gift:
  • Fill all given fields
  • Enable : set "YES" to enable for website.


  • Admin Panel Configuration

    1. Enable Free Product Gift Module
      • Yes/No option to enable or disable the Free Product Gift module.
    2. Cart Value Threshold
      • Define different cart value thresholds. For each threshold
        • Set Cart Value (Amount).
        • Assign a Product ID representing the free gift for that value.
    3. Gift Rules Configuration
      • In the Admin Panel, you can map cart value thresholds with the corresponding products:


    Uninstallation Guide


    To remove the module, run the following commands:

  • you need to run the following commands to install and activate the module:

    php bin/magento module:disable Vendor_moduleName
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f
    php bin/magento cache:flush