System contains two files that you need to download to your computer.
The first file is the jsc2.zip
or jsc2_html.zip
(which utilizes HTML pages to display items) file
that contains the Shopping Cart itself.
Second file that you need to download is jscd2_demo.zip
or
jscd2_demo_exe.zip, which contains Decrypt program for ViaJCart for decrypting orders.
You need to have the WinZip or similar utility program to unzip this file. After you unzip
this file in the directory of your choice on your local PC, you will see "Jsc2" directory with needed subdirectories and files
under it. The
"Jsc2" directory has the working shell copy of the ViaJCart.
You must maintain the same directory structure. If you are uploading the
ViaJCart to Unix server, please remember that this is a case sensitive
server and you must maintain
the same Upper/lower case for all files and subdirectories as in
original zip file.
There is no need to run any type of installation or setup programs for ViaJCart itself.
Click on JSC.htm page to start the program.
You will need to upload the entire "Jsc2" directory with all subdirectories
to your web server. The "jscd2" (Decrypt
Utility) directory MUST stay on your local
machine.
The "scripts"(or "cgi-bin") directory contains the
CGI scripts. If you choose to use the CGI option of sending orders upload JSCCGI.cgi
"scripts"(or "cgi-bin") directory contains the
CGI scripts. If you choose to use the CGI option of sending orders upload JSCCGI.cgi
(JSCCGI110.pl for ViaJCart v2.20)
in ASCII (text) mode to "cgi-bin" directory on your server. You need to upload
other scripts Only if you choose to use Real-time processing option.
We
suggest using a separate FTP
program to
upload files to the server.
Make sure to upload all .ini and page files in ASCII (text) mode.
Applet Code:
Note: For jsc2_html.zip installation (if you would like to use HTML pages to display individual items) please click here.
Due to resent popularity of Apple's iMac we examined Mac Java platform and discovered that Java environment in Netscape 4.5 and
IE 4.5 are very buggy. As the result of this, our previous version of ViaJCart 2.21 doesn't run well on MAC.
The new version 2.3 was tuned (various work around methods to bypass Browser's bugs) to run on Mac as well as Windows. You
must upload two additional files for this jscm.cab and jscm.jar.
In addition, you must have two separate pages with the applet code. One for Windows and one for Mac. We provide Java Script code
that will automatically switch to appropriate page depending on platform.
Please look at the sample pages provided: JSC.htm, jscfrm.htm, jscfrmw.htm and jscfrmm.htm.
The JSC.htm page contains frameset with two frames (jscfrm.htm and JSCAudio.htm). The jscfrm.htm page contains JavaScript code to determine platform and load appropriate HTML page (jscfrmw.htm or jscfrmm.htm) with Applet code for Windows or Mac. It will place an image button to load ViaJCart on your page. The JSCAudio.htm will load random music page into invisible frame.
If you will not be using the background music feature disable it in JSC.ini file (Music=No). Then you can start with jscfrm.htm page.
JSC.htm page:
<html>
<head>
<title>ViaJCart</title>
</head>
<frameset BORDER="0" FRAMEBORDER="0" FRAMESPACING="0" cols="100%,*">
<noframes>
<body>
</body>
</noframes>
<frame SRC="jscfrm.htm">
<noframes>
</noframes>
<frame SRC="JSCAudio.htm" name="JSCAudio" MARGINWIDTH="0" NORESIZE scrolling="no">
</frameset>
</html>
jscfrm.htm page:
This sample jscfrmw.htm page used for Windows.<html>
<head>
<title>Java Shopping Cart</title>
<base target="_self">
</head>
<body>
<script language="JavaScript">
if (navigator.appVersion.indexOf("Mac") > 0)
location="jscfrmm.htm" ;
else
location="jscfrmw.htm" ;
</script>
</body>
</html>
jscfrmw.htm page:
<applet archive="jsc.jar" code="JSC.class" width=167 height=99>
<param name="cabbase" value="jsc.cab">
<param name=Image value="Sys/jsc2_cart.gif">
<param name=OverSound value="Sys/1click.au">
<param name=ClickSound value="Sys/2clicks.au">
<param name=Color value="204,204,204">
<param name=ChangeColor value="230,230,230">
<param name=StatusLine value="ViaJCart Shopping Cart">
<param name=Menu value="JSCMenu.ini">
<param name=Strings value="JSCStrings.ini">
<param name="Start" value="No">
<h2> Java Applet </h2>
</applet>
This sample jscfrmm.htm page used for Mac.
Please notice the difference for .jar and .cab files.
jscfrmm.htm page:
<applet archive="jscm.jar" code="JSC.class" width=167 height=99>
<param name="cabbase" value="jscm.cab">
<param name=Image value="Sys/jsc2_cart.gif">
<param name=OverSound value="Sys/1click.au">
<param name=ClickSound value="Sys/2clicks.au">
<param name=Color value="204,204,204">
<param name=ChangeColor value="230,230,230">
<param name=StatusLine value="Shopping Cart">
<param name=Menu value="JSCMenu.ini">
<param name=Strings value="JSCStrings.ini">
<param name="Start" value="No">
<h2> Java Applet </h2>
</applet>
If you want to make any changes, you will need to edit jscfrmw.htm and jscfrmm.htm page.
You can use any image you like for Java
cart program. Just point to it in the following parameter:
<param name=Image value="Sys/cart.gif">
*Note: The archive statement in the example above <applet archive="jsc.jar" code="JSC.class" width=50 height=50> 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.
*Note: If you place your HTML page with an applet code in the previous level of directory from "jsc2" 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="jsc2" 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.
If you are using Real Audio you will need to disable .au audio files by specifying NO in the following parameters:
The Real Audio has a conflict with .au files.
<param name=OverSound value="No">
<param name=ClickSound value="No">
If you are not using Real Audio files and want to use .au sounds use these parameters:
<param name=OverSound value="Sys/1click.au">
<param name=ClickSound value="Sys/2clicks.au">
The Main Menu and Strings files controlled via param statement in the case you need to have several carts in the same place with different Menus and Strings. Multiple JSCStrings files are very useful when you want to have cart in several languages that sharing the same image files.
<param name=Menu value="JSCMenu.ini">
<param name=Strings value="JSCStrings.ini">
Decrypt Program:
Note for Windows 95/98/NT users: Now we have native executable file for JSCD2 decrypt utility. There is no need to download and install Java Run Time Environment (jre115-win32.exe). Just download jscd2_demo_exe.zip. Unzip it and that is all. It will contain one .exe file and two .dll files. Just click on jscd2.exe to execute. For more information see Chapter 6.
Tip: When you decrypt orders and you want the JSCD2 to point to a specific directory when you open order files do the following. Create a shortcut on your desktop by dragging out the jscd2.exe file to your desktop from Windows Explorer. Click with the right button on the created shortcut and select "Properties". In "Start in:" input field enter the path to your orders directory.
Note for Mac users: Download zipped class files. Requires installation of Java Run Time Environment. ftp://www.vssd.com/jscd2_demo.zipIMPORTANT: You can get a Java Run Time Environment for Mac at: http://www.apple.com/macos/java/
*Note: DO NOT install Winsock 2.0 option. Just execute jre/jdk 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 JSCD2.exe file points to it.
After successful installation find JSCD2.exe file in the JSCD2 main directory. This is your executable file that you run to start the JSCD2 program. The JSCD2.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 "cgi-bin" 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 ViaJCart. This script uses a popular "sendmail" program that MUST be installed on your server for this script to work.
To customize ViaJCart
follow these steps:
=================================
1. JSC.ini - setup controls for colors, text, order processing options, etc.
2. JSCMenu.ini - setup Menu file
3. JSCStrings.ini - Change "Please Wait" window text to yours
4. Create image files and place in "Pic" directory
5. Create description files for each item and place in "Txt" directory or write them in catalog files.
6. Create catalog files and place them in "Cat" directory
7. Change shipping information in JSCChkOut.ini in "Frm" directory.
8. Write custom receipt message by changing JSCReceipt.ini in "Frm" directory.
9. Upload scripts to your "cgi-bin" directory.To edit HTML pages use any HTML editor, FrontPage for example. To edit .ini and script files use standard Notepad program that comes with Windows.
Files in the "Sys" directories contain image and audio files used by ViaJCart. You can create your own custom 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 ViaJCart.
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 ViaJCart can have up to 5000 records in each catalog. We would not recommend making such large files unless you use ViaJCart in the Intranet environment.
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 ViaJCart search will search the whole database of catalog files. If you have hundreds of catalog files with hundreds of items in each use CGI search feature.
There is no limit on how many items the ViaJCart 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 catalog files with 150 items in each file. This database will contain 100 * 150 = 15,000 items.These are the current limits for the ViaJCart:
- Upto 500 lines in JSCMenu.ini file
- Upto 10 levels deep
- Max catalog lines 5000
- Max shopping cart content 200
next
Chapter 1 - Installation
Chapter 2 - JSC.ini control
file
Chapter 3 - Menu file creation
Chapter 4 - Catalog files
Chapter 5 - Checking out
process
Chapter 6 - Order;
Encryption/Decryption process
Chapter 7 - ViaJcart
Customization with JSCStrings.ini
Chapter 8 - Audio Setup
Chapter 9 - Real-Time Credit
Card Processing
Chapter 10 - Troubleshooting
Chapter 11 - Upgrade From
1.x to 2.x
Copyright © 1996-2000 Vilgorin Software Systems Development.
All Rights Reserved.