X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=config%2Fconfig_default.php;h=a5aaed212b62f6dc9c42a9c1d90eb36c35e6a5d9;hp=4df677ab391629d555ca82084fcf7ac4bce191e6;hb=aabfe164c1267fde16959de813dbd5c6611b873f;hpb=f6cfbdac33c0f4632195d6ab2a6744e050771039

diff --git a/config/config_default.php b/config/config_default.php
index 4df677ab..a5aaed21 100644
--- a/config/config_default.php
+++ b/config/config_default.php
@@ -1,12 +1,25 @@
 <?php
 
 /**
+ * Default SquirrelMail configuration file
+ *
  * BEFORE EDITING THIS FILE!
  *
  * Don't edit this file directly.  Copy it to config.php before you
  * edit it.  However, it is best to use the configuration script
  * conf.pl if at all possible.  That is the easiest and cleanest way
  * to configure.
+ *
+ * Note on SECURITY: some options require putting a password in this file.
+ * Please make sure that you adapt its permissions appropriately to avoid
+ * passwords being leaked to e.g. other system users. Take extra care when
+ * the webserver is shared with untrusted users.
+ *
+ * @copyright &copy; 2000-2006 The SquirrelMail Project Team
+ * @license http://opensource.org/licenses/gpl-license.php GNU Public License
+ * @version $Id$
+ * @package squirrelmail
+ * @subpackage config
  */
 
 /* Do not change this value. */
@@ -17,137 +30,254 @@ $config_version = '1.4.0';
 /*** Organization preferences ***/
 /**
  * Organization's name
+ * @global string $org_name
  */
 $org_name = "SquirrelMail";
 
 /**
  * Organization's logo picture (blank if none)
+ * @global string $org_logo
  */
 $org_logo = SM_PATH . 'images/sm_logo.png';
 
 /**
  * The width of the logo (0 for default)
+ * @global string $org_logo_width
  */
 $org_logo_width = '308';
 
 /**
  * The height of the logo (0 for default)
+ * @global string $org_logo_height
  */
 $org_logo_height = '111';
 
 /**
  * Webmail Title
- *   This is the web page title that appears at the top of the browser window.
+ *
+ * This is the web page title that appears at the top of the browser window.
+ * @global string $org_title
  */
-$org_title = "SquirrelMail $version";
+$org_title = "SquirrelMail";
 
 /**
+ * Signout page
+ *
  * Rather than going to the signout.php page (which only allows you
  * to sign back in), setting signout_page allows you to sign the user
  * out and then redirect to whatever page you want. For instance,
  * the following would return the user to your home page:
  *   $signout_page = '/';
  * Set to the empty string to continue to use the default signout page.
+ * @global string $signout_page
  */
 $signout_page = '';
 
 /**
+ * Top frame
+ *
  * By default SquirrelMail takes up the whole browser window,
  * this allows you to embed it within sites using frames. Set
  * this to the frame you want it to stay in.
+ * @global string $frame_top
  */
 $frame_top = '_top';
 
 /**
- * Here you can set link displayed on the right side of main page.
- * $provider_name sets name of link
- * $provider_url set address used in the link
+ * Provider name
+ *
+ * Here you can set name of the link displayed on the right side of main page.
  *
- * Link will be displayed only if you have $hide_sm_attributions 
+ * Link will be displayed only if you have $hide_sm_attributions
  * option set to true.
+ * @global string $provider_name
  */
 $provider_name = 'SquirrelMail';
-$provider_uri = 'http://www.squirrelmail.org/';
 
+/**
+ * Provider URI
+ *
+ * Here you can set URL of the link displayed on the right side of main page.
+ * When empty, this refers to the SquirrelMail About page.
+ * Link will be displayed only if you have $hide_sm_attributions
+ * option set to true.
+ * @global string $provider_uri
+ */
+$provider_uri = '';
 
 /*** Server Settings ***/
 /**
+ * Default Domain
+ *
  * The domain part of local email addresses.
  *   This is for all messages sent out from this server.
  *   Reply address is generated by $username@$domain
- * Example: In bob@foo.com, foo.com is the domain.
+ * Example: In bob@example.com, example.com is the domain.
+ * @global string $domain
  */
 $domain = 'example.com';
 
 /**
+ * Time offset inversion
+ *
  * If you are running on a machine that doesn't have the tm_gmtoff
  * value in your time structure and if you are in a time zone that
  * has a negative offset, you need to set this value to 1. This is
  * typically people in the US that are running Solaris 7.
+ * @global bool $invert_time
  */
 $invert_time = false;
 
 /**
+ * Default send transport
+ *
  * What should be used when sending email.
  * If it is set to false, SquirrelMail will use SMTP server settings.
- * If it is set to true, SquirrelMail will use program defined in 
+ * If it is set to true, SquirrelMail will use program defined in
  * $sendmail_path
+ * @global bool $useSendmail
  */
 $useSendmail = false;
 
 /**
- * Your SMTP server and port number (usually the same as the IMAP server).
+ * Your SMTP server (usually the same as the IMAP server).
+ * @global string $smtpServerAddress
  */
 $smtpServerAddress = 'localhost';
