moving functions to separate file, adding configuration files
[squirrelmail.git] / config / config_default.php
index a1e2712646ec5194fed731f587c48ee8ec239298..6a6676e4f214afb776f796271d1fee57d0ad11bb 100644 (file)
 <?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.
+ *
+ * @package squirrelmail
+ * @subpackage config
  */
 
 /* Do not change this value. */
+global $version;
 global $config_version;
-$config_version = '1.2.0';
-
-/* Organization's logo picture (blank if none) */
-global $org_logo;
-$org_logo = '../images/sm_logo.png';
+$config_version = '1.4.0';
 
-/*  The width of the logo (0 for default) */
-$org_logo_width = 308;
+/*** Organization preferences ***/
+/**
+ * Organization's name
+ * @global string $org_name
+ */
+$org_name = "SquirrelMail";
 
-/*  The height of the logo (0 for default) */
-$org_logo_height = 111;
+/**
+ * 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';
 
-/* Organization's name */
-global $org_name;
-$org_name = 'SquirrelMail';
+/**
+ * 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
  */
-global $org_title;
 $org_title = "SquirrelMail $version";
-    
+
 /**
- * Default language
- *   This is the default language. It is used as a last resort
- *   if SquirrelMail can't figure out which language to display.
- *   Use the two-letter code.
+ * 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
  */
-global $squirrelmail_default_language;
-$squirrelmail_default_language = 'en_US';
+$signout_page = '';
 
-/* The dns name and port for your imap server. */
-global $imapServerAddress, $imapPort;
-$imapServerAddress = 'localhost';
-$imapPort = 143;
+/**
+ * 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';
+
+/**
+ * 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 
+ * option set to true.
+ * @global string $provider_name
+ */
+$provider_name = 'SquirrelMail';
+
+/**
+ * Provider URI
+ *
+ * Here you can set URL of the link displayed on the right side of main page.
+ *
+ * Link will be displayed only if you have $hide_sm_attributions 
+ * option set to true.
+ * @global string $provider_uri
+ */
+$provider_uri = 'http://www.squirrelmail.org/';
 
+/*** 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
  */
-global $domain;
-$domain = 'mydomain.com';
+$domain = 'example.com';
 
-/* Your SMTP server and port number (usually the same as the IMAP server). */
-global $smtpServerAddress, $smtpPort;
+/**
+ * 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 
+ * $sendmail_path
+ * @global bool $useSendmail
+ */
+$useSendmail = false;
+
+/**
+ * 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;
 
 /**
- * Uncomment this if you want to deliver locally using sendmail
- * instead of connecting to a SMTP-server.
+ * SquirrelMail header control
+ *
+ * Option can be used to disable Received: headers added by squirrelmail.
+ * This can increase user's privacy and solve problems with spam filters
+ * that increase spam marks for dynamic dialup addresses.
+ *
+ * If admin enables this setting, system should have some logging facility 
+ * or other tools to control users. SquirrelMail's Received: header provides 
+ * information, that can't be forged by webmail user.
+ * @global bool $skip_SM_header
  */
-#global $useSendmail, $sendmail_path;
-#$useSendmail = true;
-#$sendmail_path = '/usr/sbin/sendmail';
+$skip_SM_header = false;
 
-/* This is a message that is displayed immediately after a user logs in. */
-global $motd;
-$motd = '';
+/**
+ * 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).
+ * @global string $sendmail_path
+ */
+$sendmail_path = '/usr/sbin/sendmail';
+    
+/**
+ * IMAP server address
+ *
+ * The dns name (or IP address) for your imap server.
+ * @global string $imapServerAddress
+ */
+$imapServerAddress = 'localhost';
 
 /**
- * Whether or not to use a special color for special folders. If not,
- * special folders will be the same color as the other folders.
+ * IMAP server port
+ *
+ * Port used by your imap server. (Usually 143)
+ * @global integer $imapPort
  */
-global $use_special_folder_color;
-$use_special_folder_color = true;
+$imapPort = 143;
 
 /**
+ * IMAP server type
+ *
  * The type of IMAP server you are running.
  * Valid type are the following (case is important):
  *   courier
  *   cyrus
  *   exchange
  *   uw
+ *   macosx
+ *   mercury32
  *   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
+ * @global string $imap_server_type
  */
-global $imap_server_type;
-$imap_server_type = 'cyrus';
+$imap_server_type = 'other';
 
 /**
- * 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.
+ * Advanced IMAP authentication options control
+ *
+ * CRAM-MD5, DIGEST-MD5, Plain, and TLS
+ * Set reasonable defaults - you'd never know this was there unless you ask for it
+ * @global bool $use_imap_tls
  */
