VSSD logo

bullet 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.

color_pic.jpg (5445 bytes)

*Note: not available sign The Free Version of VSSD JSC has a name of JSCF. Everything else is the same.

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:

arrow The Menu file JSCMenu.ini
arrow The Strings file JSCStrings.ini
not available sign
arrow Create catalog files in Cat directory
arrow Create new image files in Pic and Sys directories.
arrow Create new text description files in Txt directory.
arrow 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.

up.gif (442 bytes)
up

nextnext.gif (435 bytes)

Send Email

webmaster@vssd.com


VSSD logo
w w w . v s s d . c o m


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