Chapter 1 - Installation.
The VSSD JSC system contains two files that
you need to download to your computer. The first file is the jsc.zip
file that contains the Shopping Cart itself. You need to have the WinZip utility program
to unzip this file. After you unzip this file in the directory of your choice on your
local PC you will see two directories "Jsc" and "cgi-bin" with
needed files under them. The "Jsc"
directory has the working shell copy of the VSSD JSC. There is no need to run any type of
install or setup programs for VSSD JSC itself. Click on JSC.htm
page to start the program. You will need to upload the "Jsc" directory with all subdirectories
to your web server.
Second file that you need to download is jscd.zip or
jscd_exe.zip which contains the
decrypt utility JSCD to decrypt your orders. DO NOT upload "Jscd" directory, it stays on your local
machine.
The "cgi-bin" directory contains the CGI script that you need if you will use the CGI
option of JSC Deluxe version. You need to upload this script to the cgi-bin directory on
your server.
Add the following code to your HTML page. It will place an
image button to load JSC on your page. Check JSC.htm as an example.
<applet
archive="jsc.jar" code="JSC.class" width=50 height=50>
<param name="cabbase" value="jsc.cab">
<param name=Image value="Sys/cart.gif">
<param name=OverSound value="Sys/jsc.au">
<param name=ClickSound value="Sys/click.au">
<param name=Color value="204,204,204">
<param name=ChangeColor value="230,230,230">
<param name=StatusLine value="Shopping Cart">
<h2> This browser does not support java </h2>
</applet>
*Note: The first parameter in the example above <param
name="cabbase" value="jsc.cab"> is used by Microsoft
Internet Explorer 3.0 or higher. The jsc.cab file contains compressed Java class files. It
allows IE to load JSC up to 40% faster. Netscape does not support this. You should not
change this value.
Free Version: The free version users should have
"jscf.cab" in the value <param name="cabbase"
value="jscf.cab">.
*Note: The archive statement in the example above (first line) is used by the
Netscape 4.0 browser. The jsc.jar file contains compressed Java class files. It allows
Netscape 4.0 to load JSC up to 30% faster.
Free Version: The free version users should have
"jscf.jar" in the value <applet
archive="jscf.jar" code="JSCF.class" width=50
height=50>
*Note: If you
place your html page with an applet code in the previous level of directory from
"jsc" directory you will need to add codebase parameter to an applet code.
Replace first line above with the following line:
<applet archive="jsc.jar"
code=JSC.class codebase="jsc" width=50 height=50>
The HTML Applet code above is self
explanatory. The color numbers stand for numeric RGB
values. Red Green Blue from 0 to 255.
The second file is the jre115-win32.exe that
contains the Java run time environment that you need to install to run Java Shopping Cart
Decrypt JSCD utility program. *Note: DO NOT install
Winsock 2.0 option. Just execute jre115-win32.exe file and follow instructions on
the screen. The setup program will install Java Run Time Environment into C:\Program
Files\JavaSoft\JRE\1.1 folder. Please do not change this directory setting during
installation because the JSCD.exe file points to it.
After successful installation find JSCD.exe file in the JSCD main directory. This is your
executable file that you run to start the JSCD program. The JSCD.exe is not an executable
file but a Windows 95 Shortcut file. Click on it with right mouse button and select
properties option. Select Shortcut tab. The Target input field will contain something like
this: C:\Windows\jrew.exe -cp C:\Dev\devjava\JSCD JSCD. You will have to update the
directory name after -cp parameter with your JSCD directory path.
For example if you put VSSD JSCD files into C:\javashop\jscd directory your shortcut path
will look like this:
C:\Windows\jrew.exe -cp C:\javashop\jscd JSCD
The instructions above apply to Windows 95/NT only.
The "jsccgi"
directory contains CGI Perl script JSCCGI.cgi that you need to upload to your site in
cgi-bin directory if you decide to use the CGI order processing feature of the Deluxe
version. This script uses a popular sendmail program that MUST be installed on your server
for this script to work.
To customize JSC to your specific needs you will have to make changes to:
The Menu file JSCMenu.ini
The Strings file JSCStrings.ini 
Create catalog files in Cat directory
Create new image files in Pic and Sys directories.
Create new text description files in Txt directory.
Update JSC.ini file
Files in the Sys directories contain image and audio files used by JSC. You can create
your own customized images and/or audio files and place them into Sys directory overlaying
default files with the same names.
How to Organize
your data to effectively use JSC.
The best approach is to create several catalog files by category. Each catalog file should
have no more than few hundred records although 50 to 100 would be more convenient to a
customer. The Deluxe JSC can have up to 5000 records in each catalog. I would not
recommend making such big files unless you use JSC in the Intranet environment.
The free version supports up to 25 catalogs with
maximum 20 items per catalog (500 items total).
The Menu file will point to each catalog depending on the menu option. When customer
selects specific menu option only one catalog will be loaded and displayed. This way the
customer can search the menu and find items that he needs quickly.
The JSC Deluxe search will search the whole database of catalog files. If you have
hundreds of catalog files with hundreds of items in each the search might take up to
several minutes depending on you Internet connection speed. If you have under 1000
items it should be reasonable. If you have 1000 to 10,000 items it might take longer.
There is no limit on how many items the JSC Deluxe can handle because you split your data
into small catalog files that are loaded individually.
For example in your Cat directory you can have 100 cat files with 150 items in each file.
This database will contain 100 * 150 = 15,000 items.