INSTALL - PHPWEBTHINGS 1.0
-----------------------------

Now phpWebThings follows some guidelines for development:

- Needs PHP > 4.1
- Using superglobals ($_GET, $_POST, $_SESSION);
- no warnings should be displayed;
- web based installation
- web based configuration
- the langs now are an array instead of several defines,
	and there is the dev_tools/lang_checker to check if
	a translation is ok;
- every module can add a style.css at main.php without tricks;
- the menu is database driven now (but the default ones);
- *all* sideboxes are dynamic now. When using polls or picofday, don't forget
	to add a sidebxo form them, or whty won't show;
- better internationalization.

Because of some sessions issues, missing checks for configuration
and several others issues, I decided to stop the 0.5 release at
test7, and started 0.6 from the scratch. Then I began porting
the modules for the new standard, changing every access to 
globals into super globals, that is more secure.

This version uses the new phpdbform-0.4.2, fixing
internationalization issues, also as phpdbform uses
style for its forms and for right display at adm fields,
these classes were added to phpWebThings theme.

The theme has changed too, now it's the file main.php that
render the site, and following the example, themes are
much easier to develop now. I hope so.

A lot of users' modules were tested to get in 1.0 version.
Some of them didn't get in because of fail to follow for_developers.txt.
As soon as I get time, I will fix them and add them to phpwebthings.


INSTALLATION:
-------------

- First unzip or untar the file to a directory of you choice;
- chmod 0777 /var/avatars
- chmod 0777 wt_config.php (optional)

- open in your browser http://www.yourdomain/install.php
Follow the instructions there, and you will have all tables
created and an user for adminsitration too. If you chmoded wt_config.php,
it is correct for using, or edit it and fill with the information
from install.php.

- *delete* the install.php, or you will have problems.

- Now, you can run your site. Login in with the user you created,
enter at WebAdmin and configure the options for you, the modules, etc.
then enter My Account the complete your info there.

Please, enter at WebAdmin menu and press submit at every configuration
page to be sure that all configuration is stored at the database.

You can add menu items with the menu editor, simply click at Menu
link in the administration box and add your menus.
Check at info.php to don't overwrite the standard positions of
the phpwebthings menu. (phpWebThings has a simple check to
avoid overwrites, but don't count on this, its ulgy ;-)).
Normally phpWebThings menus are at positions incremented by 10.

All texts are stored at the lang dir, you can edit them to change
what text you want, just beware of the %s and %d used on it.

If you plan to use the avatars, set write access to all at
/var/avatars.

If you will use filemanager, some modules need their especific folders
to be write access to all:

modules/banners/images
modules/downloads/images
modules/news/images
modules/news/cat_images
modules/picofday/images

Please set write access to all only at these folders! OR strange things
can happens at your site. If you don't plan to use avatars neither
filemanager, don't set write access to any folder.

Only images are allowed to be uploaded.

If you plan to remove phpWebThings, beware that images uploaded by phpWebThings
should be deleted by phpWebThings, because the users that created these
files are the same user that runs the web server, that is genereally different
of your ftp user.
If you forget to delete these files, you'll need to ask for your server
administrator to clear your folder, or create a php script to do that.

This application may contain bugs and errors, feel free to send them to me!

I hope that you like to use phpwebthings as I like to make it!

If you wish to help us, join our team! It's necessary to know CVS,
SQL and PHP.

Paulo Assis
paulo@phpdbform.com
http://www.phpdbform.com
http://www.phpwebthings.org
