CyberStrong eShop Installation and Setup Guide

Installation | License Agreement | Upgrading | SQL | Revision History

Installation Instructions

Welcome to CyberStrong eShop the easy to use, easy to install shopping cart system for Windows servers.

To install CyberStrong eShop proceed as follows:

• Create a sub folder off the root folder for your Web site. We recommend naming your folder eShop, but you may choose any name you wish. Microsoft FrontPage users may find it beneficial to create a separate "web" to store their eShop files.

• Give your eShop folder permissions. To operate properly, your eShop folder will require modify permissions for the "IUSR_<Machine Name>". If you need assistance in setting your folder permissions, please see these screen shots.

• Unpack the contents of this zip file into your eShop folder. The zip file contains a number of sub folders so be sure to check the box "Use sub folder names" (or the like) when you unpack.
  
  Optional: If your host provider requires that you move your eShop database to another folder, locate and change the line:
  
                         ReturnValue = RootPath & "<database name>.mdb"
  
  in the file userexit.asp to reflect this by following the instructions contained therein.

• Test your server. Your CyberStrong eShop comes with a utility to test your database connectivity and server compatibility.  To run the utility, launch the URL http://<your domain name>/<your eShop folder>/_Test.asp and follow the instructions contained therein. We strongly recommend running these tests prior to attempting to operate your eShop.

• Test your installation. Our database comes pre-configured with a small collection of products for a fictitious café. To launch your CyberStrong eShop, load the following address into your browser: http://<your domain name>/<your eShop folder>/10Browse.asp. You should see a display of the items in the café. Move through the screens and place a test order. There are five screens in total. Note that your CyberStrong eShop software is shipped in "Demonstration Mode" to make initial testing and learning easier.

• Configure your eShop software by launching the following URL: http://<your domain name>/<your eShop folder>/_Login.asp where you will find further instructions on configuring your shopping cart software. Your temporary Login ID and password is cyberstrong which will be automatically entered for you until you change them in eShop Setup/Security.

• Link to your new shopping cart. When you are ready to go live with your shopping cart, click the Demo Mode button at the bottom of eShop Setup and set the parameter "Demonstration Mode" to "No". Create a link from your Web site to 10Browse.asp. Be sure to fill in your Secure and Non-Secure prefixes in eShop Setup/Payment. If you are unsure as to how to secure your shopping cart, please contact your host provider.

Many of the common problems encountered when setting up your CyberStrong eShop are covered on the FAQ page on our Web site at www.CyberStrong.com/eshop.

  [top]

License Agreement - Please Read Carefully

Each source code page of this product has been seeded at point of sale with one or more lines of unique information. Every copy of CyberStrong eShop is traceable to its purchaser. No portion of this code may be copied, redistributed or resold without the written permission of CyberStrong Internet Services, Inc. All violators will be prosecuted.

CyberStrong Internet Services, Inc has confirmed the operation of this software through careful testing. By using this software you agree that CyberStrong Internet Services, Inc. will not be held responsible for chargebacks, errors, loss of revenue, loss of data, intrusion by hackers, web server failure, downtime, hardware failure or any disputes that may arise from the use of this software in modified or unmodified form.

CyberStrong eShop software is supplied 'as is'. No warranty is given either implied or expressed. Purchasers use this software entirely at their own risk.

Each purchase of CyberStrong eShop, including any gateways and/or add-ons, entitles the purchaser to install the software on one web site and one development machine only. The purchaser is permitted to make alterations to the software, but the copyright of the original code remains with CyberStrong Internet Services, Inc. Any software which uses any portion of CyberStrong eShop as a base may not be resold without the expressed written permission from CyberStrong Internet Services, Inc. Further installs of CyberStrong eShop will require further licenses to be purchased from CyberStrong Internet Services, Inc.

Export of CyberStrong eShop software outside the United States of America, in whole or in part, without the expressed written permission of CyberStrong Internet Services, Inc. is strictly forbidden.

CyberStrong Internet Services, Inc reserves the right to refuse to sell CyberStrong eShop to any individual or organization for any reason.

NO REFUNDS WILL BE GIVEN. Before purchasing, the purchaser should satisfy him/herself that he/she has the technical ability to set up the software, that the software will run on the hardware/software platform that it is intended to run on and that the software is appropriate and capable of fulfilling its required role. If in any doubt, please contact CyberStrong Internet Services, Inc before purchasing.

Although we encourage the customization of CyberStrong eShop by qualified ASP programmers, you agree that CyberStrong will not be held responsible for the correct operation of its software following the modifying of its source code or database structure in any way, or by the entering or modifying of data in its database by any means other than the supplied Web-based database administration screens.

