***************************************************************************
*   Page       : readme.txt
*   Startdate  : friday wednesday january 12 2005
*   Copyright  : (C) 2004 Donny Semeleer
*   Email      : donny at phpgb dot net
*   Version    : phpgb 2.0.6 en
*************************************************************************** 

Read this first before starting with the installation!


English is not my first language, so this instruction might be somewhat....unclear on some points, but I did the best I could...

If you already have version 1.0.x installed, use the update!! (Dutch only!)


***************************
*Updating from phpGB 2.0.5
***************************

If you are already using phpGB 2.0.5 and want to update to 2.0.6 you can either upload all files to your server. If you made modifications to your guestbook please go to the official website where you can find the online manual for updating the files manually. 

If you are using an older version then 2.0.4 please update to the next version, for instance, if you have version 2.0.1 running. Update first to 2.0.2 then to 2.0.2a then to 2.0.3 then to 2.0.4 then to 2.0.5 and then to 2.0.6

Before version 2.0.3 some users had difficulties with slashes in posts. This is fixed in version 2.0.3. However. Before this version a modification was given to get rid of the slashes. This mod does not work with version 2.0.3 and 2.0.4. If you have this particular mod installed; update to 2.0.3 then to 2.0.4 then to 2.0.5 and then to 2.0.6. More information about this can be found on the forum of phpGB.


******************
*The installation:
******************

To install this guestbook your server needs to have PHP, at least version 4.0.X, installed.
Also, a MySQL database, at least version 3.x is required.
PhpGB version 2.0 has been tested on Linux RedHat with Apache 1.3.x only so far!
But it can be assumed to function on other Linux distributions as well.
Version 1.0 was tested on Windows 2000 and XP with IIS 5.0 and 6.0 and with Apache 1.3.x,
because there were some changes in the codes regarding folder- and filereading made. Windowssystems could give problems. But again, it has not been tested so it could work.
 

Upload all files and folders in the folder phpgb2 to the related directory on the server.

If all files and folders are uploaded, you need to give the file 'configuration.php' writingpermission.
On Unix-based systems (Linux) you need to CHMOD the file to 777. More information about this can be found on the forum of phpGB, www.phpgb.net

If you've managed to give the configuration file writingpermission, go to http://www.yoursite.com/yourfolder/install_phpgb2.php to finish up the installation.

On this installationpage you need to fill in an userid, your e-mail address, two times your password and your favourite film. You will need the userid and password later to log on as administrator. The password needs to be filled in twice so the script can check it. If you leave the userid or the password blank, or you do not fill in two the same passwords, an error will occur. The userid can only contain (cap)letters, numbers and the famous dashes (-  and _). A valid e-mail address needs to be filled in along with your favourite film in case you forget your password.

Fill in the databaseinformation which you either got from your ISP or, when you have a server at home, you filled in yourself in the configuration from your database. The table_prefix is set on phpgb_ , this means that all databasetables will start with phpgb_ . This only needs to be changed if you are going to install more then one guestbook on the same database. At Guestbookurl you need to fill in the entire url where the guestbook is placed. If you uploaded the entire phpgb2 folder to your server, the url will be http://www.yoursite.com/phpgb2/ 
IMPORTANT: the url needs to end with a slash!! If you're hosting locally, on your own server at home, use a backslash instead of a slash! More information about this can be found on the online manual on www.phpgb.net.

The last thing you need to do is choose the language which you are going to use for the guestbook. PhpGB version 2.0 has standard an English languagefile and a Dutch (Nederlands) languagefile. If your language is not available you can make one yourself. More information about this can be found on the website of phpGB. If you made the wrong choice, you can change the language, once the guestbook is installed succesfully, through the settings.
 
Once you've filled in all fields, click on the button 'Install'. A connection with your database is made and all tables in the database are created. Also, some information is put into the tables. The file 'configuration.php' is also being re-written with the information you gave through the install page. After this is done, you will get to see 'All databasetables are created succesfully!'. If things did not go the way they were supposed to, you will get to see an errormessage. The installationscript will attempt to write-protect the configuration file once the info was written to it. This can give an errormessage. The installation itself was succesfull and all you have to do is write-protect the file manually by setting the CHMOD back to 644.
 
If, for some reason, you can't give the configuration file writingpermission, do not panic!
You can do it manually as well! Open the file 'configuration.php' with you editor (Notepad, Textpad, Wordpad, Dreamweaver, Frontpage, Hotmetal, etc.) before uploading it to the server and replace the following:


DBSERVER   -> The database Host
DBUSERNAME -> Username for the database
DBPASSWORD -> Password for the database
DBNAME     -> Name of the database
DBPREFIX   -> The prefix which you're going to use for the databasetables
GBURL      -> The complete URL where the guestbook is placed

When you replaced these values, save the file and upload it to the server. If you did this before installing the databasetables, go to http://www.yoursite.com/yourfolder.install_phpgb2.php and fill in all fields again! This way, the databasetables are created. You will get a couple of errormessages saying that the configurationfile was not writeable, but you can ignore those.

If the installation was succesfull, you can remove the file install_phpgb2.php from the server.

After the installation, go to http://www.yoursite.com/yourfolder/index.php and you will get to see the first message, posted automatically by the phpGB group. Scroll down and click on 'Administrator'. Login with the details you gave earlier and you can start with adjusting the settings as you like them. Do not forget to fill in your e-mail address. No one will see it and it comes in quite handy if you lost your password.

For questions and other stuff, you can visit the phpGB website at all times at www.phpgb.net. We have a forum where you can post your questions and an online manual where the installationprocedure is described once again!

Enjoy your guestbook

************************************

P.S.
If you run into a problem, check the forum too see if someone else hasn't already posted the problem and a solution for it.
 
 
 