PHP-WSadmin

Welcome to PHP-WSadmin, a PHP tool for editing and maintaining your
WebSeller-Databses. 

The main purpose of PHP-WSadmin is to provide a simple interface for
editing your databases and image-collections for the WebSeller, a
powerful eCommerce-solution (take a look at www.webseller.de if you
haven't done it yet ;). For this, PHP-WSadmin provides a easy to use
webbased-interface to the most-used databases. The script also provides
an interface for uploading and maintaining the picture-collections related
to your products.

The program works out-of-the-box with a "default"-WebSeller, if you are 
using some very special features or if you have changed your databases
there are good chances, you have to edit this code as well :)


Installation:
Please refer to the file INSTALL, where you will find instructions for 
installing this tool onto the same machine your WebSeller-installation 
stays. It is - of course - possible to install this script somewhere else,
in that case you will have to provide a "local" copy of your webseller.ini
so PHP-WSadmin can read relevant data out of it. In addition the script
needs access to the MySQL-installation your WebSeller is working with.
Every customization is done via webseller.ini or wsadmin.php.


Usage:
When you start the script via your browser, you should see a productlist.
Potential warnings or errors will possibly shop up on top of the table.
Here you can see potential installation-problems (database connect not
possible, certain files not found etc).
If you don't see any messages in red or yellow, chances are good, everything
is working :)
In the productlist you will see a list of products (what have you expected? :)
with the most used properties. Be default on a single page 15 items will be
displayed (you can change this value in wsadminconfig.php). On top of the
table you will see the pagenumber and the total number of articles/pages.
You can browse through the pages by either clicking on the arrows or giving
an explicit number to jump on.
In the row beneath you can give some search-criteria (in MySQL-Syntax) which
will be linked in an AND-fashion.
When you click on a table header (item number for example), the result will
be sorted by that criteria.
It is possible to edit some values from one article and submit a "quick edit"
by clicking onto "edit" in the appropriate row. By clicking on "edit all"
all the changes you have done will be committed.
You can easily delete an article by clicking on "delete" in the appropriate
row. If you click on the item number of an article, a new screen will open
where you can edit more properties of the article and also upload images.
Everything there should be self-explanatory.
The tables for editing products groups, producers and product-types are
working identically, but there you can't browse through the pages, everything
is shown on a single page.


Troubleshooting
The most common problems are:
- database connect not possible
- image-uploads aen't working
The first problem should only occur if PHP-WSadmin is installed on a
different machine than the WebSeller itself. In this case you should
indemnify that MySQL-Connects are possible from this machine with the 
credentials listed in your webseller.ini.
Image-Uploads won't work if the WebSeller-image-directory isn't writeable
by your webserver or there are already some files in it, which can't be
overwritten by your webserver. In these cases you will have to set correct
file-permissions. There aren't any step-by-step instructions for doing so,
because every Un*x is different, sorry, but you will have to find it out on
your own.
It is existential that the installtion directory of PHP-WSadmin is protected
by means of your webserver. If that directory is public-readable, EVERYBODY
will be able to edit your product-databases, so GOOD care should be taken
here!
For more tips and hints please have a look at the forum on 
http://www.webseller.de.


Requirements:
- a working Webseller 3.x
  (earlier version will only work if they are using MySQL as datasource)
  If you have modified the database structures, you will have to edit
  also this script!
- MySQL reachable by network from the PHP-WSadmin-installation (credentials
  are given in a local copy of webseller.ini)
- Webserver with PHP 4.x (earlier version might work, but I don't believe it ;)
  Everything was tested under Solaris 8, Apache 1.3.x, PHP 4. It should work
  under different OS's and/or webservers but we haven't tested it yet
  (You feedback would be appreciated)
- Image upload will only work if your PHP supports file uploads and a write-
  able tmp-directory (refer to the PHP-documentation for further instructions)


Copyright:
PHP-WSadmin is released under the GPL. Please see the file COPYING for
further issues regarding the use andd copying of this software.


You can get new releases of PHP-WSadmin via http://www.webseller.de (have
a look at the 3rd-Party section there).
