##################################################
# Path and Security #
##################################################
$language = "english.lang.php";The language file that translates all of the labels, but not the content itself.
$path_to_gb = "kisgb.csv";The file name that stores the guestbook entries. While it is not required to be kisgb.csv, I recommend leaving it as this.
$path_to_images = "images";The path to the images directory.
$path_to_languages = "languages";The path to the languages directory. You should not store any other files in this directory except *.lang.php files.
$path_to_themes = "themes";The path to the themes directory. You should not store any other files in this directory except *.thm.php files.
$path_to_docs = "docs";The path to the docs directory.
$admin_id = "admin";The administrator user id. Change this immediately upon installation!
$admin_pw = "password";The administrator password. Change this immediately upon installation!
$admin_from_web = false;If set to true, allows editing from the web. Otherwise, viewing is allowed, by authorization, but updates must be made to the file manually.
$version = "v2.2";Version number.
$myIP = "*";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 propted 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.
$lock_admin_to_myIP = false;If set to true, then only the IP address in the myIP variable can edit via the web.
$site_url = "http://www.your_site.com";Your site URL. This is/may be used in signatures, etc.
$guestbook_name = "KISGB";The name for your guest book. This can be used in other fields and is used as the title variable.
$guestbook_signature = "Sincerely,\n\nYour Name\n$site_url";The signature that is placed on the visitor's e-mail if the guest email option is set.
##################################################
# Debugging / Tracing / Etc. #
##################################################
$admin_email_show_server_vars = false;This option will send all of the SERVER_VARS to the administrator, via the confirmation e-mail when someone signs the guestbook. NOTE THAT THIS SHOULD NOT BE SET TO TRUE FOR PRODUCTION. IT IS ONLY FOR DEBUGGING PURPOSES.
##################################################
# Assign column names for kisgb csv file header. #
# These columns MUST be in this order!!!!! #
##################################################
$col1 = "msgid";Field name for column 1 of the kisgb.csv file. These labels also will be the labels used when you use the Admin function. They are the field names that will appear in your own language. They should be brief and 1 word only, not a phrase. Line 1 MUST contain these labels and they must be in this order!
$col2 = "ip";Field name for column 2 of the kisgb.csv file.
$col3 = "date";Field name for column 3 of the kisgb.csv file.
$col4 = "time";Field name for column 4 of the kisgb.csv file.
$col5 = "name";Field name for column 5 of the kisgb.csv file.
$col6 = "email";Field name for column 6 of the kisgb.csv file.
$col7 = "home";Field name for column 7 of the kisgb.csv file.
$col8 = "pic";Field name for column 8 of the kisgb.csv file.
$col9 = "icq";Field name for column 9 of the kisgb.csv file.
$col10 = "aim";Field name for column 10 of the kisgb.csv file.
$col11 = "yim";Field name for column 11 of the kisgb.csv file.
$col12 = "msn";Field name for column 12 of the kisgb.csv file.
$col13 = "nation";Field name for column 13 of the kisgb.csv file.
$col14 = "comments";Field name for column 14 of the kisgb.csv file.
$col15 = "private";Field name for column 15 of the kisgb.csv file.
##################################################
# Confirmation Email #
##################################################
$admin_email_address = "someone@somewhere.com";Administrator e-mail address.
$admin_email_address_addl = "";Additional address(es) for Administrator.
$admin_email_advice = true;If set to true, an email advice will be sent to the administrator at the address(es) above.
$guest_email_advice = true;If set to true, an email advice will be sent to the Guest who signed the book.
##################################################
# E-mail for admin email advice. #
##################################################
$admin_email_subject = "Guest Book Entry Added";Subject line for the Admin's email advice.
$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";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.
##################################################
# E-mail for guest email advice. #
##################################################
$guest_email_subject = "Thank you for signing our Guest Book!";Subject line for the Guest's email advice.
$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";Content of Guest's email.
##################################################
# Customize the ADD window with these variables #
##################################################
$Awindow_border = 1;These variables set the table characteristics of the Sign Guest Book screen.
$Awindow_border_width = "1px";" "
$Awindow_cellspacing = 0;" "
$Awindow_cellpadding = 0;" "
$Atable_height = "50%";" "
$Atable_width = "50%";" "
$Atable_font_size = "smaller";" "
##################################################
# Customize the VIEW window with these variables #
##################################################
$Vwindow_border = 1;These variables set the table characteristics of the View Guest Book screen.
$Vwindow_border_width = "1px";" "
$Vwindow_cellspacing = 0;" "
$Vwindow_cellpadding = 2;" "
$Vtable_height = "5%";" "
$Vtable_width = "75%";" "
$Vtable_font_size = "smaller";" "
$Vtable_icon_cell_size = "10%";" "
$Vtable_max_comment_width = 80;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.
##################################################
# Customize the Intro window with these variables#
##################################################
$Intro_border = 2;These variables set the table characteristics of the Intro screen that sits on top of the View Guest Book screen.
$Intro_border_width = "1px";" "
$Intro_height = "5%";" "
$Intro_width = "90%";" "
$Intro_font_size = "bigger";" "
##################################################
# Customize the Config Update Window with these #
##################################################
$Config_update_table_width = "75%";These variables set the table characteristics of the Update Config file screen.
$Config_table_background_color = "wheat";" "
$Config_table_background_comment_color = "cornsilk";" "
##################################################
# Miscellaneous #
##################################################
$theme = "wheat.thm.php";Sets the theme of the guest book. The themes are customizable. However, I would recommend leaving the standard themes alone and copying them with your own names. that way, when new distributions are issues, your maintenance is lessened.
$body_background_image = "";Set an image for the BODY background. You cannot use both an image and a color (see next line).
$body_background_color = "";Set a color for the BODY background. You cannot use both an image and a color (see previous line).
$def_home = "";Default text for the home label. You might want to prefill the field with http:// , as an example, to save your guest's from having to type.
$def_pic = "";Default text for the pic label. You might want to prefill the field with http:// , as an example, to save your guest's from having to type.
$comment_rows = 5;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.
$comment_cols = 40;Cotrols the width of the comment box.
$img_email = "email.gif";Image for the email address.
$img_home = "url.gif";Image for the home address.
$img_pic = "photo.gif";Image for the picture address.
$img_icq = "icq.gif";ICQ image.
$img_aim = "aim.gif";AIM image.
$img_yim = "yim.gif";YIM image.
$img_msn = "msn.gif";MSN image.
$img_ip = "ip.gif";IP address image.
$show_all = false;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.
$hide_all = false;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.
$show_icq = true;Individually controlled icon based on rules above.
$show_aim = true;Individually controlled icon based on rules above.
$show_yim = true;Individually controlled icon based on rules above.
$show_msn = true;Individually controlled icon based on rules above.
$show_ip = true;Individually controlled icon based on rules above.
$allow_html = true;If set to true, a restricted set of html tags are allowed. See next variable definition.
$allowed_html_tags_no_img = "<b><em><font><i><p><strong><u>";These are the allowed html tags, for the comments section of Sign Guest Book, if $allow_html is set to true. 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.
$allow_smileys = true;If set to true, the smiley's will be allowed in the comments.
$max_smileys_allowed = 5;The maximum number of smileys allowed in each guestbook entry.
$require_name = true;If set to true, a name entry is required in the Sign Guest Book screen.
$require_email = true;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 check under win32, so i have not included the code to do so under *nix either.
$require_nation = false;If set to true, a nation/country entry is required in the Sign Guest Book screen.
$use_intro = true;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.
$date_format = "Y-m-d";Date format for displaying and storing entries in the Guest Book. Keep in mind that the values stored are text. That means that you can't vasilate between viewing styles. This should be set once and then left, unless you decide to manually convert the entries.
$time_format = "H:i:s";Time format for displaying and storing entries in the Guest Book. Keep in mind that the values stored are text. That means that you can't vasilate between viewing styles. This should be set once and then left, unless you decide to manually convert the entries.
$max_comment_length = 2000;Limit the number of characters that the comment block can contain.
$rows_per_page = 10;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.
##################################################
# 2.4 Release #
##################################################
$show_private_entries_total = false;Allow or disallow the displaying of the Private Entries comment line.
$show_admin_menu = false;Allow or disallow the displaying of the Admin Menu hyper link.
$allow_carriage_returns = true;Allow or disallow carriage retuns 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 <br>. 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.
$allow_carriage_returns_max = 3;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 <br>.
$next_prev_position = "left";Controls the placement of the Previous/Next control. Settings can be left, center, and right.
$use_languages = true;Allow or disallow the displaying of the Languages selection box.
$use_themes = true;Allow or disallow the displaying of the Themes selection box.
$use_themes_languages_header = true;Allow or disallow the displaying of the Languages/Themes selection boxes in the header section.
$use_themes_languages_footer = true;Allow or disallow the displaying of the Languages/Themes selection boxes in the footer section.
$admin_private_message_color = "#FFB1C5";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.
##################################################
# 2.5 Release #
##################################################
$icons_in_separate_column = true;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.
$theme_by_language = true;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.
##################################################
# 2.6 Release #
##################################################
$secure_site = true;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.
$secure_site_id = "secure";The secure site user id. Change this immediately upon installation!
$secure_site_pw = "password";The secure site password. Change this immediately upon installation!
$underline_hyperlinks = true;Controls whether or not any/all hyperlinks are underlined.