+/**
+ * Your SMTP port number (usually 25).
+ * @global integer $smtpPort
+ */
 $smtpPort = 25;
 
 /**
+ * SquirrelMail header encryption
+ *
+ * Encryption key allows to hide SquirrelMail Received: headers
+ * in outbound messages. Interface uses encryption key to encode
+ * username, remote address and proxied address, then stores encoded
+ * information in X-Squirrel-* headers.
+ *
+ * Warning: used encryption function is not bulletproof. When used
+ * with static encryption keys, it provides only minimal security
+ * measures and information can be decoded quickly.
+ *
+ * Encoded information can be decoded with decrypt_headers.php script
+ * from SquirrelMail contrib/ directory.
+ * @global string $encode_header_key
+ * @since 1.5.1 and 1.4.5
+ */
+$encode_header_key = '';
+
+/**
+ * Path to Sendmail
+ *
  * Program that should be used when sending email. SquirrelMail expects that
- * this program will follow options used by original sendmail 
- * (http://www.sendmail.org).
+ * this program will follow options used by original sendmail
+ * (http://www.sendmail.org). Support of -f argument is required.
+ * @global string $sendmail_path
  */
 $sendmail_path = '/usr/sbin/sendmail';
-    
+
 /**
- * The dns name (or IP address) and port for your imap server.
+ * Extra sendmail command arguments.
+ *
+ * Sets additional sendmail command arguments. Make sure that arguments are
+ * supported by your sendmail program. -f argument is added automatically by
+ * SquirrelMail scripts. Variable defaults to standard /usr/sbin/sendmail
+ * arguments. If you use qmail-inject, nbsmtp or any other sendmail wrapper,
+ * which does not support -t and -i arguments, set variable to empty string
+ * or use arguments suitable for your mailer.
+ * @global string $sendmail_args
+ * @since 1.5.1
+ */
+$sendmail_args = '-i -t';
+
+/**
+ * IMAP server address
+ *
+ * The dns name (or IP address) for your imap server.
+ * @global string $imapServerAddress
  */
 $imapServerAddress = 'localhost';
+
+/**
+ * IMAP server port
+ *
+ * Port used by your imap server. (Usually 143)
+ * @global integer $imapPort
+ */
 $imapPort = 143;
 
 /**
+ * IMAP server type
+ *
  * The type of IMAP server you are running.
  * Valid type are the following (case is important):
+ *   bincimap
  *   courier
  *   cyrus
+ *   dovecot
  *   exchange
- *   uw
+ *   hmailserver
  *   macosx
  *   mercury32
+ *   uw
  *   other
  *
  * Please note that this changes only some of server settings.
  *
  * In order to set everything correctly, you need to adjust several
- * squirrelmail options. These options are listed in doc/presets.txt
+ * SquirrelMail options. These options are listed in doc/presets.txt
+ * @global string $imap_server_type
  */
 $imap_server_type = 'other';
 
 /**
- * Advanced authentication options
- * CRAM-MD5, DIGEST-MD5, Plain, and TLS
- * Set reasonable defaults - you'd never know this was there unless you ask for it
+ * Secure IMAP connection controls
+ *
+ * 0 - use plain text connection,
+ * 1 - use imaps (adds tls:// prefix to hostname),
+ * 2 - use IMAP STARTTLS extension (rfc2595).
+ *
+ * Was boolean before 1.5.1.
+ * @global integer $use_imap_tls
+ * @since 1.4.0
  */
-$use_imap_tls = false;
-$use_smtp_tls = false;
+$use_imap_tls = 0;
 
 /**
- * auth_mech can be either 'login','plain', 'cram-md5', or 'digest-md5'
- *  SMTP can also be 'none'
+ * Secure SMTP connection controls
+ *
+ * 0 - use plain text connection,
+ * 1 - use ssmtp (adds tls:// prefix to hostname),
+ * 2 - use SMTP STARTTLS extension (rfc2487).
+ *
+ * Was boolean before 1.5.1.
+ * @global integer $use_smtp_tls
+ * @since 1.4.0
+ */
+$use_smtp_tls = 0;
+
+/**
+ * SMTP authentication mechanism
+ *
+ * auth_mech can be either 'none', 'login','plain', 'cram-md5', or 'digest-md5'
+ * @global string $smtp_auth_mech
  */
 $smtp_auth_mech = 'none';
