Fresh Installation

If you are trying this software on a shareware basis, you should obtain a temporary shareware License key and upload it to your site before installing this software. For more information on obtaining License keys, see the separate article on Licensing.

If you have already installed the shareware version of this software and have purchased a full License, there is no need to perform any of the steps below. You simply need to request a new License from us by following the instructions in the Licensing article.

Step 1 - Upload all the files and folders (even if some are empty) from this distribution to their respective directories on your web server. Please remember to BACK UP any files which you overwrite as part of this installation.

IMPORTANT: If your current template overrides (i.e. contains) any of the following files:

• includes/templates/YOUR_TEMPLATE/templates/tpl_product_info_display.php
• includes/templates/YOUR_TEMPLATE/templates/tpl_modules_attributes.php
• includes/templates/YOUR_TEMPLATE/templates/tpl_shopping_cart_default.php (add this only if you want attribute pictures to appear in your cart)

Step 2 - Backup your database, and then run the code in the file NOT_FOR_UPLOAD/sql/paps_v7.0.sql using your favorite database interface program.

REMEMBER: When creating the PAPs tables on your database make sure that no prefixes are added to the table names. This will cause PAPs not to work properly.

IMPORTANT: If using Zen Cart v1.5.x or later, please also run this SQL command on your database:

insert into admin_pages (`page_key`,`language_key`,`main_page`,`page_params`,`menu_key`,`display_on_menu`,`sort_order`) values ('paps','BOX_CATALOG_PRODUCT_ATTRIBUTE_PICTURES','FILENAME_PRODUCT_ATTRIBUTE_PICTURES','','catalog','Y','99');

Step 3 - Ensure the following folders are fully writeable:

images/paps
images/paps/linked
images/paps/fonts
images/swatch_enl
images/swatch_enl/tmp
images/paps/tmp

Step 4 (Optional) - Enable 'Detached From Enlarged Image' as a Thumbnails Position Option - In includes/templates/YOUR_TEMPLATE/templates/tpl_product_info_display.php:

If you want the position of your thumbnails to not be directly adjacent to the enlarged image, you need to select the 'Detached From Enlarged Image' position from the dropdown menu in the PAPs admin panel. In this case, the position of the line:

<?php require($template->get_template_dir('/tpl_modules_paps.php',DIR_WS_TEMPLATE, $current_page_base,'templates'). '/tpl_modules_paps.php'); ?>

within the tpl_product_info_display.php file (which is placed in step 1, above) determines only the position of the thumbnails. A separate file must be included in the tpl_product_info_display.php file which will generate the enlarged picture wherever you place it. To include the enlarged picture elsewhere in your page, add the following line:

<?php include(DIR_WS_MODULES . '/paps_layout/enlarged_pic.php'); ?>

to your tpl_product_info_display.php file. As with the tpl_modules_paps.php file included earlier, this display begins and ends with 'tr' tags, so should be placed within 'table' tags.