#  Hastymail configuration file. by default Hastymail assumes this
#  file is in /etc and named hastymail.conf. If you need to change this
#  or want to move this file to another location then you must change
#  the value located in hastmail/lib/constant.php line #5. 
#  Make sure that there are no spaces between the setting 
#  names, the equal sign, and the setting values. Lines that begin with
#  a # sign are ignored.



##################################################################
######################## IMAP Settings ###########################
##################################################################

#  The IMAP server address/hostname. Use the IMAP server ip
#  address or hostname, not both :) You can use the special value of
#  dynamic and set the value for dynamic_imap_domain to the domain
#  to append to the username for sites that use multiple IMAP servers
#  with a username in the IMAP server address.

imap_server=localhost

#  If you use "dynamic" above then set this to the domain portion of
#  the IMAP server address which will be appended by hastymail. Using any
#  other value for imap_server other than "dynamic" and this option is
#  ignored.

dynamic_imap_domain=

#  The port your IMAP server listens on. for normal IMAP connections
#  the default is 143. For tls/ssl IMAP connections the default is 993 

imap_port=143

#  If you are using PHP 4.3.0+ and have openssl support
#  compiled in you can connect to an IMAPS server, change the next line
#  to 'ssl' for a ssl socket or 'tls' for a tls socket (without the quotes)
#  Don't forget to set the IMAP port correctly! (usually 993 for imaps)
#  some servers may care which one you use but I have tried both tls and ssl 
#  for uw-imapd on port 993 and both work. However some IMAP servers may
#  only support one or the other, for example BincIMAP only supports tls.

imap_ssl=tls

#  Hastymail defaults to normal plain text LOGIN authentication. You can
#  enable CRAM-MD5 authentication by changing this to cram-md5.

imap_auth=login

#  IMAP prefix. It is useful for some servers to use an IMAP prefix to
#  limit IMAP folders to a certain directory for each user. Some IMAP
#  servers do not require a prefix, like Courier and Cyrus, in which 
#  case this value should be empty. Other servers, like UW, run faster
#  if a user's IMAP folders are seperated from other files in there $HOME
#  directory. Some common defaults for various IMAP servers:
#       UW-imap         mail/ (as in /home/username/mail/)
#       Cyrus           leave blank or INBOX
#       Courier         leave blank or INBOX
#       EIMS            special keyword "none"
#       Dovecot         special keyword "none"
#  An empty prefix setting will use an internal prefix of INBOX which
#  works with servers like Courier and Cyrus. However some IMAP servers,
#  notably EIMS use NO prefix at all. For those servers use the special
#  prefix of 'none' (without the quotes!).

prefix=

#  The IMAP delimiter. This is the character that your IMAP server uses
#  to seperate folders and subfolders. Hastymail attempts to determine
#  the delimiter but if it has a problem you can specify it here.
#  Leave this blank (or comment out) to use hastymail's autodetection.
#  Some IMAP servers allow admins to specify the dilimeter, but some
#  common defaults are:
#       UW          /
#       Courier     .
#       Cyrus       .
#       Dovecot     (leave blank)

delim=

#  This forces hastymail to sort your mailbox with PHP code.
#  This is needed if your IMAP server does not support the SORT extension.
#  Your IMAP servers CAPABILITY response should include the word SORT if it is
#  supported. See your IMAP server docs to find out more. The SORT extension
#  can really speed up the application performance for large mailboxes.

client_sort=false

#  For setups that require a username of user@domain.com the domain portion
#  of the username can be appended with this option. Just add the domain.com
#  part. For multiple domains using the same Hastymail installation set this
#  to virtual_host and hastymail will use the domain portion of the current
#  HTTP_HOST value (see the next option for how to make this work for you). 
#  If the login name already contains a domain this option will be ignored.

append_name=

#  If using the virtual_host mode of the append_name option above, then 
#  this list of host names (comma seperated, no spaces) will be trimmed from 
#  the start of the HTTP_HOST value leaving the domain to be appended to 
#  username. If this is blank or commented out then hastymail will try to 
#  autodetect the domain part of the HTTP_HOST value. If append_name
#  option is not set to virtual_host this option does nothing.