+
+/**
+ * IMAP authentication mechanism
+ *
+ * auth_mech can be either 'login','plain', 'cram-md5', or 'digest-md5'
+ * @global string $imap_auth_mech
+ */
 $imap_auth_mech = 'login';
 
 /**
+ * IMAP folder delimiter
+ *
  * This is the delimiter that your IMAP server uses to distinguish between
  * folders.  For example, Cyrus uses '.' as the delimiter and a complete
  * folder would look like 'INBOX.Friends.Bob', while UW uses '/' and would
@@ -156,18 +286,24 @@ $imap_auth_mech = 'login';
  * specify it here.
  *
  * To have it autodetect the delimiter, set it to 'detect'.
+ * @global string $optional_delimiter
  */
 $optional_delimiter = 'detect';
 
 /**
+ * POP before SMTP setting
+ *
  * Do you wish to use POP3 before SMTP?  Your server must
  * support this in order for SquirrelMail to work with it.
+ * @global bool $pop_before_smtp
  */
 $pop_before_smtp = false;
 
 
 /*** Folder Settings ***/
 /**
+ * Default IMAP folder prefix
+ *
  * Many servers store mail in your home directory. With this, they
  * store them in a subdirectory: mail/ or Mail/, etc. If your server
  * does this, please set this to what the default mail folder should
@@ -180,13 +316,17 @@ $pop_before_smtp = false;
  *     $default_folder_prefix = 'Mail/folders/';
  *
  * If you do not use this, set it to the empty string.
+ * @global string $default_folder_prefix
  */
 $default_folder_prefix = '';
 
 /**
+ * User level prefix control
+ *
  * If you do not wish to give them the option to change this, set it
  * to false. Otherwise, if it is true, they can change the folder prefix
  * to be anything.
+ * @global bool $show_prefix_option
  */
 $show_prefix_option = false;
 
@@ -218,6 +358,14 @@ $show_prefix_option = false;
  *   $delete_folder
  *      If this is true, when a folder is deleted then it will
  *      not get moved into the Trash folder.
+ * @global bool $default_move_to_trash
+ * @global bool $default_move_to_sent
+ * @global bool $default_save_as_draft
+ * @global string $trash_folder
+ * @global string $sent_folder
+ * @global string $draft_folder
+ * @global bool $auto_expunge
+ * @global bool $delete_folder
  */
 $default_move_to_trash = true;
 $default_move_to_sent  = true;
@@ -229,36 +377,53 @@ $auto_expunge = true;
 $delete_folder = false;
 
 /**
+ * Special Folder Color Control
+ *
  * Whether or not to use a special color for special folders. If not,
  * special folders will be the same color as the other folders.
+ * @global bool $use_special_folder_color
  */
 $use_special_folder_color = true;
 
 /**
+ * Create Special Folders Control
+ *
  * Should I create the Sent and Trash folders automatically for
  * a new user that doesn't already have them created?
+ * @global bool $auto_create_special
  */
 $auto_create_special = true;
 
-/* Whether or not to list the special folders first (true/false). */
+/**
+ * List Special Folders First Control
+ *
+ * Whether or not to list the special folders first (true/false).
+ * @global bool $list_special_folders_first
+ */
 $list_special_folders_first = true;
 
 /**
+ * Subfolder Layout Control
+ *
  * Are all your folders subfolders of INBOX (i.e. cyrus IMAP server).
  * If you are unsure, set it to false.
+ * @global bool $default_sub_of_inbox
  */
 $default_sub_of_inbox = true;
 
 /**
+ * Subfolder Format Control
+ *
  * Some IMAP daemons (UW) handle folders weird. They only allow a
  * folder to contain either messages or other folders, not both at
  * the same time. This option controls whether or not to display an
  * option during folder creation. The option toggles which type of
  * folder it should be.
  *
- * If this option confuses you, just set it to 'true'. You can not hurt 
+ * If this option confuses you, just set it to 'true'. You can not hurt
  * anything if it's true, but some servers will respond weird if it's
  * false. (Cyrus works fine whether it's true OR false).
+ * @global bool $show_contain_subfolders_option
  */
 $show_contain_subfolders_option = false;
 
@@ -266,41 +431,54 @@ $show_contain_subfolders_option = false;
  * These next two options set the defaults for the way that the
  * users see their folder list.
  *   $default_unseen_notify
- *       Specifies whether or not the users will see the number of 
+ *       Specifies whether or not the users will see the number of
  *       unseen in each folder by default and also which folders to
  *       do this to. Valid values are: 1=none, 2=inbox, 3=all.
  *   $default_unseen_type
  *       Specifies the type of notification to give the users by
  *       default. Valid choice are: 1=(4), 2=(4,25).