CyberStrong's copyright messages within the software code may not be removed. Branding is not permitted without the expressed written consent of CyberStrong Internet Services, Inc.

CyberStrong Internet Services, Inc reserves the right to suspend or revoke all licenses sold to a purchaser if the terms of this contract have been breached or CyberStrong's copyright has been violated. In such circumstances, the purchaser's upgrade, technical support and VAR privileges are suspended immediately and until such time as determined by CyberStrong, not exceeding 90 days following correction of the breach.

In the event that the purchaser's license has been revoked by CyberStrong, the purchaser agrees to destroy all copies and derivatives of the software in its possession within seven (7) days.

This agreement and all claims or issues regarding it shall be governed according to the laws of the Commonwealth of Virginia. Any legal action arising from the terms of this agreement must be brought within one (1) year following the original date of purchase and must be brought in the Commonwealth of Virginia.

Use this software at your own risk.

  [top]

Upgrading your CyberStrong eShop

The following will assist you in upgrading your CyberStrong eShop software.

Version numbers

CyberStrong eShop is released with version numbers of the following form:

major.minor.revision

CyberStrong eShop releases carrying version number 1.4.0 or later are upgradable without loss of product data. To upgrade your database to the current version, proceed as follows:

1. Install and test your upgrade package in a new folder as described in the section Installation Instructions above. There is no need to adjust your configuration settings at this time.

2. Once your upgrade is running properly, copy your old database over the new one.

3. Log into the admin area of your new eShop. Use the Fix utility found in eShop Setup/Maintenance to bring your old database up to the new revision. Test it again.

4. New releases of CyberStrong eShop often contain new configuration parameters and tables. Each of these are initially supplied with intelligent defaults to get your upgrade up and running quickly. However, to get the most out of your CyberStrong eShop upgrade it's a good idea to review all your configuration parameters at this time.

5. If you have made changes to the eShop source code in order to customize it, you will have to manually re-apply these changes to your upgrade and re-test.

6. Rename your old eShop folder to archive it, then rename your new eShop folder back to its production name.

7. Your upgrade is complete.

Compatibility Issues

Version 5.5 reorganizes the file structure of eShop to remove the need for parent pathing on your server. All eShop runtime files are now located in it's root folder. Files used for administration screens are prefixed with an underscore (_).

Embedding eShop in your existing Web site has been dramatically simplified. All eShop front-end pages now use the single file, /custom/cart/StoreFront.asp for embedding. Please review the page "Customizing the look and feel of your eShop" located in the help index of your eShop's admin area for details on embedding your eShop in your site. Upgrading customers should note that pages 10Browse.asp through 50Finish.asp are no longer template pages and should not be used as such. Please also note that the folder /cartlib is no longer required.

The following file names, located in your /custom folder, have been changed.

The styles styCellBrowseDark, styCellBrowseLight, styCellBrowseNav and styPageTitle were added to /custom/cart/Styles.css to support eShop's new customer login optional add-on.

The additional substitutions, $(ShippingMethod) and $(TrackingURL), may now be used in your "has shipped" e-mail template file /Custom/Cart/Email/Shipped.txt.

In eShop's userexit.asp file, specification of MS Access databases has changed from:

Case usrGetDBPath
  ReturnValue = RootPath & "database/" & cstDatabaseName   ' Simple Path

To:

Case usrGetDBPath
  ReturnValue = App.RootDataPath(cstDatabaseName)   ' Simple Path

Also, in userexit.asp, the case:

Case usrGetAdminFolderName
  ReturnValue = "admin"
  UserExit = True

is no longer used and may be removed.

Case usrCalcShippingCharges
' Sample custom shipping calculation ...

    ReturnValue = UserVal1 * 0.1

If ReturnValue < 1.00 Then
    ReturnValue = 1.00
End If
UserExit = True

Case usrGetDBPath
    ' Returns path to MSAccess database. Uncomment and/or modify one:

    ReturnValue = App.RootDataPath(cstDatabaseName)     ' Simple Path
  ' ReturnValue = "/data/" & cstDatabaseName            ' Relative to Web Root Folder
  ' ReturnValue = "d:/inetpub/myweb/" & cstDatabaseName ' Full Path
  ' ReturnValue = "DSN=eShop"                           ' System DSN

    cstServerType = "MSAccess"
    UserExit      = True

Case usrGetConnectString
    ReturnValue = "Driver={SQL Server};Server=ServerName;
                   Database=DataBaseName;UID=UserID;PWD=Password"
    cstServerType = "SQL"
    UserExit      = False