Free Gifts
Free Gifts is a module developed by Custom Scriptz for Zen Cart where your customers can get a free product by spending a certain amount.
Contents
This module is free?
- No, this module is available at our scripts store.
This module is supported by Zen Cart Team?
- No, we support this module.
This module will overwrite any of my files?
- Actually, it does not overwrite, but take place of 2 core files from Zen Cart.
System Requirements
Zen Cart v1.3.8a or v1.3.9a/b
ionCube Loaders
PHP 5 or newer
MySQL 5
Features
- Get one Product when you buy more them $x.xx.
- Example:
If your customer buy $10.00 you, him/her get product X for Free.
Screenshots
Screenshot #01
Screenshot #02
Screenshot #03
Before Installing / Upgrading
Thought our modules are exhausted tested, we do not guarantee that everything goes smoothly, so please, BACKUP YOUR DATABASE AND FILES before proceed.
Installation Instructions
- Unzip the file that you downloaded from our Customers Area to a temp dir on your computer.
- Inside that dir, you will notice one dir called "uploads".
- If your "admin" directory has a different name, rename the dir "admin" dir that's inside the "uploads" dir to match yours.
- Upload all contents of the dir "uploads" to the root of your shop (don't upload the dir "uploads", but what is inside of it). There are no overwrites.
- After uploading all files, go to the Admin Panel of your Store -> Tools -> Free Gifts.
- Free Gifts will install itself and you should notice a success message.
- Now go to Replace Files
Upgrading Instructions
- Unzip the file that you downloaded from our Client Area to a temp dir on your computer.
- Inside that dir, you will notice one dir called "uploads".
- If your "admin" dir is set to a different name, rename it to match yours.
- If you changed any of the language files located at "/includes/languages/your-languages/extra_definitions", be sure to backup this dir before overwrite the files.
- Upload all contents of the dir "uploads" to the root of your shop (don't upload the dir "uploads", but what is inside of it). Overwrite all files.
- After uploading the files, go to the Admin Panel of your Store -> Tools -> Free Gifts. Free Gifts will update itself if necessary.
- Now go to Replace Files
Replace Files
- Go to "/includes/classes" and rename the file "shopping_cart.php" to "shopping_cart-backup-dd-mm-yy.php" (where dd-mm-yy means day-month-year).
- Go to "/includes/classes" and rename the file "shopping_cart_freegifts.php" to "shopping_cart.php".
- If you changed the original file "shopping_cart.php", you will need a comparison tool like WinMerge to see what's different in both files.
- Go to "/includes/modules/order_total" and rename the file "ot_total.php" to "ot_total-backup-dd-mm-yy.php" (where dd-mm-yy means day-month-year).
- Go to "/includes/modules/order_total" and rename the file "ot_total_freegifts.php" to "ot_total.php".
- If you changed the original file "ot_total.php", you will need a comparison tool like WinMerge to see what's different in both files.
Settings
The settings below can be found at: Configuration -> Free Gifts
- Sidebox Image Width: This control the image width for the Free Gifts sidebox.
- Sidebox Image Height: This control the image height for the Free Gifts sidebox.
- Show "Already in Cart" Message: This setting is usefull to prevent your customer of inserting the product to the cart again when it's already in their cart. Setting this to True, will show a little message on the product page telling that the product is already in their cart.
Tutorial
- Go to Tools -> Layout Boxes Controller. You will notice that a new box has been found: freegifts. Go ahead and activate it. I recommend you to place on the top, so your customers will notice the free gifts. The box is not displayed if there are not free gifts available.
- After that, go to Tools -> Free Gifts.
- Click the button 'New Product', wait the page load. Depending on the number of products, this might take some seconds.
Fields
- Free Gift Name: Choose the Product that you want to be a Free Gift. Only active and products that are not already a Free Gift will appear on that list. The product does not have to be a free product.
- Free Gift Threshold: The ammount that the customer need to spend for this Free Gift to activate.
- Start Date and End Date: The timeframe that this Free Gift will be avaiable. Only Free Gifts with status active and the date is in the timeframe will be available.
- Click the Insert button.
- The Free Gift will be inserted, but the Status will be Inactive. To activate it, click the Red flag and the inverse to deactivate.
Note: Don't leave any field Empty. If you want to make the Free Gift available at 01/01/2010 only. Do as follow: Start Date -> 01/01/2010 - End Date -> 02/01/2010. Then the Free Gift will be available only at 01/01/2010.
FAQ
* What happens if the customer remove products from the cart so the threshold is less then the cart total?
- The free gift will be removed from the cart and the customer will receive a notice.
* Can I set more than one free gift at the same time for the same timeframe?
- Yes. The customer will be able to choose which one to pick.
Got Questions, Bugs or Requests?
http://customscriptz.com/support