+ * @global integer $default_unseen_notify
+ * @global integer $default_unseen_type
  */
 $default_unseen_notify = 2;
 $default_unseen_type   = 1;
 
 /**
+ * NoSelect Fix Control
+ *
  * This enables the no select fix for Cyrus when subfolders
  * exist but parent folders do not
+ * @global bool $noselect_fix_enable
  */
 $noselect_fix_enable = false;
 
 /*** General options ***/
 /**
  * Path to the data/ directory
+ *
+ *   You need to create this directory yourself (see INSTALL).
+ *
  *   It is a possible security hole to have a writable directory
  *   under the web server's root directory (ex: /home/httpd/html).
- *   For this reason, it is possible to put the data directory
- *   anywhere you would like. The path name can be absolute or
- *   relative (to the config directory). It doesn't matter. Here
- *   are two examples:
+ *   The path name can be absolute or relative (to the config directory).
+ *   If path is relative, it must use SM_PATH constant.
+ *   Here are two examples:
  *
  * Absolute:
- *   $data_dir = '/usr/local/squirrelmail/data/';
+ *   $data_dir = '/var/local/squirrelmail/data/';
  *
  * Relative (to main SM directory):
  *   $data_dir = SM_PATH . 'data/';
+ *   (NOT recommended: you need to secure apache to make sure these
+ *   files are not world readable)
+ *
+ * @global string $data_dir
  */
-$data_dir = SM_PATH . 'data/';
+$data_dir = '/var/local/squirrelmail/data/';
 
 /**
+ * Attachments directory
+ *
  * Path to directory used for storing attachments while a mail is
  * being sent. There are a few security considerations regarding
  * this directory:
@@ -309,87 +487,155 @@ $data_dir = SM_PATH . 'data/';
  *      list files in this directory. Confidential data might be laying
  *      around there.
  *    + Since the webserver is not able to list the files in the content
- *       is also impossible for the webserver to delete files lying around 
- *       there for too long.
+ *      is also impossible for the webserver to delete files lying around
+ *      there for too long. You should have some script that deletes
+ *      left over temp files.
  *    + It should probably be another directory than data_dir.
+ * @global string $attachment_dir
  */
-$attachment_dir = $data_dir;
+$attachment_dir = '/var/local/squirrelmail/attach/';
 
 /**
  * Hash level used for data directory.
- * 
- * This option allows spliting file based squirrelmail user
+ *
+ * This option allows spliting file based SquirrelMail user
  * data storage directory into several subfolders. Number from
  * 0 to 4 allows allows having up to four subfolder levels.
  *
- * Hashing should speed up directory access if you have big number 
+ * Hashing should speed up directory access if you have big number
  * of users (500 and more).
+ * @global integer $dir_hash_level
  */
 $dir_hash_level = 0;
 
 /**
+ * Default Size of Folder List
+ *
  * This is the default size of the folder list. Default
  * is 150, but you can set it to whatever you wish.
+ * @global string $default_left_size
  */
 $default_left_size = '150';
 
 /**
+ * Username Case Control
+ *
  * Some IMAP servers allow a username (like 'bob') to log in if they use
  * uppercase in their name (like 'Bob' or 'BOB'). This creates extra
  * preference files.  Toggling this option to true will transparently
  * change all usernames to lowercase.
+ * @global bool $force_username_lowercase
  */
 $force_username_lowercase = false;
 
 /**
+ * Email Priority Control
+ *
  * This option enables use of email priority flags by end users.
+ * @global bool $default_use_priority
  */
 $default_use_priority = true;
 
 /**
- * This option disables display of "created by squirrelmail developers" 
+ * SquirrelMail Attributions Control
+ *
+ * This option disables display of "created by SquirrelMail developers"
  * strings and provider link
+ * @global bool $hide_sm_attributions
+ * @since 1.2.0
  */
 $hide_sm_attributions = false;
 
 /**
- * This option enables use of read/delivery reciepts by end users.
+ * Delivery Receipts Control
+ *
+ * This option enables use of read/delivery receipts by end users.
+ * @global bool $default_use_mdn
  */
 $default_use_mdn = true;
 
 /**
+ * Identity Controls
+ *
  * If you don't want to allow users to change their email address
  * then you can set $edit_identity to false, if you want them to
  * not be able to change their full name too then set $edit_name
  * to false as well. $edit_name has no effect unless $edit_identity
  * is false;
+ * @global bool $edit_identity
+ * @global bool $edit_name
  */
 $edit_identity = true;
 $edit_name = true;
 
 /**
- * If you want to enable server side thread sorting options
- * Your IMAP server must support the THREAD extension for 
- * this to work.
+ * SquirrelMail adds username information to every sent email.
+ * It is done in order to prevent possible sender forging when
+ * end users are allowed to change their email and name
+ * information.
+ *
+ * You can disable this header, if you think that it violates
+ * user's privacy or security. Please note, that setting will
+ * work only when users are not allowed to change their identity.
+ *
+ * See SquirrelMail bug tracker #847107 for more details about it.
+ * @global bool $hide_auth_header
+ * @since 1.5.1 and 1.4.5
+ */
+$hide_auth_header = false;
+
+/**
+ * Server Side Threading Control
+ *
+ * Set it to true, if you want to disable server side thread 
+ * sorting options. Your IMAP server must support the THREAD 
+ * extension for this to have any effect.
+ * 
+ * Older SquirrelMail versions used $allow_thread_sort option.
+ * @global bool $disable_thread_sort
+ * @since 1.5.1
  */
