Free Gifts

From Custom Scriptz
Revision as of 15:42, 26 March 2013 by Diego (Talk | contribs)

Jump to: navigation, search

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.

This module is free?

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 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

Freegifts01.jpg


Screenshot #02

Freegifts02.jpg


Screenshot #03

Freegifts03.jpg

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

  • Download the license manager from http://customscriptz.com/downloads/license-manager.zip
  • Extract both license manager and the module file that you downloaded from our Customers Area to a temp dir on your computer.
  • Cut the "uploads" dir from the license manager package and past over the extracted module dir.
  • Inside the extracted 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.
  • Rename the dir "uploads/includes/templates/YOUR-TEMPLATE" to match your template.
  • Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. There are no overwrites.
  • Wait for the upload of all files to complete.
  • If your Zen Cart version is equals to 1.3.x -> go to Admin -> Tools -> Free Gifts
  • If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Free Gifts
  • You will then be redirected to the License Manager to enter your license.
  • After you enter the license, the module will redirect you to it's main page and show you that the installation was succeed.
  • Now go to Replace Files

Upgrading Instructions

  • Download the license manager from http://customscriptz.com/downloads/license-manager.zip
  • Extract both license manager and the module file that you downloaded from our Customers Area to a temp dir on your computer.
  • Cut the "uploads" dir from the license manager package and past over the extracted module dir.
  • Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. Overwrite everything.
  • Wait for the upload of all files to complete.
  • If your Zen Cart version is equals to 1.3.x -> go to Admin -> Tools -> Free Gifts
  • If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> 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_xxx.php" to "shopping_cart.php" (where xxx is the version of your cart).
  • 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 copy the file "ot_total.php" to your computer, then delete it.
  • While in "/includes/modules/order_total", rename the file "ot_total_freegifts.php" to "ot_total.php"
  • All set. Now go for the Tutorial part.

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.
  • Auto Add Product: If you have one free gift running, you can set this to True, so the gift will be automatically inserted onto the customer's cart.
  • 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.
  • Show Product Image in Messages: This will display the products image for the gifts notices.
  • Remove Free Gift if Coupon is Used: If you want to restrict a customer to use a coupon that makes the order total pass the minimum threshold to get the free gift, set this to True. Eg. Free Gift Threshold $10, customer buy $15 in total, use a coupon of 50%, so the order will be $7.50, not $10, so if this is set to True, the customer will be warned, and the free gift removed from the cart. If you don't want to care about this and let customer checkout even if the order total is less than the minimum amount, set this to False.

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 no free gifts available.
  • If your Zen Cart version is equals to 1.3.x -> go to Admin -> Tools -> Free Gifts
  • If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> 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

Retrieved from "https://customscriptz.com/w/index.php?title=Free_Gifts&oldid=264"