4 * Default SquirrelMail configuration file
6 * BEFORE EDITING THIS FILE!
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
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.
18 * @copyright 2000-2022 The SquirrelMail Project Team
19 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
21 * @package squirrelmail
25 /* Do not change this value. */
26 global $config_version;
27 $config_version = '1.5.0';
29 /*** Organization preferences ***/
32 * @global string $org_name
34 $org_name = "SquirrelMail";
37 * Organization's logo picture (blank if none)
38 * @global string $org_logo
40 $org_logo = SM_PATH
. 'images/sm_logo.png';
43 * The width of the logo (0 for default)
44 * @global string $org_logo_width
46 $org_logo_width = '308';
49 * The height of the logo (0 for default)
50 * @global string $org_logo_height
52 $org_logo_height = '111';
57 * This is the web page title that appears at the top of the browser window.
58 * @global string $org_title
60 $org_title = "SquirrelMail";
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.
71 * @global string $signout_page
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.
81 * @global string $frame_top
88 * Here you can set the text of the link displayed on the top-right
89 * of the message list.
91 * Defaults to empty (no link).
93 * @global string $provider_name
100 * Here you can set URL of the link displayed on the top-right of
103 * Defaults to empty (no link).
105 * @global string $provider_uri
109 /*** Server Settings ***/
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
116 * Example: In bob@example.com, example.com is the domain.
117 * @global string $domain
119 $domain = 'example.com';
122 * Time offset inversion
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.
128 * @global bool $invert_time
130 $invert_time = false;
133 * Default send transport
135 * What should be used when sending email.
136 * If it is set to false, SquirrelMail will use SMTP server settings.
137 * If it is set to true, SquirrelMail will use program defined in
139 * @global bool $useSendmail
141 $useSendmail = false;
144 * Your SMTP server (usually the same as the IMAP server).
145 * @global string $smtpServerAddress
147 $smtpServerAddress = 'localhost';
149 * Your SMTP port number (usually 25).
150 * @global integer $smtpPort
155 * SquirrelMail header encryption
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.
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.
166 * Encoded information can be decoded with decrypt_headers.php script
167 * from SquirrelMail contrib/ directory.
168 * @global string $encode_header_key
169 * @since 1.5.1 and 1.4.5
171 $encode_header_key = '';
176 * Program that should be used when sending email. SquirrelMail expects that
177 * this program will follow options used by original sendmail
178 * (http://www.sendmail.org). Support of -f argument is required.
179 * @global string $sendmail_path
181 $sendmail_path = '/usr/sbin/sendmail';
184 * Extra sendmail command arguments.
186 * Sets additional sendmail command arguments. Make sure that arguments are
187 * supported by your sendmail program. -f argument is added automatically by
188 * SquirrelMail scripts. Variable defaults to standard /usr/sbin/sendmail
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
191 * or use arguments suitable for your mailer.
192 * @global string $sendmail_args
193 * @since 1.5.1 and 1.4.8
195 $sendmail_args = '-i -t';
198 * IMAP server address
200 * The dns name (or IP address) for your imap server.
201 * @global string $imapServerAddress
203 $imapServerAddress = 'localhost';
208 * Port used by your imap server. (Usually 143)
209 * @global integer $imapPort
216 * The type of IMAP server you are running.
217 * Valid type are the following (case is important):
229 * Please note that this changes only some of server settings.
231 * In order to set everything correctly, you need to adjust several
232 * SquirrelMail options. These options are listed in doc/presets.txt
233 * @global string $imap_server_type
235 $imap_server_type = 'other';
238 * Secure IMAP connection controls
240 * 0 - use plain text connection,
241 * 1 - use imaps (adds tls:// prefix to hostname),
242 * 2 - use IMAP STARTTLS extension (rfc2595).
244 * Was boolean before 1.5.1.
245 * @global integer $use_imap_tls
251 * Secure SMTP connection controls
253 * 0 - use plain text connection,
254 * 1 - use ssmtp (adds tls:// prefix to hostname),
255 * 2 - use SMTP STARTTLS extension (rfc2487).
257 * Was boolean before 1.5.1.
258 * @global integer $use_smtp_tls
264 * SMTP authentication mechanism
266 * auth_mech can be either 'none', 'login','plain', 'cram-md5', or 'digest-md5'
267 * @global string $smtp_auth_mech
269 $smtp_auth_mech = 'none';
272 * Custom SMTP authentication username
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
280 $smtp_sitewide_user = '';
283 * Custom SMTP authentication password
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
291 $smtp_sitewide_pass = '';
294 * IMAP authentication mechanism
296 * auth_mech can be either 'login','plain', 'cram-md5', or 'digest-md5'
297 * @global string $imap_auth_mech
299 $imap_auth_mech = 'login';
302 * Show login error from the IMAP server (true) or show
303 * the traditional/generic "Unknown user or password
304 * incorrect" (false)?
306 * @global boolean $display_imap_login_error
308 $display_imap_login_error = false;
311 * IMAP folder delimiter
313 * This is the delimiter that your IMAP server uses to distinguish between
314 * folders. For example, Cyrus uses '.' as the delimiter and a complete
315 * folder would look like 'INBOX.Friends.Bob', while UW uses '/' and would
316 * look like 'INBOX/Friends/Bob'. Normally this should be left at 'detect'
317 * but if you are sure you know what delimiter your server uses, you can
320 * To have it autodetect the delimiter, set it to 'detect'.
321 * @global string $optional_delimiter
323 $optional_delimiter = 'detect';
326 * POP before SMTP setting
328 * Do you wish to use POP3 before SMTP? Your server must
329 * support this in order for SquirrelMail to work with it.
330 * @global bool $pop_before_smtp
332 $pop_before_smtp = false;
335 * POP before SMTP server address
337 * When using POP3 before SMTP, if the POP server address is
338 * not the same as the SMTP server address, specify it here.
339 * If this is left empty, the SMTP server address will be
341 * @global bool $pop_before_smtp_host
343 $pop_before_smtp_host = '';
346 /*** Folder Settings ***/
348 * Default IMAP folder prefix
350 * Many servers store mail in your home directory. With this, they
351 * store them in a subdirectory: mail/ or Mail/, etc. If your server
352 * does this, please set this to what the default mail folder should
353 * be. This is still a user preference, so they can change it if it
354 * is different for each user.
357 * $default_folder_prefix = 'mail/';
359 * $default_folder_prefix = 'Mail/folders/';
361 * If you do not use this, set it to the empty string.
362 * @global string $default_folder_prefix
364 $default_folder_prefix = '';
367 * User level prefix control
369 * If you do not wish to give them the option to change this, set it
370 * to false. Otherwise, if it is true, they can change the folder prefix
372 * @global bool $show_prefix_option
374 $show_prefix_option = false;
377 * The following are related to deleting messages.
378 * $default_move_to_trash
379 * If this is set to 'true', when 'delete' is pressed, it
380 * will attempt to move the selected messages to the folder
381 * named $trash_folder. If it's set to 'false', we won't even
382 * attempt to move the messages, just delete them.
383 * $default_move_to_sent
384 * If this is set to 'true', sent messages will be stored in
385 * $sent_folder by default.
386 * $default_save_as_draft
387 * If this is set to 'true', users are able to use $draft_folder
388 * to store their unfinished messages.
390 * This is the path to the default trash folder. For Cyrus
391 * IMAP, it would be 'INBOX.Trash', but for UW it would be
392 * 'Trash'. We need the full path name here.
394 * This is the patch to where Draft messages will be stored.
396 * If this is true, when a message is moved or copied, the
397 * source mailbox will get expunged, removing all messages
400 * This is the path to where Sent messages will be stored.
402 * If this is true, when a folder is deleted then it will
403 * not get moved into the Trash folder.
404 * @global bool $default_move_to_trash
405 * @global bool $default_move_to_sent
406 * @global bool $default_save_as_draft
407 * @global string $trash_folder
408 * @global string $sent_folder
409 * @global string $draft_folder
410 * @global bool $auto_expunge
411 * @global bool $delete_folder
413 $default_move_to_trash = true;
414 $default_move_to_sent = true;
415 $default_save_as_draft = true;
416 $trash_folder = 'INBOX.Trash';
417 $sent_folder = 'INBOX.Sent';
418 $draft_folder = 'INBOX.Drafts';
419 $auto_expunge = true;
420 $delete_folder = false;
423 * Special Folder Color Control
425 * Whether or not to use a special color for special folders. If not,
426 * special folders will be the same color as the other folders.
427 * @global bool $use_special_folder_color
429 $use_special_folder_color = true;
432 * Create Special Folders Control
434 * Should I create the Sent and Trash folders automatically for
435 * a new user that doesn't already have them created?
436 * @global bool $auto_create_special
438 $auto_create_special = true;
441 * List Special Folders First Control
443 * Whether or not to list the special folders first (true/false).
444 * @global bool $list_special_folders_first
446 $list_special_folders_first = true;
449 * Subfolder Layout Control
451 * Are all your folders subfolders of INBOX (i.e. cyrus IMAP server).
452 * If you are unsure, set it to false.
453 * @global bool $default_sub_of_inbox
455 $default_sub_of_inbox = true;
458 * Subfolder Format Control
460 * Some IMAP daemons (UW) handle folders weird. They only allow a
461 * folder to contain either messages or other folders, not both at
462 * the same time. This option controls whether or not to display an
463 * option during folder creation. The option toggles which type of
464 * folder it should be.
466 * If this option confuses you, just set it to 'true'. You can not hurt
467 * anything if it's true, but some servers will respond weird if it's
468 * false. (Cyrus works fine whether it's true OR false).
469 * @global bool $show_contain_subfolders_option
471 $show_contain_subfolders_option = false;
474 * These next two options set the defaults for the way that the
475 * users see their folder list.
476 * $default_unseen_notify
477 * Specifies whether or not the users will see the number of
478 * unseen in each folder by default and also which folders to
479 * do this to. Valid values are: 1=none, 2=inbox, 3=all.
480 * $default_unseen_type
481 * Specifies the type of notification to give the users by
482 * default. Valid choice are: 1=(4), 2=(4,25).
483 * @global integer $default_unseen_notify
484 * @global integer $default_unseen_type
486 $default_unseen_notify = 2;
487 $default_unseen_type = 1;
490 * NoSelect Fix Control
492 * This enables the no select fix for Cyrus when subfolders
493 * exist but parent folders do not
494 * @global bool $noselect_fix_enable
496 $noselect_fix_enable = false;
498 /*** General options ***/
500 * Path to the data/ directory
502 * You need to create this directory yourself (see INSTALL).
504 * It is a possible security hole to have a writable directory
505 * under the web server's root directory (ex: /home/httpd/html).
506 * The path name can be absolute or relative (to the config directory).
507 * If path is relative, it must use SM_PATH constant.
508 * Here are two examples:
511 * $data_dir = '/var/local/squirrelmail/data/';
513 * Relative (to main SM directory):
514 * $data_dir = SM_PATH . 'data/';
515 * (NOT recommended: you need to secure apache to make sure these
516 * files are not world readable)
518 * @global string $data_dir
520 $data_dir = '/var/local/squirrelmail/data/';
523 * Attachments directory
525 * Path to directory used for storing attachments while a mail is
526 * being sent. There are a few security considerations regarding
528 * + It should have the permission 733 (rwx-wx-wx) to make it
529 * impossible for a random person with access to the webserver to
530 * list files in this directory. Confidential data might be laying
532 * + Since the webserver is not able to list the files in the content
533 * is also impossible for the webserver to delete files lying around
534 * there for too long. You should have some script that deletes
535 * left over temp files.
536 * + It should probably be another directory than data_dir.
537 * @global string $attachment_dir
539 $attachment_dir = '/var/local/squirrelmail/attach/';
542 * Hash level used for data directory.
544 * This option allows spliting file based SquirrelMail user
545 * data storage directory into several subfolders. Number from
546 * 0 to 4 allows allows having up to four subfolder levels.
548 * Hashing should speed up directory access if you have big number
549 * of users (500 and more).
550 * @global integer $dir_hash_level
555 * Default Size of Folder List
557 * This is the default size of the folder list. Default
558 * is 150, but you can set it to whatever you wish.
559 * @global string $default_left_size
561 $default_left_size = '150';
564 * Username Case Control
566 * Some IMAP servers allow a username (like 'bob') to log in if they use
567 * uppercase in their name (like 'Bob' or 'BOB'). This creates extra
568 * preference files. Toggling this option to true will transparently
569 * change all usernames to lowercase.
570 * @global bool $force_username_lowercase
572 $force_username_lowercase = false;
575 * Email Priority Control
577 * This option enables use of email priority flags by end users.
578 * @global bool $default_use_priority
580 $default_use_priority = true;
583 * SquirrelMail Attributions Control
585 * This option disables display of "created by SquirrelMail developers"
587 * @global bool $hide_sm_attributions
590 $hide_sm_attributions = false;
593 * Delivery Receipts Control
595 * This option enables use of read/delivery receipts by end users.
596 * @global bool $default_use_mdn
598 $default_use_mdn = true;
603 * If you don't want to allow users to change their email address
604 * then you can set $edit_identity to false; if you want them to
605 * not be able to change their full name too then set $edit_name
606 * to false as well. $edit_reply_to likewise controls users' ability
607 * to change their reply-to address. $edit_name and $edit_reply_to
608 * have no effect unless $edit_identity is false;
609 * @global bool $edit_identity
610 * @global bool $edit_name
611 * @global bool $edit_reply_to
613 $edit_identity = true;
615 $edit_reply_to = true;
618 * SquirrelMail adds username information to every sent email.
619 * It is done in order to prevent possible sender forging when
620 * end users are allowed to change their email and name
623 * You can disable this header, if you think that it violates
624 * user's privacy or security. Please note, that setting will
625 * work only when users are not allowed to change their identity.
627 * See SquirrelMail bug tracker #847107 for more details about it.
628 * @global bool $hide_auth_header
629 * @since 1.5.1 and 1.4.5
631 $hide_auth_header = false;
634 * Server Side Threading Control
636 * Set it to true, if you want to disable server side thread
637 * sorting options. Your IMAP server must support the THREAD
638 * extension for this to have any effect.
640 * Older SquirrelMail versions used $allow_thread_sort option.
641 * @global bool $disable_thread_sort
644 $disable_thread_sort = false;
647 * Server Side Sorting Control
649 * Set it to true, if you want to disable server side sorting
650 * and use SM client side sorting instead (client side sorting
651 * can be slow). Your IMAP server must support the SORT extension
652 * for this to have any effect.
654 * Older SquirrelMail versions used $allow_server_sort option.
655 * @global bool $disable_server_sort
658 $disable_server_sort = false;
661 * IMAP Charset Use Control
663 * This option allows you to choose if SM uses charset search
664 * Your imap server should support SEARCH CHARSET command for
666 * @global bool $allow_charset_search
668 $allow_charset_search = true;
671 * Search functions control
673 * This option allows you to control the use of advanced search form.
674 * Set to 0 to enable basic search only, 1 to enable advanced search only
675 * or 2 to enable both.
676 * @global integer $allow_advanced_search
678 $allow_advanced_search = 0;
683 * Leave this alone unless you know what you are doing.
684 * @global string $session_name
686 $session_name = 'SQMSESSID';
691 * Only transmit cookies via a secure connection
692 * if the session was started using HTTPS/SSL?
696 * @global bool $only_secure_cookies
697 * @since 1.5.2 and 1.4.16
699 $only_secure_cookies = true;
704 * Disable security tokens used to authenticate the
705 * source of user data received by SquirrelMail?
707 * It is highly discouraged to enable this setting.
709 * @global bool $disable_security_tokens
710 * @since 1.5.2 and 1.4.20RC1
712 $disable_security_tokens = false;
715 * Check Page Referrer
717 * Enforces a safety check on page requests by checking
718 * that the referrer is the domain specified by this
719 * setting. If this setting is "###DOMAIN###", the
720 * current value of the $domain variable will be used
723 * If a browser doesn't send referrer data, this check
724 * will be silently bypassed.
727 * $check_referrer = 'example.com';
728 * $check_referrer = '###DOMAIN###';
730 * @global string $check_referrer
731 * @since 1.5.2 and 1.4.20RC1
733 $check_referrer = '';
736 * Security Image Type
738 * Switches between using a transparent image
739 * and one that states "this image has been
740 * removed for security reasons"
742 * @global bool $use_transparent_security_image
743 * @since 1.5.2 and 1.4.23
745 $use_transparent_security_image = true;
750 * You can define your own theme and put it in directory in SM_PATH/css/.
751 * You must call it as the example below. You can name the theme
754 * To add a new theme to the options that users can choose from, just
755 * add a new number to the array at the bottom, and follow the pattern.
757 * $user_theme_default sets theme that will be used by default
759 * @global integer $user_theme_default
762 $user_theme_default = 0;
765 * Listing of installed themes
766 * @global array $user_themes
769 $user_themes[0]['PATH'] = 'none';
770 $user_themes[0]['NAME'] = 'Default';
772 $user_themes[1]['PATH'] = '../css/blue_gradient/';
773 $user_themes[1]['NAME'] = 'Blue Options';
776 * Message Icons control
778 * Use icons for message and folder markers
779 * @global bool $use_icons
786 * You can create your own icon themes and put them in a directory in
787 * SM_PATH/images/themes/. Your users will be able to choose whatever
788 * icon themes are listed below.
790 * To add a new theme to the list of available icon themes, just add a new
791 * number to the array below and follow the pattern
793 * $icon_theme_default sets the theme that will be used by default.
794 * $icon_theme_fallback specifies which theme will be used if an icon is
795 * not found in the selected theme
797 * @global integer $icon_theme_def
798 * @global integer $icon_theme_fallback
802 $icon_theme_fallback = 3;
805 * Listing of installed icon themes
806 * @global array $icon_themes
809 $icon_themes[0]['PATH'] = 'none';
810 $icon_themes[0]['NAME'] = 'No Icons';
812 $icon_themes[1]['PATH'] = 'template';
813 $icon_themes[1]['NAME'] = 'Template Default Icons';
815 $icon_themes[2]['PATH'] = '../images/themes/default/';
816 $icon_themes[2]['NAME'] = 'Default Icon Set';
818 $icon_themes[3]['PATH'] = '../images/themes/xp/';
819 $icon_themes[3]['NAME'] = 'XP Style Icons';
823 * You can define your own template set (skin) and put it in a new
824 * directory under SM_PATH/templates. The ID must match the name of
825 * the template directory as the example below. You can name the
826 * template whatever you want. For an example of a template, see
827 * the ones included in the SM_PATH/templates directory.
829 * To add a new template to the options that users can choose from, just
830 * add a new number to the array at the bottom, and follow the pattern.
832 * $templateset_default sets the skin that will be used by default
833 * when a user doesn't have a skin selection
834 * in their preferences. (Must be the "ID" of
835 * the desired template set)
837 * $templateset_fallback tells SquirrelMail which template set (skin)
838 * to use when looking for a file that is not
839 * contained within whatever skin is currently
840 * being used. (Must be the "ID" of the desired
843 * $rpc_templateset sets the skin that will be used by default
844 * when a user is making an RPC request. This
845 * does not usually need to be changed, but
846 * can be used to change the RPC protocol that
847 * is used to respond to RPC requets. (Must be
848 * the "ID" of the desired template set and
849 * should NOT be a template set that is included
850 * in the $aTemplateSet list; PLEASE NOTE that
851 * new RPC template sets should always be named
852 * "<skin name>_rpc", as SquirrelMail will assume
853 * any template sets ending in "_rpc" are intended
854 * for its RPC interface only)
856 * @global string $templateset_default
857 * @global string $templateset_fallback
858 * @global string $rpc_templateset
860 $templateset_default = 'default';
861 $templateset_fallback = 'default';
862 $rpc_templateset = 'default_rpc';
864 $aTemplateSet[0]['ID'] = 'default';
865 $aTemplateSet[0]['NAME'] = 'Default';
866 $aTemplateSet[1]['ID'] = 'default_advanced';
867 $aTemplateSet[1]['NAME'] = 'Advanced';
870 * Default interface font size.
871 * @global string $default_fontsize
874 $default_fontsize = '';
878 * @global string $default_fontset
881 $default_fontset = '';
884 * List of available fontsets.
885 * @global array $fontsets
889 $fontsets['serif'] = 'serif';
890 $fontsets['sans'] = 'helvetica,arial,sans-serif';
891 $fontsets['comicsans'] = 'comic sans ms,sans-serif';
892 $fontsets['verasans'] = 'bitstream vera sans,verdana,sans-serif';
893 $fontsets['tahoma'] = 'tahoma,sans-serif';
897 * Array of arrays with LDAP server parameters. See
898 * functions/abook_ldap_server.php for a list of possible
902 * $ldap_server[0] = Array(
903 * 'host' => 'memberdir.netscape.com',
904 * 'name' => 'Netcenter Member Directory',
905 * 'base' => 'ou=member_directory,o=netcenter.com'
908 * NOTE: please see security note at the top of this file when
909 * entering a password.
911 // Add your ldap server options here
914 * Javascript in Addressbook Control
916 * Users may search their addressbook via either a plain HTML or Javascript
917 * enhanced user interface. This option allows you to set the default choice.
918 * Set this default choice as either:
921 * @global bool $default_use_javascript_addr_book
923 $default_use_javascript_addr_book = false;
926 * Shared filebased address book
927 * @global string $abook_global_file
928 * @since 1.5.1 and 1.4.4
930 $abook_global_file = '';
933 * Writing into shared address book control
934 * @global bool $abook_global_file_writeable
935 * @since 1.5.1 and 1.4.4
937 $abook_global_file_writeable = false;
940 * Listing of shared address book control
941 * @global bool $abook_global_file_listing
944 $abook_global_file_listing = true;
947 * Controls file based address book entry size
949 * This setting controls space allocated to file based address book records.
950 * End users will be unable to save address book entry, if total entry size
951 * (quoted address book fields + 4 delimiters + linefeed) exceeds allowed
952 * address book length size.
954 * Same setting is applied to personal and global file based address books.
956 * It is strongly recommended to keep default setting value. Change it only
957 * if you really want to store address book entries that are bigger than two
959 * @global integer $abook_file_line_length
962 $abook_file_line_length = 2048;
967 * This is a message that is displayed immediately after a user logs in.
968 * @global string $motd
974 * To install plugins, just add elements to this array that have
975 * the plugin directory name relative to the /plugins/ directory.
976 * For instance, for the 'squirrelspell' plugin, you'd put a line like
978 * $plugins[] = 'squirrelspell';
979 * $plugins[] = 'listcommands';
981 // Add list of enabled plugins here
985 * To disable all plugins regardless of any that are installed
986 * above, turn on $disable_plugins. To disable them ONLY for
987 * one user, put that username into $disable_plugins_user.
988 * @global boolean $disable_plugins
989 * @global string $disable_plugins_user
992 $disable_plugins = false;
993 $disable_plugins_user = '';
998 * Read the administrator's manual in order to get more information
999 * about these settings.
1002 * Database-driven private addressbooks
1003 * DSN (Data Source Name) for a database where the private
1004 * addressbooks are stored. See the administrator's manual for more info.
1005 * If it is not set, the addressbooks are stored in files
1007 * The DSN is in the format: mysql://user:pass@hostname/dbname
1008 * The table is the name of the table to use within the
1009 * specified database.
1011 * NOTE: please see security note at the top of this file when
1012 * entering a password.
1015 $addrbook_table = 'address';
1017 * Database used to store user data
1020 $prefs_table = 'userprefs';
1022 * Preference key field
1023 * @global string $prefs_key_field
1025 $prefs_key_field = 'prefkey';
1027 * Size of preference key field
1028 * @global integer $prefs_key_size
1031 $prefs_key_size = 64;
1033 * Preference owner field
1034 * @global string $prefs_user_field
1036 $prefs_user_field = 'user';
1038 * Size of preference owner field
1039 * @global integer $prefs_user_size
1042 $prefs_user_size = 128;
1044 * Preference value field
1045 * @global string $prefs_val_field
1047 $prefs_val_field = 'prefval';
1049 * Size of preference key field
1050 * @global integer $prefs_val_size
1053 $prefs_val_size = 65536;
1055 /*** Global sql database options ***/
1057 * DSN of global address book database
1058 * @global string $addrbook_global_dsn
1059 * @since 1.5.1 and 1.4.4
1061 $addrbook_global_dsn = '';
1063 * Table used for global database address book
1064 * @global string $addrbook_global_table
1065 * @since 1.5.1 and 1.4.4
1067 $addrbook_global_table = 'global_abook';
1069 * Control writing into global database address book
1070 * @global boolean $addrbook_global_writeable
1071 * @since 1.5.1 and 1.4.4
1073 $addrbook_global_writeable = false;
1075 * Control listing of global database address book
1076 * @global boolean $addrbook_global_listing
1077 * @since 1.5.1 and 1.4.4
1079 $addrbook_global_listing = false;
1081 /*** Language settings ***/
1085 * This is the default language. It is used as a last resort
1086 * if SquirrelMail can't figure out which language to display.
1087 * Language names usually consist of language code, undercore
1088 * symbol and country code
1089 * @global string $squirrelmail_default_language
1091 $squirrelmail_default_language = 'en_US';
1096 * This option controls what character set is used when sending
1097 * mail and when sending HTML to the browser. Option works only
1098 * with US English (en_US) translation. Other translations use
1099 * charsets that are set in translation settings.
1101 * @global string $default_charset
1103 $default_charset = 'iso-8859-1';
1106 * Alternative Language Names Control
1108 * This options allows displaying native language names in language
1110 * @global bool $show_alternative_names
1113 $show_alternative_names = false;
1116 * Aggressive Decoding Control
1118 * This option enables reading of Eastern multibyte encodings.
1119 * Functions that provide this support are very cpu and memory intensive.
1120 * Don't enable this option unless you really need it.
1121 * @global bool $aggressive_decoding
1124 $aggressive_decoding = false;
1127 * Lossy Encoding Control
1129 * This option allows charset conversions when output charset does not support
1130 * all symbols used in original charset. Symbols unsupported by output charset
1131 * will be replaced with question marks.
1132 * @global bool $lossy_encoding
1135 $lossy_encoding = false;
1138 * Controls use of time zone libraries
1142 * <li>0 - default, SquirrelMail uses GNU C timezone names in
1143 * TZ environment variables
1144 * <li>1 - strict, SquirrelMail uses 'TZ' subkey values in TZ
1145 * environment variables
1146 * <li>2 - custom, SquirrelMail loads time zone data from
1147 * config/timezones.php and uses time zone array keys in
1148 * TZ enviroment variables
1149 * <li>3 - custom strict, SquirrelMail loads time zone data from
1150 * config/timezones.php and uses TZ subkey values in
1151 * TZ enviroment variables
1153 * Use of any other value switches to default SquirrelMail time zone
1154 * handling ($time_zone_type).
1155 * @global integer $time_zone_type
1158 $time_zone_type = 0;
1163 * This is used to build the URL to the SquirrelMail location.
1164 * It should contain only the protocol and hostname/port parts
1165 * of the URL; the full path will be appended automatically.
1167 * If not specified or empty, it will be autodetected.
1170 * http://webmail.example.org
1171 * http://webmail.example.com:8080
1172 * https://webmail.example.com:6691
1174 * To be clear: do not include any of the path elements, so if
1175 * SquirrelMail is at http://www.example.net/web/mail/src/login.php, you
1176 * write: http://www.example.net
1178 * @global string $config_location_base
1179 * @since 1.5.2 and 1.4.8
1181 $config_location_base = '';
1185 * Iframe sandbox code control
1187 * Use iframe to render html emails
1188 * (temp option used during debuging of new code)
1189 * @global bool $use_iframe
1192 $use_iframe = false;
1195 * PHP recode functions control
1197 * Use experimental code with php recode functions when reading messages with
1198 * different encoding. This code is faster that original SM functions,
1199 * but it require php with recode support.
1201 * Don't enable this option if you are not sure about availability of
1203 * @global bool $use_php_recode
1206 $use_php_recode = false;
1209 * PHP iconv functions control
1211 * Use experimental code with php iconv functions when reading messages with
1212 * different encoding. This code is faster that original SM functions,
1213 * but it require php with iconv support and works only with some translations.
1215 * Don't enable this option if you are not sure about availability of
1217 * @global bool $use_php_iconv
1220 $use_php_iconv = false;
1225 * In some cases, buffering all output allows more complex functionality,
1226 * especially for plugins that want to add headers on hooks that are beyond
1227 * the point of output having been sent to the browser otherwise (although
1228 * most plugins that need this feature will turn it on automatically by
1231 * It is also possible to define a custom output handler as needed by special
1232 * environments. If $buffered_output_handler is non-empty, a function named
1233 * the same as the value of $buffered_output_handler should be defined in
1237 $buffer_output = false;
1238 $buffered_output_handler = '';
1241 * Allow Remote configtest Access
1243 * Controls remote configuration checks
1244 * @global boolean $allow_remote_configtest
1247 $allow_remote_configtest = false;
1250 * SquirrelMail Debug Mode
1252 * Various debugging levels can be enabled using this setting.
1253 * More than one mode can be used at once by combining them
1254 * with pipes ("|"). See the SM_DEBUG_MODE_* constants in
1255 * include/constants.php
1257 $sm_debug_mode = SM_DEBUG_MODE_OFF
;
1260 * "Secured Configuration" Mode
1262 * Enable/disable "Secured Configuration" mode, wherein certain
1263 * security-sensitive configuration settings are made immutable
1266 $secured_config = true;
1271 * This is the HTTPS (SSL-secured HTTP) port. It can be left empty,
1272 * in which case SquirrelMail will assume the standard port 443.
1273 * Make sure to set this correctly when serving HTTPS on a non-
1276 $sq_https_port = 443;
1279 * Ignore HTTP_X_FORWARDED_* headers?
1281 * Whether or not HTTP_X_FORWARDED_* headers are respected by
1282 * SquirrelMail (or plugins).
1284 $sq_ignore_http_x_forwarded_headers = true;
1287 * Subscribe Listing Control
1289 * this disables listing all of the folders on the IMAP Server to
1290 * generate the folder subscribe listbox (this can take a long time
1291 * when you have a lot of folders). Instead, a textbox will be
1292 * displayed allowing users to enter a specific folder name to subscribe to
1294 * This option can't be changed by conf.pl
1295 * @global bool $no_list_for_subscribe
1297 $no_list_for_subscribe = false;
1300 * Color in config control
1302 * This option is used only by conf.pl script to generate configuration
1303 * menu with some colors and is provided here only as reference.
1304 * @global integer $config_use_color
1306 $config_use_color = 2;
1309 * Ask User for Personal Information on login
1311 * When a user logs in that doesn't have an email address configured,
1312 * redirect him/her to the options page with a request to fill in their
1313 * personal information.
1315 * @global bool $ask_user_info
1317 $ask_user_info = true;