
---------------------------------------
PgMarket: some hints for final users...
---------------------------------------

According to the included PostgreSQL dumps, the root password is "password",
and the pratesi's password is "marco71".
Passwords are stored md5'ed; they ARE NOT transmitted as clear text passwords:
they are md5'ed on the client side through JavaScript.
See the included md5.js and all related forms, you will note some "fake" forms.
Clients with JavaScript disabled are not able to login.
A warning is provided to clients that try to signup with JavaScript disabled.

In the products description field you can also insert HTML code intead of text;
you simply have to take care to avoid errors.
Please also note that all the inserted new lines are preserved
when the product description is shown, as they are converted on the fly
to the "<br>" tag through the nl2br() PHP function.
This choice is done mainly to allow preservation of new lines
when simple text is inserted.
You can disable it simply replacing ovwbr() with ov() where you you want.

The Fiscal Code is used in Italy, it depends on personal informations
such as the First Name, the Second Name, the Birth Day, and so on,
and it also contains some kind of "checksum".
As it is not used in other countries, I have provided a signup form
for non italian persons, it does not contain the Fiscal Code input.

The Company identification number consists of 11 digits,
hence a "demo" number (a demo Partita IVA) can be 11111111111

You can assign a "special_level" to each product;
products are shown ordered by special_level.
Furthermore, when you add/edit a product, you can check
the "Special Product" box if you want that product to appear
in the "Special Products" section in the PgMarket home.

Products without images can be handled, too: simply insert
a new product without choosing an image.
You can add an image later by editing the product and choosing
an image.
You can also edit a product without changing its image:
simply edit it without selecting an image, and, if an image
is already used, it will be maintained; if no image is already used,
the product will remain without any image.
Finally, if you want to change a product's image, simply
edit it and choose a new image.

Discounts: please see the demo to understand how they are handled.
If you do not want to discount a product, simply either do not fill
the corresponding values or set them to 0.
Otherwise, if you want to discount a product, choose discount
and discqty; if at least discqty items of that product are requested,
such items are discounted according to the discount percentage.

To set the dependence between weight and delivery price, please
customize the ending part of cart.inc.php

W.r.t. the import feature, keep in mind that
in the "users" table, the "usertype" field is "pf" for persons
(Persona Fisica in Italian) and "az" for Companies (AZienda in Italian).

I will try to document any other "obscure" feature of PgMarket...
please, remember: your feedback (yes, just you, I am talking to you :)
has a noticeable importance to obtain a good documentation...
moreover, cooperation is just in the spirit of GNU :-)

--
Marco Pratesi
http://www.telug.it
pratesi@telug.it