-$allow_thread_sort = false;
+$disable_thread_sort = false;
 
-/** 
- * to use server-side sorting instead of SM client side.
- * Your IMAP server must support the SORT extension for this
- * to work.
+/**
+ * Server Side Sorting Control
+ *
+ * Set it to true, if you want to disable server side sorting 
+ * and use SM client side sorting instead (client side sorting 
+ * can be slow). Your IMAP server must support the SORT extension 
+ * for this to have any effect.
+ * 
+ * Older SquirrelMail versions used $allow_server_sort option.
+ * @global bool $disable_server_sort
+ * @since 1.5.1
  */
-$allow_server_sort = false;
+$disable_server_sort = false;
 
 /**
+ * IMAP Charset Use Control
+ *
  * This option allows you to choose if SM uses charset search
- * Your imap server should support SEARCH CHARSET command for 
+ * Your imap server should support SEARCH CHARSET command for
  * this to work.
+ * @global bool $allow_charset_search
  */
 $allow_charset_search = true;
 
 /**
- * PHP session name.  Leave this alone unless you know what you are doing.
+ * Search functions control
+ *
+ * This option allows you to control the use of advanced search form.
+ * Set to 0 to enable basic search only, 1 to enable advanced search only
+ * or 2 to enable both.
+ * @global integer $allow_advanced_search
+ */
+$allow_advanced_search = 0;
+
+/**
+ * PHP session name.
+ *
+ * Leave this alone unless you know what you are doing.
+ * @global string $session_name
  */
 $session_name = 'SQMSESSID';
 
@@ -403,14 +649,20 @@ $session_name = 'SQMSESSID';
  *
  * To add a new theme to the options that users can choose from, just
  * add a new number to the array at the bottom, and follow the pattern.
- * 
+ *
  * $theme_default sets theme that will be used by default
- * $theme_css sets stylesheet (from theme/css directory) that will be 
+ * $theme_css sets stylesheet (from theme/css directory) that will be
  * used by default.
+ * @global integer $theme_default
+ * @global string $theme_css
  */
 $theme_default = 0;
 $theme_css = '';
 
+/**
+ * Listing of installed themes
+ * @global array $theme
+ */
 $theme[0]['PATH'] = SM_PATH . 'themes/default_theme.php';
 $theme[0]['NAME'] = 'Default';
 
@@ -519,6 +771,100 @@ $theme[34]['NAME'] = 'Penguin';
 $theme[35]['PATH'] = SM_PATH . 'themes/minimal_bw.php';
 $theme[35]['NAME'] = 'Minimal BW';
 
