Difference between revisions of "AIO Product Page"

From Custom Scriptz
Jump to: navigation, search
(Features)
(Upgrading Instructions)
 
(20 intermediate revisions by the same user not shown)
Line 8: Line 8:
  
 
=== This module will overwrite any of my files? ===
 
=== This module will overwrite any of my files? ===
* No, this module does not overwrite any core file from Zen Cart.  
+
* No, this module does not overwrite any core file from Zen Cart, but take place of two .htaccess file from default Zen Cart installation.
  
 
== System Requirements ==
 
== System Requirements ==
Line 26: Line 26:
 
'''Screenshot #01'''
 
'''Screenshot #01'''
  
[[File:freegifts01.jpg]]
+
[[File:aio1.png]]
  
  
 
'''Screenshot #02'''
 
'''Screenshot #02'''
  
[[File:freegifts02.jpg]]
+
[[File:aio2.png]]
  
  
 
'''Screenshot #03'''
 
'''Screenshot #03'''
  
[[File:freegifts03.jpg]]
+
[[File:aio3.png]]
 +
 
 +
 
 +
'''Screenshot #04'''
 +
 
 +
[[File:aio4.png]]
 +
 
 +
 
 +
'''Screenshot #05'''
 +
 
 +
[[File:aio5.png]]
  
 
== Before Installing / Upgrading ==
 
== Before Installing / Upgrading ==
Line 42: Line 52:
  
 
== 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.
+
* Download the license manager from http://customscriptz.com/downloads/license-manager.zip
* Inside that dir, you will notice one dir called "uploads".
+
* Extract both license manager and the module file that you downloaded from our [http://customscriptz.com/customers 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.
 
* 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.
* 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.
+
* Go to [[#Rename_Files|Rename Files]]
* 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 ==
 
== Upgrading Instructions ==
* Unzip the file that you downloaded from our [http://customscriptz.com/customers Client Area] to a temp dir on your computer.
+
* Download the license manager from http://customscriptz.com/downloads/license-manager.zip
* Inside that dir, you will notice one dir called "uploads".
+
* Extract both license manager and the module file that you downloaded from our [http://customscriptz.com/customers Customers Area] to a temp dir on your computer.
* If your "admin" dir is set to a different name, rename it to match yours.
+
* Cut the "uploads" dir from the license manager package and past over the extracted module dir.
* 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. Overwrite everything.
* 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.
+
* Do not upload the "extras" dir.
* 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.
+
* Go to [[#Rename_Files|Rename 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 ==
+
== Rename 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).
+
On the store files
* Go to "/includes/classes" and rename the file "shopping_cart_freegifts.php" to "shopping_cart.php".
+
* Go to "/admin" and rename the file "product.php" to "_product.php" (in case the product type you are replacing is product)
* 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 "/admin/includes/languages/YOUR_LANGUAGE" and rename the file "product.php" to "_product.php"
 +
* Go to "/admin/includes/modules" and rename the dir "product" to "_product"
  
* 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).
+
Inside the upload package
* Go to "/includes/modules/order_total" and rename the file "ot_total_freegifts.php" to "ot_total.php".
+
* Go to "/admin" and rename the file "aio_product.php" to "product.php" (in case the product type you are replacing is product)
* 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.
+
* Go to "/admin/includes/languages/YOUR_LANGUAGE" and rename the file "aio_product.php" to "product.php"
 +
* Go to "/admin/includes/modules" and rename the file "aio_product.php" to "product.php"
 +
* 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, upload the "extras". Remember to rename the "admin" dir as well that's inside the "extras" dir.
  
== Settings ==
+
Back to the store files
'''The settings below can be found at: Configuration -> Free Gifts'''
+
* Go to "/admin" and rename the file ".htaccess" to "default.htaccess", then rename the file "aio.htaccess" to ".htaccess"
 +
* Go to "/admin/includes" and rename the file ".htaccess" to "default.htaccess", then rename the file "aio.htaccess" to ".htaccess"
  
* '''Sidebox Image Width:''' This control the image width for the Free Gifts sidebox.
+
Entering the License
* '''Sidebox Image Height:'''  This control the image height for the Free Gifts sidebox.
+
* Go to Admin -> Catalog -> Categories / Products -> Try to insert a new product, you will then be redirected to the License Manager to enter your license.
* '''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.
+
* You will then be redirected to the License Manager to enter your license.
* '''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.
+
* After you enter the license, the module will redirect you to it's main page and show you that the installation was succeed.
* '''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.
+
== Settings ==
 +
* There are no settings for this module.
  
 
== Tutorial ==
 
== 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.
+
* Go to Store Admin -> Catalog -> Categories/Products
* After that, go to Tools -> Free Gifts.
+
* Edit or Insert a New Product
* Click the button 'New Product', wait the page load. Depending on the number of products, this might take some seconds.
+
* You should be able to see the AIO page.
 
+
'''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 ==
 
== 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?'''
 
'''Got Questions, Bugs or Requests?'''
 
http://customscriptz.com/support
 
http://customscriptz.com/support

Latest revision as of 18:00, 14 February 2012

AIO Product Page (all-in-one product page) is a module developed by Custom Scriptz for Zen Cart that gives you everything you need to edit and manage your product details, images, attributes and files.

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?

  • No, this module does not overwrite any core file from Zen Cart, but take place of two .htaccess file from default Zen Cart installation.

System Requirements

Zen Cart v1.3.8a or newer
ionCube Loaders
PHP 5 or newer
MySQL 5

Features

With AIO Product Page you can manage all the following from a single page:

  • All the Product Details
  • Images
  • Attributes
  • Files

Screenshots

Screenshot #01

Aio1.png


Screenshot #02

Aio2.png


Screenshot #03

Aio3.png


Screenshot #04

Aio4.png


Screenshot #05

Aio5.png

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.
  • 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.
  • Go to Rename 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.
  • Do not upload the "extras" dir.
  • Go to Rename Files

Rename Files

On the store files

  • Go to "/admin" and rename the file "product.php" to "_product.php" (in case the product type you are replacing is product)
  • Go to "/admin/includes/languages/YOUR_LANGUAGE" and rename the file "product.php" to "_product.php"
  • Go to "/admin/includes/modules" and rename the dir "product" to "_product"

Inside the upload package

  • Go to "/admin" and rename the file "aio_product.php" to "product.php" (in case the product type you are replacing is product)
  • Go to "/admin/includes/languages/YOUR_LANGUAGE" and rename the file "aio_product.php" to "product.php"
  • Go to "/admin/includes/modules" and rename the file "aio_product.php" to "product.php"
  • 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, upload the "extras". Remember to rename the "admin" dir as well that's inside the "extras" dir.

Back to the store files

  • Go to "/admin" and rename the file ".htaccess" to "default.htaccess", then rename the file "aio.htaccess" to ".htaccess"
  • Go to "/admin/includes" and rename the file ".htaccess" to "default.htaccess", then rename the file "aio.htaccess" to ".htaccess"

Entering the License

  • Go to Admin -> Catalog -> Categories / Products -> Try to insert a new product, you will then be redirected to the License Manager to enter your license.
  • 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.

Settings

  • There are no settings for this module.

Tutorial

  • Go to Store Admin -> Catalog -> Categories/Products
  • Edit or Insert a New Product
  • You should be able to see the AIO page.

FAQ

Got Questions, Bugs or Requests? http://customscriptz.com/support