Java Shopping Cart Setup Documentation

Chapter 2 - JSC.ini control file.

The JSC.ini file contains various customizable parameters like colors, your mail server, email address for orders etc. We will cover each parameter in JSC.ini file in this chapter.

Each line in the file has a name=value setup.
The name is Upper/Lower case sensitive.

Sample JSC.ini file:

Title=VSSD Shopping Cart Ver 1.0 (c) 1998
BgColor=153,204,255
HSize=640
VSize=480
ChkOutHSize=500
ChkOutVSize=400
BtnColor=204,204,204
BtnChgColor=230,230,230
LogoBannerLn1=Welcome to our Web Catalog !
LogoBannerLn2=*
BtnSearchClick=Sys/2clicks.au
BtnSearchOver=Sys/1click.au
BtnShopCartClick=Sys/2clicks.au
BtnShopCartOver=Sys/1click.au
BtnCheckoutClick=Sys/2clicks.au
BtnCheckoutOver=Sys/1click.au
BtnHelpClick=Sys/2clicks.au
BtnHelpOver=Sys/1click.au
BtnPanColor=204,255,204
CatPanColor=204,200,204
InsPanColor=153,153,204
HedPanColor=204,204,153
StaPanColor=255,255,204
CGIserver=www.vssd.com
CGIscript=/cgi-bin/JSCCGI.cgi
SMTPserver=www.vssd.com
SMTPrelay=relay.pair.com
EMailName=VSSD_Test_Order
EMailFrom=jsc@vssd.com
FTPserver=*
FTPuser=1235555321321321123321456654876678987488
FTPpassword=34523453256723441124476456654876678987477
FTPdir=public_html/JSC/Ord
PSW=2408123321123321123321456654876678987456

Description of each parameter line in the JSC.ini file.

The Title parameter:
You can specify title for the main JSC window. Usually one uses company name.
Examples:
Title=VSSD Test Shopping Cart Ver 1.0 (c) 1997
Title=My company name

The background color for JSC:
You can specify background color for JSC with BgColor parameter. The color is defined by three numbers that represent Red, Green, and Blue values of 0 to 255.

You can define any color combination with these three values.
Examples:
light blue : BgColor=153,204,255
red           : BgColor=255,0,0
blue        : BgColor=0,0,255
white        : BgColor=255,255,255

Main JSC window horizontal and vertical parameters:
The HSize parameter specified horizontal size of the main window in pixels. The default set at 540 pixels.
Example: HSize=540.
The VSize parameter specifies vertical size of the main window in pixels. The default set at 420 pixels.
Example: VSize=420

JSC CheckOut Form window horizontal and vertical parameters:
The ChkOutHSize parameter specifies horizontal size of the checkout windows in pixels. The default set at 460 pixels.
Example: ChkOutHSize=460.

The ChkOutVSize parameter specifies vertical size of the checkout windows in pixels.
The default set at 400 pixels.
Example: ChkOutVSize=400

Main JSC window button colors:
The BtnColor parameter specifies button transparent color.
Example: BtnColor=204,204,204
When you move mouse over the button the color will change.
You specify that via BtnChgColor parameter.
Example: BtnChgColor=230,230,230

Initial Welcome messages:
You can have up to two lines of welcoming messages under the the banner image when JSC starts. See examples below:
LogoBannerLn1=Welcome to our company on-line Catalog !
LogoBannerLn2=We have the largest selection !
You can suppress these messages if you like by specifying '*'.
Examples:
LogoBannerLn1=*
LogoBannerLn2=*

Audio files for buttons on the main JSC window:

The following parameters are used to specify audio .au files for Search, Shopping Cart, Checkout, and Help buttons. Usually they reside in the Sys directory but can be placed in any directory.
See examples below:
BtnSearchClick=Sys/click.au
BtnSearchOver=Sys/move.au
BtnShopCartClick=Sys/click.au
BtnShopCartOver=Sys/move.au
BtnCheckoutClick=Sys/click.au
BtnCheckoutOver=Sys/move.au
BtnHelpClick=Sys/click.au
BtnHelpOver=Sys/move.au

Main JSC window buttons panel background color:
This is similar to JSC background color above.
Example: BtnPanColor=204,255,204

Colors:
These are additional colors definitions that can be customized to your needs. CatPanColor is the background color for insert catalog messages that are optional.
The InsPanColor is for banner background.
The HeadPanColor is for items list headings background panel color.
Example:
CatPanColor=204,200,204
InsPanColor=153,153,204
HedPanColor=204,204,153

The best way is to try several different setting and see what happens.
This is similar to JSC background color above.