+$theme[36]['PATH'] = SM_PATH . 'themes/redmond.php';
+$theme[36]['NAME'] = 'Redmond';
+
+$theme[37]['PATH'] = SM_PATH . 'themes/netstyle_theme.php';
+$theme[37]['NAME'] = 'Net Style';
+
+$theme[38]['PATH'] = SM_PATH . 'themes/silver_steel_theme.php';
+$theme[38]['NAME'] = 'Silver Steel';
+
+$theme[39]['PATH'] = SM_PATH . 'themes/simple_green_theme.php';
+$theme[39]['NAME'] = 'Simple Green';
+
+$theme[40]['PATH'] = SM_PATH . 'themes/wood_theme.php';
+$theme[40]['NAME'] = 'Wood';
+
+$theme[41]['PATH'] = SM_PATH . 'themes/bluesome.php';
+$theme[41]['NAME'] = 'Bluesome';
+
+$theme[42]['PATH'] = SM_PATH . 'themes/simple_green2.php';
+$theme[42]['NAME'] = 'Simple Green 2';
+
+$theme[43]['PATH'] = SM_PATH . 'themes/simple_purple.php';
+$theme[43]['NAME'] = 'Simple Purple';
+
+$theme[44]['PATH'] = SM_PATH . 'themes/autumn.php';
+$theme[44]['NAME'] = 'Autumn';
+
+$theme[45]['PATH'] = SM_PATH . 'themes/autumn2.php';
+$theme[45]['NAME'] = 'Autumn 2';
+
+$theme[46]['PATH'] = SM_PATH . 'themes/blue_on_blue.php';
+$theme[46]['NAME'] = 'Blue on Blue';
+
+$theme[47]['PATH'] = SM_PATH . 'themes/classic_blue.php';
+$theme[47]['NAME'] = 'Classic Blue';
+
+$theme[48]['PATH'] = SM_PATH . 'themes/classic_blue2.php';
+$theme[48]['NAME'] = 'Classic Blue 2';
+
+$theme[49]['PATH'] = SM_PATH . 'themes/powder_blue.php';
+$theme[49]['NAME'] = 'Powder Blue';
+
+$theme[50]['PATH'] = SM_PATH . 'themes/techno_blue.php';
+$theme[50]['NAME'] = 'Techno Blue';
+
+$theme[51]['PATH'] = SM_PATH . 'themes/turquoise.php';
+$theme[51]['NAME'] = 'Turquoise';
+
+/**
+ * Templates
+ *   You can define your own template and put it in this directory.
+ *   You must call it as the example below. You can name the template
+ *   whatever you want. For an example of a template, see the ones
+ *   included in the template directory.
+ *
+ * To add a new template to the options that users can choose from, just
+ * add a new number to the array at the bottom, and follow the pattern.
+ *
+ * $templateset_default sets theme that will be used by default
+ * used by default.
+ * @global integer $templateset_default
+ */
+$templateset_default = 0;
+
+$aTemplateSet[0]['PATH'] = SM_PATH . 'templates/default/';
+$aTemplateSet[0]['NAME'] = 'Default template';
+$aTemplateSet[1]['PATH'] = SM_PATH . 'templates/default_advanced/';
+$aTemplateSet[1]['NAME'] = 'Advanced template';
+
+/**
+ * Default interface font size.
+ * @global string $default_fontsize
+ * @since 1.5.1
+ */
+$default_fontsize = '';
+
+/**
+ * Default font set
+ * @global string $default_fontset
+ * @since 1.5.1
+ */
+$default_fontset = '';
+
+/**
+ * List of available fontsets.
+ * @global array $fontsets
+ * @since 1.5.1
+ */
+$fontsets = array();
+$fontsets['serif'] = 'serif';
+$fontsets['sans'] = 'helvetica,arial,sans-serif';
+$fontsets['comicsans'] = 'comic sans ms,sans-serif';
+$fontsets['verasans'] = 'bitstream vera sans,verdana,sans-serif';
+$fontsets['tahoma'] = 'tahoma,sans-serif';
 
 /**
  * LDAP server(s)
@@ -531,23 +877,69 @@ $theme[35]['NAME'] = 'Minimal BW';
  *       'host' => 'memberdir.netscape.com',
  *       'name' => 'Netcenter Member Directory',
  *       'base' => 'ou=member_directory,o=netcenter.com'
- *   ); 
+ *   );
+ *
+ *   NOTE: please see security note at the top of this file when
+ *   entering a password.
  */
 // Add your ldap server options here
 
 /**
+ * Javascript in Addressbook Control
+ *
  * Users may search their addressbook via either a plain HTML or Javascript
  * enhanced user interface. This option allows you to set the default choice.
  * Set this default choice as either:
  *    true  = javascript
  *    false = html
+ * @global bool $default_use_javascript_addr_book
  */
 $default_use_javascript_addr_book = false;
 
+/**
+ * Shared filebased address book
+ * @global string $abook_global_file
+ * @since 1.5.1 and 1.4.4
+ */
+$abook_global_file = '';
+
+/**
+ * Writing into shared address book control
+ * @global bool $abook_global_file_writeable
+ * @since 1.5.1 and 1.4.4
+ */
+$abook_global_file_writeable = false;
+
+/**
+ * Listing of shared address book control
+ * @global bool $abook_global_file_listing
+ * @since 1.5.1
+ */
+$abook_global_file_listing = true;
+
+/**
+ * Controls file based address book entry size
+ * 
+ * This setting controls space allocated to file based address book records.
+ * End users will be unable to save address book entry, if total entry size 
+ * (quoted address book fields + 4 delimiters + linefeed) exceeds allowed
+ * address book length size.
+ *
+ * Same setting is applied to personal and global file based address books.
+ *
+ * It is strongly recommended to keep default setting value. Change it only
+ * if you really want to store address book entries that are bigger than two
+ * kilobytes (2048).
+ * @global integer $abook_file_line_length
+ * @since 1.5.2
+ */
+$abook_file_line_length = 2048;
 
 /**
  * MOTD
- * This is a message that is displayed immediately after a user logs in. 
+ *
+ * This is a message that is displayed immediately after a user logs in.
+ * @global string $motd
  */
 $motd = "";
 
