###################################################################### Installation - phpWebSite 0.8.x ###################################################################### Language phpWebSite comes in different languages. Make sure get the language you want to use. Do not use the unprocessed source code of phpWebSite for your site. You will get TRANSLATE[[...]] statements everywhere. Requirements phpWebSite requires PHP v4.0.6 or higher This can be downloaded at: http://www.php.net/ You need to have PHP session support compiled in! You also need to have register globals set to ON! For more info on how to configure those options read the related chapter below. phpWebSite also requires MySQL. This can be downloaded at: http://www.mysql.com/ You must have create privilages on the database you are going to use! ###################################################################### Instructions Installing phpWebSite 0.8.x ###################################################################### 1. Gunzip the phpWebSite tarball into the web directory of your choice. 2. Edit the config.php file to match your system and your preferences. The config.php file is commented to help you with this task. *IMPORTANT* The Database Config section MUST be complete. Decide your database name now. You should at least have a look at security_hash and cookiePrefix, and pay special attention to all path names. 3. Create a database in MySQL using the name you declared for your database in the config.php file above Ex. # mysql -uroot -p mysql> create database database_name; mysql> exit Alternatively, you can also create the database with phpMyAdmin. phpMyAdmin can be downloaded from: http://www.phpwizard.net/projects/phpMyAdmin/ or (better) from SourceForge https://sourceforge.net/projects/phpmyadmin/ 4. Read _carefully_ the notes below about common PHP configuration pitfalls and configure your site or server accordingly, if neeeded 5. Set permissions for the images directory so you can upload images. we recommend the following: # chown -R nobody.nobody images/ # chown -R nobody.nobody mod/mainpage/images/ # chown -R nobody.nobody mod/userpage/images/ # chown -R nobody.nobody mod/userpage/uploads/ This assumes your websever runs as the user "nobody" and that you can do this (i.e. have root access) on your server. If you cannot do this (your running on a host), do folowing: # chmod -R 777 images/ # chmod -R 777 mod/mainpage/images/ # chmod -R 777 mod/userpage/images/ # chmod -R 777 mod/userpage/uploads/ 6. phpWebSite has a completely web-based install - point your browser to: http://your_phpWebSite_powered_site.com and follow the onscreen instructions. 7. Point your web browser at your new phpWebSite powered site. You can administer your site by going to: http://your_phpWebSite_powered_site.com/admin.php and logging in using the following: Username: admin Password: phpwebsite Remember to change the admin password (Edit Admins) in order to protect your site! 8. Delete or move the setup folder when you have confirmed your successful installation. 9. If you want to install the calendar module delivered with the package, you need to point your browser to calendar_setup.php. After you installed the module, you may delete or move the calendar_setup.php files. ###################################################################### Common PHP configuration pitfalls ###################################################################### Chapter index: 1 - Sessions 2 - The register_globals flag 3 - Error meggages handling 1. Sessions ----------- To make phpWebSite work you need PHP to be compiled with session support in. This can only be done at compile time; you can check if sessions support in built-in reading the output of a script like: The are two common issues with sessions, which can be easily solved. a) When you try to validate your site with the W3C XTML validator it outputs a lot of errors like: * Line 77, column 35: ...