-global $signout_page;
-$signout_page = '';
+$use_imap_tls = false;
+
+/**
+ * Advanced SMTP authentication options control
+ *
+ * CRAM-MD5, DIGEST-MD5, Plain, and TLS
+ * Set reasonable defaults - you'd never know this was there unless you ask for it
+ * @global bool $use_smtp_tls
+ */
+$use_smtp_tls = false;
 
 /**
+ * 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
+ * look like 'INBOX/Friends/Bob'.  Normally this should be left at 'detect'
+ * but if you are sure you know what delimiter your server uses, you can
+ * 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
@@ -118,29 +278,39 @@ $signout_page = '';
  *     $default_folder_prefix = 'Mail/folders/';
  *
  * If you do not use this, set it to the empty string.
+ * @global string $default_folder_prefix
  */
-global $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
  */
-global $show_prefix_option;
 $show_prefix_option = false;
 
 /**
  * The following are related to deleting messages.
- *   $move_to_trash
- *      if this is set to 'true', when 'delete' is pressed, it
+ *   $default_move_to_trash
+ *      If this is set to 'true', when 'delete' is pressed, it
  *      will attempt to move the selected messages to the folder
  *      named $trash_folder. If it's set to 'false', we won't even
  *      attempt to move the messages, just delete them.
+ *   $default_move_to_sent
+ *      If this is set to 'true', sent messages will be stored in
+ *      $sent_folder by default.
+ *   $default_save_as_draft
+ *      If this is set to 'true', users are able to use $draft_folder
+ *      to store their unfinished messages.
  *   $trash_folder
  *      This is the path to the default trash folder. For Cyrus
  *      IMAP, it would be 'INBOX.Trash', but for UW it would be
  *      'Trash'. We need the full path name here.
+ *   $draft_folder
+ *      This is the patch to where Draft messages will be stored.
  *   $auto_expunge
  *      If this is true, when a message is moved or copied, the
  *      source mailbox will get expunged, removing all messages
@@ -150,10 +320,15 @@ $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
  */
-global $default_move_to_trash, $default_move_to_sent, $default_save_as_draft;
-global $trash_folder, $sent_folder, $draft_folder, $auto_expunge;
-global $delete_folder;
 $default_move_to_trash = true;
 $default_move_to_sent  = true;
 $default_save_as_draft = true;
@@ -164,24 +339,43 @@ $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
  */
-global $auto_create_special;
 $auto_create_special = true;
 
-/* Whether or not to list the special folders first (true/false). */
-global $list_special_folders_first;
+/**
+ * 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
  */
-global $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
@@ -191,21 +385,39 @@ $default_sub_of_inbox = true;
  * 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
  */
-global $show_contain_subfolders_option;
 $show_contain_subfolders_option = false;
 
 /**
- * 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. For cyrillic it is best to use KOI8-R,
- * since this implementation is faster than the alternatives.
+ * 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 
+ *       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
  */
-global $default_charset;
-$default_charset = 'iso-8859-1';
+$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
+ *
  *   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
@@ -216,13 +428,15 @@ $default_charset = 'iso-8859-1';
  * Absolute:
  *   $data_dir = '/usr/local/squirrelmail/data/';
  *
- * Relative (to the config directory):
- *   $data_dir = '../data/';
+ * Relative (to main SM directory):
+ *   $data_dir = SM_PATH . 'data/';
+ * @global string $data_dir
  */
-global $data_dir;
-$data_dir = '../data/';
+$data_dir = SM_PATH . '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:
@@ -234,30 +448,131 @@ $data_dir = '../data/';
  *       is also impossible for the webserver to delete files lying around 
  *       there for too long.
  *    + It should probably be another directory than data_dir.
+ * @global string $attachment_dir
  */
-global $attachment_dir;
-$attachment_dir = "$data_dir";
+$attachment_dir = $data_dir;
 
-/* Hash level used for data directory. */
-global $dir_hash_level;
+/**
+ * Hash level used for data directory.
+ * 
+ * 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 
+ * 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
  */
-global $default_left_size;
-$default_left_size = 150;
+$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
  */