@@ -557,15 +949,15 @@ $motd = "";
  * the plugin directory name relative to the /plugins/ directory.
  * For instance, for the 'sqclock' plugin, you'd put a line like
  * the following.
- *    $plugins[0] = 'sqclock';
- *    $plugins[1] = 'attachment_common';
+ *    $plugins[] = 'sqclock';
+ *    $plugins[] = 'attachment_common';
  */
 // Add list of enabled plugins here
 
 
 /*** Database ***/
 /**
- * Read doc/database.txt in order to get more information 
+ * Read doc/database.txt in order to get more information
  * about these settings.
  */
 /**
@@ -577,6 +969,9 @@ $motd = "";
  *   The DSN is in the format: mysql://user:pass@hostname/dbname
  *   The table is the name of the table to use within the
  *   specified database.
+ *
+ *   NOTE: please see security note at the top of this file when
+ *   entering a password.
  */
 $addrbook_dsn = '';
 $addrbook_table = 'address';
@@ -585,95 +980,242 @@ $addrbook_table = 'address';
  */
 $prefs_dsn = '';
 $prefs_table = 'userprefs';
+/**
+ * Preference key field
+ * @global string $prefs_key_field
+ */
 $prefs_key_field = 'prefkey';
+/**
+ * Size of preference key field
+ * @global integer $prefs_key_size
+ * @since 1.5.1
+ */
+$prefs_key_size = 64;
+/**
+ * Preference owner field
+ * @global string $prefs_user_field
+ */
 $prefs_user_field = 'user';
+/**
+ * Size of preference owner field
+ * @global integer $prefs_user_size
+ * @since 1.5.1
+ */
+$prefs_user_size = 128;
+/**
+ * Preference value field
+ * @global string $prefs_val_field
+ */
 $prefs_val_field = 'prefval';
+/**
+ * Size of preference key field
+ * @global integer $prefs_val_size
+ * @since 1.5.1
+ */
+$prefs_val_size = 65536;
 
+/*** Global sql database options ***/
+/**
+ * DSN of global address book database
+ * @global string $addrbook_global_dsn
+ * @since 1.5.1 and 1.4.4
+ */
+$addrbook_global_dsn = '';
+/**
+ * Table used for global database address book
+ * @global string $addrbook_global_table
+ * @since 1.5.1 and 1.4.4
+ */
+$addrbook_global_table = 'global_abook';
+/**
+ * Control writing into global database address book
+ * @global boolean $addrbook_global_writeable
+ * @since 1.5.1 and 1.4.4
+ */
+$addrbook_global_writeable = false;
+/**
+ * Control listing of global database address book
+ * @global boolean $addrbook_global_listing
+ * @since 1.5.1 and 1.4.4
+ */
+$addrbook_global_listing = false;
 
 /*** Language settings ***/
 /**
  * Default language
+ *
  *   This is the default language. It is used as a last resort
  *   if SquirrelMail can't figure out which language to display.
- *   Language names usually consist of language code, undercore 
+ *   Language names usually consist of language code, undercore
  *   symbol and country code
+ * @global string $squirrelmail_default_language
  */
 $squirrelmail_default_language = 'en_US';
 
 /**
- * This option controls what character set is used when sending mail
- * and when sending HTML to the browser. Do not set this to US-ASCII,
- * use ISO-8859-1 instead.
- * 
- * You can set this option, only if $squirrelmail_default_language setting
- * contains 'en_US' string. In any other case system does not allow 
- * making mistakes with incorrect language and charset combinations.
+ * Default Charset
+ *
+ * This option controls what character set is used when sending
+ * mail and when sending HTML to the browser. Option works only
+ * with US English (en_US) translation. Other translations use
+ * charsets that are set in translation settings.
+ *
+ * @global string $default_charset
  */
 $default_charset = 'iso-8859-1';
 
 /**
- * This option controls number of languages available to end user in
- * language selection preferences. You can use space separated list
- * of translations installed in locale/ directory or special keys
- * 'all' (all languages are available) and 'none' (language selection
- * is disabled, interface is set to $squirrelmail_default_language
- */
-$available_languages   = 'all';
-
-/**
- * This options allows displaying native language names in language 
+ * Alternative Language Names Control
+ *
+ * This options allows displaying native language names in language
  * selection box.
+ * @global bool $show_alternative_names
+ * @since 1.5.0
  */
 $show_alternative_names   = false;
 
 /**
- * This option enables reading of Eastern multibyte encodings. 
+ * Aggressive Decoding Control
+ *
+ * This option enables reading of Eastern multibyte encodings.
  * Functions that provide this support are very cpu and memory intensive.
  * Don't enable this option unless you really need it.
+ * @global bool $aggressive_decoding
+ * @since 1.5.1
+ */
+$aggressive_decoding = false;
+
+/**
+ * Lossy Encoding Control
+ *
+ * This option allows charset conversions when output charset does not support
+ * all symbols used in original charset. Symbols unsupported by output charset
+ * will be replaced with question marks.
+ * @global bool $lossy_encoding
+ * @since 1.5.1
+ */
+$lossy_encoding = false;
+
+/**
+ * Controls use of time zone libraries
+ *
+ * Possible values:
+ * <ul>
+ *  <li>0 - default, SquirrelMail uses GNU C timezone names in
+ *          TZ environment variables
+ *  <li>1 - strict, SquirrelMail uses 'TZ' subkey values in TZ
+ *          environment variables
+ *  <li>2 - custom, SquirrelMail loads time zone data from
+ *          config/timezones.php and uses time zone array keys in
+ *          TZ enviroment variables
+ *  <li>3 - custom strict, SquirrelMail loads time zone data from
+ *          config/timezones.php and uses TZ subkey values in
+ *          TZ enviroment variables
+ * </ul>
+ * Use of any other value switches to default SquirrelMail time zone
+ * handling ($time_zone_type).
+ * @global integer $time_zone_type
+ * @since 1.5.1
+ */
+$time_zone_type = 0;
+
+/**
+ * Location base
+ * 
+ * This is used to build the URL to the SquirrelMail location.
+ * It should contain only the protocol and hostname/port parts
+ * of the URL; the full path will be appended automatically.
+ *
+ * If not specified or empty, it will be autodetected.
+ *
+ * Examples:
+ * http://webmail.example.org
+ * http://webmail.example.com:8080
+ * https://webmail.example.com:6691
+ *
+ * To be clear: do not include any of the path elements, so if
+ * SquirrelMail is at http://www.example.net/web/mail/src/login.php, you
+ * write: http://www.example.net
+ *
+ * @global string $config_location_base;
+ * @since 1.5.2
  */