virtual_list=www,mail,webmail

#  Some IMAP servers don't like to get literal data for search terms. To
#  use a simple quoted string instead, set the following option to true.
#  This is mainly a workaround for EIMS

simple_search=false



#############################################################################
######################## Additional IMAP servers  ###########################
#############################################################################

#  Hastymail can be configured to use multiple IMAP server accounts.
#  To configure another IMAP server you must define another set of the
#  above settings with the "alt_1_" prefix in front of each name.
#  To add a 3rd, 4th or more IMAP servers just add another set of settings
#  using alt_2_, alt_3_, etc. If more than one IMAP server is defined
#  then users will have a dropdown on the login page allowing them to choose
#  which server to log into. The only required setting is the alt_1_imap_server
#  setting, the rest will use the default values if unset.
#
#  example:
#
# alt_1_imap_server=localhost
# alt_1_imap_port=143
# alt_1_imap_ssl=false
# alt_1_prefix=mail/
# alt_1_delim=
# alt_1_client_sort=false
#
#  If more than one IMAP server is configured, then you can use the following
#  settings to name each server entry in the dropdown box.
#
#  imap_server_label=
#  alt_1_imap_server_label=
#
#  Otherwise the value for imap_server is used in the dropdown.
#
#  Any of the remaining settings can have an alternate value with an 
#  alt_1_ prefix and will be used if the user logs into 
#  the alt_1_imap_server. If each additional IMAP server has its own
#  smtp_server value then each imap account can use a different SMTP server
#  
#  example:
#
#  default value:
#  smtp_server=localhost
#
#  value used when user logs into alt_1_imap_server:
#  alt_1_smtp_server=10.1.1.10



##################################################################
######################## SMTP Settings ###########################
##################################################################

#  The SMTP server address. Like the IMAP server option, hostname or
#  ip address of the smtp server

smtp_server=localhost

#  The port your SMTP server listens on. The default SMTP port is 25

smtp_port=25

#  The default domain for outgoing mail. This will be used to append
#  to your login name when sending mail if no From addresses
#  are setup on the user's options page. If users login with a
#  username@domain.com type username, or the append_name option is set
#  (in the IMAP section) this option will be ignored.

domain=testdomain.com
   
#  Authenticate SMTP connections. This option makes hastymail
#  authenticate your username and password to the SMTP server
#  before users send messages out. This can be set to:
#       plain
#       login
#       cram-md5
#  Leave blank or set to false for no SMTP authentication

smtp_auth=false

#  If you are using PHP 4.3.0+ and have openssl support
#  compiled in you can connect to a SMTP server using SSL, change the next 
#  line to 'ssl' for a ssl socket or 'tls' for a tls socket 
#  (without the quotes) Don't forget to set the SMTP port correctly! 
#  (usually 465 for ssmtp) Some servers may care which one you use but I
#  don't have a ssmtp setup to test with at the moment.

smtp_ssl=false

#  Hastymail uses the hostname used to access the hastymail web pages as
#  the name passed to the SMTP server when negotiating a connection. This
#  name could be different in the case of virtual hosting so you can override
#  the default behavior by supplying the hostname you want to use here.

smtp_helo_name=false



#######################################################################
######################## Hastymail Settings ###########################
#######################################################################

#  Settings storage system.  Use this option to define the storage method
#  you wish to use for your user settings.  Valid options are currently
#  db, or file.

settings_storage=file


#  Location to create and save user settings files. User setting files
#  are saved as plain text files with name=value pairs, one per line.
#  The files are named username.settings, where username is the users
#  imap login name in lowercase. Be sure to include the trailing hierarchy
#  delimiter!

settings_dir=/var/hastymail/settings/


#  If you are setting settings_storage to db, you must configure the
#  following setting.  Details on the parameters and formats can be
#  found on the PHP PEAR documentation at:
#    http://pear.php.net/manual/en/package.database.db.intro-dsn.php

