OpenBook beta 1.2.2

- 2nd May 2002

OpenBook is a simple PHP/MySQL guestbook application which is fast and lightweight.

This guestbook has been developed and tested under Windows running Apache using MySQL 3.23 and 4.1.0. The latest version can be obtained from the download page and a working demo is available at http://openbook.sourceforge.net

Note: all files are best viewed with a tab size of 2.

Installation

Note: it is recommended that you set "magic_quotes_gpc" to "off" in your php.ini file or an .htaccess file.

  1. Unarchive package (.zip, .tar.gz) using a suitable archiving application, eg. Winzip, Powerarchiver,WinRAR, etc. You'll have a directory named openbook-version containing all the required files.
  2. Open common.php in your favorite text editor and look for the following lines:
    $dbhost="localhost";  // database host address
    $dbuser="root";     // database user name
    $dbpassword="";   // database password
    $default_db="openbook";  // name of database
    You may also want to change the other settings in common.php to suit your preferences.
  3. Change these values to suit your database configuration and save the file.
  4. Upload all the files to your host using a FTP program like CuteFTP, WS_FTP, or LeechFTP.
  5. Run the install script install.php. For example, if you uploaded the file to http://www.yourdomain.com/openbook/install.php, you'd point your web browser there and that'd run the install script.
  6. Once installation is completed should go to the admin panel (User ID: admin, Password: 12345) to change your password.

Upgrading from versions 1.2.0 or 1.2.1 to 1.2.2

Note: no upgrade script is available so if you've made modifications to the script, you'll lose those changes!

  1. Edit the settings in common.php (installation step 2).
  2. Upload and overwrite your old files with the new ones (ATTENTION! You'll lose any modifications you've made to your previous installation).
  3. Run the upgrade script upgrade_1.2.2.php.

Upgrading from versions earlier than 1.2.0

Note: no upgrade script is available so if you've made modifications to the script, you'll lose those changes!

  1. Edit the settings in common.php (installation step 2).
  2. Upload and overwrite your old files with the new ones (ATTENTION! You'll lose any modifications you've made to your previous installation).
  3. Run the upgrade script upgrade_direct_1.2.2.php.

Change Log

Version 1.2.2 Version 1.2.1 Version 1.2.0 Version 1.1.1 Version 1.1.0 Version 1.0.12 Version 1.0.10

To Do list

  1. visitor can give a rating for the website
  2. easy theme-based altering of appearance of guestbook for administrator
  3. smilies
  4. allow BBcode-like input for users
  5. avoid resubmits by caused by pressing "Back" or by double-clicking
  6. notification of new guestbook entry to administrator via email
  7. "Preview Post" option
  8. page-spanning
  9. ability for admin to add comments

Support

You can post any queries, bugs or comments in the forum at http://openbook.sourceforge.net/forum. You can also contact me at redemption@fastmail.fm.

Disclaimer

This application is licensed under the GNU General Public License (GPL). Details of the license can be found in the license.txt file included in the package.