"Fossies" - the Fresh Open Source Software Archive
Member "php3guest-1.8.0/README" (16 May 2006, 4810 Bytes) of package /linux/www/old/php3guest-1.8.0.tgz:
As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard
) with prefixed line numbers.
Alternatively you can here view
the uninterpreted source code file.
2 v 1.8.0
3 (c) Bastian Friedrich 2000-2006
5 php3guest is a guestbook implementation for PHP using a mysql database as a
6 backend. You are granted usage rights as stated in the GPL (see file COPYING)
8 Get the current version from http://www.bastian-friedrich.de/comp/guestbook/
10 A WORD IN ADVANCE (for Version 1.8.0)
12 I have used php3guest as my personal guestbook for my private web site for a
13 number of years now. Unfortunately, the guestbook has been spammed with
14 commercial and semi-commercial entries in the last one or two years; I scarcely
15 get "normal" entries any longer.
17 Although I have implemented a number of anti-spamming techniques preventing
18 most automated spamming bots from entering in the guestbook, I probably will
19 shut down my guestbook in the future. This version of php3guest, 1.8.0,
20 probably will be the last release.
22 Due to the fact that I lost contact with most of the original translators,
23 the anti-spamming labels in the language packs have NOT been updated to reflect
24 the changes. English-language labels will occur in those files!
29 - Create a mysql database (i use the name "guestbook"), e.g. with mysqladmin
30 "mysqladmin -pyourpassword create guestbook"
31 - Create a table definition
32 ("mysql -pyourpassword guestbook < table-definition.mysql") or something like
34 - copy the guestbook script and the config files to an arbitrary directory
35 in your web site directory
36 - copy the sample php3guestrc.php.sample to your personal config file,
38 - edit the (hopefully self explaining) config file php3guestrc.php; You will
39 not have to change anything in the script itself.
40 - READY!
43 WHAT YOU WILL NEED
45 - A running installation of mySQL
46 - Sufficient rights to create, read and write a new database and a table in it.
47 If you do not have these rights, your administrator MIGHT help you :)
48 - A webserver with PHP (PHP > 4.1.0)
49 - The php3guest package
52 WHAT YOU SHOULD CHANGE IN THE CONFIG FILE
54 - The password for private entries. Note that this password will eventually be
55 transmitted as clear text and may be interceptable by third people. So do NOT
56 choose your regular passord (which is a bad habbit anyway)
57 - If you want to receive any new entries as email, change $mailEntries to "1"
58 and set a mail address in $mailEntriesTo. $mailEntriesFrom can be set to an
59 arbitrary account which is allowed to send email. If you do not like the
60 default subject, change $mailEntriesSubject as well.
61 - Change $defaultLanguage to your preferred language. Multiple sample files are
63 - If you want viewers to switch the interface language, fill in the
64 "$possibleLanguages" variable with the desired languages (space separated) and
65 remove unneeded packs, respectively.
66 If you want a button to change the language (i.e. if you don't have
69 - Activate the desired anti-spamming techniques: antiSpamImage is enabled per
70 default. The maximum entry length is set to 8 kB.
71 - If you get regular spam with similar content, create "forbiddenWords" arrays,
72 consisting of a word list and appropriate reject texts for each phrase. There
73 are two samples in the default php3guestrc.
76 A full reference of all available settings in php3guestrc.php can be found at
79 A full reference of all variables in the language specific files
80 (php3guest.language.inc) can be found at
84 A SHORT NOTE ON SESSIONS
86 php3guest relies on PHP session handling to transport login information and
87 user settings. In PHP's default setup, it will set browser cookies to
88 establish session handling, but it can use URL variables as well if se up
91 If you have direct access to your php.ini, you may want to set
92 session.use_trans_sid = 1 and session.use_only_cookies = 0
93 Depending on your web server's setup, you may be able to set these flags in
94 a local .htaccess file. Simply uncomment the second and third line in the
95 supplied sample file.
97 TESTED WITH...
99 - Linux 2.4.x, 2.6.x
100 - MySQL 3.23.48, 3.23.55, 4.1.13
101 - PHP 4.1.0, 4.3.1, 5.0.4
102 - Apache 1.3.23, 2.0.46, 2.0.54
106 php3guest was developed for my personal needs, but with an eye on other users'
107 requirements. I hope it will fulfill your needs. If you are happy or unhappy
108 with anything my script provides, feel free to email me (flames will go to
109 /dev/null ;)
112 Bastian Friedrich
113 Freiburg, Germany