Create a subdirectory for WebShop in your html directory and move the archive into the directory, for example
cd cd html mkdir webshop mv /path_where_archive_is/ws230-your_system_name.tar.gz webshop cd webshop where < path_where_archive_is> is the path to your download directory and < your_system_name> is system name(bsd, bsdi, etc.)
Unpack the archive
Unix : gzip -d ws230-your_system_name.tar.gz WinNT : pkunzip -d ws230-win-intel.zip OS/2 Warp: unzip -d ws230-warp-intel.zip
Extract the files stored in the tar volume
tar xvf ws230-your_system_name.tar (tar is a part of a standard distribution of every Unix system). For Windows NT and OS/2 Warp, skip this step.
Copy sample directory to get your own WebShop installation
Unix : cp -R sample my_shop WinNT and OS/2 Warp : copy sample my_shop
Configure
There are some things you need to configure before starting iNetLab WebShop
Ensure that www-server allows to run scripts from the directory that you set as CGI directory. (For details ask your web administrator). If it's not available move script(shop.cgi or shop.exe) to your CGI directory and edit CGI path in shop.conf
Register your copy of iNetLab WebShop
Open index.html file (that exists in my_shop directory) with java-capable browser (Netscape Navigator, Microsoft Explorer, HotJava, etc.)
Click to start iNetLab Webshop.
WARNING Read section Limitations of this manual carefully if you use an unregistered (demo) version!
Administrator password
Now it's a good time to select your administration password.
Note Evaluation version of WebShop has no password protection of Admin form.
Information about making your WebShop database secure can be found in
Securitysection of this manual.
Setup the shop.conf file in the config directory.
This file sets general configuration variables for iNetLab WebShop.
See comments in configuration files for information about parameters and
examples of usage.
A short list of variables available for configuration
Configuring iNetLab WebShop
Setup html files for your WebShop. Sample html file are presented in
the samle directory of WebShop.Its name is index.html.
Design html page as you wish, using the same applet codes as that is
in the sample.
| CGIPATH | URL of your cgi-bin directory where shop.cgi is stored |
| DATABASE | UNIX path of your database(db) directory |
| SHOP | URLs of a set of your .dat files |
| PLUGIN | a set of custom plugins |
| CREDITCARD | using credit card information |
| MAILTOSHOP | mailing orders to shop owner |
| MAILTOUSER | mailing orders to customer |
| BACKGROUND | background colors |
| MARK | a set of status marks for orders |
| STATE | The state where shop is placed to calculate taxes |
| STATE_TAX | Tax rate in this state |
| DISCOUNT | custom discount scheme |
| DISCOUNT_BY_SUM | custom discount scheme based on order total |
| DISCOUNT_BY_ITEM | custom discount scheme based on amount of items |
| SHIPPING | custom shipping costs scheme |
| SHIPPING_BY_SUM | custom shipping costs scheme based on order total |
| SHIPPING_BY_ITEM | custom shipping costs scheme based on amount of items |
| LANGUAGE | fix used language |
| CURRENCY | fix used currency |
| SCREXT | Extention of shop script(cgi, exe) |
NOTE: Netscape Navigator has a bug with parameters recognition. If you set the document encoding to be different from Latin1, the browser will not read applet parameters. If this happens, you should set the LANGUAGE parameter in the shop.conf file. It will override the applet parameter, but you will loose the ability of showing your catalog in different languages. USE THIS OPTION IF YOU ENCOUNTER PROBLEMS WITH NETSCAPE NAVIGATOR ONLY!
The PRICECOLS parameter defines the number of price lists. It can be useful for arbitrary discount systems you wish to implement.
Example: PRICECOLS = 3 implements 3 price lists.All catalog items are divided into sections by category. Section names must be enclosed in brackets.
Example: [Motherboard] defines the "Motherboard" section.All entries must be defined according to the following format:
(catalog item number) (short text description) (price1)....(priceN) DESC = (URL of the html file description) (optional) delimited by (BLANK LINE) Examples: MB-PT256 Pentium Triton2 VX 75-200 256K 106 103 101 DESC = files/desc.html LINE = One line description of the product MB-PT256 Pentium Triton2 VX 75-200 256K 106 103 101The last item has no description page and no single line description.
1. The total sum of any order cannot be greater than $500.
2. The admin has no password at all. Everybody may administrate iNetLab WebShop.
Probably web server couldn't find your shop.cgi or it's not allowed for execute
This means that the script(shop.cgi) is not able to write to your database.Where to get the last version of WebShop
The last version of iNetLab WebShop can be found at
http://www.inetlab.com/webshop/
How to register iNetLab WebShop
If you want to register an unregistered version, please
go to http://www.inetlab.com/webshop/buy.html or contact
Victor Pai (demon@inetlab.com)
Alexander Osipov (shu@inetlab.com)
or your local reseller.
You will receive recent information about the ways of obtaining a
serial number.
Troubleshooting
Web Server couldn't execute: http://www.your.server.name/your_home_dir/webshop/cgi/shop.cgi
You can detect the problem by pointing browser to this URL and read server message. If it'll be "file not found"
you need to edit shop.conf and enter there correct URL. Another message will mean script is not allowed to execute.
Just check is it so or consult your system administrator. Simplest way to make it executable is to perform the following command
chmod ogu+x cgi/*
ERROR: Couldn't create/open file /your_home_dir/html/webshop/my_shop/db/user.dbf
Check is the path correct(otherwise edit shop.conf). If path is correct be sure db
directory and all files are accessable by script. The simplest way is to perform the following command
chmod a+w my_shop/db
Note: Path used above is absolute Unix path, not URL!
How to contact the authors
You can contact the authors via the iNetLab Home Page at
http://www.inetlab.com. All bug reports may be sent to Alexander
Osipov (shu@inetlab.com). For purchasing and another marketing purposes
(reselling, etc.), contact Victor Pai (demon@inetlab.com).
If you found any errors and inaccuracies in this manual, please contact Victor Pai (demon@inetlab.com).