"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 or download the uninterpreted source code file.

    1                          php3guest
    2                           v 1.8.0
    3              (c) Bastian Friedrich 2000-2006
    4 
    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)
    7 
    8 Get the current version from http://www.bastian-friedrich.de/comp/guestbook/
    9 
   10 A WORD IN ADVANCE (for Version 1.8.0)
   11 =====================================
   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.
   16 
   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.
   21 
   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!
   25 
   26 
   27 INSTALLATION
   28 ============
   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
   33   that
   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,
   37   php3guestrc.php
   38 - edit the (hopefully self explaining) config file php3guestrc.php; You will
   39   not have to change anything in the script itself.
   40 - READY!
   41 
   42 
   43 WHAT YOU WILL NEED
   44 ==================
   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
   50 
   51 
   52 WHAT YOU SHOULD CHANGE IN THE CONFIG FILE
   53 =========================================
   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
   62   included.
   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
   67   JavaScript enabled), set $usableWithoutJavascript to 1 (or revert to 0,
   68   respectively).
   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.
   74 
   75 
   76 A full reference of all available settings in php3guestrc.php can be found at
   77 http://www.bastian-friedrich.de/comp/guestbook/config.html
   78 
   79 A full reference of all variables in the language specific files
   80 (php3guest.language.inc) can be found at
   81 http://www.bastian-friedrich.de/comp/guestbook/language.html
   82 
   83 
   84 A SHORT NOTE ON SESSIONS
   85 ========================
   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
   89 properly.
   90 
   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.
   96 
   97 TESTED WITH...
   98 ==============
   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
  103 
  104 MooOOH!
  105 =======
  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 ;)
  110 
  111 
  112 Bastian Friedrich
  113 Freiburg, Germany
  114 bastian@bastian-friedrich.de
  115 http://www.bastian-friedrich.de/
  116