PHP 5.3 deprecated ereg() function (#2820952)
[squirrelmail.git] / config / config_default.php
CommitLineData
59177427 1<?php
716fa276 2
a3439b27 3/**
2d896bbf 4 * Default SquirrelMail configuration file
5 *
a3439b27 6 * BEFORE EDITING THIS FILE!
7 *
8 * Don't edit this file directly. Copy it to config.php before you
9 * edit it. However, it is best to use the configuration script
10 * conf.pl if at all possible. That is the easiest and cleanest way
11 * to configure.
2d896bbf 12 *
223cc0f5 13 * Note on SECURITY: some options require putting a password in this file.
14 * Please make sure that you adapt its permissions appropriately to avoid
15 * passwords being leaked to e.g. other system users. Take extra care when
16 * the webserver is shared with untrusted users.
17 *
d4e46166 18 * @copyright &copy; 2000-2009 The SquirrelMail Project Team
4b4abf93 19 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
20 * @version $Id$
2d896bbf 21 * @package squirrelmail
22 * @subpackage config
a3439b27 23 */
24
25/* Do not change this value. */
26global $config_version;
5be870b5 27$config_version = '1.5.0';
a3439b27 28
f6cfbdac 29/*** Organization preferences ***/
30/**
31 * Organization's name
2d896bbf 32 * @global string $org_name
f6cfbdac 33 */
34$org_name = "SquirrelMail";
b6e0c3b6 35
f6cfbdac 36/**
37 * Organization's logo picture (blank if none)
2d896bbf 38 * @global string $org_logo
f6cfbdac 39 */
40$org_logo = SM_PATH . 'images/sm_logo.png';
b6e0c3b6 41
f6cfbdac 42/**
43 * The width of the logo (0 for default)
2d896bbf 44 * @global string $org_logo_width
f6cfbdac 45 */
46$org_logo_width = '308';
b6e0c3b6 47
f6cfbdac 48/**
49 * The height of the logo (0 for default)
2d896bbf 50 * @global string $org_logo_height
f6cfbdac 51 */
52$org_logo_height = '111';
a3439b27 53
54/**
55 * Webmail Title
2d896bbf 56 *
57 * This is the web page title that appears at the top of the browser window.
58 * @global string $org_title
a3439b27 59 */
8b5c49cd 60$org_title = "SquirrelMail";
f6cfbdac 61
a3439b27 62/**
2d896bbf 63 * Signout page
64 *
f6cfbdac 65 * Rather than going to the signout.php page (which only allows you
66 * to sign back in), setting signout_page allows you to sign the user
67 * out and then redirect to whatever page you want. For instance,
68 * the following would return the user to your home page:
69 * $signout_page = '/';
70 * Set to the empty string to continue to use the default signout page.
2d896bbf 71 * @global string $signout_page
a3439b27 72 */
f6cfbdac 73$signout_page = '';
a3439b27 74
f6cfbdac 75/**
2d896bbf 76 * Top frame
77 *
f6cfbdac 78 * By default SquirrelMail takes up the whole browser window,
79 * this allows you to embed it within sites using frames. Set
80 * this to the frame you want it to stay in.
2d896bbf 81 * @global string $frame_top
f6cfbdac 82 */
83$frame_top = '_top';
a3439b27 84
85/**
2d896bbf 86 * Provider name
87 *
5810acfa 88 * Here you can set the text of the link displayed on the top-right
89 * of the message list.
90 *
91 * Defaults to empty (no link).
f6cfbdac 92 *
2d896bbf 93 * @global string $provider_name
f6cfbdac 94 */
5810acfa 95$provider_name = '';
f6cfbdac 96
2d896bbf 97/**
98 * Provider URI
99 *
5810acfa 100 * Here you can set URL of the link displayed on the top-right of
101 * the message list.
102 *
103 * Defaults to empty (no link).
104 *
2d896bbf 105 * @global string $provider_uri
106 */
8b5c49cd 107$provider_uri = '';
f6cfbdac 108
109/*** Server Settings ***/
110/**
2d896bbf 111 * Default Domain
112 *
a3439b27 113 * The domain part of local email addresses.
114 * This is for all messages sent out from this server.
115 * Reply address is generated by $username@$domain
5d28b77e 116 * Example: In bob@example.com, example.com is the domain.
2d896bbf 117 * @global string $domain
a3439b27 118 */
884eba1e 119$domain = 'example.com';
a3439b27 120
f6cfbdac 121/**
2d896bbf 122 * Time offset inversion
123 *
f6cfbdac 124 * If you are running on a machine that doesn't have the tm_gmtoff
125 * value in your time structure and if you are in a time zone that
126 * has a negative offset, you need to set this value to 1. This is
127 * typically people in the US that are running Solaris 7.
2d896bbf 128 * @global bool $invert_time
f6cfbdac 129 */
130$invert_time = false;
a3439b27 131
132/**
2d896bbf 133 * Default send transport
134 *
f6cfbdac 135 * What should be used when sending email.
136 * If it is set to false, SquirrelMail will use SMTP server settings.
91e0dccc 137 * If it is set to true, SquirrelMail will use program defined in
f6cfbdac 138 * $sendmail_path
2d896bbf 139 * @global bool $useSendmail
a3439b27 140 */
f6cfbdac 141$useSendmail = false;
a3439b27 142
f6cfbdac 143/**
2d896bbf 144 * Your SMTP server (usually the same as the IMAP server).
145 * @global string $smtpServerAddress
f6cfbdac 146 */
147$smtpServerAddress = 'localhost';
2d896bbf 148/**
149 * Your SMTP port number (usually 25).
150 * @global integer $smtpPort
151 */
f6cfbdac 152$smtpPort = 25;
a3439b27 153
154/**
432db2fc 155 * SquirrelMail header encryption
2d896bbf 156 *
432db2fc 157 * Encryption key allows to hide SquirrelMail Received: headers
158 * in outbound messages. Interface uses encryption key to encode
159 * username, remote address and proxied address, then stores encoded
160 * information in X-Squirrel-* headers.
cba7675e 161 *
432db2fc 162 * Warning: used encryption function is not bulletproof. When used
163 * with static encryption keys, it provides only minimal security
164 * measures and information can be decoded quickly.
165 *
166 * Encoded information can be decoded with decrypt_headers.php script
167 * from SquirrelMail contrib/ directory.
168 * @global string $encode_header_key
94511d23 169 * @since 1.5.1 and 1.4.5
cba7675e 170 */
432db2fc 171$encode_header_key = '';
cba7675e 172
173/**
2d896bbf 174 * Path to Sendmail
175 *
f6cfbdac 176 * Program that should be used when sending email. SquirrelMail expects that
91e0dccc 177 * this program will follow options used by original sendmail
fd7ab795 178 * (http://www.sendmail.org). Support of -f argument is required.
2d896bbf 179 * @global string $sendmail_path
a3439b27 180 */
f6cfbdac 181$sendmail_path = '/usr/sbin/sendmail';
91e0dccc 182
f6cfbdac 183/**
fd7ab795 184 * Extra sendmail command arguments.
85bacb8f 185 *
186 * Sets additional sendmail command arguments. Make sure that arguments are
fd7ab795 187 * supported by your sendmail program. -f argument is added automatically by
85bacb8f 188 * SquirrelMail scripts. Variable defaults to standard /usr/sbin/sendmail
fd7ab795 189 * arguments. If you use qmail-inject, nbsmtp or any other sendmail wrapper,
190 * which does not support -t and -i arguments, set variable to empty string
85bacb8f 191 * or use arguments suitable for your mailer.
fd7ab795 192 * @global string $sendmail_args
5e68a08e 193 * @since 1.5.1 and 1.4.8
fd7ab795 194 */
195$sendmail_args = '-i -t';
196
197/**
2d896bbf 198 * IMAP server address
199 *
200 * The dns name (or IP address) for your imap server.
201 * @global string $imapServerAddress
f6cfbdac 202 */
203$imapServerAddress = 'localhost';
2d896bbf 204
205/**
206 * IMAP server port
207 *
208 * Port used by your imap server. (Usually 143)
209 * @global integer $imapPort
210 */
f6cfbdac 211$imapPort = 143;
a3439b27 212
213/**
2d896bbf 214 * IMAP server type
215 *
a3439b27 216 * The type of IMAP server you are running.
217 * Valid type are the following (case is important):
e498ebbd 218 * bincimap
a3439b27 219 * courier
220 * cyrus
e498ebbd 221 * dovecot
a3439b27 222 * exchange
b39825f0 223 * hmailserver
e498ebbd 224 * macosx
f6cfbdac 225 * mercury32
e498ebbd 226 * uw
a3439b27 227 * other
f6cfbdac 228 *
229 * Please note that this changes only some of server settings.
230 *
231 * In order to set everything correctly, you need to adjust several
598294a7 232 * SquirrelMail options. These options are listed in doc/presets.txt
2d896bbf 233 * @global string $imap_server_type
a3439b27 234 */
884eba1e 235$imap_server_type = 'other';
a3439b27 236
237/**
a15f9d93 238 * Secure IMAP connection controls
2d896bbf 239 *
a15f9d93 240 * 0 - use plain text connection,
241 * 1 - use imaps (adds tls:// prefix to hostname),
242 * 2 - use IMAP STARTTLS extension (rfc2595).
243 *
244 * Was boolean before 1.5.1.
245 * @global integer $use_imap_tls
246 * @since 1.4.0
a3439b27 247 */
a15f9d93 248$use_imap_tls = 0;
2d896bbf 249
250/**
a15f9d93 251 * Secure SMTP connection controls
252 *
253 * 0 - use plain text connection,
254 * 1 - use ssmtp (adds tls:// prefix to hostname),
255 * 2 - use SMTP STARTTLS extension (rfc2487).
2d896bbf 256 *
a15f9d93 257 * Was boolean before 1.5.1.
258 * @global integer $use_smtp_tls
259 * @since 1.4.0
2d896bbf 260 */
a15f9d93 261$use_smtp_tls = 0;
a3439b27 262
263/**
2d896bbf 264 * SMTP authentication mechanism
265 *
266 * auth_mech can be either 'none', 'login','plain', 'cram-md5', or 'digest-md5'
267 * @global string $smtp_auth_mech
f6cfbdac 268 */
269$smtp_auth_mech = 'none';
2d896bbf 270
271/**
029d1fc2 272 * Custom SMTP authentication username
273 *
274 * IMAP username is used if variable is set to empty string.
275 * Variable is included in main configuration file only from 1.5.2 version.
276 * Older versions stored it in config_local.php.
277 * @global string $smtp_sitewide_user
278 * @since 1.5.0
279 */
280$smtp_sitewide_user = '';
281
282/**
283 * Custom SMTP authentication password
284 *
285 * IMAP password is used if $smtp_sitewide_user global is set to empty string.
286 * Variable is included in main configuration file only from 1.5.2 version.
287 * Older versions stored it in config_local.php.
288 * @global string $smtp_sitewide_pass
289 * @since 1.5.0
290 */
291$smtp_sitewide_pass = '';
292
293/**
2d896bbf 294 * IMAP authentication mechanism
295 *
296 * auth_mech can be either 'login','plain', 'cram-md5', or 'digest-md5'
297 * @global string $imap_auth_mech
298 */
f6cfbdac 299$imap_auth_mech = 'login';
300
301/**
2d896bbf 302 * IMAP folder delimiter
303 *
f6cfbdac 304 * This is the delimiter that your IMAP server uses to distinguish between
305 * folders. For example, Cyrus uses '.' as the delimiter and a complete
306 * folder would look like 'INBOX.Friends.Bob', while UW uses '/' and would
307 * look like 'INBOX/Friends/Bob'. Normally this should be left at 'detect'
308 * but if you are sure you know what delimiter your server uses, you can
309 * specify it here.
310 *
311 * To have it autodetect the delimiter, set it to 'detect'.
2d896bbf 312 * @global string $optional_delimiter
f6cfbdac 313 */
314$optional_delimiter = 'detect';
315
316/**
2d896bbf 317 * POP before SMTP setting
318 *
f6cfbdac 319 * Do you wish to use POP3 before SMTP? Your server must
320 * support this in order for SquirrelMail to work with it.
2d896bbf 321 * @global bool $pop_before_smtp
f6cfbdac 322 */
323$pop_before_smtp = false;
324
783e926e 325/**
326 * POP before SMTP server address
327 *
328 * When using POP3 before SMTP, if the POP server address is
329 * not the same as the SMTP server address, specify it here.
330 * If this is left empty, the SMTP server address will be
331 * used by default.
332 * @global bool $pop_before_smtp_host
333 */
334$pop_before_smtp_host = '';
335
f6cfbdac 336
337/*** Folder Settings ***/
338/**
2d896bbf 339 * Default IMAP folder prefix
340 *
a3439b27 341 * Many servers store mail in your home directory. With this, they
342 * store them in a subdirectory: mail/ or Mail/, etc. If your server
343 * does this, please set this to what the default mail folder should
344 * be. This is still a user preference, so they can change it if it
345 * is different for each user.
346 *
347 * Example:
348 * $default_folder_prefix = 'mail/';
349 * -- or --
350 * $default_folder_prefix = 'Mail/folders/';
351 *
352 * If you do not use this, set it to the empty string.
2d896bbf 353 * @global string $default_folder_prefix
a3439b27 354 */
a3439b27 355$default_folder_prefix = '';
356
357/**
2d896bbf 358 * User level prefix control
359 *
a3439b27 360 * If you do not wish to give them the option to change this, set it
361 * to false. Otherwise, if it is true, they can change the folder prefix
362 * to be anything.
2d896bbf 363 * @global bool $show_prefix_option
a3439b27 364 */
a3439b27 365$show_prefix_option = false;
366
367/**
368 * The following are related to deleting messages.
f6cfbdac 369 * $default_move_to_trash
370 * If this is set to 'true', when 'delete' is pressed, it
a3439b27 371 * will attempt to move the selected messages to the folder
372 * named $trash_folder. If it's set to 'false', we won't even
373 * attempt to move the messages, just delete them.
f6cfbdac 374 * $default_move_to_sent
375 * If this is set to 'true', sent messages will be stored in
376 * $sent_folder by default.
377 * $default_save_as_draft
378 * If this is set to 'true', users are able to use $draft_folder
379 * to store their unfinished messages.
a3439b27 380 * $trash_folder
381 * This is the path to the default trash folder. For Cyrus
382 * IMAP, it would be 'INBOX.Trash', but for UW it would be
383 * 'Trash'. We need the full path name here.
f6cfbdac 384 * $draft_folder
385 * This is the patch to where Draft messages will be stored.
a3439b27 386 * $auto_expunge
387 * If this is true, when a message is moved or copied, the
388 * source mailbox will get expunged, removing all messages
389 * marked 'Deleted'.
390 * $sent_folder
391 * This is the path to where Sent messages will be stored.
4e85a37f 392 * $delete_folder
393 * If this is true, when a folder is deleted then it will
394 * not get moved into the Trash folder.
2d896bbf 395 * @global bool $default_move_to_trash
396 * @global bool $default_move_to_sent
397 * @global bool $default_save_as_draft
398 * @global string $trash_folder
399 * @global string $sent_folder
400 * @global string $draft_folder
401 * @global bool $auto_expunge
402 * @global bool $delete_folder
a3439b27 403 */
a3439b27 404$default_move_to_trash = true;
405$default_move_to_sent = true;
406$default_save_as_draft = true;
407$trash_folder = 'INBOX.Trash';
408$sent_folder = 'INBOX.Sent';
409$draft_folder = 'INBOX.Drafts';
410$auto_expunge = true;
4e85a37f 411$delete_folder = false;
a3439b27 412
413/**
2d896bbf 414 * Special Folder Color Control
415 *
f6cfbdac 416 * Whether or not to use a special color for special folders. If not,
417 * special folders will be the same color as the other folders.
2d896bbf 418 * @global bool $use_special_folder_color
f6cfbdac 419 */
420$use_special_folder_color = true;
421
422/**
2d896bbf 423 * Create Special Folders Control
424 *
a3439b27 425 * Should I create the Sent and Trash folders automatically for
426 * a new user that doesn't already have them created?
2d896bbf 427 * @global bool $auto_create_special
a3439b27 428 */
a3439b27 429$auto_create_special = true;
430
2d896bbf 431/**
432 * List Special Folders First Control
433 *
434 * Whether or not to list the special folders first (true/false).
91e0dccc 435 * @global bool $list_special_folders_first
2d896bbf 436 */
a3439b27 437$list_special_folders_first = true;
438
439/**
2d896bbf 440 * Subfolder Layout Control
441 *
a3439b27 442 * Are all your folders subfolders of INBOX (i.e. cyrus IMAP server).
443 * If you are unsure, set it to false.
2d896bbf 444 * @global bool $default_sub_of_inbox
a3439b27 445 */
a3439b27 446$default_sub_of_inbox = true;
447
448/**
2d896bbf 449 * Subfolder Format Control
450 *
a3439b27 451 * Some IMAP daemons (UW) handle folders weird. They only allow a
452 * folder to contain either messages or other folders, not both at
453 * the same time. This option controls whether or not to display an
454 * option during folder creation. The option toggles which type of
455 * folder it should be.
456 *
91e0dccc 457 * If this option confuses you, just set it to 'true'. You can not hurt
a3439b27 458 * anything if it's true, but some servers will respond weird if it's
459 * false. (Cyrus works fine whether it's true OR false).
2d896bbf 460 * @global bool $show_contain_subfolders_option
a3439b27 461 */
a3439b27 462$show_contain_subfolders_option = false;
463
464/**
f6cfbdac 465 * These next two options set the defaults for the way that the
466 * users see their folder list.
467 * $default_unseen_notify
91e0dccc 468 * Specifies whether or not the users will see the number of
f6cfbdac 469 * unseen in each folder by default and also which folders to
470 * do this to. Valid values are: 1=none, 2=inbox, 3=all.
471 * $default_unseen_type
472 * Specifies the type of notification to give the users by
473 * default. Valid choice are: 1=(4), 2=(4,25).
2d896bbf 474 * @global integer $default_unseen_notify
475 * @global integer $default_unseen_type
a3439b27 476 */
f6cfbdac 477$default_unseen_notify = 2;
478$default_unseen_type = 1;
a3439b27 479
480/**
2d896bbf 481 * NoSelect Fix Control
482 *
f6cfbdac 483 * This enables the no select fix for Cyrus when subfolders
484 * exist but parent folders do not
2d896bbf 485 * @global bool $noselect_fix_enable
f6cfbdac 486 */
487$noselect_fix_enable = false;
488
489/*** General options ***/
490/**
a3439b27 491 * Path to the data/ directory
2d896bbf 492 *
368ab966 493 * You need to create this directory yourself (see INSTALL).
494 *
a3439b27 495 * It is a possible security hole to have a writable directory
496 * under the web server's root directory (ex: /home/httpd/html).
368ab966 497 * The path name can be absolute or relative (to the config directory).
ff6d5db0 498 * If path is relative, it must use SM_PATH constant.
368ab966 499 * Here are two examples:
a3439b27 500 *
501 * Absolute:
368ab966 502 * $data_dir = '/var/local/squirrelmail/data/';
a3439b27 503 *
f6cfbdac 504 * Relative (to main SM directory):
884eba1e 505 * $data_dir = SM_PATH . 'data/';
368ab966 506 * (NOT recommended: you need to secure apache to make sure these
507 * files are not world readable)
508 *
2d896bbf 509 * @global string $data_dir
a3439b27 510 */
aabfe164 511$data_dir = '/var/local/squirrelmail/data/';
a3439b27 512
513/**
2d896bbf 514 * Attachments directory
515 *
a3439b27 516 * Path to directory used for storing attachments while a mail is
517 * being sent. There are a few security considerations regarding
518 * this directory:
519 * + It should have the permission 733 (rwx-wx-wx) to make it
520 * impossible for a random person with access to the webserver to
521 * list files in this directory. Confidential data might be laying
522 * around there.
523 * + Since the webserver is not able to list the files in the content
368ab966 524 * is also impossible for the webserver to delete files lying around
525 * there for too long. You should have some script that deletes
526 * left over temp files.
a3439b27 527 * + It should probably be another directory than data_dir.
2d896bbf 528 * @global string $attachment_dir
a3439b27 529 */
aabfe164 530$attachment_dir = '/var/local/squirrelmail/attach/';
a3439b27 531
f6cfbdac 532/**
533 * Hash level used for data directory.
91e0dccc 534 *
598294a7 535 * This option allows spliting file based SquirrelMail user
f6cfbdac 536 * data storage directory into several subfolders. Number from
537 * 0 to 4 allows allows having up to four subfolder levels.
538 *
91e0dccc 539 * Hashing should speed up directory access if you have big number
f6cfbdac 540 * of users (500 and more).
2d896bbf 541 * @global integer $dir_hash_level
f6cfbdac 542 */
a3439b27 543$dir_hash_level = 0;
544
545/**
2d896bbf 546 * Default Size of Folder List
547 *
a3439b27 548 * This is the default size of the folder list. Default
549 * is 150, but you can set it to whatever you wish.
2d896bbf 550 * @global string $default_left_size
a3439b27 551 */
f6cfbdac 552$default_left_size = '150';
a3439b27 553
554/**
2d896bbf 555 * Username Case Control
556 *
a3439b27 557 * Some IMAP servers allow a username (like 'bob') to log in if they use
558 * uppercase in their name (like 'Bob' or 'BOB'). This creates extra
559 * preference files. Toggling this option to true will transparently
560 * change all usernames to lowercase.
2d896bbf 561 * @global bool $force_username_lowercase
a3439b27 562 */
a3439b27 563$force_username_lowercase = false;
564
565/**
2d896bbf 566 * Email Priority Control
567 *
f6cfbdac 568 * This option enables use of email priority flags by end users.
2d896bbf 569 * @global bool $default_use_priority
f6cfbdac 570 */
571$default_use_priority = true;
572
573/**
2d896bbf 574 * SquirrelMail Attributions Control
575 *
598294a7 576 * This option disables display of "created by SquirrelMail developers"
5810acfa 577 * strings and links.
2d896bbf 578 * @global bool $hide_sm_attributions
beebd508 579 * @since 1.2.0
f6cfbdac 580 */
581$hide_sm_attributions = false;
582
583/**
2d896bbf 584 * Delivery Receipts Control
585 *
586 * This option enables use of read/delivery receipts by end users.
587 * @global bool $default_use_mdn
f6cfbdac 588 */
589$default_use_mdn = true;
590
591/**
2d896bbf 592 * Identity Controls
593 *
f6cfbdac 594 * If you don't want to allow users to change their email address
595 * then you can set $edit_identity to false, if you want them to
596 * not be able to change their full name too then set $edit_name
597 * to false as well. $edit_name has no effect unless $edit_identity
598 * is false;
2d896bbf 599 * @global bool $edit_identity
600 * @global bool $edit_name
f6cfbdac 601 */
602$edit_identity = true;
603$edit_name = true;
604
605/**
432db2fc 606 * SquirrelMail adds username information to every sent email.
85bacb8f 607 * It is done in order to prevent possible sender forging when
608 * end users are allowed to change their email and name
432db2fc 609 * information.
610 *
611 * You can disable this header, if you think that it violates
612 * user's privacy or security. Please note, that setting will
613 * work only when users are not allowed to change their identity.
614 *
615 * See SquirrelMail bug tracker #847107 for more details about it.
616 * @global bool $hide_auth_header
94511d23 617 * @since 1.5.1 and 1.4.5
432db2fc 618 */
619$hide_auth_header = false;
620
621/**
2d896bbf 622 * Server Side Threading Control
623 *
e7650b35 624 * Set it to true, if you want to disable server side thread
625 * sorting options. Your IMAP server must support the THREAD
626 * extension for this to have any effect.
627 *
628 * Older SquirrelMail versions used $allow_thread_sort option.
11e00010 629 * @global bool $disable_thread_sort
e7650b35 630 * @since 1.5.1
f6cfbdac 631 */
11e00010 632$disable_thread_sort = false;
f6cfbdac 633
2d896bbf 634/**
635 * Server Side Sorting Control
636 *
e7650b35 637 * Set it to true, if you want to disable server side sorting
638 * and use SM client side sorting instead (client side sorting
639 * can be slow). Your IMAP server must support the SORT extension
640 * for this to have any effect.
641 *
642 * Older SquirrelMail versions used $allow_server_sort option.
643 * @global bool $disable_server_sort
644 * @since 1.5.1
f6cfbdac 645 */
11e00010 646$disable_server_sort = false;
f6cfbdac 647
648/**
2d896bbf 649 * IMAP Charset Use Control
650 *
f6cfbdac 651 * This option allows you to choose if SM uses charset search
91e0dccc 652 * Your imap server should support SEARCH CHARSET command for
f6cfbdac 653 * this to work.
2d896bbf 654 * @global bool $allow_charset_search
f6cfbdac 655 */
656$allow_charset_search = true;
657
658/**
fdefb2e7 659 * Search functions control
660 *
661 * This option allows you to control the use of advanced search form.
662 * Set to 0 to enable basic search only, 1 to enable advanced search only
663 * or 2 to enable both.
664 * @global integer $allow_advanced_search
665 */
666$allow_advanced_search = 0;
667
668/**
2d896bbf 669 * PHP session name.
670 *
671 * Leave this alone unless you know what you are doing.
672 * @global string $session_name
f6cfbdac 673 */
674$session_name = 'SQMSESSID';
675
676
677/**
82351c82 678 * User Themes
83139c0b 679 * You can define your own theme and put it in directory in SM_PATH/css/.
a3439b27 680 * You must call it as the example below. You can name the theme
83139c0b 681 * whatever you want.
a3439b27 682 *
683 * To add a new theme to the options that users can choose from, just
684 * add a new number to the array at the bottom, and follow the pattern.
91e0dccc 685 *
82351c82 686 * $user_theme_default sets theme that will be used by default
83139c0b 687 *
82351c82 688 * @global integer $user_theme_default
83139c0b 689 * @since 1.5.2
a3439b27 690 */
82351c82 691$user_theme_default = 0;
a3439b27 692
2d896bbf 693/**
694 * Listing of installed themes
82351c82 695 * @global array $user_themes
83139c0b 696 * @since 1.5.2
2d896bbf 697 */
82351c82 698$user_themes[0]['PATH'] = 'none';
699$user_themes[0]['NAME'] = 'Default';
48adf5d6 700
5425b547 701$user_themes[1]['PATH'] = '../css/blue_gradient/';
702$user_themes[1]['NAME'] = 'Blue Options';
83139c0b 703
704/**
705 * Message Icons control
706 *
707 * Use icons for message and folder markers
708 * @global bool $use_icons
709 * @since 1.5.1
710 */
5425b547 711$use_icons = true;
83139c0b 712
713/**
714 * Icon Themes
715 * You can create your own icon themes and put them in a directory in
716 * SM_PATH/images/themes/. Your users will be able to choose whatever
717 * icon themes are listed below.
718 *
719 * To add a new theme to the list of available icon themes, just add a new
720 * number to the array below and follow the pattern
721 *
722 * $icon_theme_default sets the theme that will be used by default.
341fd984 723 * $icon_theme_fallback specifies which theme will be used if an icon is
724 * not found in the selected theme
83139c0b 725 *
726 * @global integer $icon_theme_def
341fd984 727 * @global integer $icon_theme_fallback
83139c0b 728 * @since 1.5.2
729 */
341fd984 730$icon_theme_def = 1;
731$icon_theme_fallback = 3;
83139c0b 732
733/**
734 * Listing of installed icon themes
ede2374a 735 * @global array $icon_themes
83139c0b 736 * @since 1.5.2
737 */
738$icon_themes[0]['PATH'] = 'none';
739$icon_themes[0]['NAME'] = 'No Icons';
740
741$icon_themes[1]['PATH'] = 'template';
742$icon_themes[1]['NAME'] = 'Template Default Icons';
743
744$icon_themes[2]['PATH'] = '../images/themes/default/';
745$icon_themes[2]['NAME'] = 'Default Icon Set';
746
747$icon_themes[3]['PATH'] = '../images/themes/xp/';
748$icon_themes[3]['NAME'] = 'XP Style Icons';
749
a3439b27 750/**
85bacb8f 751 * Templates
293906dd 752 * You can define your own template set (skin) and put it in a new
753 * directory under SM_PATH/templates. The ID must match the name of
5e78e498 754 * the template directory as the example below. You can name the
755 * template whatever you want. For an example of a template, see
756 * the ones included in the SM_PATH/templates directory.
85bacb8f 757 *
758 * To add a new template to the options that users can choose from, just
759 * add a new number to the array at the bottom, and follow the pattern.
760 *
293906dd 761 * $templateset_default sets the skin that will be used by default
762 * when a user doesn't have a skin selection
763 * in their preferences. (Must be the "ID" of
764 * the desired template set)
5e78e498 765 *
293906dd 766 * $templateset_fallback tells SquirrelMail which template set (skin)
767 * to use when looking for a file that is not
768 * contained within whatever skin is currently
769 * being used. (Must be the "ID" of the desired
770 * template set)
771 *
d81572f7 772 * $rpc_templateset sets the skin that will be used by default
773 * when a user is making an RPC request. This
774 * does not usually need to be changed, but
775 * can be used to change the RPC protocol that
776 * is used to respond to RPC requets. (Must be
777 * the "ID" of the desired template set and
778 * should NOT be a template set that is included
779 * in the $aTemplateSet list; PLEASE NOTE that
780 * new RPC template sets should always be named
781 * "<skin name>_rpc", as SquirrelMail will assume
782 * any template sets ending in "_rpc" are intended
783 * for its RPC interface only)
784 *
293906dd 785 * @global string $templateset_default
786 * @global string $templateset_fallback
d81572f7 787 * @global string $rpc_templateset
85bacb8f 788 */
293906dd 789$templateset_default = 'default';
790$templateset_fallback = 'default';
d81572f7 791$rpc_templateset = 'default_rpc';
85bacb8f 792
5e78e498 793$aTemplateSet[0]['ID'] = 'default';
794$aTemplateSet[0]['NAME'] = 'Default';
795$aTemplateSet[1]['ID'] = 'default_advanced';
796$aTemplateSet[1]['NAME'] = 'Advanced';
85bacb8f 797
798/**
81132de8 799 * Default interface font size.
800 * @global string $default_fontsize
801 * @since 1.5.1
802 */
803$default_fontsize = '';
804
805/**
806 * Default font set
807 * @global string $default_fontset
808 * @since 1.5.1
809 */
810$default_fontset = '';
811
812/**
813 * List of available fontsets.
814 * @global array $fontsets
815 * @since 1.5.1
816 */
817$fontsets = array();
818$fontsets['serif'] = 'serif';
819$fontsets['sans'] = 'helvetica,arial,sans-serif';
820$fontsets['comicsans'] = 'comic sans ms,sans-serif';
821$fontsets['verasans'] = 'bitstream vera sans,verdana,sans-serif';
822$fontsets['tahoma'] = 'tahoma,sans-serif';
823
824/**
a3439b27 825 * LDAP server(s)
826 * Array of arrays with LDAP server parameters. See
827 * functions/abook_ldap_server.php for a list of possible
828 * parameters
829 *
830 * EXAMPLE:
831 * $ldap_server[0] = Array(
832 * 'host' => 'memberdir.netscape.com',
833 * 'name' => 'Netcenter Member Directory',
834 * 'base' => 'ou=member_directory,o=netcenter.com'
91e0dccc 835 * );
223cc0f5 836 *
837 * NOTE: please see security note at the top of this file when
838 * entering a password.
a3439b27 839 */
f6cfbdac 840// Add your ldap server options here
3499f99f 841
a3439b27 842/**
2d896bbf 843 * Javascript in Addressbook Control
844 *
a3439b27 845 * Users may search their addressbook via either a plain HTML or Javascript
846 * enhanced user interface. This option allows you to set the default choice.
847 * Set this default choice as either:
848 * true = javascript
849 * false = html
2d896bbf 850 * @global bool $default_use_javascript_addr_book
a3439b27 851 */
a3439b27 852$default_use_javascript_addr_book = false;
853
4272758c 854/**
855 * Shared filebased address book
856 * @global string $abook_global_file
71d3f882 857 * @since 1.5.1 and 1.4.4
4272758c 858 */
859$abook_global_file = '';
860
861/**
862 * Writing into shared address book control
863 * @global bool $abook_global_file_writeable
71d3f882 864 * @since 1.5.1 and 1.4.4
4272758c 865 */
866$abook_global_file_writeable = false;
a3439b27 867
80e86e94 868/**
71d3f882 869 * Listing of shared address book control
870 * @global bool $abook_global_file_listing
871 * @since 1.5.1
872 */
873$abook_global_file_listing = true;
874
875/**
7311c377 876 * Controls file based address book entry size
877 *
878 * This setting controls space allocated to file based address book records.
879 * End users will be unable to save address book entry, if total entry size
880 * (quoted address book fields + 4 delimiters + linefeed) exceeds allowed
881 * address book length size.
882 *
883 * Same setting is applied to personal and global file based address books.
884 *
885 * It is strongly recommended to keep default setting value. Change it only
886 * if you really want to store address book entries that are bigger than two
887 * kilobytes (2048).
888 * @global integer $abook_file_line_length
889 * @since 1.5.2
890 */
891$abook_file_line_length = 2048;
892
893/**
f6cfbdac 894 * MOTD
2d896bbf 895 *
91e0dccc 896 * This is a message that is displayed immediately after a user logs in.
2d896bbf 897 * @global string $motd
80e86e94 898 */
f6cfbdac 899$motd = "";
80e86e94 900
80e86e94 901
a3439b27 902/**
903 * To install plugins, just add elements to this array that have
904 * the plugin directory name relative to the /plugins/ directory.
521d86d6 905 * For instance, for the 'squirrelspell' plugin, you'd put a line like
a3439b27 906 * the following.
521d86d6 907 * $plugins[] = 'squirrelspell';
908 * $plugins[] = 'listcommands';
a3439b27 909 */
f6cfbdac 910// Add list of enabled plugins here
a3439b27 911
f6cfbdac 912
93d67e0d 913/**
914 * To disable all plugins regardless of any that are installed
915 * above, turn on $disable_plugins. To disable them ONLY for
916 * one user, put that username into $disable_plugins_user.
917 * @global boolean $disable_plugins
918 * @global string $disable_plugins_user
919 * @since 1.5.2
920 */
921$disable_plugins = false;
922$disable_plugins_user = '';
923
924
f6cfbdac 925/*** Database ***/
a3439b27 926/**
6f4c512c 927 * Read the administrator's manual in order to get more information
f6cfbdac 928 * about these settings.
8a7d0669 929 */
f6cfbdac 930/**
931 * Database-driven private addressbooks
932 * DSN (Data Source Name) for a database where the private
6f4c512c 933 * addressbooks are stored. See the administrator's manual for more info.
f6cfbdac 934 * If it is not set, the addressbooks are stored in files
935 * in the data dir.
936 * The DSN is in the format: mysql://user:pass@hostname/dbname
937 * The table is the name of the table to use within the
938 * specified database.
223cc0f5 939 *
940 * NOTE: please see security note at the top of this file when
941 * entering a password.
f6cfbdac 942 */
943$addrbook_dsn = '';
944$addrbook_table = 'address';
945/**
946 * Database used to store user data
947 */
948$prefs_dsn = '';
949$prefs_table = 'userprefs';
06316c07 950/**
85bacb8f 951 * Preference key field
06316c07 952 * @global string $prefs_key_field
953 */
f6cfbdac 954$prefs_key_field = 'prefkey';
06316c07 955/**
956 * Size of preference key field
957 * @global integer $prefs_key_size
958 * @since 1.5.1
959 */
960$prefs_key_size = 64;
961/**
85bacb8f 962 * Preference owner field
06316c07 963 * @global string $prefs_user_field
964 */
f6cfbdac 965$prefs_user_field = 'user';
06316c07 966/**
967 * Size of preference owner field
968 * @global integer $prefs_user_size
969 * @since 1.5.1
970 */
971$prefs_user_size = 128;
972/**
85bacb8f 973 * Preference value field
06316c07 974 * @global string $prefs_val_field
975 */
f6cfbdac 976$prefs_val_field = 'prefval';
06316c07 977/**
978 * Size of preference key field
979 * @global integer $prefs_val_size
980 * @since 1.5.1
981 */
982$prefs_val_size = 65536;
71d3f882 983
984/*** Global sql database options ***/
30e9932c 985/**
71d3f882 986 * DSN of global address book database
987 * @global string $addrbook_global_dsn
f0a4a973 988 * @since 1.5.1 and 1.4.4
30e9932c 989 */
990$addrbook_global_dsn = '';
71d3f882 991/**
992 * Table used for global database address book
993 * @global string $addrbook_global_table
f0a4a973 994 * @since 1.5.1 and 1.4.4
71d3f882 995 */
30e9932c 996$addrbook_global_table = 'global_abook';
71d3f882 997/**
998 * Control writing into global database address book
999 * @global boolean $addrbook_global_writeable
f0a4a973 1000 * @since 1.5.1 and 1.4.4
71d3f882 1001 */
30e9932c 1002$addrbook_global_writeable = false;
71d3f882 1003/**
1004 * Control listing of global database address book
1005 * @global boolean $addrbook_global_listing
f0a4a973 1006 * @since 1.5.1 and 1.4.4
71d3f882 1007 */
30e9932c 1008$addrbook_global_listing = false;
7c612fdd 1009
f6cfbdac 1010/*** Language settings ***/
7c612fdd 1011/**
f6cfbdac 1012 * Default language
2d896bbf 1013 *
f6cfbdac 1014 * This is the default language. It is used as a last resort
1015 * if SquirrelMail can't figure out which language to display.
91e0dccc 1016 * Language names usually consist of language code, undercore
f6cfbdac 1017 * symbol and country code
2d896bbf 1018 * @global string $squirrelmail_default_language
aa0da530 1019 */
f6cfbdac 1020$squirrelmail_default_language = 'en_US';
7c612fdd 1021
f6cfbdac 1022/**
2d896bbf 1023 * Default Charset
1024 *
fe48c808 1025 * This option controls what character set is used when sending
1026 * mail and when sending HTML to the browser. Option works only
1027 * with US English (en_US) translation. Other translations use
867fed37 1028 * charsets that are set in translation settings.
fe48c808 1029 *
2d896bbf 1030 * @global string $default_charset
f6cfbdac 1031 */
1032$default_charset = 'iso-8859-1';
7c612fdd 1033
f6cfbdac 1034/**
2d896bbf 1035 * Alternative Language Names Control
1036 *
91e0dccc 1037 * This options allows displaying native language names in language
f6cfbdac 1038 * selection box.
2d896bbf 1039 * @global bool $show_alternative_names
f03f6ee7 1040 * @since 1.5.0
f6cfbdac 1041 */
1042$show_alternative_names = false;
aa0da530 1043
8a7d0669 1044/**
f03f6ee7 1045 * Aggressive Decoding Control
2d896bbf 1046 *
91e0dccc 1047 * This option enables reading of Eastern multibyte encodings.
f6cfbdac 1048 * Functions that provide this support are very cpu and memory intensive.
1049 * Don't enable this option unless you really need it.
f03f6ee7 1050 * @global bool $aggressive_decoding
1051 * @since 1.5.1
ca85aabe 1052 */
f03f6ee7 1053$aggressive_decoding = false;
1054
1055/**
6d3689f5 1056 * Lossy Encoding Control
f03f6ee7 1057 *
91e0dccc 1058 * This option allows charset conversions when output charset does not support
1059 * all symbols used in original charset. Symbols unsupported by output charset
f03f6ee7 1060 * will be replaced with question marks.
6d3689f5 1061 * @global bool $lossy_encoding
f03f6ee7 1062 * @since 1.5.1
1063 */
6d3689f5 1064$lossy_encoding = false;
ca85aabe 1065
4766fd60 1066/**
1067 * Controls use of time zone libraries
1068 *
1069 * Possible values:
1070 * <ul>
1071 * <li>0 - default, SquirrelMail uses GNU C timezone names in
1072 * TZ environment variables
1073 * <li>1 - strict, SquirrelMail uses 'TZ' subkey values in TZ
1074 * environment variables
1075 * <li>2 - custom, SquirrelMail loads time zone data from
1076 * config/timezones.php and uses time zone array keys in
1077 * TZ enviroment variables
1078 * <li>3 - custom strict, SquirrelMail loads time zone data from
1079 * config/timezones.php and uses TZ subkey values in
1080 * TZ enviroment variables
1081 * </ul>
1082 * Use of any other value switches to default SquirrelMail time zone
1083 * handling ($time_zone_type).
1084 * @global integer $time_zone_type
1085 * @since 1.5.1
1086 */
1087$time_zone_type = 0;
1088
74530cf4 1089/**
1090 * Location base
1091 *
1092 * This is used to build the URL to the SquirrelMail location.
1093 * It should contain only the protocol and hostname/port parts
1094 * of the URL; the full path will be appended automatically.
1095 *
1096 * If not specified or empty, it will be autodetected.
1097 *
1098 * Examples:
1099 * http://webmail.example.org
1100 * http://webmail.example.com:8080
1101 * https://webmail.example.com:6691
1102 *
1103 * To be clear: do not include any of the path elements, so if
1104 * SquirrelMail is at http://www.example.net/web/mail/src/login.php, you
1105 * write: http://www.example.net
1106 *
05a7e5b4 1107 * @global string $config_location_base
1108 * @since 1.5.2 and 1.4.8
74530cf4 1109 */
1110$config_location_base = '';
1111
f6cfbdac 1112/*** Tweaks ***/
1113/**
74d6a0d9 1114 * Iframe sandbox code control
1115 *
1116 * Use iframe to render html emails
1117 * (temp option used during debuging of new code)
1118 * @global bool $use_iframe
1119 * @since 1.5.1
1120 */
1121$use_iframe = false;
1122
1123/**
2d896bbf 1124 * PHP recode functions control
1125 *
f6cfbdac 1126 * Use experimental code with php recode functions when reading messages with
1127 * different encoding. This code is faster that original SM functions,
1128 * but it require php with recode support.
91e0dccc 1129 *
1130 * Don't enable this option if you are not sure about availability of
f6cfbdac 1131 * recode support.
2d896bbf 1132 * @global bool $use_php_recode
f03f6ee7 1133 * @since 1.5.0
f6cfbdac 1134 */
1135$use_php_recode = false;
f03f6ee7 1136
f6cfbdac 1137/**
2d896bbf 1138 * PHP iconv functions control
1139 *
f6cfbdac 1140 * Use experimental code with php iconv functions when reading messages with
1141 * different encoding. This code is faster that original SM functions,
1142 * but it require php with iconv support and works only with some translations.
91e0dccc 1143 *
1144 * Don't enable this option if you are not sure about availability of
f6cfbdac 1145 * iconv support.
2d896bbf 1146 * @global bool $use_php_iconv
f03f6ee7 1147 * @since 1.5.0
f6cfbdac 1148 */
1149$use_php_iconv = false;
ca85aabe 1150
1151/**
775a1f52 1152 * Output Buffering
1153 *
1154 * In some cases, buffering all output allows more complex functionality,
1155 * especially for plugins that want to add headers on hooks that are beyond
1156 * the point of output having been sent to the browser otherwise (although
1157 * most plugins that need this feature will turn it on automatically by
1158 * themselves).
1159 *
1160 * It is also possible to define a custom output handler as needed by special
1161 * environments. If $buffered_output_handler is non-empty, a function named
1162 * the same as the value of $buffered_output_handler should be defined in
1163 * config_local.php.
1164 *
1165 */
1166$buffer_output = false;
1167$buffered_output_handler = '';
1168
1169/**
8f557b94 1170 * Allow Remote configtest Access
1171 *
71d3f882 1172 * Controls remote configuration checks
1173 * @global boolean $allow_remote_configtest
1174 * @since 1.5.1
1175 */
1176$allow_remote_configtest = false;
1177
1178/**
8f557b94 1179 * SquirrelMail Debug Mode
1180 *
1181 * Various debugging levels can be enabled using this setting.
1182 * More than one mode can be used at once by combining them
1183 * with pipes ("|"). See the SM_DEBUG_MODE_* constants in
1184 * include/constants.php
1185 */
1186$sm_debug_mode = SM_DEBUG_MODE_OFF;
1187
1188/**
1189 * "Secured Configuration" Mode
1190 *
1191 * Enable/disable "Secured Configuration" mode, wherein certain
1192 * security-sensitive configuration settings are made immutable
1193 * by other code.
1194 */
1195$secured_config = true;
1196
1197/**
1198 * HTTPS Port
1199 *
1200 * This is the HTTPS (SSL-secured HTTP) port. It can be left empty,
1201 * in which case SquirrelMail will assume the standard port 443.
1202 * Make sure to set this correctly when serving HTTPS on a non-
1203 * standard port.
1204 */
1205$sq_https_port = 443;
1206
1207/**
1208 * Ignore HTTP_X_FORWARDED_* headers?
1209 *
1210 * Whether or not HTTP_X_FORWARDED_* headers are respected by
1211 * SquirrelMail (or plugins).
1212 */
1213$sq_ignore_http_x_forwarded_headers = true;
1214
1215/**
2d896bbf 1216 * Subscribe Listing Control
1217 *
52ed2f88 1218 * this disables listing all of the folders on the IMAP Server to
1219 * generate the folder subscribe listbox (this can take a long time
1220 * when you have a lot of folders). Instead, a textbox will be
f6cfbdac 1221 * displayed allowing users to enter a specific folder name to subscribe to
91e0dccc 1222 *
f6cfbdac 1223 * This option can't be changed by conf.pl
2d896bbf 1224 * @global bool $no_list_for_subscribe
f6cfbdac 1225 */
52ed2f88 1226$no_list_for_subscribe = false;
1227
1228/**
2d896bbf 1229 * Color in config control
1230 *
f6cfbdac 1231 * This option is used only by conf.pl script to generate configuration
91e0dccc 1232 * menu with some colors and is provided here only as reference.
2d896bbf 1233 * @global integer $config_use_color
47a29326 1234 */
f6cfbdac 1235$config_use_color = 2;
209e24bb 1236
1237/**
1238 * Ask User for Personal Information on login
1239 *
1240 * When a user logs in that doesn't have an email address configured,
1241 * redirect him/her to the options page with a request to fill in their
1242 * personal information.
1243 *
1244 * @global bool $ask_user_info
1245 */
1246$ask_user_info = true;
1247