		############################################
		##                                        ##
		##        WEB SHOP MANAGER v 2.0          ##
		##   by Daniel Williams & Stephen Hogg    ##
		##                                        ##
		##      http://www.webscriptworld.com     ##
		##                                        ##
		############################################
					
Copyright 2003 Web Drive Limited. All Rights Reserved.

This product is licensed, and may only be used under one Domain name.

Selling the code for this program without prior written consent is expressly forbidden.
Obtain permission before redistributing this program over the Internet or in any other
medium.  In all cases copyright and header must remain intact.

#######################################################################
#  DONATIONS                                                          #
#######################################################################

If you like this script please make a donation at PayPal (www.paypal.com) to 
daniel@webdrive.biz

Any amount is most appreciated and will help us continue to develop and improve 
our scripts.


########################################################################################

ABOUT THE WEB SHOP MANAGER

The Web Shop Manager allows you to manage a fully functional online store from a 
centralized web-based administration system.

The notes below describe the features of the Web Shop Manager, as well as support notes.
Please read the following notes before setting up your Web Shop Manager.

QUICK FEATURES

* Items grouped by category
* Multiple options per item
* Searchable database
* Stock availability options
* Multi currency 
* Tax options
* Freight options
* Full web-based shop administration

Descriptions below...

########################################################################################

ABOUT SECURITY

Security Features:

* Max 3 Login attempts allowed. Upon 3 incorrect attempts the Password file is locked
  and an email message sent to the administrator informing of the breach.
* Credit Card numbers are not stored, but sent via email, and can be encrypted using PGP
  (download PGP from www.pgpi.net)

########################################################################################

SETTING UP THE WEB SHOP MANAGER FOR ADVANCED USERS

1. Create a directory called "webshop" or something similar. Chmod to 707.
2. Inside this directory create 2 directories. "admin", and "images"
3. Chmod to 707 "admin"
4. Upload the INDEX.PHP, ADMIN.PHP, STYLE.CSS, FUNCTIONS.PHP files to the "admin" directory
5. Upload all other files to the base directory
6. Chmod to 707 DBASE.TXT, FREIGHT.TXT, PAYTYPE.TXT, VARS.PHP
7. Access the admin from "yourdomain.com/webshop/admin/index.php"

########################################################################################

SETTING UP THE WEB SHOP MANAGER FOR BEGINNERS

First you need to create a directory where you will store the Web Shop Manager.
"webshop" is a good name to use. Now change the permissions of this directory (chmod) to 
707. You can do this in most FTP clients by selecting the directory and choosing the 
option "Change File Attributes".

Upload these files to the directory you just created:
- checkout.php
- dbase.txt
- freight.txt
- footer.php
- functions.php
- header.php
- index.php
- mail.php
- paytype.txt
- style.css
- vars.php
- view.php

Now create the following directories:
- admin
- images

Now chmod the following files and directories to 707:
- admin
- dbase.txt
- freight.txt
- paytype.txt
- vars.php

Upload these files to the admin directory:
- admin.php
- functions.php
- index.php
- style.css

Now via the Web go to the "yourdomain.com/webshop/admin" directory you just created. 
You will be prompted to enter a password. You can choose anything you like, but ensure
you remember the password as you'll need to enter it every time you access the Web Shop
Manager.

Note: For added security it is a good idea to change the name of the index.php file 
to something else. This will make it even harder for hackers and crackers to find your
login page. A blank html file is created by the script to remove the directory listing
in the browser. If you do change the name you will need to change the file name we post 
to in index.php and admin.php.

You can change the password at any time by selecting "Change Password" on the menu.

Once you have logged in for the first time you'll need to enter some information about 
your site, server, and shop configuration.

The Set Up already includes some variables as a guide to setting up.

* GENERAL SETTINGS *

1. URL to the Web Shop
Enter the full URL to your Web Shop, e.g., http://www.yourdomain.com/webshop

2. Email
Enter the email addresses where you want orders sent.

3. PGP USERNAME
Enter the username for your server so messages can be encrypted.

4. Sort by Alpha
When checked the database will be sorted alphabetically upon adding items.

5. View Cart on Add Item
When checked the "View Shopping" page will be displayed upon adding an item. 
Unchecked the customer will be able to continue adding items on the page.

6. Number of Options
This is the number of form fields for entering multiple options for an item.

7. Extra Charge
If you have any extra charges at check out enter the name and amount here.


* FREIGHT SETTINGS *

1. Add Freight
Checked this will add freight to the total upon ordering.

2. Freight Options
Here you can add different freight options.


* TAX SETTINGS *

1. Tax Name
This is the name of your goods and services tax for your country.

2. Tax Percentage
Enter the percentage the total will be charged in tax.

3. Tax Included
If checked the message will display "items include tax". Otherwise, excluded and tax 
will be added at check out.


* CURRENCY SETTINGS *

1. Currency
Enter your currency, e.g., US Dollars, Australian Dollars, etc.

2. Currency Symbol
Enter your currency symbol, e.g., $, , etc.


* MESSAGES *

1. Pre-Order Message
This will be displayed in the "Important Messages" area at check out. You can include
HTML if needed.

2. Post-Order Message
This will be displayed once the order has been completed. You can include HTML if needed.


* PAYMENT OPTIONS *

1. Payment Types
Enter the different payment types you accept. Enter each item on a new line.


You can change any of this information at any time by selecting "Settings" from the menu.

########################################################################################

USING THE WEB SHOP MANAGER

Now that you've gone through the initial set up process you'll be ready to start using the 
Web Shop Manager.

###########################################
* Adding an Item *
###########################################

To add an item select "Add Item" from the menu. Then proceed to complete the following 
fields:

1. Category 
Enter a category name for this item, e.g., Books, CD's, etc.
If you've previously added items a select list will appear with other categories you've 
added.

2. Item Name
Enter the name of the item.

3. Item Type
If this is a single item select "Single". If the item has multiple options select 
"Multiple".

4. Item Options
For multiple options enter each option name and its price here. There are a maximum 
of 5 options per item.

5. Price
For single items, enter the price here.

6. RRP
If your price is lower than the regular retail price, you can enter the normal price
here, to compare pricing.

7. Image
Product images should be uploaded to the "images" directory you created during set up.
Select the item image from this list.

8. Availability
Select whether the item is currently in stock, out of stock, or advance order only.
If out of stock, the item will still be displayed but cannot be ordered.

9. Advance Date Available
If the item is advance order only, you can enter the date when the item will be 
available. 

10. Details Page
If you have another page describing more details you can enter the URL here, or 
enter an address to another site.

11. Description
Enter the item's description here.


###########################################
* Editing and Deleting Items *
###########################################

To edit or delete a forum select "Edit Items" from the menu. Select an item and choose 
"Edit" or "Delete".

If you are editing an item you can change any of the fields you completed when adding 
the item.

###########################################
* Header, Footer & Style Sheet *
###########################################

You can customise the look at style of the Web Shop Manager by editing these files:
- header.php
- footer.php
- style.css

###########################################
* Uninstalling the Web Shop Manager *
###########################################

Since the files created by the WSM are owned by the user "nobody" you'll need to run 
the uninstall to remove all the files created by the script.

To uninstall select "Uninstall" from the menu. Click the button labelled
"Uninstall WSM". Be warned, ALL files will be removed from the directory!


########################################################################################

Copyright 2003 Web Drive Limited
