Using Sales-n-Stats with X-Cart software

Beginning from X-Cart version 4.0.18 integration is not required, you only need to adjust the settings of the corresponding module and import the .sns file containing Sales-n-Stats settings.

If you are going to use Sales-n-Stats for monitoring a store based on X-Cart of an earlier version, the integration should be done by means of a special integration module Sales-n-Stats connector. Download from the section 'Software distributives' of Sales-n-Stats 'File area' the archive of the integration package xcart-x.y.z-connector.zip, where x, y, z are your X-Cart version numbers.

Note: Sales-n-Stats integration with X-Cart software by means of the integration package is fully functional for X-Cart versions 4.0.14 and later. Use of the package with earlier versions is possible with a special patch furnished with the module distributive. See the integration instructions for earlier versions below in the section 'Integration with X-Cart versions prior 4.0.14'.

The process of integration by means of the integration package is the same for X-Cart Gold and X-Cart Pro.

•	xsns-x.y.z.tgz - integration module Sales-n-Stats connector;

•	xcart-x.y.z.sns - X-Cart-specific settings for import into Sales-n-Stats;

After downloading the archive from the 'File area', uncompress it and follow the instructions in the file INSTALL.X-SNS.

Uncompress the archive xsns-x.y.z.tgz and copy the resulting files to the directory where your X-Cart is installed.

1.	Run in the browser the installation script: http://www.yourhost.com/xcart_dir/install-xsns.php X-SnS connector installation wizard is launched.

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

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 X-Cart modules (if you purchased any). If you do not remember your Auth code, look it up in include/install.php file at any time.

3.	The installation script copies the files and makes 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 interrupting the installation process and run the installation wizard from the beginning.

4.	Log in to the admin area. In the 'Administration' menu go to the 'Modules' section.

6.	Go to the 'General settings' -> 'Sales-n-Stats connector options' section.

7.	Specify the location of your Sales-n-Stats Data Collector by entering its HTTP URL and, if applicable, HTTPS URL.

Note: If the monitored website has a https version make sure that the domain is the same for both http and https. For example your data collector URLs might be http://example.com/sns_collector and https://example.com/sns_collector. If the domain names are different, the same visitor will be identified as two different visitors if he moves from a http to a https page and vice versa.

8.	Depending on the platform of your Sales-n-Stats collector (php or ASP.Net), specify the extension of Sales-n-Stats collector files (PHP or ASP).

Note: For the current version of Sales-n-Stats only a php-based collector is available, so choose 'PHP'.

9.	Enter the same passphrase that you use to access Data Collector.

As a result of SnS connector module installation, the operator button ('Click for Live Help') is automatically integrated into the template skin1/customer/home.tpl. If you do not want your visitors to be able to initiate visitor-to-operator communication, manually remove the following piece of code:

<TD width="150" valign="top">
{if $active_modules.SnS_connector}
{include file="modules/SnS_connector/button.tpl"}<BR>
<BR>
{/if}

After installing and configuring the integration module, you need to import X-Cart-specific settings into your Sales-n-Stats.

1.	Locate the file xcart-x.y.z.sns. Click Open. 'Import system settings' dialog is displayed.

2.	Make sure the necessary check boxes in the 'Import system settings' dialog are selected. Click OK. The zones used for Quick start demonstration are replaced in the Site Monitor by the zone set typical for X-Cart (Default zone, Catalog, Product info, Cart, Checkout, Help&Legal).

Do not forget to select the appropriate template set for Sales-n-Stats elements that appear on your X-Cart-based site (Main Menu -> Tools -> System settings -> Data Collector -> Web templates).

The installation process for X-Cart versions prior 4.0.14 differs for X-Cart version 3.4x and X-Cart versions 3.5.x-4.0.8.

For all X-Cart versions prior 4.0.14 first install the integration module - Sales-n-Stats connector. The installation of the integration module is the same as for X-Cart version 4.0.14. Refer to 'Installing integration module' section for more information.

After installing the module, you need to apply a special patch that enables your X-Cart to function using the module code for X-Cart version 3.4x only. The patch can be applied using the command patch<patch.DIFF. The patch that needs to be applied is a file named patch.DIFF that is located in the directory where your X-Cart is installed (it appears in that directory after you uncompress the module archive and copy the resulting files to your X-Cart root directory). If for some reason you cannot apply the patch in the way described above, manually edit the code of the script config.php located in X-Cart root directory.

if (!@include_once(../modules/SnS_connector/config.php)
@include_once(./modules/SnS_connector/config.php);

For X-Cart versions 3.4x, 3.5x-4.08 you also need to insert the operator button manually. To insert Sales-n-Stats operator button (Click for Live Help/Leave a Message) into your store website:

{if $active_modules.SnS_connector}
{include file=modules/SnS_connector/button.tpl}<BR>
<BR>
{/if}

into the template responsible for the part of the customer front-end in which you want that button to appear.

Normally it is the template customer/home.tpl (at the top of one of the side columns of the central area of the interface).You should also use the SnS connector of an appropriate version. Do not use the patch for these versions.

Beginning with X-Cart version 4.0.8 all you have to do is install the module and the operation button is integrated automatically.