settings_dbdsn=mysql://user:pass@localhost/hasty_prefs

#  Set the name of the table used to store the users settings here.

settings_dbtable=hm_prefs

#  Set the field name used to store the username here.

settings_table_user=username

#  Set the field name used to store the settings name here.

settings_table_key=settings_key

#  Set the field name used to store the settings data here.

settings_table_data=settings_data


#  Contact Storage Information
#
#  Storage types currently supported are file, and db.  The default is
#  file.

contacts_storage=file

#  Contacts Database DSN

contacts_dbdsn=mysql://user:pass@localhost/hasty_prefs

#  Contacts Table

contacts_dbtable=hasty_contacts

#  Contacts table user field

contacts_dbuserfld=username

#  Contacts table name field

contacts_dbcontactfld=contact_name

#  Contacts table data field

contacts_dbdatafld=contact_data


#  One of the weaknesses in PHP's cookie-less session setup is that if 
#  someone "steals" your session id they may be able to craft a URL to
#  access your hastymail account. Lots of checks are in place to keep this
#  from happening but by setting this option to true an extra precaution is
#  taken by randomizing the session id on each page load. The downside is that
#  the back button does not work. If you want the most in security and your
#  users don't mind being logged out if they hit 'back' then set this to true.
#
#  NOTE: There is a bug in PHP 4.1.0 -> 4.1.2 that does not allow a PHP script 
#      to redifine the session id in this manner. See this bug report for more:
#      http://bugs.php.net/bug.php?id=13834.
#      
#  NOTE: We have had reports of people getting logged out at seemingly random
#      times with this option and have been unable to track down the cause.

dynamic_sessionid=false

#  Hastymail does not use cookies for sessions, so no cookie support is required
#  in your web browser for Hastymail to work. If you want however you can use
#  an additional cookie check which contains a random value generated on each page
#  load. This value is NOT the session id. This adds another layer of security to
#  your hastymail account. If the value in the user's cookie does not match the one
#  stored in the session then the user will be logged out.

cookie_check=false

#  This option will add a hidden Iframe to each page that restarts your 
#  PHP session every 5 minutes. The default inactivity timeout for PHP
#  sessions is ~20 minutes. If not using this option users will get logged
#  out if inactive too long.

iframe=false

#  The Maximum upload size for adding attachments. This does NOT override
#  the upload_max_filesize value in your php.ini. It only sets the value
#  of MAX_FILE_SIZE in the compose page HTML. The default is the same as the
#  php default for upload_max_filesize, 2097152 bytes.

max_file_size=2097152

#  Hastymail can log user access times and locations on login and logout
#  by setting log_users to true. You must also supply a filename with absolute
#  path to the log file location. Remember this log file (and its parent 
#  directory) must be writeable by the user that the web server runs as.
#  You must create this file and be sure to adjust its permissions/ownership
#  to be writeable by the web server software.

log_users=false
log_path=/var/hastymail/settings/hm_log

#  In order to make it easier to troubleshoot setup problems Hastymail comes
#  with a login_debug option. When set to 'true' this option will stop the 
#  execution of Hastymail and dump IMAP connection information out to the
#  screeni on an attempted login.

login_debug=false

#  Setting this to true will redirect users to a https connection before 
#  logging in, even if they go to a normal http address for the login page.

force_ssl=true

#  The default page displayed after logging out can be changed by putting a full
#  url (with the http:// part) here.

signout_url=

#  Using the following setting the HTML title of Hastymail's pages can be
#  changed to a custom string. This also shows up as the heading on the 
#  login page

page_title=Hastymail 1.5-CVS

#  To supply a custom banner image or text on your login page put the image
#  in the hastymail/images directory and put the image name here. Or if you
#  want to use your own custom html or text string make its value the text
#  you want to display. If not set or set to false then no image or text will
#  be displayed. Set the banner type to either image or text for the type of
#  banner you want to use.

login_banner=false
banner_type=image

