project: | Jax Guestbook (WWW Visitors Book) | |||||||||||||
file: | jax_guestbook.php | |||||||||||||
version: | 3.06 (optional database support) | |||||||||||||
interpreter: | PHP 4.02+, PHP 4.1+ | |||||||||||||
code: | Andreas John | |||||||||||||
design: | Andreas John | |||||||||||||
homepage: | www.jtr.de/scripting/php/guestbook | |||||||||||||
license: |
Copyright (C) 2001-2002, Andreas John (Jack (tR)) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license you can find in the added text file gpl.txt or on the website of the Free Software Foundation under: http://www.fsf.org/copyleft/gpl.html Please note, that I can give NO WARRANTY FOR DAMAGES CAUSED BY THE USE OF THE PROGRAM...
|
|||||||||||||
credits: |
It's just a tiny script, but I want to say a Big Thank You to all the people supporting this and other Open Source Projects by giving hints, translations and link it on their websites... Special thanx go to:
|
1. What's Jax Guestbook ? What do I need it for?
Jax Guestbook is a script, that enriches your homepage with a little WWW visitor's book. In a WWW visitor's book your homepage's visitors can add personal greetings and commentaries about your Website, as well as links to their own websites...
Current features of Jax Guestbook:
Instant messenger status indicator
(currently ICQ is supported)
IP logging for flood-protection (banning of multiple postings)
2. How to install Jax Guestbook on my website?
Jax Guestbook was written in PHP 4. It requires PHP - a server side scripting language that enables you to design websites with dynamical generated content! (If you did not already - ask your provider for PHP support!)
You don't need database support to run Jax Guestbook!
If you have PHP support on your website do the following:
3. How to use Jax Guestbook with MySQL?
Jax Guestbook can use CSV textfiles or MySQL database tables for saving the guestbook entries. Using MySQL gives you a better performance if you have a large guestbook...
If you have MySQL support do the following:
CREATE TABLE guestbook ( id int(4) NOT NULL auto_increment, date varchar(10) default NULL, time varchar(8) default NULL, ip varchar(16) default NULL, name varchar(30) default NULL, mail varchar(100) NOT NULL default '', age char(3) default NULL, location varchar(30) default NULL, homepage varchar(100) default NULL, icq varchar(12) default NULL, message text NOT NULL, PRIMARY KEY (id) ) TYPE=MyISAM; CREATE TABLE ips2block ( id int(11) NOT NULL auto_increment, ip varchar(16) NOT NULL default '0', timestamp varchar(10) NOT NULL default '', PRIMARY KEY (id) ) TYPE=MyISAM;
4. How many entries Jax Guestbook can handle?
Currently the script on my website handles about 300 entries (in CSV-file mode) and it makes it's job. Theoretically (depending on your webserver's space and power) it should be able to handle a larger amount of a few hundreds of entries. If you have a big guestbook using MySQL data source is the better way...
5. Can Jax Guestbook handle several guestbooks?
No problem! :-)
If you want to handle more than one guestbook on your homepage there are two
ways to accomplish it:
Either:
You put the script in separate directories (one for each guestbook). But this can become hard to handle the more guestbooks you use.
Or:
You call the script using the parameter guestbook_id e.g:
http://../jax_guestbook.php?guestbook_id=1
For security reasons the name of the guestbook file can not be forwarded with the URL.
The allocation of the guestbook IDs and the guestbook names (hold in the file globals.inc.php) you currently have to modify manually:
...
// Titel of the HTML-page
$gbfiles[0]->title = "Jax Guestbook";
$gbfiles[1]->title = "Guestbook 2";// Data source
$gbfiles[0]->data_source = "csvfile";
$gbfiles[1]->data_source = "csvfile";$gbfiles[0]->guestbookfile = "guestbook";
$gbfiles[1]->guestbookfile = "secondbook";$gbfiles[0]->ipblockfile = "ips2block";
$gbfiles[1]->ipblockfile = "ips2block2";// CSS template for the Guestbook
$gbfiles[0]->css = "styles/blue-orange.css";
$gbfiles[1]->css = "styles/blue.css";...
The example shows how to run a second guestbook with the same script:
The file secondbook will be used by the URL http://../jax_guestbook.php?guestbook_id=1
and corresponding the URL http://../jax_guestbook?guestbook_id=2 uses a third guestbook and so on...
You can freely choose the data source (mysql/csvfile) for each guestbook!
- There are no known bugs at the moment.
If you find any error or if you have proposals for improvement, please don't hesistate to contact me directly:
Berlin, 01.05.2002 - Jack (tR)