-$agresive_decoding = false;
+$config_location_base = '';
 
 /*** Tweaks ***/
 /**
- * Use experimental DHTML folder listing
+ * Iframe sandbox code control
+ *
+ * Use iframe to render html emails
+ * (temp option used during debuging of new code)
+ * @global bool $use_iframe
+ * @since 1.5.1
  */
-$advanced_tree = false;
+$use_iframe = false;
+
 /**
- * Use older way of folder listing
+ * Message Icons control
+ *
+ * Use icons for message and folder markers
+ * @global bool $use_icons
+ * @since 1.5.1
  */
-$oldway = false;
+$use_icons = false;
+
 /**
+ * PHP recode functions control
+ *
  * Use experimental code with php recode functions when reading messages with
  * different encoding. This code is faster that original SM functions,
  * but it require php with recode support.
- * 
- * Don't enable this option if you are not sure about availability of 
+ *
+ * Don't enable this option if you are not sure about availability of
  * recode support.
+ * @global bool $use_php_recode
+ * @since 1.5.0
  */
 $use_php_recode = false;
+
 /**
+ * PHP iconv functions control
+ *
  * Use experimental code with php iconv functions when reading messages with
  * different encoding. This code is faster that original SM functions,
  * but it require php with iconv support and works only with some translations.
- * 
- * Don't enable this option if you are not sure about availability of 
+ *
+ * Don't enable this option if you are not sure about availability of
  * iconv support.
+ * @global bool $use_php_iconv
+ * @since 1.5.0
  */
 $use_php_iconv = false;
 
 /**
+ * Controls remote configuration checks
+ * @global boolean $allow_remote_configtest
+ * @since 1.5.1
+ */
+$allow_remote_configtest = false;
+
+/**
+ * Subscribe Listing Control
+ *
  * this disables listing all of the folders on the IMAP Server to
  * generate the folder subscribe listbox (this can take a long time
  * when you have a lot of folders).  Instead, a textbox will be
  * displayed allowing users to enter a specific folder name to subscribe to
- * 
+ *
  * This option can't be changed by conf.pl
+ * @global bool $no_list_for_subscribe
  */
 $no_list_for_subscribe = false;
 
 /**
+ * Color in config control
+ *
  * This option is used only by conf.pl script to generate configuration
- * menu with some colors and is provided here only as reference. 
+ * menu with some colors and is provided here only as reference.
+ * @global integer $config_use_color
  */
 $config_use_color = 2;
 
@@ -682,11 +1224,3 @@ $config_use_color = 2;
  */
 @include SM_PATH . 'config/config_local.php';
 
-/**
- * Make sure there are no characters after the PHP closing
- * tag below (including newline characters and whitespace).
- * Otherwise, that character will cause the headers to be
- * sent and regular output to begin, which will majorly screw
- * things up when we try to send more headers later.
- */
-?>
\ No newline at end of file