Legacy code was probably wrong
[squirrelmail.git] / doc / presets.txt
index 9971265..5762a12 100644 (file)
@@ -1,11 +1,12 @@
 $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
@@ -39,13 +40,6 @@ 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).
 
-CAPABILITY IMAP4 IMAP4rev1 ACL QUOTA LITERAL+ MAILBOX-REFERRALS NAMESPACE
- UIDPLUS ID NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND BINARY SORT
- THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE IDLE LISTEXT
- LIST-SUBSCRIBED X-NETSCAPE
-
-PERMANENTFLAGS (\Answered \Flagged \Draft \Deleted \Seen $MDNSent \*)
-
               imap_server_type = cyrus
          default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX.Trash
@@ -63,11 +57,6 @@ show_contain_subfolders_option = false
 --------------
 Server supports server side sorting. Plain text logins are disabled by default.
 
-CAPABILITY IMAP4REV1 IDLE NAMESPACE MAILBOX-REFERRALS BINARY UNSELECT SCAN SORT
- THREAD=REFERENCES THREAD=ORDEREDSUBJECT MULTIAPPEND LOGIN-REFERRALS STARTTLS
- AUTH=LOGIN
-PERMANENTFLAGS (Seen \* \Answered \Flagged \Deleted \Draft \Seen)
-
               imap_server_type = uw
          default_folder_prefix = mail/
                   trash_folder = Trash
@@ -84,6 +73,7 @@ show_contain_subfolders_option = true
 'exchange' settings:
 --------------------
 Server does not support server side sorting.
+
               imap_server_type = exchange
          default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX/Deleted Items
@@ -101,20 +91,9 @@ show_contain_subfolders_option = false
 -------------------
 Fast, scalable, enterprise IMAP server that uses Maildirs
 
-CAPABILITY IMAP4rev1 UIDPLUS CHILDREN NAMESPACE THREAD=ORDEREDSUBJECT
- THREAD=REFERENCES SORT QUOTA IDLE ACL ACL2=UNION
-
-PERMANENTFLAGS (\* \Draft \Answered \Flagged \Deleted \Seen)
-
-Recent (3.0.0+) versions support most of character sets used by SquirrelMail, 
-if courier-imap is compiled with --enable-unicode option. Only koi8-u 
-is not supported. Server can be compiled with custom number of supported
-character sets. Sorting can be disabled in imapd configuration. Capability
-string can be set in configuration. Supports CRAM-MD5, CRAM-SHA1 and 
-CRAM-SHA256, if userdb or other backend stores passwords in plain text. Does 
-not handle traditional mailbox files.
-
-Site URL: http://www.courier-mta.org/
+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.
@@ -149,12 +128,6 @@ show_contain_subfolders_option = false
 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.
 
-Tested 4.1.1 (Build 140).
-CAPABILITY IMAP4 IMAP4rev1 QUOTA 
-PERMANENTFLAGS (\Deleted \Seen \Draft \Answered \Flagged)
-
-Site URL: http://www.hmailserver.com/
-
               imap_server_type = hmailserver   (used in imap_search.php)
          default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX.Trash
@@ -172,9 +145,6 @@ show_contain_subfolders_option = false
 ---------------------
 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.
@@ -186,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 = <none> (is set to empty string)
                   trash_folder = Trash
@@ -206,19 +174,12 @@ show_contain_subfolders_option = true
 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 = <none> (is set to empty string)
                   trash_folder = Trash
@@ -236,20 +197,11 @@ show_contain_subfolders_option = false
 'bincimap' settings:
 --------------------
 Preset is used with Binc IMAP server. Available since 1.5.1 and 1.4.6.
-Tested v.1.2.13 and 1.3.4
-
-CAPABILITY IMAP4rev1 STARTTLS AUTH=LOGIN AUTH=PLAIN (1.2.13)
-CAPABILITY IMAP4rev1 STARTTLS AUTH=LOGIN AUTH=PLAIN IDLE LITERAL+ NAMESPACE CHILDREN (1.3.4)
-
-PERMANENTFLAGS (\Answered \Flagged \Deleted \Seen \Draft) - 1.2.13
-PERMANENTFLAGS (\Answered \Flagged \Deleted \Seen \Draft \*) - 1.3.4
 
 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.
 
-Site URL: http://www.bincimap.org
-
 * 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/
@@ -278,3 +230,63 @@ show_contain_subfolders_option = false
 
 
 * 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 <none>
+* 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 = <none> (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
+
+-------------------