Status line background color:
This is similar to JSC background color above.
Example: StaPanColor=255,255,204

CGI Server and Script Setup:
If you decide to use CGI script to process orders (see other options below) you will need to specify your Web server (usually the same as your site URL) and directory of cgi script (usually /cgi/bin) by setting CGIserver and CGIscript parameters. See example below. If you want to disable this put '*' as a server name.

Example1: Enable CGI processing
CGIserver=www.vssd.com
CGIscript=/cgi-bin/JSCCGI.cgi

Example2: Disable CGI processing
CGIserver=*
CGIscript=/cgi-bin/JSCCGI.cgi

Mail Server Setup:
One of the requirements for JSC to be operational is to have SMTP mail server available on the site where you keep your JSC Applet. This is a security restriction of Java Applets. The applet must be on the same server. You can also use FTP instead of SMTP to save your orders on the site. Read FTP Server Setup section.

How do you know if you site has SMTP enabled?

You can check this with you Netscape or Explorer browser by typing http://www.yourname.com:25 in the browsers URL field. The browser should connect to the server and return SMTP message similar to this '220 yourname.com ESMTP sendmail 8.8.5 ready'. If the server does not respond you probably don't have it and need to get an account with some Web provider that will have it. For example, Pair Networks will provide this type of account for $4.95 a month and $5 for installation www.pair.com.
For example if your domain is www.yourname.com and it has SMPT mail server running you specify.
SMTPserver=www.yourname.com and SMTPrelay=*
The EmailName and EmailFrom specify your company name and email for orders. You can disable Email process and save the orders on your site for later download via FTP.
The SMTPserver=* will disable email process.

Example 1:

SMTPserver=www.yourname.com
SMTPrelay=*
EMailName=YourComany
EMailFrom=Orders@yourname.com

On some systems you have SMPT server running but it has some restrictions. For example Pair Networks allows you to send mail to people on the same server only. If you try to send it to someone else it will be rejected. This will limit the use of your shopping cart. The solution for this situation is an Relay Mail Server. Pair Network provides relay mail server for your email. But the applet sits on the other server and cannot connect to Relay Server directly. The way to solve this is to connect to local SMPT server and tell it to pass email to Relay Server.

Example 2: Enable SMTP mail to use FTP.

SMTPserver=www.yourname.com
SMTPrelay=relay.pair.com
EMailName=YourComany
EMailFrom=Orders@yourname.com

The SMTPserver refers to the SMPT server name with restrictions. The SMTPrelay refers to the relay server that SMPTserver uses.

You can disable email order processing in case you don't want to use it or it is not available for you web account.

Example 3: Disable SMTP mail to use FTP.

SMTPserver=*
SMTPrelay=relay.pair.com
EMailName=YourComany
EMailFrom=Orders@yourname.com

FTP Server Setup:
You can use regular FTP protocol to save orders on your site and download them later. Many Web and/or ISP provides do not have mail server SMPT available on the same HTTP server where you keep your HTML pages and your JSC files. If this is the case you will have to disbale
SMPT server (see previous section) and use FTP protocol instead. Almost every web site has to have an FTP access. How else can you upload you html pages and images to the site. JSC uses the same method to save encrypted orders on your site. All you have to do is specify certain FTP information in the JSC.ini file. The FTPserver parameter specifies your FTP server name which is usualy the same name as your site address. If you need to disable FTP process use "*" as the server name (Example: FTPserver=*). The FTPuser contains user login id. It is ecrypted for privacy. You cannot specify this parameter simply by typing your user id here.
You need to use JSCD utility program to encrypt your user id. The JSCD will ask you for the location of the JSC.ini file and will make all needed updates in this file. See Chapter 6. The FTPpassword parameter is similar to FTPuser but contains your FTP encrypted password. You need to create it with JSCD utility as well. The FTPdir specifies the directory that you want to go to when saving your orders with this method. This name must conform with the Operating System standards that is used on your server.
You can use both SMPT email and FTP methods at the same time. The check out process will take a little longer if you do that.

Example 1: Enable FTP process

FTPserver=www.yoursite.com
FTPuser=2405555321321321123321456654876678987488
FTPpassword=24023453256723441124476456654876678987477
FTPdir=public_html/JSC/Ord

Example 2: Disable FTP process

FTPserver=*
FTPuser=*
FTPpassword=*
FTPdir=*

Password for Orders:
This should not be touched. It is updated automatically by Java Shopping Cart Decrypt utility module JSCD.
Example:PSW=18383321123321123321456654876678987456

up

next

webmaster@vssd.com

Copyright � 1996-1998 Vilgorin Software Systems Development.
All Rights Reserved.