-global $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;
+
+/**
+ * SquirrelMail Attributions Control
+ *
+ * This option disables display of "created by squirrelmail developers" 
+ * strings and provider link
+ * @global bool $hide_sm_attributions
+ */
+$hide_sm_attributions = false;
+
+/**
+ * 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;
+
+/**
+ * Server Side Threading Control
+ *
+ * If you want to enable server side thread sorting options
+ * Your IMAP server must support the THREAD extension for 
+ * this to work.
+ * @global bool $allow_thread_sort
+ */
+$allow_thread_sort = false;
+
+/**
+ * Server Side Sorting Control
+ *
+ * to use server-side sorting instead of SM client side.
+ * Your IMAP server must support the SORT extension for this
+ * to work.
+ * @global bool $allow_server_sort
+ */
+$allow_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 
+ * this to work.
+ * @global bool $allow_charset_search
+ */
+$allow_charset_search = true;
+
+/**
+ * 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';
+
+
 /**
  * Themes
  *   You can define your own theme and put it in this directory.
@@ -267,117 +582,130 @@ $force_username_lowercase = false;
  *
  * 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 
+ * used by default.
+ * @global integer $theme_default
+ * @global string $theme_css
  */
-global $theme;
+$theme_default = 0;
+$theme_css = '';
 
 /**
- * The first one HAS to be here, and is your system's default
- * theme. It can be any theme you want.
+ * Listing of installed themes
+ * @global array $theme
  */
-$theme[0]['PATH'] = '../themes/default_theme.php';
+$theme[0]['PATH'] = SM_PATH . 'themes/default_theme.php';
 $theme[0]['NAME'] = 'Default';
 
-$theme[1]['PATH'] = '../themes/plain_blue_theme.php';
+$theme[1]['PATH'] = SM_PATH . 'themes/plain_blue_theme.php';
 $theme[1]['NAME'] = 'Plain Blue';
 
-$theme[2]['PATH'] = '../themes/sandstorm_theme.php';
+$theme[2]['PATH'] = SM_PATH . 'themes/sandstorm_theme.php';
 $theme[2]['NAME'] = 'Sand Storm';
 
-$theme[3]['PATH'] = '../themes/deepocean_theme.php';
+$theme[3]['PATH'] = SM_PATH . 'themes/deepocean_theme.php';
 $theme[3]['NAME'] = 'Deep Ocean';
 
-$theme[4]['PATH'] = '../themes/slashdot_theme.php';
+$theme[4]['PATH'] = SM_PATH . 'themes/slashdot_theme.php';
 $theme[4]['NAME'] = 'Slashdot';
 
-$theme[5]['PATH'] = '../themes/purple_theme.php';
+$theme[5]['PATH'] = SM_PATH . 'themes/purple_theme.php';
 $theme[5]['NAME'] = 'Purple';
 
-$theme[6]['PATH'] = '../themes/forest_theme.php';
+$theme[6]['PATH'] = SM_PATH . 'themes/forest_theme.php';
 $theme[6]['NAME'] = 'Forest';
 
-$theme[7]['PATH'] = '../themes/ice_theme.php';
+$theme[7]['PATH'] = SM_PATH . 'themes/ice_theme.php';
 $theme[7]['NAME'] = 'Ice';
 
-$theme[8]['PATH'] = '../themes/seaspray_theme.php';
+$theme[8]['PATH'] = SM_PATH . 'themes/seaspray_theme.php';
 $theme[8]['NAME'] = 'Sea Spray';
 
-$theme[9]['PATH'] = '../themes/bluesteel_theme.php';
+$theme[9]['PATH'] = SM_PATH . 'themes/bluesteel_theme.php';
 $theme[9]['NAME'] = 'Blue Steel';
 
-$theme[10]['PATH'] = '../themes/dark_grey_theme.php';
+$theme[10]['PATH'] = SM_PATH . 'themes/dark_grey_theme.php';
 $theme[10]['NAME'] = 'Dark Grey';
 
-$theme[11]['PATH'] = '../themes/high_contrast_theme.php';
+$theme[11]['PATH'] = SM_PATH . 'themes/high_contrast_theme.php';
 $theme[11]['NAME'] = 'High Contrast';
 
-$theme[12]['PATH'] = '../themes/black_bean_burrito_theme.php';
+$theme[12]['PATH'] = SM_PATH . 'themes/black_bean_burrito_theme.php';
 $theme[12]['NAME'] = 'Black Bean Burrito';
 
-$theme[13]['PATH'] = '../themes/servery_theme.php';
+$theme[13]['PATH'] = SM_PATH . 'themes/servery_theme.php';
 $theme[13]['NAME'] = 'Servery';
 
-$theme[14]['PATH'] = '../themes/maize_theme.php';
+$theme[14]['PATH'] = SM_PATH . 'themes/maize_theme.php';
 $theme[14]['NAME'] = 'Maize';
 
