iNetLab WebShop v2.30 readme

How to install iNetLab WebShop
Configuring iNetLab WebShop
Limitations of the unregistered version
Where to get the last version of iNetLab WebShop
How to register iNetLab WebShop
Troubleshooting
How to contact the authors

How to install iNetLab WebShop

Download the WebShop 2.30 archive
You can download proper version of webshop from
here

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

  • CGI directory where shop.cgi script is stored. (default value may be ok)
  • The UNIX path to the database directory(db). You must change it probably.
  • URL to your shop.dat files (default value should be ok)
  • For quick run make database directory writable(chmod a+w db) and scrip executable(chmod a+x shop.cgi)

    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.

  • Choose "Obtain Key" subitem from Register menu item, and enter your registered serial number(or ILAB-DEMO)
  • Press the "Obtain Key" button in the window appeared.
  • For registered serial number you'll be asked for a password. Select your own password, you'll need it to re-register WebShop in future.
  • You will see the message "Requesting license from the server...". This time WebShop requests a license for your installation from our server and this step can take some minutes.
  • Wait for a "Thank you" message
  • Press the "Close" button. If all the above steps are performed correctly, the Register memu item will disappear. Installation is now complete, and you can start using 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.

  • Click to start Webshop Admin.
  • During the first login, the admin password is blank so press "Login" button.
  • Change it after the login to ensure security of your database.

    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.

    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.

    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


    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!

    Create your shop

    Setup the shop.dat files in the config directory. This file provides your catalog data for iNetLab WebShop.

    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 101
    
    The last item has no description page and no single line description.

    Limitations of the unregistered version

    If you have an unregistered version of iNetLab WebShop, you encounter two limitations:

    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.

    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

    Probably web server couldn't find your shop.cgi or it's not allowed for execute
    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

    This means that the script(shop.cgi) is not able to write to your database.
    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).


    (c) iNetLab 1997 webmaster@inetlab.com