* conf.pl if at all possible. That is the easiest and cleanest way
* to configure.
*
- * @copyright © 2000-2005 The SquirrelMail Project Team
+ * 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 © 2000-2006 The SquirrelMail Project Team
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
* @version $Id$
* @package squirrelmail
/**
* Extra sendmail command arguments.
- *
- * Sets additional sendmail command arguments. Make sure that arguments are
+ *
+ * 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
+ * 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.
+ * or use arguments suitable for your mailer.
* @global string $sendmail_args
- * @since 1.5.1
+ * @since 1.5.1 and 1.4.8
*/
$sendmail_args = '-i -t';
$imap_server_type = 'other';
/**
- * Advanced IMAP authentication options control
+ * Secure IMAP connection controls
+ *
+ * 0 - use plain text connection,
+ * 1 - use imaps (adds tls:// prefix to hostname),
+ * 2 - use IMAP STARTTLS extension (rfc2595).
*
- * 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
+ * Was boolean before 1.5.1.
+ * @global integer $use_imap_tls
+ * @since 1.4.0
*/
-$use_imap_tls = false;
+$use_imap_tls = 0;
/**
- * Advanced SMTP authentication options control
+ * Secure SMTP connection controls
*
- * 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
+ * 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 = false;
+$use_smtp_tls = 0;
/**
* SMTP authentication mechanism
*/
$smtp_auth_mech = 'none';
+/**
+ * Custom SMTP authentication username
+ *
+ * IMAP username is used if variable is set to empty string.
+ * Variable is included in main configuration file only from 1.5.2 version.
+ * Older versions stored it in config_local.php.
+ * @global string $smtp_sitewide_user
+ * @since 1.5.0
+ */
+$smtp_sitewide_user = '';
+
+/**
+ * Custom SMTP authentication password
+ *
+ * IMAP password is used if $smtp_sitewide_user global is set to empty string.
+ * Variable is included in main configuration file only from 1.5.2 version.
+ * Older versions stored it in config_local.php.
+ * @global string $smtp_sitewide_pass
+ * @since 1.5.0
+ */
+$smtp_sitewide_pass = '';
+
/**
* IMAP authentication mechanism
*
*
* @global string $data_dir
*/
-$data_dir = '/var/local/squirrelmail/data';
+$data_dir = '/var/local/squirrelmail/data/';
/**
* Attachments directory
* + 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 disables display of "created by SquirrelMail developers"
* strings and provider link
* @global bool $hide_sm_attributions
+ * @since 1.2.0
*/
$hide_sm_attributions = false;
/**
* 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
+ * 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
/**
* 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
+ * 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;
/**
* 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
+ * 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
$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)
* Array of arrays with LDAP server parameters. See
* '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
*/
$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
*
* 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';
$prefs_dsn = '';
$prefs_table = 'userprefs';
/**
- * Preference key field
+ * Preference key field
* @global string $prefs_key_field
*/
$prefs_key_field = 'prefkey';
*/
$prefs_key_size = 64;
/**
- * Preference owner field
+ * Preference owner field
* @global string $prefs_user_field
*/
$prefs_user_field = 'user';
*/
$prefs_user_size = 128;
/**
- * Preference value field
+ * Preference value field
* @global string $prefs_val_field
*/
$prefs_val_field = 'prefval';
* 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.
+ * charsets that are set in translation settings.
*
* @global string $default_charset
*/
*/
$time_zone_type = 0;
-/*** Tweaks ***/
/**
- * Advanced DHTML tree control
+ * 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.
*
- * Use experimental DHTML folder listing
- * @global bool $advanced_tree
- * @since 1.5.0
+ * 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 and 1.4.8
*/
-$advanced_tree = false;
+$config_location_base = '';
+/*** Tweaks ***/
/**
* Iframe sandbox code control
*
* @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).
- * 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