svncommit
2008-08-29 cca626ef7e4859ee84a02a2f09b3d4e8db9584c5
commit | author | age
4e17e6 1 <?php
T 2
3 /*
4  +-----------------------------------------------------------------------+
5  | Main configuration file                                               |
6  |                                                                       |
7  | This file is part of the RoundCube Webmail client                     |
83ce4b 8  | Copyright (C) 2005-2008, RoundCube Dev. - Switzerland                 |
52c1f2 9  | Licensed under the GNU GPL                                            |
4e17e6 10  |                                                                       |
T 11  +-----------------------------------------------------------------------+
12
13 */
14
15 $rcmail_config = array();
16
17
968bdc 18 // system error reporting: 1 = log; 2 = report (not implemented yet), 4 = show, 8 = trace
13c1af 19 $rcmail_config['debug_level'] = 1;
4e17e6 20
b77d0d 21 // log driver:  'syslog' or 'file'.
A 22 $rcmail_config['log_driver'] = 'file';
23
24 // Syslog ident string to use, if using the 'syslog' log driver.
25 $rcmail_config['syslog_id'] = 'roundcube';
26
27 // Syslog facility to use, if using the 'syslog' log driver.
28 // For possible values see installer or http://php.net/manual/en/function.openlog.php
29 $rcmail_config['syslog_facility'] = LOG_USER;
30
31 // use this folder to store log files (must be writebale for apache user)
32 // This is used by the 'file' log driver.
33 $rcmail_config['log_dir'] = 'logs/';
34
35 // use this folder to store temp files (must be writeable for apache user)
36 $rcmail_config['temp_dir'] = 'temp/';
37
6dc026 38 // enable caching of messages and mailbox data in the local database.
T 39 // this is recommended if the IMAP server does not run on the same machine
40 $rcmail_config['enable_caching'] = TRUE;
41
cc9570 42 // lifetime of message cache
T 43 // possible units: s, m, h, d, w
44 $rcmail_config['message_cache_lifetime'] = '10d';
45
7902df 46 // automatically create a new RoundCube user when log-in the first time.
7cc38e 47 // a new user will be created once the IMAP login succeeds.
4e17e6 48 // set to false if only registered users can use this service
T 49 $rcmail_config['auto_create_user'] = TRUE;
50
51 // the mail host chosen to perform the log-in
52 // leave blank to show a textbox at login, give a list of hosts
42b113 53 // to display a pulldown menu or set one host as string.
T 54 // To use SSL connection, enter ssl://hostname:993
4e17e6 55 $rcmail_config['default_host'] = '';
T 56
42b113 57 // TCP port used for IMAP connections
T 58 $rcmail_config['default_port'] = 143;
59
aec031 60 // IMAP auth type. Can be "auth" (CRAM-MD5), "plain" (PLAIN) or "check" to auto detect.
T 61 // Optional, defaults to "check"
b026c3 62 $rcmail_config['imap_auth_type'] = null;
T 63
0566ad 64 // Automatically add this domain to user names for login
T 65 // Only for IMAP servers that require full e-mail addresses for login
66 // Specify an array with 'host' => 'domain' values to support multiple hosts
67 $rcmail_config['username_domain'] = '';
68
977a29 69 // This domain will be used to form e-mail addresses of new users
T 70 // Specify an array with 'host' => 'domain' values to support multiple hosts
13c1af 71 $rcmail_config['mail_domain'] = '';
977a29 72
T 73 // Path to a virtuser table file to resolve user names and e-mail addresses
74 $rcmail_config['virtuser_file'] = '';
75
f88d41 76 // Query to resolve user names and e-mail addresses from the database
T 77 // %u will be replaced with the current username for login.
78 // The query should select the user's e-mail address as first col
79 $rcmail_config['virtuser_query'] = '';
80
4e17e6 81 // use this host for sending mails.
fd8c50 82 // to use SSL connection, set ssl://smtp.host.com
4e17e6 83 // if left blank, the PHP mail() function is used
T 84 $rcmail_config['smtp_server'] = '';
85
fd8c50 86 // SMTP port (default is 25; 465 for SSL)
968bdc 87 $rcmail_config['smtp_port'] = 25;
T 88
d206c1 89 // SMTP username (if required) if you use %u as the username RoundCube
S 90 // will use the current username for login
4e17e6 91 $rcmail_config['smtp_user'] = '';
T 92
d206c1 93 // SMTP password (if required) if you use %p as the password RoundCube
S 94 // will use the current user's password for login
4e17e6 95 $rcmail_config['smtp_pass'] = '';
T 96
d206c1 97 // SMTP AUTH type (DIGEST-MD5, CRAM-MD5, LOGIN, PLAIN or empty to use
S 98 // best server supported one)
99 $rcmail_config['smtp_auth_type'] = '';
100
aca3d2 101 // SMTP HELO host 
S 102 // Hostname to give to the remote server for SMTP 'HELO' or 'EHLO' messages 
103 // Leave this blank and you will get the server variable 'server_name' or 
104 // localhost if that isn't defined. 
105 $rcmail_config['smtp_helo_host'] = '';
106
4e17e6 107 // Log sent messages
T 108 $rcmail_config['smtp_log'] = TRUE;
109
110 // these cols are shown in the message list
f5480d 111 // available cols are: subject, from, to, cc, replyto, date, size, encoding, flag
A 112 $rcmail_config['list_cols'] = array('subject', 'from', 'date', 'size', 'flag');
4e17e6 113
5349b7 114 // includes should be interpreted as PHP files
e9ac14 115 $rcmail_config['skin_include_php'] = FALSE;
fd8c50 116
7902df 117 // session lifetime in minutes
T 118 $rcmail_config['session_lifetime'] = 10;
119
4e17e6 120 // check client IP in session athorization
aad6e2 121 $rcmail_config['ip_check'] = false;
T 122
123 // Use an additional frequently changing cookie to athenticate user sessions.
124 // There have been problems reported with this feature.
125 $rcmail_config['double_auth'] = false;
4e17e6 126
bac7d1 127 // this key is used to encrypt the users imap password which is stored
T 128 // in the session record (and the client cookie if remember password is enabled).
129 // please provide a string of exactly 24 chars.
130 $rcmail_config['des_key'] = 'rcmail-!24ByteDESkey*Str';
131
58e360 132 // the default locale setting
522007 133 $rcmail_config['language'] = 'en_US';
4e17e6 134
T 135 // use this format for short date display
136 $rcmail_config['date_short'] = 'D H:i';
137
138 // use this format for detailed date/time formatting
139 $rcmail_config['date_long'] = 'd.m.Y H:i';
140
8c8b2a 141 // use this format for today's date display
S 142 $rcmail_config['date_today'] = 'H:i';
143
4e17e6 144 // add this user-agent to message headers when sending
b2ff3d 145 $rcmail_config['useragent'] = 'RoundCube Webmail/0.1';
4e17e6 146
15a9d1 147 // use this name to compose page titles
T 148 $rcmail_config['product_name'] = 'RoundCube Webmail';
149
4e17e6 150 // only list folders within this path
T 151 $rcmail_config['imap_root'] = '';
152
1966c5 153 // store draft message is this mailbox
S 154 // leave blank if draft messages should not be stored
155 $rcmail_config['drafts_mbox'] = 'Drafts';
156
b4b081 157 // store spam messages in this mailbox
S 158 $rcmail_config['junk_mbox'] = 'Junk';
159
4e17e6 160 // store sent message is this mailbox
T 161 // leave blank if sent messages should not be stored
162 $rcmail_config['sent_mbox'] = 'Sent';
163
164 // move messages to this folder when deleting them
165 // leave blank if they should be deleted directly
166 $rcmail_config['trash_mbox'] = 'Trash';
167
fa4cd2 168 // display these folders separately in the mailbox list.
83ce4b 169 // these folders will also be displayed with localized names
4e17e6 170 $rcmail_config['default_imap_folders'] = array('INBOX', 'Drafts', 'Sent', 'Junk', 'Trash');
T 171
b2ff3d 172 // automatically create the above listed default folders on login
T 173 $rcmail_config['create_default_folders'] = FALSE;
174
c8c1e0 175 // protect the default folders from renames, deletes, and subscription changes
S 176 $rcmail_config['protect_default_folders'] = TRUE;
177
876b15 178 // if in your system 0 quota means no limit set this option to TRUE 
A 179 $rcmail_config['quota_zero_as_unlimited'] = FALSE;
180
3baec2 181 // Set TRUE if deleted messages should not be displayed
T 182 // This will make the application run slower
183 $rcmail_config['skip_deleted'] = FALSE;
184
4b3af3 185 // Set true to Mark deleted messages as read as well as deleted
S 186 // False means that a message's read status is not affected by marking it as deleted
187 $rcmail_config['read_when_deleted'] = TRUE;
188
189 // When a Trash folder is not present and a message is deleted, flag 
190 // the message for deletion rather than deleting it immediately.  Setting this to 
191 // false causes deleted messages to be permanantly removed if there is no Trash folder
d22455 192 $rcmail_config['flag_for_deletion'] = FALSE;
4b3af3 193
0ea884 194 // Behavior if a received message requests a message delivery notification (read receipt)
T 195 // 0 = ask the user, 1 = send automatically, 2 = ignore (never send or ask)
196 $rcmail_config['mdn_requests'] = 0;
197
967b34 198 // Use this charset as fallback for message decoding
17b5fb 199 $rcmail_config['default_charset'] = 'ISO-8859-1';
T 200
996066 201 // Make use of the built-in spell checker. It is based on GoogieSpell.
e9ac14 202 // Since Google only accepts connections over https your PHP installatation
T 203 // requires to be compiled with Open SSL support
ed5d29 204 $rcmail_config['enable_spellcheck'] = TRUE;
T 205
5d2b7f 206 // Set the spell checking engine. 'googie' is the default. 'pspell' is also available,
T 207 // but requires the Pspell extensions. When using Nox Spell Server, also set 'googie' here.
208 $rcmail_config['spellcheck_engine'] = 'googie';
209
996066 210 // For a locally installed Nox Spell Server, please specify the URI to call it.
T 211 // Get Nox Spell Server from http://orangoo.com/labs/?page_id=72
212 // Leave empty to use the Google spell checking service, what means
213 // that the message content will be sent to Google in order to check spelling
214 $rcmail_config['spellcheck_uri'] = '';
215
216 // These languages can be selected for spell checking.
217 // Configure as a PHP style hash array: array('en'=>'English', 'de'=>'Deutsch');
5d2b7f 218 // Leave empty for default set of Google spell check languages, should be defined
T 219 // when using local Pspell extension
996066 220 $rcmail_config['spellcheck_languages'] = NULL;
T 221
4b0f65 222 // path to a text file which will be added to each sent message
T 223 // paths are relative to the RoundCube root folder
224 $rcmail_config['generic_message_footer'] = '';
967b34 225
T 226 // add a received header to outgoing mails containing the creators IP and hostname
227 $rcmail_config['http_received_header'] = false;
4b0f65 228
T 229 // this string is used as a delimiter for message headers when sending
4647e1 230 // leave empty for auto-detection
T 231 $rcmail_config['mail_header_delimiter'] = NULL;
b076a4 232
aec82b 233 // session domain: .example.org
T 234 $rcmail_config['session_domain'] = '';
235
6153e2 236 // This indicates which type of address book to use. Possible choises:
A 237 // 'sql' (default) and 'ldap'.
238 // If set to 'ldap' then it will look at using the first writable LDAP
4f9c83 239 // address book as the primary address book and it will not display the
S 240 // SQL address book in the 'Address Book' view.
6153e2 241 $rcmail_config['address_book_type'] = 'sql';
4f9c83 242
S 243 // In order to enable public ldap search, configure an array like the Verisign
244 // example further below. if you would like to test, simply uncomment the example.
245 //
246 // If you are going to use LDAP for individual address books, you will need to 
247 // set 'user_specific' to true and use the variables to generate the appropriate DNs to access it.
248 //
249 // The recommended directory structure for LDAP is to store all the address book entries
250 // under the users main entry, e.g.:
251 //
252 //  o=root
253 //   ou=people
254 //    uid=user@domain
255 //    mail=contact@contactdomain
256 //    
257 // So the base_dn would be uid=%fu,ou=people,o=root
258 // The bind_dn would be the same as based_dn or some super user login.
eea43f 259 /** 
f11541 260  * example config for Verisign directory
eea43f 261  *
f11541 262  * $rcmail_config['ldap_public']['Verisign'] = array(
T 263  *  'name'          => 'Verisign.com',
264  *  'hosts'         => array('directory.verisign.com'),
265  *  'port'          => 389,
cd6749 266  *  'use_tls'        => false,
4f9c83 267  *  'user_specific' => false,   // If true the base_dn, bind_dn and bind_pass default to the user's IMAP login.
S 268  *  // %fu - The full username provided, assumes the username is an email
269  *  //       address, uses the username_domain value if not an email address.
270  *  // %u  - The username prior to the '@'.
271  *  // %d  - The domain name after the '@'.
f11541 272  *  'base_dn'       => '',
e3caaf 273  *  'bind_dn'       => '',
T 274  *  'bind_pass'     => '',
4f9c83 275  *  'writable'      => false,   // Indicates if we can write to the LDAP directory or not.
S 276  *  // If writable is true then these fields need to be populated:
277  *  // LDAP_Object_Classes, required_fields, LDAP_rdn
278  *  'LDAP_Object_Classes' => array("top", "inetOrgPerson"), // To create a new contact these are the object classes to specify (or any other classes you wish to use).
279  *  'required_fields'     => array("cn", "sn", "mail"),     // 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).
280  *  'LDAP_rdn'      => 'mail', // 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.
03b271 281  *  'ldap_version'  => 3,       // using LDAPv3
f11541 282  *  'search_fields' => array('mail', 'cn'),  // fields to search in
T 283  *  'name_field'    => 'cn',    // this field represents the contact's name
284  *  'email_field'   => 'mail',  // this field represents the contact's e-mail
6b603d 285  *  'surname_field' => 'sn',    // this field represents the contact's last name
T 286  *  'firstname_field' => 'gn',  // this field represents the contact's first name
4f9c83 287  *  'sort'          => 'cn',    // The field to sort the listing by.
f11541 288  *  'scope'         => 'sub',   // search mode: sub|base|list
81355a 289  *  'filter'        => '',      // used for basic listing (if not empty) and will be &'d with search queries. example: status=act
a0530a 290  *  'global_search' => true,    // perform a global search for address auto-completion on compose
f11541 291  *  'fuzzy_search'  => true);   // server allows wildcard search
eea43f 292  */
d1d2c4 293
b19097 294 // don't allow these settings to be overriden by the user
T 295 $rcmail_config['dont_override'] = array();
296
9606ff 297 // try to load host-specific configuration
2ca388 298 // see http://trac.roundcube.net/wiki/Howto_Config for more details
967b34 299 $rcmail_config['include_host_config'] = false;
T 300
fe6b7a 301 // don't let users set pagesize to more than this value if set
A 302 $rcmail_config['max_pagesize'] = 200;
303
304 // mime magic database
305 $rcmail_config['mime_magic'] = '/usr/share/misc/magic';
306
307 // default sort col
308 $rcmail_config['message_sort_col'] = 'date';
309
310 // default sort order
311 $rcmail_config['message_sort_order'] = 'DESC';
312
967b34 313 // THIS OPTION WILL ALLOW THE INSTALLER TO RUN AND CAN EXPOSE SENSITIVE CONFIG DATA.
T 314 // ONLY ENABLE IT IF YOU'RE REALLY SURE WHAT YOU'RE DOING!
315 $rcmail_config['enable_installer'] = false;
4e17e6 316
166b61 317 // Log successful logins
A 318 $rcmail_config['log_logins'] = false;
319
320 /**
321  * 'Delete always'
322  * This setting reflects if mail should be always marked as deleted,
323  * even if moving to "Trash" fails. This is necessary in some setups
324  * because a) people may not have a Trash folder or b) they are over
325  * quota (and Trash is included in the quota).
326  *
327  * This is a failover setting for iil_C_Move when a message is moved
328  * to the Trash, and not the same as "delete_right_away".
329  */
330 $rcmail_config['delete_always'] = false;
331
4e17e6 332 /***** these settings can be overwritten by user's preferences *****/
T 333
67effe 334 // skin name: folder from skins/
A 335 $rcmail_config['skin'] = 'default';
e58df3 336
4e17e6 337 // show up to X items in list view
T 338 $rcmail_config['pagesize'] = 40;
339
340 // use this timezone to display date/time
d7d663 341 $rcmail_config['timezone'] = intval(date('O'))/100 - date('I');
4e17e6 342
5349b7 343 // is daylight saving On?
d7d663 344 $rcmail_config['dst_active'] = (bool)date('I');
4647e1 345
4e17e6 346 // prefer displaying HTML messages
T 347 $rcmail_config['prefer_html'] = TRUE;
348
712b30 349 // display images in mail from known senders
A 350 $rcmail_config['addrbook_show_images'] = FALSE;
351
b19097 352 // compose html formatted messages by default
45a470 353 $rcmail_config['htmleditor'] = FALSE;
b19097 354
30233b 355 // show pretty dates as standard
T 356 $rcmail_config['prettydate'] = TRUE;
4e17e6 357
d656f1 358 // save compose message every 300 seconds (5min)
T 359 $rcmail_config['draft_autosave'] = 300;
0566ad 360
b19097 361 // default setting if preview pane is enabled
T 362 $rcmail_config['preview_pane'] = FALSE;
363
eaa394 364 // Clear Trash on logout
A 365 $rcmail_config['logout_purge'] = FALSE;
366
367 // Compact INBOX on logout
368 $rcmail_config['logout_expunge'] = FALSE;
50c753 369
166b61 370 // Display attached images below the message body 
A 371 $rcmail_config['inline_images'] = TRUE;
5e0045 372
4e17e6 373 // end of config file
1966c5 374 ?>