X-Cart:Gift Registry

Overview

The module is intended for creating Gift Registries for different events (for instance a birthday, a wedding, etc). Gift Registries are a good tool for managing put off products (Wish list) and allow to:

• sort out products by event according to what products you'd like to buy for this or that occasion;

• inform your friends about your plans and wishes;

• keep track of products being bought

• This module supplements the Wish List and can’t be activated without activation of the Wish List. It increases the functionality of the Wish List with a number of new features. Namely, you get the ability to:

• create and manage 'events'. Each event has the following set of characteristics:

• status: public/private/disabled

• date of event

• title

• description shown to the guests in the events list of Search results and in the Wish List of the event

• HTML-card which is customized HTML content created by the author of the event ( for example, detailed info about place and time of an event) which is opened in a pop-up window when a guest visits event wish list

• create 'event wish lists' - sets of products you would like to be bought for a particular occasion (including Gift Certificates and configurations).

• control who may access event information and event wish lists.

• create 'recipients lists' - lists of names and e-mail addresses of event participants to whom notifications of the event and event wish list contents will be sent.

• edit and preview the e-mail notification content

• import/ export recipients list in CSV-format ( the option may be switched off in General settings/Gift Registry options)

• use guest books where visitors can leave messages regarding this or that event ( it may be disabled)
• move products between event wish lists and the main wish list ( any product may be added to the event wish list only through the main wish list)

• track the amount of purchased products in event wish list

Installation

The process of installing the module X-GiftRegistry is the same for X-Cart Gold and X-Cart Pro.

To install the module, take the following steps:

1. Download the module distributive from the File area of your X-Cart Account. The file you need is named x-'giftreg'-x.y.z.tgz, where x, y and z are the numbers of the module version (must be the same as the version of your X-Cart).

2. Uncompress the archive file x-'giftreg'-x.y.z.tgz and copy the resulting files to the directory where your X-Cart is installed. The file INSTALL.X-GIFTREG provides instructions for installing the module.

Note: Please make sure you keep the directory structure during unpacking and uploading, otherwise some necessary files can be overwritten!

3. Run in the browser the installation script: http://www.yourhost.com/xcart_dir/install-x'giftreg'.php

4. Enter your authentication code, read the License Agreement and, if you accept the terms and conditions of the License Agreement, click the Next button.

Note. The authentication code is issued on completion of X-Cart installation. It is used to prevent unauthorized re-installation of X-Cart. You also need to know this code to install any purchased X-Cart modules. If you do not remember your Auth code, you can look it up at any time in the file include/install.php.

5. The installation script will copy the files and make all the necessary changes in the database.

Note. If, while running the installation, you get any messages marked red, it means some errors were encountered and the installation has not been completed properly. Resolve the issues causing the installation process to be interrupted and run the installation wizard from the beginning.

Click on Next to proceed.

6. After the installation is completed, you will get a message informing you of the completion of the installation process.

Now you need to enable the module and configure it for work with your X-Cart based store.

To uninstall

To uninstall X-GiftRegistry, do the following:

1. Launch the Installation Wizard (Point your browser at the location of your store with the addition of /install-xgiftreg.php)
2. At the first step of the Installation Wizard (Step 1: License agreement), select the 'Un-install the module' radio button.
3. Click the Next button.
4. The Installation Wizard will remove the module files and deactivate the module (Step 2: Uninstalling the module). Click Next to proceed.
5. Step 3: Uninstallation complete is the final step of the uninstallation process. It notifies you that the module has been successfully uninstalled.

Important: After uninstalling X-GiftRegistry, be sure to remove the module distribution package from your web directory.