Location: PHPKode > projects > KISGB (Keep It Simple Guest Book) > kisgb/docs/config.explain.html
<html>
<head>
<style>
	#comment {background-color:lavender;color:gray;}
	#td1 {width:"30%";background-color:lavender;color:blue;font-weight:bold;text-align:left;}
	#td2 {background-color:lavender;color:purple;font-weight:bold;text-align:left;}
	#td3 {background-color:purple;color:lavender;font-weight:bold;text-align:center;}
	#urgent {font-weight:bold;color:red;}
</style>
</head>
<body>
<table border="1" width="100%" cellspacing="0" cellpadding="2">
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# LEAVE THIS SET TO INDEX.PHP UNLESS TRYING TO   #
# INSERT KISGB INTO A TABLE IN YOUR WEB PAGE OR  #
# IF THE KISGB FOLDER IS NOT IN THE ROOT WEB     #
# DIRECTORY.                                     #
#                                                #
# IF INSERTING KISGB INTO A TABLE IN ONE OF YOUR #
# WEBPAGES, THEN THIS SHOULD BE SET TO FILE THAT #
# STARTS KISGB. THIS FILE MUST RESIDE IN KISGB   #
# DIRECTORY REGARDLESS OF WHICH METHOD YOU USE!  #
##################################################
</pre>
</td></tr><tr><td id="td1">$root_document = "index.php";</td><a name="q45"><td id="td2">The path and name to the file that is used to initially call the KISGB.  Unless you are installing the KISGB within another document's HTML table, leave this set to index.php .  This setting is used in the event that another document needs to "imbed" KISGB within itself.  For example, let's say that you have built a web site that uses tables of different sizes to layout your pages.  You would like KISGB to be displayed within your table.  Then you would modify this setting to be the name of the document that has KISGB imbedded in it.  You then have to modify the document as explained in the <a href="faq.html">FAQ</a> and <a href="history.html">History</a> document. In addition, the document that is imbedding KISGB must be coded so that it gets called through the PHP processor.  Normally this is done by making sure that the document name ends in .php, like guestbook.php.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Path and Security                              #
##################################################
</pre>
</td></tr><tr><td id="td1">$use_userprefs = true;</td><td id="td2">If set to true then the file contained in $path_to_user_prefs is used to set the user configuration settings.  It is  recommended that you leave this set to true.  Otherwise the config.php file is used and that file gets overwritten during application updates.
</td></tr><tr><td id="td1">$path_to_user_prefs = "user.prefs.php";</td><td id="td2">The file name that stores the user configurations settings. It is recommended leaving it as this.
</td></tr><tr><td id="td1">$path_to_gb = "kisgb.csv.php";</td><td id="td2">The file name that stores the guestbook entries.  While it is not required to be kisgb.csv.php, It is recommended leaving it as this.
</td></tr><tr><td id="td1">$path_to_images = "images";</td><td id="td2">The path to the images directory.
</td></tr><tr><td id="td1">$path_to_languages = "languages";</td><td id="td2">The path to the languages directory. You should not store any other files in this directory except *.lang.php files.
</td></tr><tr><td id="td1">$path_to_themes = "themes";</td><a name="q20"><td id="td2">The path to the themes directory. You should not store any other files in this directory except *.thm.php files.</a>
</td></tr><tr><td id="td1">$path_to_docs = "docs";</td><td id="td2">The path to the docs directory.
</td></tr><tr><td id="td1">$admin_id = "admin";</td><td id="td2"><a name="q30">The administrator user id.  <span id=urgent>Change this immediately upon installation!</span></a>
</td></tr><tr><td id="td1">$admin_pw = "password";</td><td id="td2"><a name="q40">The administrator password.  <span id=urgent>Change this immediately upon installation!</span></a>
</td></tr><tr><td id="td1">$admin_from_web = false;</td><td id="td2"><a name="q50">If set to true, allows editing from the web.  Otherwise, viewing is allowed, by authorization, but updates must be made to the file manually. This must also be set to TRUE if you want message level editing.</a>
</td></tr><tr><td id="td1">$secure_site = true;</td><td id="td2"><a name="q150">When set to true, the guest book will only be accessible through HTTP authentication, a.k.a. userid/password.  This allows you to operate a secure site guestbook.  To keep it "simple", there is no userid/password file.  All users have the same userid and password.</a>
</td></tr><tr><td id="td1">$secure_site_id = "secure";</td><td id="td2"><a name="q160">The secure site user id.  <span id=urgent>Change this immediately upon installation!</span></a>
</td></tr><tr><td id="td1">$secure_site_pw = "password";</td><td id="td2"><a name="q170">The secure site password.  <span id=urgent>Change this immediately upon installation!</span></a>
</td></tr><tr><td id="td1">$myIP = "*";</td><td id="td2"><a name="q60">The IP addresses for Administrator Menu. There is a logic check to verify the IP address of the connection to this variable.  If it matches, then the Menu item will appear on the View and Add screens.  This does NOT prevent or allow editing, per se. If you have admin access, then you can add /admin.php to the main url and you will be prompted with the login screen. Note that you can have multiple addresses separated by commas.  An asterisk (*) is the default.  this will allow everyone to see the menu but only those authorized can gain access.  If your address is via dhcp, you will probably want to leave this asterisk.</a>
</td></tr><tr><td id="td1">$lock_admin_to_myIP = false;</td><td id="td2"><a name="q70">If set to true, then only the IP address in the myIP variable can edit via the web.</a>
</td></tr><tr><td id="td1">$version = "v5.00";</td><td id="td2">Version number.
</td></tr><tr><td id="td1">$site_url = "http://www.your_site.com";</td><td id="td2"><a name="q80">Your site URL.  This is/may be used in signatures, etc.</a>
</td></tr><tr><td id="td1">$guestbook_name = "KISGB";</td><td id="td2"><a name="q90">The name for your guest book.  This can be used in other fields and is used as the title variable.</a>
</td></tr><tr><td id="td1">$guestbook_signature = "Sincerely,\n\nYour Name\n$site_url";</td><td id="td2">The signature that is placed on the visitor's e-mail if the guest email option is set.
</td></tr><tr><td id="td1">$only_registered_users_can_add = TRUE;</td><td id="td2"><span id=urgent>This setting is for the phpNuke version only.  If set to TRUE, anonymous posting is NOT allowed.</span>
</td></tr><tr><td id="td1">$useGetHostByAddr = false;</td><td id="td2">It is often needed to know the actual host name of the IP visiting your site.  If this is set to TRUE, then a dns lookup is performed and the actual host name is stored, rather than the generic IP.  If you find that your signing process is sluggish, try setting this to FALSE and see if that improves/fixes it.
</td></tr><tr><td id="td1">$encryptPassword = false;</td><td id="td2">If this setting is FALSE, then the raw password is stored in the kisgb entries file.  Setting it to true will use MD5 encryption.  This cannot be unencrypted.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Message Editing Settings                       #
##################################################
</pre>
</td></tr><tr><td id="td1">$allow_msg_lvl_edit_by_admin = false;</td><td id="td2">If set to true then the Admin will have message level editing allowed.  This will display the lock icon or whatever image you have chosen.
</td></tr><tr><td id="td1">$allow_msg_lvl_edit_by_user = false;</td><td id="td2">If set to true then the User will have message level editing allowed.  This will display the lock icon or whatever image you have chosen.
</td></tr><tr><td id="td1">$allow_msg_lvl_delete_by_user = false;</td><td id="td2">If set to true then the User will have message level deletion allowed.
</td></tr><tr><td id="td1">$admin_email_advice_on_gb_edit = false;</td><td id="td2">If set to true then the Admin will receive an e-mail whenever a message is modified.
</td></tr><tr><td id="td1">$admin_email_subject_on_gb_edit = "Guest Book entry modified";</td><td id="td2">The "subject" that appears in the Admin e-mail message that is set if $admin_email_advice_on_gb_edit is set to true.
</td></tr><tr><td id="td1">$admin_links_to_config_when_msg_edit_on = true;</td><td id="td2">When set to true, the logic checks to see if message level editing is on.  If so, then selecting the Admin link will, instead, go to the config update page.  This is to help sites that have many entries.  Otherwise, if you have several hundred entries, then selecting Admin will cause the browser to have to display all of the entries and then you will have to scroll around to find the entry that you actually want.  Setting it to false will ALWAYS bring the Admin link to the Admin page.  It is recommended leaving this set to TRUE.
</td></tr><tr><td id="td1">$admin_email_show_server_vars = false;</td><td id="td2">This option will send all of the SERVER_VARS to the administrator, via the confirmation e-mail when someone signs the guestbook.<font color=red> NOTE THAT THIS SHOULD NOT BE SET TO TRUE FOR PRODUCTION. IT IS ONLY FOR DEBUGGING PURPOSES.</font>
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Assign column names for kisgb csv file header. #
# These columns MUST be in this order!!!!!       #
##################################################
</pre>
</td></tr><tr><td id="td1">$col1  = "msgid";</td><td id="td2"><a name="q140">Field name for column 1 of the kisgb.csv file. These labels also will be the labels used when you use the Admin and View Private function. They should NOT be changed. <span id=urgent>Line 2 MUST contain these labels and they must be in this order!</span>
</td></tr><tr><td id="td1">$col2  = "ip";</td><td id="td2">Field name for column 2 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col3  = "date";</td><td id="td2">Field name for column 3 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col4  = "time";</td><td id="td2">Field name for column 4 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col5  = "name";</td><td id="td2">Field name for column 5 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col6  = "email";</td><td id="td2">Field name for column 6 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col7  = "home";</td><td id="td2">Field name for column 7 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col8  = "pic";</td><td id="td2">Field name for column 8 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col9  = "icq";</td><td id="td2">Field name for column 9 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col10 = "aim";</td><td id="td2">Field name for column 10 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col11 = "yim";</td><td id="td2">Field name for column 11 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col12 = "msn";</td><td id="td2">Field name for column 12 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col13 = "nation";</td><td id="td2">Field name for column 13 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col14 = "comments";</td><td id="td2">Field name for column 14 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col15 = "private";</td><td id="td2">Field name for column 15 of the kisgb.csv file.
</td></tr><tr><td id="td1">$col16 = "password";</td><td id="td2">Field name for column 16 of the kisgb.csv file.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Confirmation Email                             #
##################################################
</pre>
</td></tr><tr><td id="td1">$admin_email_address = "hide@address.com";</td><td id="td2"><a name="q100">Administrator e-mail address.</a>
</td></tr><tr><td id="td1">$admin_email_address_addl = "";</td><td id="td2"><a name="q110">Additional address(es) for Administrator.</a>
</td></tr><tr><td id="td1">$admin_email_advice = true;</td><td id="td2"><a name="q120">If set to true, an email advice will be sent to the administrator at the address(es) above.</a>
</td></tr><tr><td id="td1">$guest_email_advice = true;</td><td id="td2"><a name="q130">If set to true, an email advice will be sent to the Guest who signed the book.</a>
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# E-mail for admin email advice.                 #
##################################################
</pre>
</td></tr><tr><td id="td1">$admin_email_subject = "Guest Book Entry Added";</td><td id="td2">Subject line for the Admin's email advice.
</td></tr><tr><td id="td1">$admin_email_msg = "The following entry has been added to $guestbook_name.\n\n$col1 : $msgid\n$col2 : $ip\n$col3 : $date\n$col4 : $time\n";</td><td id="td2">Content of Admin's email. In this example, PHP variables are used.  Some of these variables are not contained in this config.sys file but are from the addtogb.php file.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# E-mail for guest email advice.                 #
##################################################
</pre>
</td></tr><tr><td id="td1">$guest_email_subject = "Thank you for signing our Guest Book!";</td><td id="td2">Subject line for the Guest's email advice.
</td></tr><tr><td id="td1">$guest_email_msg = "$name,\n\nThank you for taking the time to sign $guestbook_name.  We hope you enjoyed our site.  Come back often, if you like!\n\n$guestbook_signature";</td><td id="td2">Content of Guest's email.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Customize the ADD window with these variables  #
##################################################
</pre>
</td></tr><tr><td id="td1">$defaultName = 'Anonymous Coward';</td><td id="td2">Set this to anything you like. It will be the default name that will appear when Adding a message.
</td></tr><tr><td id="td1">$Awindow_border = 1;</td><td id="td2">These variables set the table characteristics of the Sign Guest Book screen.
</td></tr><tr><td id="td1">$Awindow_border_width = "1px";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Awindow_cellspacing = 0;</td><td id="td2">" "
</td></tr><tr><td id="td1">$Awindow_cellpadding = 0;</td><td id="td2">" "
</td></tr><tr><td id="td1">$Atable_height = "4%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Atable_width = "50%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Atable_font_size = "smaller";</td><td id="td2">" "
</td></tr><tr><td id="td1">$comment_rows = 5;</td><td id="td2">Controls the size of the comment box in the Sign Guest Book page. This is only a starting point.  The box will expand as needed.
</td></tr><tr><td id="td1">$comment_cols = 40;</td><td id="td2">Controls the width of the comment box.
</td></tr><tr><td id="td1">$max_name_length = 20;</td><td id="td2">Limit the number of characters that the name field can contain.
</td></tr><tr><td id="td1">$max_email_length = 30;</td><td id="td2">Limit the number of characters that the email field can contain.
</td></tr><tr><td id="td1">$max_comment_length = 2000;</td><td id="td2">Limit the number of characters that the comment block can contain.
</td></tr><tr><td id="td1">$allow_html = true;</td><td id="td2">If set to true, a restricted set of html tags are allowed. See next variable definition.
</td></tr><tr><td id="td1">$allowed_html_tags_no_img = "&lt;b&gt;&lt;em&gt;&lt;font&gt;&lt;i&gt;&lt;p&gt;&lt;strong&gt;&lt;u&gt;";</td><td id="td2">These are the allowed html tags, for the comments section of Sign Guest Book, if $allow_html is set to true.  <span id=urgent>The IMG tag is not allowed in this list.  It is only allowed for the smileys.  If $allow_smileys is set to true, then the IMG tag is automatically inserted.</span>
</td></tr><tr><td id="td1">$allow_smileys = true;</td><td id="td2">If set to true, the smiley's will be allowed in the comments.
</td></tr><tr><td id="td1">$max_smileys_allowed = 5;</td><td id="td2">The maximum number of smileys allowed in each guestbook entry.
</td></tr><tr><td id="td1">$smiley_window_width = 300;</td><td id="td2">Controls the initial width of the Smiley pop-up window.
</td></tr><tr><td id="td1">$smiley_window_height = 600;</td><td id="td2">Controls the initial height of the Smiley pop-up window.
</td></tr><tr><td id="td1">$allow_carriage_returns = true;</td><td id="td2">Allow or disallow carriage returns in the comments section. People will try to hack your guestbook, trust me!  One way is to try to enter extremely large messages.  Another way is to try to blow up the table display.  This setting, if set to true, will allow the displaying of carriage returns as new lines.  It does this by converting the new line characters to &lt;br&gt;.  Keep in mind that even if set to false, it still stores the new line, it just won't display it. The $allow_carriage_returns_max setting controls how many actually get stored.
</td></tr><tr><td id="td1">$allow_carriage_returns_max = 3;</td><td id="td2">This setting will not allow more than 3, or whatever you set it to, carriage returns to be actually stored in the file. The setting $allow_carriage_returns will still control whether or not to display the new line as a &lt;br&gt;.
</td></tr><tr><td id="td1">$def_home = "";</td><td id="td2">Default text for the home label.  You might want to pre fill the field with http:// , as an example, to save your guest's from having to type.
</td></tr><tr><td id="td1">$def_pic = "";</td><td id="td2">Default text for the pic label.  You might want to pre fill the field with http:// , as an example, to save your guest's from having to type.
</td></tr><tr><td id="td1">$img_email = "email.gif";</td><td id="td2">Image for the email address.
</td></tr><tr><td id="td1">$img_home = "url.gif";</td><td id="td2">Image for the home address.
</td></tr><tr><td id="td1">$img_pic = "photo.gif";</td><td id="td2">Image for the picture address.
</td></tr><tr><td id="td1">$img_icq = "icq.gif";</td><td id="td2">ICQ image.
</td></tr><tr><td id="td1">$img_aim = "aim.gif";</td><td id="td2">AIM image.
</td></tr><tr><td id="td1">$img_yim = "yim.gif";</td><td id="td2">YIM image.
</td></tr><tr><td id="td1">$img_msn = "msn.gif";</td><td id="td2">MSN image.
</td></tr><tr><td id="td1">$img_ip = "ip.gif";</td><td id="td2">IP address image.
</td></tr><tr><td id="td1">$img_msg_update = "edit_msg.gif";</td><td id="td2">Message level edit image.
</td></tr><tr><td id="td1">$require_name = true;</td><td id="td2">If set to true, a name entry is required in the Sign Guest Book screen.
</td></tr><tr><td id="td1">$require_email = true;</td><td id="td2">If set to true, an email entry is required in the Sign Guest Book screen.  There is an attempt made to verify the integrity of the address entered, but it is not foolproof.  The validity of the address is not able to be checked under win32, so the code to do so under *nix is noth included either.
</td></tr><tr><td id="td1">$require_nation = false;</td><td id="td2">If set to true, a nation/country entry is required in the Sign Guest Book screen.
</td></tr><tr><td id="td1">$show_all = false;</td><td id="td2">If set to true, then all icons will be shown in view screen.  If set to false, then the icons can be individually controlled, as long as $hide_all is false.
</td></tr><tr><td id="td1">$hide_all = false;</td><td id="td2">If set to true, then all icons will be hidden in view screen.  If set to false, then the icons can be individually controlled, as long as $show_all is false.
</td></tr><tr><td id="td1">$show_name = true;</td><td id="td2">Controls the displaying/inputting of the name field.
</td></tr><tr><td id="td1">$show_email = true;</td><td id="td2">Controls the displaying/inputting of the e-mail field.
</td></tr><tr><td id="td1">$show_home = true;</td><td id="td2">Controls the home page url field.
</td></tr><tr><td id="td1">$show_pic = true;</td><td id="td2">Controls the displaying/inputting of the url that points to a picture field..
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# use_pic is for using the actual picture.       #
# pic_width sets the image display width.        #
# pic_height sets the image display height.      #
##################################################
</pre>
</td></tr><tr><td id="td1">$use_pic = true;</td><td id="td2">If set to true, then the display will be the actual picture in the link. If set to false, then a picture icon, from above, will be used.
</td></tr><tr><td id="td1">$pic_width = 48;</td><td id="td2">Controls the img width for display of the picture icon.
</td></tr><tr><td id="td1">$pic_height = 64;</td><td id="td2">Controls the img height for display of the picture icon.
</td></tr><tr><td id="td1">$picTypes = "gif,jpg,png,tif.bmp";</td><td id="td2">Controls the img type that are allowed in the img tag src= attribute.  To limit your exposure to hacking, if the src= attribute does not end in one of these types (i.e. *.jpg) then it is not recognized as valid and will be discarded.
</td></tr><tr><td id="td1">$show_icq = true;</td><td id="td2">Individually controlled icon based on rules above.
</td></tr><tr><td id="td1">$show_aim = true;</td><td id="td2">Individually controlled icon based on rules above.
</td></tr><tr><td id="td1">$show_yim = true;</td><td id="td2">Individually controlled icon based on rules above.
</td></tr><tr><td id="td1">$show_msn = true;</td><td id="td2">Individually controlled icon based on rules above.
</td></tr><tr><td id="td1">$show_nation = true;</td><td id="td2">Drop down selection box for nations.
</td></tr><tr><td id="td1">$show_ip = true;</td><td id="td2">Individually controlled icon based on rules above.
</td></tr><tr><td id="td1">$show_private = true;</td><td id="td2">If set to true then the user will see a checkbox to allow private messages to be saved.
</td></tr><tr><td id="td1">$show_password = true;</td><td id="td2">If set to true then the user will see a password box to allow private messages to be viewed and/or for message level editing.
</td></tr><tr><td id="td1">$show_date = true;</td><td id="td2">Individually controlled display of the date field.
</td></tr><tr><td id="td1">$show_time = true;</td><td id="td2">Individually controlled display of the time field.
</td></tr><tr><td id="td1">$show_serach = true;</td><td id="td2">Individually controlled display of the search menu link/image.
</td></tr><tr><td id="td1">$show_preview = true;</td><td id="td2">Individually controlled display of the Preview button for previewing messages before adding them.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Customize the VIEW window with these variables #
##################################################
</pre>
</td></tr><tr><td id="td1">$Vwindow_border = 1;</td><td id="td2">These variables set the table characteristics of the View Guest Book screen.
</td></tr><tr><td id="td1">$Vwindow_border_width = "1px";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vwindow_cellspacing = 0;</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vwindow_cellpadding = 2;</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vtable_height = "5%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vtable_width = "75%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vtable_font_size = "smaller";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vtable_icon_cell_size = "10%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Vtable_max_comment_width = 80;</td><td id="td2">This sets the maximum line length for a solid string of characters. Some people try to overrun the table width by holding down just 1 key.  This prevents that and will force a line break at 80 characters, or whatever amount you specify.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Customize the Intro window with these variables#
##################################################
</pre>
</td></tr><tr><td id="td1">$use_intro = true;</td><td id="td2">If set to true, an introduction text is presented at the top of the View Page.  the text is language specific and is maintained in the *.lang.php files.
</td></tr><tr><td id="td1">$Intro_text = "Welcome to my Guest Book";</td><td id="td2">Message to be displayed at the top of your Guest Book.
</td></tr><tr><td id="td1">$Intro_border = 2;</td><td id="td2">These variables set the table characteristics of the Intro screen that sits on top of the View Guest Book screen.
</td></tr><tr><td id="td1">$Intro_border_width = "1px";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Intro_height = "5%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Intro_width = "90%";</td><td id="td2">" "
</td></tr><tr><td id="td1">$Intro_font_size = "bigger";</td><td id="td2">" "
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Global Appearance                              #
##################################################
</pre>
</td></tr><tr><td id="td1">$language = "english.lang.php";</td><a name="q10"><td id="td2">The language file that translates all of the labels, but not the content itself.</a>
</td></tr><tr><td id="td1">$use_languages = true;</td><td id="td2">Allow or disallow the displaying of the Languages selection box.
</td></tr><tr><td id="td1">$theme = "wheat.thm.php";</td><td id="td2">Sets the theme of the guest book.  The themes are customizable.  However, It is recommended leaving the standard themes alone and copying them with your own names.  that way, when new distributions are issues, your maintenance is lessened.
</td></tr><tr><td id="td1">$use_themes = true;</td><td id="td2">Allow or disallow the displaying of the Themes selection box.
</td></tr><tr><td id="td1">$theme_by_language = true;</td><td id="td2">When set to true, the theme drop down selection box will display to the right of the language selection box. When set to false, the language box will be on the far left and the theme box will be on the far right.
</td></tr><tr><td id="td1">$use_themes_languages_header = true;</td><td id="td2">Allow or disallow the displaying of the Languages/Themes selection boxes in the header section.
</td></tr><tr><td id="td1">$use_themes_languages_footer = true;</td><td id="td2">Allow or disallow the displaying of the Languages/Themes selection boxes in the footer section.
</td></tr><tr><td id="td1">$body_background_image = "";</td><td id="td2">Set an image for the BODY background. You cannot use both an image and a color (see next line).
</td></tr><tr><td id="td1">$body_background_color = "";</td><td id="td2">Set a color for the BODY background. You cannot use both an image and a color (see previous line).
</td></tr><tr><td id="td1">$body_font_family = "";</td><td id="td2">Set a font for the Guest Book overall.  The syntax of this field, if more than one font is used, is the CSS syntax.
</td></tr><tr><td id="td1">$rows_per_page = 10;</td><td id="td2">As the number of entries gets longer and longer, it naturally takes longer to load. This setting allows you to control the number of entries/rows per page.  A setting of zero is unlimited, i.e., the entire guestbook.
</td></tr><tr><td id="td1">$button_font_size = "smaller";</td><td id="td2">Set the font size for the text on all buttons used in KISGB.
</td></tr><tr><td id="td1">$button_font_family = "";</td><td id="td2">Set the font family for the text on all buttons used in KISGB.
</td></tr><tr><td id="td1">$button_border_width = 1;</td><td id="td2">Set the border width (if allowed) for all buttons used in KISGB.
</td></tr><tr><td id="td1">$button_border_style = "outset";</td><td id="td2">Set the border style (if allowed) for all buttons used in KISGB.
</td></tr><tr><td id="td1">$show_private_entries_total = false;</td><td id="td2">Allow or disallow the displaying of the Private Entries comment line.
</td></tr><tr><td id="td1">$show_admin_menu = false;</td><td id="td2">Allow or disallow the displaying of the Admin Menu hyper link/image.
</td></tr><tr><td id="td1">$show_home_menu = false;</td><td id="td2">Allow or disallow the displaying of the Home Page hyper link/image.
</td></tr><tr><td id="td1">$next_prev_position = "left";</td><td id="td2">Controls the placement of the Previous/Next control.  Settings can be left, center, and right.
</td></tr><tr><td id="td1">$admin_private_message_color = "#FFB1C5";</td><td id="td2">This setting will change the color of the comments area in the admin panel, for private messages.  That way, the private messages will be more easily spotted.
</td></tr><tr><td id="td1">$icons_in_separate_column = true;</td><td id="td2">Allow or disallow the displaying of the icons in the left hand column of the View table. You can either have the icons displayed beside the comments on the left or in the header line, thereby only having a one column table.
</td></tr><tr><td id="td1">$icon_separator = "&lt;br />&lt;br />";</td><td id="td2">This allows you to set what kind of separator is used after the date and/or time is displayed when displaying icons in separate columns.
</td></tr><tr><td id="td1">$message_separator = "&lt;br />&lt;br />";</td><td id="td2">This allows you to set what kind of separator is used to separate messages, in the event you do not use borders around your messages..
</td></tr><tr><td id="td1">$underline_hyperlinks = true;</td><td id="td2">Controls whether or not any/all hyperlinks are underlined.
</td></tr><tr><td id="td1">$label_home_site_img = &quot;&lt;img src=&quot;images/home.gif&quot; border=0 width=20 height=20&gt;&quot;;</td><td id="td2">This will display the image/icon instead of text from the language file for Home.  If set to "" then the text definition from the language file will be displayed.
</td></tr><tr><td id="td1">$label_admin_menu_img = &quot;&lt;img src=&quot;images/lock.gif&quot; border=0 width=20 height=20&gt;&quot;;</td><td id="td2">This will display the image/icon instead of text from the language file for Admin Menu.  If set to "" then the text definition from the language file will be displayed.
</td></tr><tr><td id="td1">$label_sign_gb_img = &quot;&lt;img src=&quot;images/edit_msg.gif&quot; border=0 width=20 height=20&gt;&quot;;</td><td id="td2">This will display the image/icon instead of text from the language file for Sign Guest Book.  If set to "" then the text definition from the language file will be displayed.
</td></tr><tr><td id="td1">$label_search_gb_img = &quot;&lt;img src=&quot;images/binocular.gif&quot; border=0 width=20 height=20&gt;&quot;;</td><td id="td2">This will display the image/icon instead of text from the language file for Search.  If set to "" then the text definition from the language file will be displayed.
</td></tr><tr><td id="td1">$label_viewall_gb_img = &quot;&lt;img src=&quot;images/binocular.gif&quot; border=0 width=20 height=20&gt;&quot;;</td><td id="td2">This will display the image/icon instead of text from the language file for View All.  If set to "" then the text definition from the language file will be displayed.
</td></tr><tr><td id="td1">$page_alignment_center = true;</td><td id="td2">When set to true (default) then all kisgb screens are set to be centered in the page that they are displayed in.  If set to false, then the user has placement control over the View and Sign screens. This is most applicable and useful when using kisgb in tables.
</td></tr><tr><td id="td1">$use_footer = true;</td><td id="td2">The displaying of the footer is a requirement of the license.  The intent is to give credit where credit is due.  However, sometimes the footer can be difficult to place on a website, so by setting this setting to false, the footer will be suppressed.  However, it is then required that you provide credits elsewhere on your site with a link to my web site.
</td></tr><tr><td id="td1">$use_header_view = true;</td><td id="td2">When set to true (default) then the header.php file is included at the top of the guest book view page.
</td></tr><tr><td id="td1">$use_header_sign = false;</td><td id="td2">When set to false (default) then the header.php file is not included at the top of the guest book sign page.
</td></tr><tr><td id="td1">$use_filter_file = TRUE;</td><td id="td2">When set to TRUE (default) then the bad language and banned IP  file (filter.php) is applied to the message BEFORE it gets posted.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Miscellaneous                                  #
##################################################
</pre>
</td></tr><tr><td id="td1">$use_javascript_check = false;</td><td id="td2">This setting turns on/off the browser javascript check mechanism.
</td></tr><tr><td id="td1">$words_not_allowed_in_anchor_tag = "javascript,onmouseover,onmouseout";</td><td id="td2">Any word that can invoke a script, when places in a link, needs to be in this setting.  There must not be any spaces/blanks in this string and all words must be separated by a comma.
</td></tr><tr><td id="td1">$date_format = "Y-m-d";</td><td id="td2">Date format for displaying and storing entries in the Guest Book.  The storing of this value is deprecated. The format is only for display now.  Eventually, this field will be used for something else.
</td></tr><tr><td id="td1">$time_format = "H:i:s";</td><td id="td2">Time format for displaying and storing entries in the Guest Book.   The storing of this value is deprecated. The format is only for display now.  Eventually, this field will be used for something else.
</td></tr><tr><td id="td1">$hours_to_offset = 0;</td><td id="td2">This setting will allow you to adjust the timestamp from that of your server.  By using a negative number you will back the time up.  By using a positive number you will advance the time.
</td></tr><tr><td id="td1">$csv_buffer_size = 9192;</td><td id="td2">This setting will allow you to adjust the amount of data that the read function for csv files will read up to.  This way, you have complete control over the size postings allowed.  This differs from the comment size setting in that it encompasses the entire record, not just the comments.
</td></tr><tr><td id="td1">$realm_name = "Secured Area";</td><td id="td2">This setting simply allows you to name the Realm that appears when using HTTP authorization.
</td></tr><tr><td id="td1">$flood_control_timer = 60;</td><td id="td2">This setting activates flood control. A value of zero causes the flood control to be ignored.  Any other numeric value is in seconds in-between posts for any given IP.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# These control the comment box when editing     #
# messages.                                      #
##################################################
</pre>
</td></tr><tr><td id="td1">$commentBoxColumns = 80;</td><td id="td2">These control the comment box width size when editing a message.
</td></tr><tr><td id="td1">$commentBoxRows = 4;</td><td id="td2">These control the comment box height size when editing a message.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Enter time in seconds.  -1=Unlimited           #
# 1 minute=60, 1 hour=60*60, 1 day=60*60*24,     #
# 1 week=7*60*60*24, etc.                        #
# Admins can always update regardless of setting.#
##################################################
</pre>
</td></tr><tr><td id="td1">$cutoff_date_for_updates = 0;</td><td id="td2">This setting allows you to control the TIME INTERVAL at which posts can no longer be updated.  A value of -1 means there is no time limit.  Other values must be in second.  So, 60=60 seconds - 60*60 or 3600 = 1 hour - 60*60*24 = 1 day, etc.
</td></tr><tr><td colspan="2" id="td3">
<pre>
##################################################
# Miscellaneous Messages                         #
##################################################
</pre>
</td></tr><tr><td id="td1">$registry_msg = "This site allows the registering of user names.<br />This user name is registered and in order to use it, you must log into the system.<br />Please login, select another name,  and/or contact the <br /><a href='mailto:$admin_email_address'>system administrator</a><br /> for further information.";</td><td id="td2">This message is not used at the present time, but is in the config.php file only.
</td></tr>
</table>
</body>
</html>
Return current item: KISGB (Keep It Simple Guest Book)