FAQ

FAQ = Frequently Asked Questions (and the answers)

Frequently Askes Questions

How to install the Guestbook?
How to import the default Guestbook of CMSimple?
How to create a new Language?
How to protect against SPAM?
How to avoid < SCRIPT > or < HTML > in the entries?
How to change the colors of the guestbook?
How to change the fonts of the guestbook?
How to display the date and time information?
How to use mail notification?
Why do I need to switch off the guestbook?

Questions & Answers

Q: How to install the Guestbook?

A: A description how to install is available here (under the section installation). For individual questions and problems according the installations please use the forum.

top


Q: How to import the default Guestbook of CMSimple?

A: The default guestbook of CMSimple stores all entries directely as HTML in the guestbook file. This causes that it is not exactly possible to detect the structures, because there are no clearly defined blocks for the names and the messages.
At the moment the plugin GBook doesn't support an automatic function for importing the default guestbook. Please open the default CMSimple guestbook with a normal editor and enter the entries manually into the new guestbook file. Please take care to the semikolon (;) it is really necessary.

top


Q: How to create a new Language?

A: If you want to offer your website in multiple laguanges, surely the guestbook and its entries should support the different languages as well. The plugin GBook offers you this functionality. It creates for each language its own guestbook file. Each guestbook file ends with a two character code, representing the containing language. For example the english guestbook has the filename Guestbook_en.txt, the german one the filename Guestbook_de.txt and so on.
A general description, how to use multiple languages with CMSimple you will find in the CMSimple manual.

top


Q: How to protect against SPAM?

A: Guestbooks are often the target of spammer. Mostly so called bots - automatically working programs - are used to create the spam entries. To avoid automatic creating of entries GBook has the option to use a Captcha. This means for each new entry a code of characters and numbers will be created. This code is displayed on the screen and must be reentered by the user as aprovement. Most of the bots can't do this, with the result no entry is created.
The gbook displays the approvement code (=CAPTCHA) if the option is set to captcha = True. The captcha is dynamically and individually created for each user.

top


Q: How to avoid < SCRIPT > or < HTML > in the entries?

A: I fyou set the option remove_html = True, gbook will remove alle HTML code in the text. These codes are
- Formatting (bold, italic, ...)
- Links (a href)
- Scripts (script)
Therefore no unexpected links or hidden code can be stored in your guestbook entries.

top


Q: How to change the colors of the guestbook?

A: All color definitions for gbook are stored in the css file "stylesheet.css", located in the folder "/plugins/gbook/css". In this folder there are two additional css files which are containing alternative color definitions. But only the file with the name "stylesheet.css" is used.
If the predefined colors doesn't match to your website, please feel free to modify the css file.

top


Q: How to change the fonts of the guestbook?

A: All font definitions are stored in the css file "stylesheet.css", located in the folder "/plugins/gbook/css". Changes of the text layout (eg. font, font size etc.) can be made in this file.

top


Q: How to display the date and time information?

A: The format for date and time can be set up to several formats. The default settings are having the following meaning:

Date format d.m.y
d = display day with leading zero, followed by a dot ".",
m = display month as number with leading zero, followed by a dot "." and at least
y = display the year as two-digit number.

Time format H:i:s
H = display hours in 24 hours format with leading zeros, followed by ":",
i
= display minutes with leading zeros, followed by ":" and at least
s
= display the seconds with leading zeros.

For more information please see PHP Online Documentation.

top


Q: How to use mail notification?

A: Immediately after successfully storing of a guestbook entry, a info mail to the webmaster can be send. The mail address of the webmaster must be specified in the configuration under info_mail. The e-mail service must be setup by your web provider in the PHP configurations.

Tip:
Whe you specify in the field info_mail multiple mail addresses, the info will be sent to all of them. The mail addresses must be separated by a comma.

top


Q: Why do I need to switch off the guestbook?

A: In spite of all protection, it can happen a spammer will fill your guestbook. If you want to switch of creating of new entries for some time, use the configuration new_entries = False to switch off the guestbook.

top