#  Hastymail can use a default language setting for all users. Users can select
#  their own langauge setting from the options page, but this setting will be
#  the default otherwise. en_US is used if not set. The available language
#   options are:
#       cs_CZ  Czech
#       de_DE  German
#       en_US  English
#       es_ES  Spanish
#       fi_FI  Finnish
#       fr_FR  French
#       hu_HU  Hungarian
#       it_IT  Italian
#       nl_NL  Dutch

default_lang=en_US

#  If you have IMAP support built in to PHP then you can set the following to
#  true to get proper utf7 decoding of mailbox names. 

utf7_decode_folder=false

#  IDNA defines a way to convert domain names with non-ascii characters into
#  DNS safe ascii versions using a conversion method called punycode. Change
#  this to true to do IDNA conversion on outgoing email addresses. You cannot
#  use this mode if you disable utf8 mode above.

idna_convert=false

#  You can choose from any of the style sheet themes in the hastymail/themes
#  directory to use as the sitewide default theme. This will effect the login
#  page and any user who has not selected his/her own theme setting

default_theme=default.css

#  Hastymail can autocreate special folders the first time a user logs in.
#  The special folders are sent, trash, and drafts. If these are commented
#  out or left blank they will not be created.

autocreate_sent=
autocreate_drafts=
autocreate_trash=


#  Special folders (sent|drafts|trash) can be "locked" by setting this value
#  to true. This will make it impossible for users to disable there functionality
#  or to remove the folders

lock_special_folders=false


#  By default hastymail displays first level subfolders of the INBOX at the
#  same level of INBOX, because many IMAP servers default to this type of
#  configuration. Any newly created folder will also be placed in the INBOX.
#  To display folders at there actual location and to allow users to create
#  folders outside of INBOX change the following to true

allow_root_folders=false

 
#  Hastymail has its own rc4 based encryption function to encrypt user passwords
#  when storing them in the PHP session. To use the PHP mcrypt support, set the
#  following option to true.

use_mcrypt=false

#  Select the type of encryption to use for the above mcrypt support. The mcrypt
#  PHP support in Debian GNU/Linux unstable contains these ciphers:
#
#    cast-128 cast-128 gost gost rijndael-128 rijndael-128 twofish twofish
#    arcfour arcfour cast-256 cast-256 loki97 loki97 rijndael-192 rijndael-192
#    saferplus saferplus wake wake blowfish-compat blowfish-compat des des
#    panama panama rijndael-256 rijndael-256 serpent serpent xtea xtea blowfish
#    blowfish enigma enigma rc2 rc2 tripledes tripledes 

mcrypt_cipher=blowfish

#  Set the following setting to true to set a received header on outgoing mail
#  that displays the IP address of the client who sent the message
#  (like an x-originating-ip header)

ip_header=false

#  Hastymail uses a default X-Mailer header of Hastymail followed by the version
#  number. You can override that here with your own custom X-Mailer header. If
#  left blank, commented out, or set to false the default is used. To have NO
#  X-Mailer header in outgoing messages set to "none". You can incorporate the
#  hastymail version number by using the $VERSION keyword. (hastymail $VERSION)

xmailer_header=

#  Hastymail autodetects text and small screen browsers and jumps to simple mode
#  when a user logs in with a browser of this type, regardless of the value of
#  the user's simple mode setting. To disable this ability set this to true.

no_auto_simplify=false

#  Text browsers work well with simple mode, but palm devices with limited screen
#  space end up being cluttered. Hastymail will autodetect plam based browsers and
#  limit the display to only the essential functions to read and respond to messages
#  by jumping to "palm mode". To disable this ability set the following to true

no_palm_mode=false

#  All accounts can be set to use simple mode by default by setting this to true

always_simplify=false

#  By default Hastymail users can create as many "profiles" as they like. Each
#  profile contains a reply-to address, name and signature. Profile editing can
#  be disabled site-wide by setting this value to true, in which case users
#  can add a name and signature to the default profile but thats it.

disable_profiles=false

#  Hastymail has a "bounce message" feature that sends a fake SMTP failure
#  notice to the sender of a message indicating that the destination user
#  does not exist. This option is disabled by default. To enalbe change the
#  following to true.

