| | |
| | | | Main configuration file | |
| | | | | |
| | | | This file is part of the Roundcube Webmail client | |
| | | | Copyright (C) 2005-2010, The Roundcube Dev Team | |
| | | | Licensed under the GNU GPL | |
| | | | Copyright (C) 2005-2011, The Roundcube Dev Team | |
| | | | | |
| | | | Licensed under the GNU General Public License version 3 or | |
| | | | any later version with exceptions for skins & plugins. | |
| | | | See the README file for a full license statement. | |
| | | | | |
| | | +-----------------------------------------------------------------------+ |
| | | |
| | |
| | | // LOGGING/DEBUGGING |
| | | // ---------------------------------- |
| | | |
| | | // system error reporting: 1 = log; 2 = report (not implemented yet), 4 = show, 8 = trace |
| | | // system error reporting, sum of: 1 = log; 4 = show, 8 = trace |
| | | $rcmail_config['debug_level'] = 1; |
| | | |
| | | // log driver: 'syslog' or 'file'. |
| | |
| | | // to display a pulldown menu or set one host as string. |
| | | // To use SSL/TLS connection, enter hostname with prefix ssl:// or tls:// |
| | | // Supported replacement variables: |
| | | // %n - http hostname ($_SERVER['SERVER_NAME']) |
| | | // %d - domain (http hostname without the first part) |
| | | // %n - hostname ($_SERVER['SERVER_NAME']) |
| | | // %t - hostname without the first part |
| | | // %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part) |
| | | // %s - domain name after the '@' from e-mail address provided at login screen |
| | | // For example %n = mail.domain.tld, %d = domain.tld |
| | | // For example %n = mail.domain.tld, %t = domain.tld |
| | | $rcmail_config['default_host'] = ''; |
| | | |
| | | // TCP port used for IMAP connections |
| | | $rcmail_config['default_port'] = 143; |
| | | |
| | | // IMAP AUTH type (DIGEST-MD5, CRAM-MD5, LOGIN, PLAIN or empty to use |
| | | // IMAP AUTH type (DIGEST-MD5, CRAM-MD5, LOGIN, PLAIN or null to use |
| | | // best server supported one) |
| | | $rcmail_config['imap_auth_type'] = null; |
| | | |
| | |
| | | // Enable this option to force LSUB command usage instead. |
| | | $rcmail_config['imap_force_lsub'] = false; |
| | | |
| | | // Some server configurations (e.g. Courier) doesn't list folders in all namespaces |
| | | // Enable this option to force listing of folders in all namespaces |
| | | $rcmail_config['imap_force_ns'] = false; |
| | | |
| | | // IMAP connection timeout, in seconds. Default: 0 (no limit) |
| | | $rcmail_config['imap_timeout'] = 0; |
| | | |
| | |
| | | // If left blank, the PHP mail() function is used |
| | | // Supported replacement variables: |
| | | // %h - user's IMAP hostname |
| | | // %n - http hostname ($_SERVER['SERVER_NAME']) |
| | | // %d - domain (http hostname without the first part) |
| | | // %n - hostname ($_SERVER['SERVER_NAME']) |
| | | // %t - hostname without the first part |
| | | // %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part) |
| | | // %z - IMAP domain (IMAP hostname without the first part) |
| | | // For example %n = mail.domain.tld, %d = domain.tld |
| | | // For example %n = mail.domain.tld, %t = domain.tld |
| | | $rcmail_config['smtp_server'] = ''; |
| | | |
| | | // SMTP port (default is 25; 465 for SSL) |
| | | // SMTP port (default is 25; use 587 for STARTTLS or 465 for the |
| | | // deprecated SSL over SMTP (aka SMTPS)) |
| | | $rcmail_config['smtp_port'] = 25; |
| | | |
| | | // SMTP username (if required) if you use %u as the username Roundcube |
| | |
| | | // ONLY ENABLE IT IF YOU'RE REALLY SURE WHAT YOU'RE DOING! |
| | | $rcmail_config['enable_installer'] = false; |
| | | |
| | | // don't allow these settings to be overriden by the user |
| | | $rcmail_config['dont_override'] = array(); |
| | | |
| | | // provide an URL where a user can get support for this Roundcube installation |
| | | // PLEASE DO NOT LINK TO THE ROUNDCUBE.NET WEBSITE HERE! |
| | | $rcmail_config['support_url'] = ''; |
| | | |
| | | // replace Roundcube logo with this image |
| | | // specify an URL relative to the document root of this Roundcube installation |
| | | $rcmail_config['skin_logo'] = null; |
| | | |
| | | // automatically create a new Roundcube user when log-in the first time. |
| | | // a new user will be created once the IMAP login succeeds. |
| | | // set to false if only registered users can use this service |
| | | $rcmail_config['auto_create_user'] = true; |
| | | |
| | | // Enables possibility to log in using email address from user identities |
| | | $rcmail_config['user_aliases'] = false; |
| | | |
| | | // use this folder to store log files (must be writeable for apache user) |
| | | // This is used by the 'file' log driver. |
| | | $rcmail_config['log_dir'] = 'logs/'; |
| | |
| | | // tell PHP that it should work as under secure connection |
| | | // even if it doesn't recognize it as secure ($_SERVER['HTTPS'] is not set) |
| | | // e.g. when you're running Roundcube behind a https proxy |
| | | // this option is mutually exclusive to 'force_https' and only either one of them should be set to true. |
| | | $rcmail_config['use_https'] = false; |
| | | |
| | | // Allow browser-autocompletion on login form. |
| | | // 0 - disabled, 1 - username and host only, 2 - username, host, password |
| | | $rcmail_config['login_autocomplete'] = 0; |
| | | |
| | | // If users authentication is not case sensitive this must be enabled. |
| | | // You can also use it to force conversion of logins to lower case. |
| | | // After enabling it all user records need to be updated, e.g. with query: |
| | | // UPDATE users SET username = LOWER(username); |
| | | $rcmail_config['login_lc'] = false; |
| | | |
| | | // automatically create a new Roundcube user when log-in the first time. |
| | | // a new user will be created once the IMAP login succeeds. |
| | | // set to false if only registered users can use this service |
| | | $rcmail_config['auto_create_user'] = true; |
| | | |
| | | // replace Roundcube logo with this image |
| | | // specify an URL relative to the document root of this Roundcube installation |
| | | $rcmail_config['skin_logo'] = null; |
| | | // Forces conversion of logins to lower case. |
| | | // 0 - disabled, 1 - only domain part, 2 - domain and local part. |
| | | // If users authentication is case-insensitive this must be enabled. |
| | | // Note: After enabling it all user records need to be updated, e.g. with query: |
| | | // UPDATE users SET username = LOWER(username); |
| | | $rcmail_config['login_lc'] = 2; |
| | | |
| | | // Includes should be interpreted as PHP files |
| | | $rcmail_config['skin_include_php'] = false; |
| | | |
| | | // display software version on login screen |
| | | $rcmail_config['display_version'] = false; |
| | | |
| | | // Session lifetime in minutes |
| | | // must be greater than 'keep_alive'/60 |
| | | $rcmail_config['session_lifetime'] = 10; |
| | | |
| | | // session domain: .example.org |
| | | // Session domain: .example.org |
| | | $rcmail_config['session_domain'] = ''; |
| | | |
| | | // Session name. Default: 'roundcube_sessid' |
| | | $rcmail_config['session_name'] = null; |
| | | |
| | | // Session path. Defaults to PHP session.cookie_path setting. |
| | | $rcmail_config['session_path'] = null; |
| | | |
| | | // Backend to use for session storage. Can either be 'db' (default) or 'memcache' |
| | | // If set to memcache, a list of servers need to be specified in 'memcache_hosts' |
| | |
| | | $rcmail_config['session_storage'] = 'db'; |
| | | |
| | | // Use these hosts for accessing memcached |
| | | // Define any number of hosts in the form hostname:port |
| | | $rcmail_config['memcache_hosts'] = null; // e.g. array( 'localhost:11211', '192.168.1.12:11211' ); |
| | | // Define any number of hosts in the form of hostname:port or unix:///path/to/socket.file |
| | | $rcmail_config['memcache_hosts'] = null; // e.g. array( 'localhost:11211', '192.168.1.12:11211', 'unix:///var/tmp/memcached.sock' ); |
| | | |
| | | // check client IP in session athorization |
| | | $rcmail_config['ip_check'] = false; |
| | |
| | | // Specify an array with 'host' => 'domain' values to support multiple hosts |
| | | // Supported replacement variables: |
| | | // %h - user's IMAP hostname |
| | | // %n - http hostname ($_SERVER['SERVER_NAME']) |
| | | // %d - domain (http hostname without the first part) |
| | | // %n - hostname ($_SERVER['SERVER_NAME']) |
| | | // %t - hostname without the first part |
| | | // %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part) |
| | | // %z - IMAP domain (IMAP hostname without the first part) |
| | | // For example %n = mail.domain.tld, %d = domain.tld |
| | | // For example %n = mail.domain.tld, %t = domain.tld |
| | | $rcmail_config['username_domain'] = ''; |
| | | |
| | | // This domain will be used to form e-mail addresses of new users |
| | |
| | | // %n - http hostname ($_SERVER['SERVER_NAME']) |
| | | // %d - domain (http hostname without the first part) |
| | | // %z - IMAP domain (IMAP hostname without the first part) |
| | | // For example %n = mail.domain.tld, %d = domain.tld |
| | | // For example %n = mail.domain.tld, %t = domain.tld |
| | | $rcmail_config['mail_domain'] = ''; |
| | | |
| | | // Password charset. |
| | |
| | | // send plaintext messages as format=flowed |
| | | $rcmail_config['send_format_flowed'] = true; |
| | | |
| | | // don't allow these settings to be overriden by the user |
| | | $rcmail_config['dont_override'] = array(); |
| | | |
| | | // Set identities access level: |
| | | // 0 - many identities with possibility to edit all params |
| | | // 1 - many identities with possibility to edit all params but not email address |
| | | // 2 - one identity with possibility to edit all params |
| | | // 3 - one identity with possibility to edit all params but not email address |
| | | // 4 - one identity with possibility to edit only signature |
| | | $rcmail_config['identities_level'] = 0; |
| | | |
| | | // Mimetypes supported by the browser. |
| | |
| | | // Enable DNS checking for e-mail address validation |
| | | $rcmail_config['email_dns_check'] = false; |
| | | |
| | | // Disables saving sent messages in Sent folder (like gmail) (Default: false) |
| | | // Note: useful when SMTP server stores sent mail in user mailbox |
| | | $rcmail_config['no_save_sent_messages'] = false; |
| | | |
| | | // ---------------------------------- |
| | | // PLUGINS |
| | | // ---------------------------------- |
| | |
| | | // ---------------------------------- |
| | | |
| | | // default messages sort column. Use empty value for default server's sorting, |
| | | // or 'arrival', 'date', 'subject', 'from', 'to', 'size', 'cc' |
| | | // or 'arrival', 'date', 'subject', 'from', 'to', 'fromto', 'size', 'cc' |
| | | $rcmail_config['message_sort_col'] = ''; |
| | | |
| | | // default messages sort order |
| | | $rcmail_config['message_sort_order'] = 'DESC'; |
| | | |
| | | // These cols are shown in the message list. Available cols are: |
| | | // subject, from, to, cc, replyto, date, size, status, flag, attachment, 'priority' |
| | | $rcmail_config['list_cols'] = array('subject', 'status', 'from', 'date', 'size', 'flag', 'attachment'); |
| | | // subject, from, to, fromto, cc, replyto, date, size, status, flag, attachment, 'priority' |
| | | $rcmail_config['list_cols'] = array('subject', 'status', 'fromto', 'date', 'size', 'flag', 'attachment'); |
| | | |
| | | // the default locale setting (leave empty for auto-detection) |
| | | // RFC1766 formatted language name like en_US, de_DE, de_CH, fr_FR, pt_BR |
| | |
| | | // display these folders separately in the mailbox list. |
| | | // these folders will also be displayed with localized names |
| | | // NOTE: Use folder names with namespace prefix (INBOX. on Courier-IMAP) |
| | | $rcmail_config['default_imap_folders'] = array('INBOX', 'Drafts', 'Sent', 'Junk', 'Trash'); |
| | | $rcmail_config['default_folders'] = array('INBOX', 'Drafts', 'Sent', 'Junk', 'Trash'); |
| | | |
| | | // automatically create the above listed default folders on login |
| | | // automatically create the above listed default folders on first login |
| | | $rcmail_config['create_default_folders'] = false; |
| | | |
| | | // protect the default folders from renames, deletes, and subscription changes |
| | |
| | | // Makes that words with symbols will be ignored (e.g. g@@gle) |
| | | $rcmail_config['spellcheck_ignore_syms'] = false; |
| | | |
| | | // Use this char/string to separate recipients when composing a new message |
| | | $rcmail_config['recipients_separator'] = ','; |
| | | |
| | | // don't let users set pagesize to more than this value if set |
| | | $rcmail_config['max_pagesize'] = 200; |
| | | |
| | |
| | | // ---------------------------------- |
| | | |
| | | // This indicates which type of address book to use. Possible choises: |
| | | // 'sql' (default) and 'ldap'. |
| | | // 'sql' (default), 'ldap' and ''. |
| | | // If set to 'ldap' then it will look at using the first writable LDAP |
| | | // address book as the primary address book and it will not display the |
| | | // SQL address book in the 'Address Book' view. |
| | | // If set to '' then no address book will be displayed or only the |
| | | // addressbook which is created by a plugin (like CardDAV). |
| | | $rcmail_config['address_book_type'] = 'sql'; |
| | | |
| | | // In order to enable public ldap search, configure an array like the Verisign |
| | |
| | | 'name' => 'Verisign.com', |
| | | // Replacement variables supported in host names: |
| | | // %h - user's IMAP hostname |
| | | // %n - http hostname ($_SERVER['SERVER_NAME']) |
| | | // %d - domain (http hostname without the first part) |
| | | // %n - hostname ($_SERVER['SERVER_NAME']) |
| | | // %t - hostname without the first part |
| | | // %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part) |
| | | // %z - IMAP domain (IMAP hostname without the first part) |
| | | // For example %n = mail.domain.tld, %d = domain.tld |
| | | // For example %n = mail.domain.tld, %t = domain.tld |
| | | 'hosts' => array('directory.verisign.com'), |
| | | 'port' => 389, |
| | | 'use_tls' => false, |
| | |
| | | // The login name is used to search for the DN to bind with |
| | | 'search_base_dn' => '', |
| | | 'search_filter' => '', // e.g. '(&(objectClass=posixAccount)(uid=%u))' |
| | | // DN and password to bind as before searching for bind DN, if anonymous search is not allowed |
| | | 'search_bind_dn' => '', |
| | | 'search_bind_pw' => '', |
| | | // Default for %dn variable if search doesn't return DN value |
| | | 'search_dn_default' => '', |
| | | // Optional authentication identifier to be used as SASL authorization proxy |
| | |
| | | // The RDN field that is used for new entries, this field needs |
| | | // to be one of the search_fields, the base of base_dn is appended |
| | | // to the RDN to insert into the LDAP directory. |
| | | 'LDAP_rdn' => 'mail', |
| | | 'LDAP_rdn' => 'cn', |
| | | // The required fields needed to build a new contact as required by |
| | | // the object classes (can include additional fields not required by the object classes). |
| | | 'required_fields' => array('cn', 'sn', 'mail'), |
| | | 'search_fields' => array('mail', 'cn'), // fields to search in |
| | | // mapping of contact fields to directory attributes |
| | | // for every attribute one can specify the number of values (limit) allowed. |
| | | // default is 1, a wildcard * means unlimited |
| | | 'fieldmap' => array( |
| | | // Roundcube => LDAP |
| | | // Roundcube => LDAP:limit |
| | | 'name' => 'cn', |
| | | 'surname' => 'sn', |
| | | 'firstname' => 'givenName', |
| | | 'email' => 'mail', |
| | | 'jobtitle' => 'title', |
| | | 'email' => 'mail:*', |
| | | 'phone:home' => 'homePhone', |
| | | 'phone:work' => 'telephoneNumber', |
| | | 'phone:mobile' => 'mobile', |
| | | 'phone:pager' => 'pager', |
| | | 'street' => 'street', |
| | | 'zipcode' => 'postalCode', |
| | | 'region' => 'st', |
| | | 'locality' => 'l', |
| | | 'country' => 'c', |
| | | // if you country is a complex object, you need to configure 'sub_fields' below |
| | | 'country' => 'c', |
| | | 'organization' => 'o', |
| | | 'department' => 'ou', |
| | | 'jobtitle' => 'title', |
| | | 'notes' => 'description', |
| | | // these currently don't work: |
| | | // 'phone:workfax' => 'facsimileTelephoneNumber', |
| | | // 'photo' => 'jpegPhoto', |
| | | // 'manager' => 'manager', |
| | | // 'assistant' => 'secretary', |
| | | ), |
| | | // Map of contact sub-objects (attribute name => objectClass(es)), e.g. 'c' => 'country' |
| | | 'sub_fields' => array(), |
| | | 'sort' => 'cn', // The field to sort the listing by. |
| | | 'scope' => 'sub', // search mode: sub|base|list |
| | | 'filter' => '(objectClass=inetOrgPerson)', // used for basic listing (if not empty) and will be &'d with search queries. example: status=act |
| | |
| | | // -> in this case, assure that groups and contacts are separated due to the concernig filters! |
| | | 'groups' => array( |
| | | 'base_dn' => '', |
| | | 'scope' => 'sub', // search mode: sub|base|list |
| | | 'filter' => '(objectClass=groupOfNames)', |
| | | 'object_classes' => array("top", "groupOfNames"), |
| | | 'member_attr' => 'member', // name of the member attribute, e.g. uniqueMember |
| | |
| | | // available placeholders: {street}, {locality}, {zipcode}, {country}, {region} |
| | | $rcmail_config['address_template'] = '{street}<br/>{locality} {zipcode}<br/>{country} {region}'; |
| | | |
| | | // Matching mode for addressbook search (including autocompletion) |
| | | // 0 - partial (*abc*), default |
| | | // 1 - strict (abc) |
| | | // 2 - prefix (abc*) |
| | | // Note: For LDAP sources fuzzy_search must be enabled to use 'partial' or 'prefix' mode |
| | | $rcmail_config['addressbook_search_mode'] = 0; |
| | | |
| | | // ---------------------------------- |
| | | // USER PREFERENCES |
| | | // ---------------------------------- |
| | |
| | | $rcmail_config['default_charset'] = 'ISO-8859-1'; |
| | | |
| | | // skin name: folder from skins/ |
| | | $rcmail_config['skin'] = 'default'; |
| | | $rcmail_config['skin'] = 'larry'; |
| | | |
| | | // show up to X items in list view |
| | | $rcmail_config['pagesize'] = 40; |
| | | // show up to X items in messages list view |
| | | $rcmail_config['mail_pagesize'] = 50; |
| | | |
| | | // show up to X items in contacts list view |
| | | $rcmail_config['addressbook_pagesize'] = 50; |
| | | |
| | | // sort contacts by this col (preferably either one of name, firstname, surname) |
| | | $rcmail_config['addressbook_sort_col'] = 'surname'; |
| | | |
| | | // the way how contact names are displayed in the list |
| | | // 0: display name |
| | | // 1: (prefix) firstname middlename surname (suffix) |
| | | // 2: (prefix) surname firstname middlename (suffix) |
| | | // 3: (prefix) surname, firstname middlename (suffix) |
| | | $rcmail_config['addressbook_name_listing'] = 0; |
| | | |
| | | // use this timezone to display date/time |
| | | // valid timezone identifers are listed here: php.net/manual/en/timezones.php |
| | | // 'auto' will use the browser's timezone settings |
| | | $rcmail_config['timezone'] = 'auto'; |
| | | |
| | | // is daylight saving On? |
| | | $rcmail_config['dst_active'] = (bool)date('I'); |
| | | |
| | | // prefer displaying HTML messages |
| | | $rcmail_config['prefer_html'] = true; |
| | |
| | | // 2 - Always show inline images |
| | | $rcmail_config['show_images'] = 0; |
| | | |
| | | // open messages in new window |
| | | $rcmail_config['message_extwin'] = false; |
| | | |
| | | // open message compose form in new window |
| | | $rcmail_config['compose_extwin'] = false; |
| | | |
| | | // compose html formatted messages by default |
| | | // 0 - never, 1 - always, 2 - on reply to HTML message only |
| | | // 0 - never, 1 - always, 2 - on reply to HTML message, 3 - on forward or reply to HTML message |
| | | $rcmail_config['htmleditor'] = 0; |
| | | |
| | | // show pretty dates as standard |
| | |
| | | $rcmail_config['check_all_folders'] = false; |
| | | |
| | | // If true, after message delete/move, the next message will be displayed |
| | | $rcmail_config['display_next'] = false; |
| | | $rcmail_config['display_next'] = true; |
| | | |
| | | // 0 - Do not expand threads |
| | | // 1 - Expand all threads automatically |
| | | // 2 - Expand only threads with unread messages |
| | | $rcmail_config['autoexpand_threads'] = 0; |
| | | |
| | | // When replying place cursor above original message (top posting) |
| | | $rcmail_config['top_posting'] = false; |
| | | // When replying: |
| | | // -1 - don't cite the original message |
| | | // 0 - place cursor below the original message |
| | | // 1 - place cursor above original message (top posting) |
| | | $rcmail_config['reply_mode'] = 0; |
| | | |
| | | // When replying strip original signature from message |
| | | $rcmail_config['strip_existing_sig'] = true; |
| | |
| | | // Defaults of the search field configuration. |
| | | // The array can contain a per-folder list of header fields which should be considered when searching |
| | | // The entry with key '*' stands for all folders which do not have a specific list set. |
| | | // Please note that folder names should to be in sync with $rcmail_config['default_imap_folders'] |
| | | // Please note that folder names should to be in sync with $rcmail_config['default_folders'] |
| | | $rcmail_config['search_mods'] = null; // Example: array('*' => array('subject'=>1, 'from'=>1), 'Sent' => array('subject'=>1, 'to'=>1)); |
| | | |
| | | // Defaults of the addressbook search field configuration. |
| | |
| | | // when moving to Trash fails. This is necessary in some setups |
| | | // when user is over quota and Trash is included in the quota. |
| | | $rcmail_config['delete_always'] = false; |
| | | |
| | | // Directly delete messages in Junk instead of moving to Trash |
| | | $rcmail_config['delete_junk'] = false; |
| | | |
| | | // Behavior if a received message requests a message delivery notification (read receipt) |
| | | // 0 = ask the user, 1 = send automatically, 2 = ignore (never send or ask) |
| | |
| | | // Enables spell checking before sending a message. |
| | | $rcmail_config['spellcheck_before_send'] = false; |
| | | |
| | | // Skip alternative email addresses in autocompletion (show one address per contact) |
| | | $rcmail_config['autocomplete_single'] = false; |
| | | |
| | | // Default font for composed HTML message. |
| | | // Supported values: Andale Mono, Arial, Arial Black, Book Antiqua, Courier New, |
| | | // Georgia, Helvetica, Impact, Tahoma, Terminal, Times New Roman, Trebuchet MS, Verdana |
| | | $rcmail_config['default_font'] = ''; |
| | | |
| | | // end of config file |