#******************************************************
# FILE NAME:     README
#
# CREATED BY:    Webplus, Inc. Web+Applications Team
# CREATED ON:    October 31, 2000
# LAST UPDATE:   Sep 29, 2003
#
# DESCRIPTION:   Web+Shop v5.1.0 README
#		 
#		 This document contains instructions 
#		 for installing, configuring, 
#		 and troubleshooting Web+Shop.
#
# NOTE:          To install Web+Shop, it is required
#		 that you have Web+ installed in your
#		 server.
#
#
# (c) Copyright 2003, Webplus, Inc.
#******************************************************

------------------------
HOW TO USE THIS DOCUMENT
------------------------
Windows Users: For best viewing, open this document in Notepad and enable "Word Wrap" (in the Edit menu). To print this document, open it in Notepad or similar ASCII text capable word processor, then use the Print command in the File menu. 
Unix Users: View this file in your favorite text editor: pico, vi, emacs are all good choices.


CONTENTS
========
0.  Web+Shop 5.1.0 Documentation
1.  System Requirements
2.  Installing Web+Shop v5.1.0
3.  Configuring Web+Shop v5.1.0
4.  Getting Web+Shop 5.1.0 checkout portion to work under SSL
5.  Troubleshooting
6.  Technical Support


0.  Web+Shop 5.1.0 Documentation
================================
The full documentation for Web+Shop4.6 is in .pdf format (viewable in Adobe Acrobat Reader, http://www.adobe.com). It can be found on our ftp site at ftp://ftp.talentsoft.com/doc/webplus_shop_users_guide.pdf and can be read on all Windows and Unix platforms.  Web+Shop4.7 has added several promotional features and has some strutural changes.  Web+Shop5.0.0 has added new shipping options for UPS, USPS and FedEx. Web+Shop5.1.0 added templates for customization and pricing ability in product options. Please refer to Release.txt for these changes.  The added features are more or less self-explanatory in the user interface; more descriptions may be added later.  Users can always contact support@talentsoft.com if they have difficulties using the new features.

1. System Requirements
=======================
To install and use Web+Shop v5.1.0, the following minimum system requirements must be met:

1.1 Windows:
------------
*  Web+ v4.6 or higher (available at http://www.talentsoft.com)
*  Microsoft Access97 or higher (recommended)

1.2 Unix:
---------
*  Web+ v4.6 or higher (available at http://www.talentsoft.com)
*  mySQL 3.22.39 or higher


2.  Installing Web+Shop v5.1.0
==============================

2.1 Installing Web+Shop v5.1.0 on Windows/NT
--------------------------------------------
2.1.0  You must have Web+ installed on the server you're installing Web+Shop on. If you don't have Web+ installed, you can download it from our website at http://www.talentsoft.com. Before installing Web+Shop, make sure your installation of Web+ is functioning properly by accessing http://localhost/webplus/index.htm and verifying your installation. It is also recommended to test the database-related example applications to ensure your database connectivity is working properly. If Web+ is not working properly, refer to your Web+ documentation (available at http://www.talentsoft.com).

2.1.1  Download the self-extracting Web+Shop executable file into a temporary directory or run the file directly from the distribution CD to begin installing Web+Shop on your machine.

2.1.2  Since you have Web+ installed, check the checkbox to continue. You cannot install Web+Shop without Web+ installed.

2.1.3  Select the directory into which you want to install Web+Shop. By default, Web+Shop is installed in the directory c:\webplus\script\webpshop. If the directory already exists, the setup program will prompt you to back it up. Back up your previous version of Web+Shop in c:\webplus\script\webpshop\backup or a different directory of your choosing. 

2.1.4  Select your web server's HTML root directory. The default value will probably show the correct directory, based on your installation of Web+. You may change or browse to it if necessary.

2.1.5  Enter a password for securing FileIO to the configuration, images, and store template files. This will prevent other (non-Web+Shop) scripts from accessing these files without specifying the correct password.

2.1.6  After you input all required information, Web+ will create a program group, copy all files, and modify the system registry.

2.1.7  Use the shortcuts in the program group to access the Web+Shop default Store Entry and Administration pages.

2.1.8  This installation (Windows version) uses MS Access as the default database.  After verifying that the installation is successful, you can migrate to other databases.  Please refer to database/Sqlconfig.txt for instructions to migrate to MS SQL Server.  Other databases such as Oracle can refer to the same document and go through a similar procedure. 


2.2 Installing Web+Shop v5.1.0 on Unix 
============================================
2.2.0  You must have Web+ installed on the server you're installing Web+Shop on. If you don't have Web+ installed, you can download it from our website at http://www.talentsoft.com. Before installing Web+Shop, make sure your installation of Web+ is functioning properly by accessing http://localhost/webplus/index.htm and verifying your installation. It is also recommended to test the database-related example applications to ensure your database connectivity is working properly. If Web+ is not working properly, refer to your Web+ documentation (available at http://www.talentsoft.com).

2.2.1  Download the Web+Shop tarball into a temporary directory or copy the file from the CD to a temporary directory. Then install Web+Shop on your machine by running the shell script install_shop.sh. This script should be run as the root user. 

2.2.3  Select the directory into which you want to install Web+Shop. By default, Web+Shop is installed into /user/local/webplus/script/webpshop. You may change a different location if you wish. The installation script will lead you through the remaining steps of the install.


3. Configuring Web+Shop v5.1.0
==============================
There are several ways to configure various aspects of Web+Shop. You can use the Web+Shop Mall Administrator, Web+Shop Store Administrator, or  you can manually modify the webpshop.ini (webpshop.conf on Unix) and webp_global.wml configuration files using a standard ASCII text editor. Most configurations are made using the Mall and Store Administrator tools. The configuration files are used for configuring paths, the timeout time for administrator sessions (used for security), and the File IO read and write passwords.

Caution: We strongly recommend that you back up your original configuration file before you manually attempt to edit it.

3.1. Mall Administrator
-----------------------
You can add, rename, and delete stores using the Web+Shop Mall Administrator. 
It can be accessed at: http://yourhost/cgi-bin/webplus.exe?script=/webpshop/admin/login.wml. 
The login screen will appear. Login with your Mall Administrator username and password. 
The default username and password for the Mall Administrator are:
	Username: malladmin
	Password: password

3.2. Store Administrator
------------------------
3.2.1 Regular Store Administration:
You can manage inventory, process orders, customize the look and feel of your store, etc. using the Web+Shop Store Administrator. 
It can be accessed at: http://yourhost/cgi-bin/webplus.exe?script=/webpshop/admin/login.wml. 
The login screen will appear. Login with your Store Administrator username and password. One store is created by default during installation. 
The default username and password for this default store's Store Administrator is:
	Username: storeadmin
	Password: password

3.2.2 Store Affiliate Program Administration:
The Affiliate Program is added in v4.7 and has a different admin interface.  Each store has its own Affiliate Program that is administrated by the store administrator.  At the Login page, click Go to Affiliate Program Admin and enter the store admin's Username and Password to log in.  You can edit your Affiliate Program settings, manage your Affiliates, view your Affiliate transactions, approve new transactions, use a sum up page to change transaction status when you pay commission, and view your reports. 

3.3. webpshop.ini (webpshop.conf on Unix)
-----------------------------------------
Note: Be sure to backup your webpshop.ini or webpshop.conf file before making any changes.

You can change the timeout time (in minutes) for administrator sessions (both mall and store administrators) by changing the timeout number in webpshop.ini (located in the /webpshop/script logical Web+ directory).

The datasource name can also be configured in the Web+Shop config file. This must match the datasource name set in the ODBC Control Panel (Windows only) for the Web+Shop 5.1.0 database and in the [Datasources] section of the Web+Server Manager (all platforms).

If you are using Cardservice International LinkPoint as your payment processor, you can configure it for test transactions by changing the transmode (transaction mode) setting in webpshop.ini or webpshop.conf.  For other payment gateways follow the instructions from your payment gateway company.  Web+Shop5.1.0 provides the necessary input interface for carrying out the transaction.

If you need to change the displayed name of the Web+Shop product or the displayed copyright notice, this can also be done in webpshop.ini or webpshop.conf. Changing the displayed copyright notice does NOT change the status of Webplus, Inc.'s copyright on all code distributed by Webplus, Inc. that constitutes Web+Shop. It is only provided as a convenience to companies who wish to have a higher level of service branding.

3.4 webp_global.wml
-------------------
Note: Be sure to backup your webp_global.wml file before making any changes.

The following items are configured in the webp_global.wml:
* URLs and Paths to scripts and images
* FileIO read and write password - must match those set in the [FileIO] section of the Web+Server Manager


4.  Getting Web+Shop 5.1.0 checkout portion to work under SSL
===========================================================
After installing Web+Shop as directed above, open the configuration file (webpshop.ini on Windows/webpshop.conf on Unix) in the /webpshop/script directory (by default, located at webplus/script/webpshop/script). Change the "sslcheckout" parameter from 0 to 1. 

By default the line looks like: sslcheckout=0
Change it to read: sslcheckout=1

This will make Web+Shop 5.1.0's checkout portion to work under SSL for better security.

If you wish to have all pages of Web+Shop to work under ssl, then set sslcheckout=0 and make the link you use to connect to Web+Shop an "https://" link.


5. Troubleshooting
==================
5.1. Error Code = 10260: File access error.
-------------------------------------------
This problem is caused by a misconfiguration in the [FileIO] section of the Web+Server Manager. Make sure there are 2 logical/physical path mappings showing for Web+Shop. They are as follows:
Logical Path    Physical Path                              Read   Write
------------    -------------                              ----   -----
/webpshop       path to directory containing webpshop.ini   x       x
/webpshopHTML   path to webpshop in HTML Root Dir.          x       x


5.2. Error Code = 10220: Script file error.
-------------------------------------------
This problem is caused by a misconfiguration in the [Scripts] section of the Web+Server Manager. Make sure there are 2 logical/physical path mappings showing for Web+Shop. They are as follows:
Logical Path     Physical Path
------------     -------------
/webpshop        path to directory containing webpshop.ini
/webpshopHTML    path to webpshop in HTML Root Dir.


5.3. Images are appearing as broken.
------------------------------------
This is the result of the webpshop directory (the one containing the images directory) not being in the proper location. It must be in the HTML Root directory (ex. /usr/local/apache/htdocs for Apache or c:\inetpub\wwwroot for Windows)


5.4. I need to add more stores than Web+Shop allows (E-commerce edition).
-------------------------------------------------------------------------
Contact the Webplus, Inc. Sales Team to purchase a license for more stores. Contact information is below.


6. Technical Support:
=====================

For Web+Shop Technical Support, contact:	
	Web+Shop Technical Support
	Email:  support@talentsoft.com
	Web:    http://www.talentsoft.com

NOTE: Webplus, Inc. will not provide any technical support for Web+Shop if the files are
modified in any way not explicitly instructed in the official version release documentation or applicable patch instructions.

For Web+Shop Sales, contact:
	Webplus, Inc.
	Mail:   416 Production St. N., Aberdeen, SD 57401, USA
	Tel:  	(605) 229-0307
	Fax:  	(605) 229-0394
	Email:  sales@talentsoft.com
	Web:    http://www.talentsoft.com



(c) 2003 Webplus, Inc.  All rights reserved.

talentsoft, the talentsoft logo, Web+, and the Web+ logo are all trademarks or registered trademarks of Webplus, Inc.

Other brand names are trademarks or registered trademarks of their respective owners.
