Guestbook Administration - F.A.Q

Admin Section:
In this section you have the option to edit and delete posts. There are 3 control buttons for every post:
- Edit -> Lets you change the text of a comment.
- Delete -> Lets you delete the comment in question.
- Delete by IP -> Lets you delete all comments posted by the same IP address.

Config Section:

1. Database Options
2. Graphic Code Protection
3. Required Fields
4. IP Ban and Bad Words Filters
5. Posts Entries
6. E-Mail Options
7. Webmaster Options
1. Database Options

The following options can be configured only upon installation. You cannot change them after the Guestbook has been installed:

* Subject / Name / E-mail / Location / Homepage / Comment Length: This value specifies how many characters can be entered for the respective input field. Specifying too short lengths could be inconvenient for your visitors since they may not be able to enter all their info. Specifying too long lengths will make the database use more disk space on your account. We recommend that you leave the default values.

* BB Code enabled: Whether styles (bold, italic, underlined, quote, URL link) are enabled for the "Comment" field. If you disable this option, the BBCode buttons will be removed from the comment form automatically.
Default value: Yes

2. Graphic Code Protection

* Enabled: When enabled, visitors must recognize a graphic image to show that they are real visitors (and not spam bots). If this option is disabled, the graphic code image will not be displayed on the comment form. We strongly recommend that you enable the graphic code protection feature as it protects from automated spam entries in your Guestbook. Note that visitors can use the "Preview" feature without recognizing the graphic image.
Default value: Enabled

* Password Pattern: This pattern defines the set of characters that can be used in the graphic code image. The pattern is a standard regular expression, note the brackets at the begin and at the end. Only upper-case characters are accepted, lower-case characters will automatically be converted to their respective upper-case equivalents. For example, if you want to allow the characters A to Z and the numbers 0 to 9, you have to use the following password pattern:
[A-Z0-9]

We recommend that you use numbers only in your image code, as they are easier to recognize by humans. The default value for this field consists of the numbers from 0 to 9.
Default value: [1234567890]

* Password Length: This number defines how many characters your image protection will have. The characters used for the image text are defined by the "Password Pattern" field.
Default value: 5

* Image Height in Pixels: This number defines the height of the protection image. Adjust it for your custom design if needed.
If the option "Image Bigger Text" (see below) is disabled, the minimum height is 13 pixels. If the option "Image Bigger Text" is enabled, the minimum height is 25 pixels.
Default value: 27

* Image Polygons: When enabled, randomly generated color polygons will be displayed in the background of your protection image.
Default value: No

* Image Dots: When enabled, randomly positioned black dots will be displayed in the background of your protection image.
Default value: No

* Image Lines: When enabled, randomly positioned black lines will be displayed in the background of your protection image.
Default value: No

* Image Random XY: When enabled, every character of the protection image will be positioned using a random X and Y offset.
Default value: No

* Image Bigger Text: Sets a bigger font for the characters used in the protection image.
Default value: No

* Image Colors: When enabled, every character of the protection image will be colored in a randomly chosen color.
Default value: No

3. Required Fields

This option lets you define which fields must always be filled out by the visitor, for a comment to be posted successfully in your guestbook. In addition, the "E-mail" field can be validated by the Guestbook before accepting it. If a visitor enters an invalid email address, they will be asked to correct it.

The Guestbook provides two mechanisms to check if the required fields are filled out and valid:
- client-side - the input is checked via JavaScript before the form is submitted to the server. If an error is found, a message box is displayed in the visitor's browser.
- server-side - works after the form is submitted. In case of wrong input or input which contains words defined as "bad", a red error message is displayed in the form and the visitor is asked to correct their input.

The following fields are marked as required by default: Subject, Name, E-mail (also validated), Comment.

4. IP Ban and Bad Words Filters

The "Bad" word filter lets you ban words or phrases. The "Bad" words will not be accepted in any field of the input form. You can use wild-card words/phrases. Here are some examples:
*word -> this will ban words that end in "word", such as: "word", "password", "testword", "sword", etc.
sample -> this will ban the word "sample".
*ing* -> this will ban words that contain "ing", such as: "singing", "swing", "ingle", etc.
bad phrase -> this will ban the exact phrase "bad phrase".

Note that only one bad word/phrase can be entered per line. You can separate lines by pressing Enter. Use the "Save" button to update the list. You can get back to the "Config" section window by using the "Back" button.

The "IP Ban" filter lets you ban certain IP addresses or IP address ranges from accessing your Guestbook. Visitors whose IP addresses match the forbidden ones will not be able to see or post in your Guestbook. They will see a pre-defined message which states that they are banned. You have the option to ban either an exact IP address or to use an IP address range (Apache web server style):
127.0.0.1 -> this will ban visitors only from the IP address 127.0.0.1
127.0.0. -> this will ban all visitors from 127.0.0.* (127.0.0.0 to 127.0.0.255)

Note that only one bad IP address/range must be entered per line. You can separate lines by pressing Enter. Use the "Save" button to update the list. You can get back to the "Config" section window by using the "Back" button.

5. Posts Entries

* Entries Per Page: This number defines how many post entries will be shown per page.
Default value: 5

* Last Posted Entries at the Top of the Page: This option defines whether entries that were posted last should be displayed at the top or at the bottom of the page. In other words, this option defines the sort order of the entries in your Guestbook. Note that this also affects the position of the input form - if the last posted entry is displayed at the bottom of the page, then the form is displayed at the bottom of the page as well.
Default value: Yes

* Date / Time Format (PHP date() format): This field defines the format of the date/time stamp which is displayed for each comment. The format uses the same format as the PHP date() function. You can get more information about the formatting characters and their meaning at the following page: http://www.php.net/manual/en/function.date.php
Default value: D M j, G:i:s T Y (i.e. "Mon Sep 19, 7:26:19 EDT 2005")

* Show a "Thank You" Page on New Post: When enabled, a "Thank You" page will be displayed after the visitor posts a comment to the Guestbook.
Default value: Yes

* Encoding: Select the appropriate character encoding for your web pages and email notifications.
Default: USA / Western European (ISO-8859-1)

6. E-Mail Options

* Send an E-Mail on New Post: When enabled, the webmaster will receive an email notification upon new entry in the Guestbook.
Default value: Disabled

* From Address: The value entered here will be used as a "From" header in the email notification

* Subject: The value entered here will be used as a "Subject" header in the email notification.

You can edit the email notification message in the template file "tpl/client_new_post_email.tpl". Templates are discussed in the other section of this FAQ (Template Integration).

7. Webmaster Options

* Webmaster E-Mail: Enter your e-mail here. This e-mail address is used at the login page of the Administration panel. Furthermore, automated e-mail notifications from the Guestbook (if enabled) are sent to this email address.

* "New Webmaster Password" and "Confirm the New Password":
To change your password, enter the new password in both fields and click the "Update" button. If you leave these fields empty, the webmaster's password will not be changed.

Template Integration | Template Variables | Config / Admin Section