Difference between revisions of "Free Gifts"
Line 1: | Line 1: | ||
− | '''Free Gifts''' is a module developed by [[Custom Scriptz]] for [http://www.zen-cart.com Zen Cart] where your | + | '''Free Gifts''' is a module developed by [[Custom Scriptz]] for [http://www.zen-cart.com Zen Cart] where your customers can get a free product by spending a certain amount. |
− | + | ||
=== This module is free? === | === This module is free? === | ||
− | * No, this module | + | * No, this module is available at our [http://customscriptz.com scripts store]. |
=== This module is supported by Zen Cart Team? === | === This module is supported by Zen Cart Team? === | ||
Line 9: | Line 8: | ||
=== This module will overwrite any of my files? === | === 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 == | == System Requirements == | ||
Line 38: | Line 37: | ||
== Before Installing / Upgrading == | == Before Installing / Upgrading == | ||
− | '''Thought our modules are exhausted tested, we do not guarantee that everything goes smoothly, so please, | + | '''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 == | == Installation Instructions == | ||
− | + | * Unzip the file that you downloaded from our [http://customscriptz.com/customers 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|Replace Files]] | ||
− | == | + | == Upgrading Instructions == |
− | + | * Unzip the file that you downloaded from our [http://customscriptz.com/customers 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]] | ||
− | + | == 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 [http://winmerge.org 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 [http://winmerge.org WinMerge] to see what's different in both files. | |
− | + | ||
− | + | ||
== Settings == | == Settings == | ||
Line 67: | Line 71: | ||
* '''Sidebox Image Width:''' This control the image width for the Free Gifts sidebox. | * '''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. | * '''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 == | == Tutorial == | ||
Line 74: | Line 77: | ||
* After that, go to Tools -> Free Gifts. | * 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. | * Click the button 'New Product', wait the page load. Depending on the number of products, this might take some seconds. | ||
− | |||
'''Fields''' | '''Fields''' | ||
Line 81: | Line 83: | ||
* '''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. | * '''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. | * 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 '''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. | + | 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 == | == FAQ == | ||
− | * What happens if the customer remove products from the cart so the threshold is less then the cart total? | + | '''* 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. | * 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 | + | '''* 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 |
Revision as of 09:56, 18 February 2010
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 newer
ionCube Loaders
PHP 5.x.x 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