enable_bounce_option=false

#  The following setting will add a "redirect" option to the message view allowing
#  users to redirect a message unaltered to another address, including the message
#  headers. This option is disable by default. Change the value to true to enable

enable_redirect_option=false

#  We try to support as many different browsers as possible without
#  special modification, but Netscape 4.x browsers fall through the gaps.
#  There are several places in the code with Netscape 4.x workarounds that
#  are triggered by a Netscape 4.x user agent string. To enable those set
#  the following to true

enable_nn4_workarounds=false

#  This setting limits the amount of IMAP folders hastymail will display
#  per user (per namespace)

max_folders=500

#  Because there are so many different ways to setup webserver software,
#  and so many different types of webserver software it can be tricky for
#  hastymail to determine the correct host name of the server to build URLS
#  with. The logic that build the URLs for hastymail works most of the time
#  however you can override that here by defining your web server name with
#  the following option. Leave this blank to let hastymail autodetect the
#  correct name.

webserver_name=

#  Hastymail by default uses the HTTP_HOST value to build URLs. For some
#  web server software the SERVER_NAME value is required instead of the
#  HTTP_HOST value. If hastymail does not correctly build URLs and
#  you are not using the Apache web server try changing this value to true.

use_server_name=false

#  Most typical IMAP setups use only one namespace, however some sites
#  have multiple namespaces available to their users. this option allows
#  users to add namespaces to their folder list so they can then access
#  them. This does not allow a user to CREATE a namespace, only to access
#  existing allowed namespaces. This is disabled by default.

allow_alt_namespace=false 

#  Hastymail comes with a default template set, and a set of templates
#  for simple mode. Other template sets will be available in the future.
#  To define the default template set for hastymail select it here. If
#  unset or blank the default set will be used.
#  Available templates are:
#       default
#       simple

template_set=default

#  Hastymail will cache folder sort order and save that information in the PHP
#  session for as long as possible. After accessing large folders the cache can
#  become bloated and slow down the interface. The following two settings control
#  how large the cache can become, and how small to shrink it to when it excedes
#  the maximum. The higher these numbers the more Hastymail will cache sort informaiton
#  resulting in larger PHP session files but less IMAP traffic. Lowering the numbers
#  will force hastymail to only use a small cache keeping the PHP session smaller
#  but requesting more informaiton from the IMAP server instead. The following
#  defaults (6000 and 3000) work well for my production Courier system.

folder_cache_max=6000
folder_cache_min=3000

#  The "new mail" page of hastymail allows users to set a time limit for the page
#  to refresh. The allowed times are all between 1 and 30 minutes. To limit users
#  to only one time or no automatic refresh set this to the refresh in minutes you
#  want to allow. Leave blank for the default refresh options

refresh_limit=

#  Hastymail has built in spell checking capability. This requires the pspell
#  module to be compiled with your hastymail build as well as the supporting
#  aspell and dictionary packages. To enable the spell check option set the
#  following to true

enable_spellcheck=false

##################################################################
######################## LDAP SETTINGS ###########################
##################################################################

#  The following settings allow users to access addresses in an ldap 
#  database. Hastymail binds anonymously to read in the addresses unless
#  the ldap_auth setting is set to true. No write access is available at
#  this time.

#  The LDAP server hostname or ip address

ldap_server=

# Use LDAP over tls/ssl by setting this to true

ldap_ssl=false

#  The LDAP server port to connect to

ldap_port=389

#  The LDAP server base DN

ldap_base_dn=dc=yourdn, dc=com

#  Optional value to narrow the ldap search to a portion of the LDAP tree
#  otherwise cn=* is used

ldap_search_term=objectclass=person

#  Hastymail defaults to an aononymous ldap connection. Set the following
#  option to true to have Hastymail attempt to bind to the ldap server
#  with the users IMAP login username and password

ldap_auth=false

#  Some LDAP dbs are quite large and the default behavior of loading them all on
#  the compose page can be BAD so set this to true and LDAP contacts will only
#  be accessed when using the search function on the compose page

ldap_search_only=false