X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=doc%2Fpresets.txt;h=5762a1298be67ec18cec7b4d4ea530685cb64b25;hp=9d2f1ac730a0aa18db0ef489ecf9fd27efea06ff;hb=a564b9e3f94dcd52acd4133c84de9cac3da3cab6;hpb=67a24f8a5c008341b8f353432c210159a94fc094;ds=sidebyside diff --git a/doc/presets.txt b/doc/presets.txt index 9d2f1ac7..5762a129 100644 --- a/doc/presets.txt +++ b/doc/presets.txt @@ -1,19 +1,21 @@ $Date$ -This file lists SquirrelMail options set by D option in conf.pl +This file lists the SquirrelMail settings set by option D in conf.pl -It can be used if user can't run conf.pl and changes options manually. -Settings can be different if IMAP server uses shared folders. +These can be used if the administrator can't run conf.pl and wants to +change these settings manually. These settings can be different if +the IMAP server uses shared folders. -Possible server values are: +Possible server type values are: + bincimap = Binc IMAP server + courier = Courier IMAP server cyrus = Cyrus IMAP server - uw = University of Washington's IMAP server + dovecot = Dovecot Secure IMAP server exchange = Microsoft Exchange IMAP server - courier = Courier IMAP server - macosx = Mac OS X Mailserver hmailserver = hMailServer + macosx = Mac OS X Mailserver mercury32 = Mercury/32 - dovecot = Dovecot Secure IMAP server + uw = University of Washington's IMAP server ----------------- default settings: @@ -34,6 +36,10 @@ show_contain_subfolders_option = false ----------------- 'cyrus' settings: ----------------- +Server supports server side sorting since 2.0.4 version. euc-jp, euc-kr, +tis-620, cp1251, cp1255 character sets are not supported by sorting functions +(v.2.2.12). + imap_server_type = cyrus default_folder_prefix = (is set to empty string) trash_folder = INBOX.Trash @@ -49,6 +55,8 @@ show_contain_subfolders_option = false -------------- 'uw' settings: -------------- +Server supports server side sorting. Plain text logins are disabled by default. + imap_server_type = uw default_folder_prefix = mail/ trash_folder = Trash @@ -64,6 +72,8 @@ show_contain_subfolders_option = true -------------------- 'exchange' settings: -------------------- +Server does not support server side sorting. + imap_server_type = exchange default_folder_prefix = (is set to empty string) trash_folder = INBOX/Deleted Items @@ -79,6 +89,12 @@ show_contain_subfolders_option = false ------------------- 'courier' settings: ------------------- +Fast, scalable, enterprise IMAP server that uses Maildirs + +Server supports server side sorting. SquirrelMail can issue IMAP commands +that are supported only when courier-imap is compiled with --enable-unicode +option. + imap_server_type = courier default_folder_prefix = INBOX. trash_folder = Trash @@ -109,6 +125,9 @@ show_contain_subfolders_option = false ----------------------- 'hmailserver' settings: ----------------------- +Preset is used with hMailServer IMAP server. Available since SquirrelMail 1.5.1 +and 1.4.4. Open source email server for WinNT and later. + imap_server_type = hmailserver (used in imap_search.php) default_folder_prefix = (is set to empty string) trash_folder = INBOX.Trash @@ -124,11 +143,8 @@ show_contain_subfolders_option = false --------------------- 'mercury32' settings: --------------------- -Preset is used for Mercury Mail Transport System. Available since 1.5.0 +Preset is used for Mercury Mail Transport System. Available since 1.5.0 and 1.4.6. Free email server for Win32 and Netware. -Tested Win32 v.4.01b -CAPABILITY IMAP4rev1 X-MERCURY -PERMANENTFLAGS (\Deleted \Draft \Seen \Answered) Comments: * Server side sorting and threading are not supported. @@ -140,8 +156,6 @@ Comments: $imap_server_type variable is used to handle imap folder subscription differences. -Site URL: http://www.pmail.com - imap_server_type = mercury32 default_folder_prefix = (is set to empty string) trash_folder = Trash @@ -157,22 +171,15 @@ show_contain_subfolders_option = true ------------------- 'dovecot' settings: ------------------- -Preset used for Dovecot Secure IMAP server. Available since 1.5.1. +Preset used for Dovecot Secure IMAP server. Available since 1.5.1 and 1.4.6. There is no code specific to Dovecot IMAP server. Preset provides only a quick -way to set correct folder settings. - -Tested v.0.99.14 - -CAPABILITY IMAP4rev1 SORT THREAD=REFERENCES MULTIAPPEND UNSELECT LITERAL+ IDLE - CHILDREN LISTEXT LIST-SUBSCRIBED NAMESPACE - -PERMANENTFLAGS (\Answered \Flagged \Deleted \Seen \Draft \*) +way to set correct folder settings. Preset works with any IMAP server that does +not store IMAP folders under INBOX and IMAP folders can store messages and other +folders. Preset can also be used with Bejy IMAP server. IMAP server supports server side sorting and threading. -Site URL: http://www.dovecot.org - imap_server_type = dovecot default_folder_prefix = (is set to empty string) trash_folder = Trash @@ -186,3 +193,100 @@ show_contain_subfolders_option = false force_username_lowercase = true +-------------------- +'bincimap' settings: +-------------------- +Preset is used with Binc IMAP server. Available since 1.5.1 and 1.4.6. + +IMAP server does not support server side sorting and threading. Plain text +logins are disabled by default. Due to available storage backend configuration +options it is impossible to create single preset, which covers all setups. + +* Default (1.2.13) configuration with Maildir++ depot and / delimiter + imap_server_type = bincimap (is used to handle INBOX in folder management) + default_folder_prefix = INBOX/ + trash_folder = Trash + sent_folder = Sent + draft_folder = Drafts + show_prefix_option = false + default_sub_of_inbox = false +show_contain_subfolders_option = false + optional_delimiter = / (can be set to 'detect') + delete_folder = true + force_username_lowercase = false (depends on checkpassword) + +* Default (1.3.4) configuration with IMAPdir depot - same as dovecot ? + imap_server_type = bincimap + default_folder_prefix = (is set to empty string) + trash_folder = Trash + sent_folder = Sent + draft_folder = Drafts + show_prefix_option = false + default_sub_of_inbox = false +show_contain_subfolders_option = false + optional_delimiter = / (can be set to 'detect') + delete_folder = true + force_username_lowercase = false (depends on checkpassword) + + +* Configuration with Maildir++ depot and . delimiter - use courier preset. + + +--------------------- +'gmail' settings: +--------------------- +Support for using SquirrelMail as a front end for Google Mail (Gmail) +accounts was added in SquirrelMail versions 1.4.20 and 1.5.2 and is +currently experimental. + +CAPABILITY IMAP4rev1 UNSELECT LITERAL+ IDLE NAMESPACE QUOTA ID XLIST CHILDREN +X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE + +Notes: +* Might want to remove "All Mail" from folder drop-down lists (such as the + ones for moving mail to folders... "All Mail" is not a folder in Gmail + (it is a super-folder that shows mail from all folders) +* Might want to remove the whole folder list drop-down from Create Folder + section, since labels/folders are usually just created as children of +* Might want to remove any folders prefixed with [Gmail]/ from the rename + and delete folders drop down selectors, since those are Gmail system folders +* Might want to tweak what's included in the (un)subscribe menus too(?) +* The folder list order is slightly strange, with the Gmail system folders + listed below the user labels/folders +* When a user changes languages in Gmail's interface, the Drafts, Sent and + Trash folder names are changed to localized versions thereof. To see those + folders correctly in SquirrelMail, the user should change the SquirrelMail + language to match. Moreover, SquirrelMail then needs to be told what + folders to use for Drafts, Sent and Trash in Options --> Folder Preferences. + These default settings will only correctly find the Sent, Trash and Drafts + folders if both Gmail and SquirrelMail languages are set to English. + (This could be solved with implementation of extended LIST command support.) +* In some places (Europe?), the "[Gmail]" prefix should be "[Google Mail]" + and "Trash" might be called "Bin" + + imap_server_type = gmail + default_folder_prefix = (is set to empty string) + trash_folder = [Gmail]/Trash + default_move_to_trash = true + sent_folder = [Gmail]/Sent Mail + draft_folder = [Gmail]/Drafts + auto_create_special = false + show_prefix_option = false + default_sub_of_inbox = false +show_contain_subfolders_option = false + optional_delimiter = / + delete_folder = true + force_username_lowercase = false + domain = gmail.com + imapServerAddress = imap.gmail.com + imapPort = 993 + use_imap_tls = true + imap_auth_mech = login + smtpServerAddress = smtp.gmail.com + smtpPort = 465 + use_smtp_tls = true + smtp_auth_mech = login + pop_before_smtp = false + useSendmail = false + +-------------------