-$theme[15]['PATH'] = '../themes/bluesnews_theme.php';
+$theme[15]['PATH'] = SM_PATH . 'themes/bluesnews_theme.php';
 $theme[15]['NAME'] = 'BluesNews';
 
-$theme[16]['PATH'] = '../themes/deepocean2_theme.php';
+$theme[16]['PATH'] = SM_PATH . 'themes/deepocean2_theme.php';
 $theme[16]['NAME'] = 'Deep Ocean 2';
 
-$theme[17]['PATH'] = '../themes/blue_grey_theme.php';
+$theme[17]['PATH'] = SM_PATH . 'themes/blue_grey_theme.php';
 $theme[17]['NAME'] = 'Blue Grey';
 
-$theme[18]['PATH'] = '../themes/dompie_theme.php';
+$theme[18]['PATH'] = SM_PATH . 'themes/dompie_theme.php';
 $theme[18]['NAME'] = 'Dompie';
 
-$theme[19]['PATH'] = '../themes/methodical_theme.php';
+$theme[19]['PATH'] = SM_PATH . 'themes/methodical_theme.php';
 $theme[19]['NAME'] = 'Methodical';
 
-$theme[20]['PATH'] = '../themes/greenhouse_effect.php';
+$theme[20]['PATH'] = SM_PATH . 'themes/greenhouse_effect.php';
 $theme[20]['NAME'] = 'Greenhouse Effect (Changes)';
 
-$theme[21]['PATH'] = '../themes/in_the_pink.php';
+$theme[21]['PATH'] = SM_PATH . 'themes/in_the_pink.php';
 $theme[21]['NAME'] = 'In The Pink (Changes)';
 
-$theme[22]['PATH'] = '../themes/kind_of_blue.php';
+$theme[22]['PATH'] = SM_PATH . 'themes/kind_of_blue.php';
 $theme[22]['NAME'] = 'Kind of Blue (Changes)';
 
-$theme[23]['PATH'] = '../themes/monostochastic.php';
+$theme[23]['PATH'] = SM_PATH . 'themes/monostochastic.php';
 $theme[23]['NAME'] = 'Monostochastic (Changes)';
 
-$theme[24]['PATH'] = '../themes/shades_of_grey.php';
+$theme[24]['PATH'] = SM_PATH . 'themes/shades_of_grey.php';
 $theme[24]['NAME'] = 'Shades of Grey (Changes)';
 
-$theme[25]['PATH'] = '../themes/spice_of_life.php';
+$theme[25]['PATH'] = SM_PATH . 'themes/spice_of_life.php';
 $theme[25]['NAME'] = 'Spice of Life (Changes)';
 
-$theme[26]['PATH'] = '../themes/spice_of_life_lite.php';
+$theme[26]['PATH'] = SM_PATH . 'themes/spice_of_life_lite.php';
 $theme[26]['NAME'] = 'Spice of Life - Lite (Changes)';
 
-$theme[27]['PATH'] = '../themes/spice_of_life_dark.php';
+$theme[27]['PATH'] = SM_PATH . 'themes/spice_of_life_dark.php';
 $theme[27]['NAME'] = 'Spice of Life - Dark (Changes)';
 
-$theme[28]['PATH'] = '../themes/christmas.php';
+$theme[28]['PATH'] = SM_PATH . 'themes/christmas.php';
 $theme[28]['NAME'] = 'Holiday - Christmas';
 
-$theme[29]['PATH'] = '../themes/darkness.php';
+$theme[29]['PATH'] = SM_PATH . 'themes/darkness.php';
 $theme[29]['NAME'] = 'Darkness (Changes)';
 
-$theme[30]['PATH'] = '../themes/random.php';
+$theme[30]['PATH'] = SM_PATH . 'themes/random.php';
 $theme[30]['NAME'] = 'Random (Changes every login)';
 
-$theme[31]['PATH'] = '../themes/midnight.php';
+$theme[31]['PATH'] = SM_PATH . 'themes/midnight.php';
 $theme[31]['NAME'] = 'Midnight';
 
-$theme[32]['PATH'] = '../themes/alien_glow.php';
+$theme[32]['PATH'] = SM_PATH . 'themes/alien_glow.php';
 $theme[32]['NAME'] = 'Alien Glow';
 
-$theme[33]['PATH'] = '../themes/dark_green.php';
+$theme[33]['PATH'] = SM_PATH . 'themes/dark_green.php';
 $theme[33]['NAME'] = 'Dark Green';
 
-$theme[33]['PATH'] = '../themes/penguin.php';
-$theme[33]['NAME'] = 'Penguin';
+$theme[34]['PATH'] = SM_PATH . 'themes/penguin.php';
+$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';
 
 /**
  * LDAP server(s)
@@ -392,8 +720,46 @@ $theme[33]['NAME'] = 'Penguin';
  *       'base' => 'ou=member_directory,o=netcenter.com'
  *   ); 
  */
-global $ldap_server;
+// 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;
+
+
+/**
+ * MOTD
+ *
+ * This is a message that is displayed immediately after a user logs in. 
+ * @global string $motd
+ */
+$motd = "";
+
+
+/**
+ * To install plugins, just add elements to this array that have
+ * 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';
+ */
+// Add list of enabled plugins here
+
+
+/*** Database ***/
+/**
+ * Read doc/database.txt in order to get more information 
+ * about these settings.
+ */
 /**
  * Database-driven private addressbooks
  *   DSN (Data Source Name) for a database where the private
@@ -404,114 +770,174 @@ global $ldap_server;
  *   The table is the name of the table to use within the
  *   specified database.
  */
-global $addrbook_dsn, $addrbook_table;
 $addrbook_dsn = '';
 $addrbook_table = 'address';
-
-global $prefs_dsn, $prefs_table;
+/**
+ * Database used to store user data
+ */
 $prefs_dsn = '';
 $prefs_table = 'userprefs';
-
+$prefs_key_field = 'prefkey';
+$prefs_user_field = 'user';
+$prefs_val_field = 'prefval';
 /**
- * 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 sql database options
  */
-global $default_use_javascript_addr_book;
-$default_use_javascript_addr_book = false;
+$addrbook_global_dsn = '';
+$addrbook_global_table = 'global_abook';
+$addrbook_global_writeable = false;
+$addrbook_global_listing = false;
 
+/*** Language settings ***/
 /**
- * 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 
- *       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).
+ * 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 
+ *   symbol and country code
+ * @global string $squirrelmail_default_language
  */
-global $default_unseen_notify, $default_unseen_type;
-$default_unseen_notify = 2;
-$default_unseen_type   = 1;
+$squirrelmail_default_language = 'en_US';
+
 /**
- * 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.
+ * 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 functions/i18n.php.
+ *
+ * @global string $default_charset
  */
-global $invert_time;
-$invert_time = false;
+$default_charset = 'iso-8859-1';
 
 /**
- * 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.
+ * Available Languages
+ *
+ * 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
+ * @global string $available_languages
+ * @since 1.5.0
  */
+$available_languages   = 'all';
 
-global $frame_top;
-$frame_top = '_top';
-
-global $plugins;
 /**
- * To install plugins, just add elements to this array that have
- * 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';
+ * 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;
 
 /**
- * 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;
+ * 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
  */
-
-global $edit_identity, $edit_name;
-$edit_identity = true;
-$edit_name = true;
-
+$aggressive_decoding = false;
 
 /**
- * If you want to enable server side thread sorting options
- * Your IMAP server must support the THREAD extension for 
- * this to work.
+ * 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;
 
-global $allow_thread_sort;
-$allow_thread_sort = false;
+/*** Tweaks ***/
+/**
+ * Advanced DHTML tree control 
+ *
+ * Use experimental DHTML folder listing
+ * @global bool $advanced_tree
+ * @since 1.5.0
+ */
+$advanced_tree = false;
 
-/** 
- * to use server-side sorting instead of SM client side.
- * Your IMAP server must support the SORT extension for this
- * to work.
+/**
+ * Older listing way control
+ *
+ * Use older way of folder listing
+ * @global bool $oldway
  */
+$oldway = false;
 
-global $allow_server_sort;
-$allow_server_sort = false;
+/**
+ * Message Icons control
+ *
+ * Use icons for message and folder markers
+ * @global bool $use_icons
+ */
+$use_icons = false;
 
 /**
- * This enables the no select fix for Cyrus when subfolders
- * exist but parent folders do not
+ * 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 
+ * recode support.
+ * @global bool $use_php_recode
+ * @since 1.5.0
  */
+$use_php_recode = false;
 
-global $noselect_fix_enable;
-$noselect_fix_enable = 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 
+ * iconv support.
+ * @global bool $use_php_iconv
+ * @since 1.5.0
+ */
+$use_php_iconv = 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 */
-global $no_list_for_subscribe;
+ * 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. 
+ * @global integer $config_use_color
+ */
+$config_use_color = 2;
+
+/**
+ * This option includes special configuration options
+ */
+@include SM_PATH . 'config/config_local.php';
+
 /**
  * Make sure there are no characters after the PHP closing
  * tag below (including newline characters and whitespace).