<?xml version="1.0" encoding="ISO-8859-1"?>
<!--

 V-webmail configuration file

 WARNING:

 DO NOT ALTER THIS FILE! Make a copy called local.config.xml and modify that instead.

 About this file
 ===============

 This file is a configuration file for controlling all parameters
 of this application. Once read it is cached to prevent unnecessary re-reading.
 The cached copy is kept in the V-webmail tmp dir, whereever that may be located.

 If this file is changed and thus the last modified time changed, it will be
 re-read. If the last modified time does not change, it will not be re-read.

-->

<v-webmail>
  <configuration>

    <!--
    ====================================================================================================
     This part is used to control a few global parameters of this application.
    ====================================================================================================
    -->

    <!--

    default_lang
    ============
    This is the default language file to use. If you want to set it to something other
    than english, check first the lang/ directory to see what language files are available.
    Then pick a code (the two/three letters in the middle of the files name, eg en, de, id, big5)
    and set it here.

    config_checks
    =============
    This flag determines whether configuration checks are performed when the login page is displayed.
    You should leave this turned On until you are confident that V-webmail is running ok. Various
    checks are performed, eg permissions on directories, correct PHP versions and imap extension
    availability.

    send_version_header
    ===================
    This determines whether V-webmail will send an X-Powered-By HTTP header
    with the response.  The default is 'true', which shouldn't be a problem, but
    some may prefer to turn it off as one extra security-through-obscurity measure.

    prefs_storage
    =============
    Preferences storage
    This option determines how your preferences are stored. The default option is using files. The
    other options are currently MySQL (mysql) or Postgres (postgres).

    c-client
    ========
    If you're using a recent version of PHP (4.1.0+) and also the 2001 version of the
    c-client library

    servers_strict
    ==============
    This setting determines, whether the users of V-webmail will be limited to the server
    settings in this file or not.

    -->

    <general>

      <default_lang>en</default_lang>
      <config_checks       type="boolean">false</config_checks>
      <send_version_header type="boolean">false</send_version_header>

      <prefs_storage>
        <type>file</type>
        <hostname></hostname>
        <username></username>
        <password></password>
        <database></database>
        <table></table>
      </prefs_storage>

      <c-client>2001</c-client>
      <servers_strict      type="boolean">true</servers_strict>

    </general>


    <!--
    ====================================================================================================
     This part is used to configure the defined virtual hosts and their behaviour.
    ====================================================================================================
    -->

    <!--

    description
    ===========
    This is the default host. If a particular host/port combination does not match any of the
    defined virtual hosts, this one will be used. Also, any settings omitted from other vhosts
    will be taken from the default. Do not change the name of this host.

    allow_html_email
    ================
    Whether to allow HTML images to be viewed or not. This may or may not introduce security
    issues depending on whether you decide to strip unsafe tags or not. If turned off, the
    text version will be displayed.

    strip_unsafe_tags
    =================
    Whether to strip unsafe html tags from html emails before displaying.

    remove_external_images
    ======================
    Whether to remove external images from html emails. These can be used for tracking purposes,
    so it's wise to remove them.

    add_username_server
    ===================
    Whether to add username and servername to outgoing email. If your users aren't entirely
    trustworthy, this can be a useful addition for spam tracking. It does of course bring
    into question the security of adding server/username to an outgoing email, hence it is
    disabled by default.

    allow_changeable_email
    ======================
    Whether to allow the user to change their email address in preferences and the compose
    page. If you disable this the email address will be built from <username>@<server>, so
    this combination should be valid.

    username_is_email
    =================
    Some pop3/imap servers use full email addresses (eg user@domain.com) as the username. If
    this is the case for you and you have the above option turned OFF, v-webmail needs to know
    that the username is the full email address. otherwise it will be constructed incorrectly.

    http_compression
    ================
    Whether to use HTTP compression or not. This can cause redirection problems so it defaults
    to Off. If you don't experience these issues (blank screen, hitting refresh then redirects
    correctly) with it on, that's fine.

    cache_email_list
    ================
    Whether to cache email list summaries. This uses the users' session to store the information.
    If you have you PHP session data directory mounted on a ramdisk or tmpfs partition (for example)
    this option can provide a significant speed increase.

    refresh_email_list
    ==================
    Whether to clear the cache when the number of messages changes. Having this on avoids most instances
    of stale content being shown.

    cache_email_list
    ================
    Whether to cache the subscribed folder list or not.

    add_ip_header
    =============
    Whether to add an X-Originating-IP header to outgoing emails.

    outgoing_append
    ===============
    Text file to append to outgoing emails. This file must be in the same place as this file (ie the
    config/ directory)

    x_mailer
    ========
    Optional X-Mailer header string to add to outgoing mail. If this is left blank the V-webmail name and
    version will be used instead.

    allow_identities
    ================
    Whether or not to allow the use of identities or not. If you've set allow_changeable_email to 'false', then
    this setting will have no effect, and identities will be disabled.

    allow_fetchmail
    ===============
    Whether or not to allow the use of remote mail account polling. This requires the account to be IMAP,
    and allows users to setup any number of remote POP3/IMAP accounts to poll and download mail from.

    allow_blacklists
    ================
    Whether or not to allow the use of blacklists. This requires the account to be IMAP, as it uses search
    facilities to work.

    templates
    =========
    This defines what template sets are available to the virtual host. It should be a comma
    seperated list of "<directory>:<description>" (without quotes). If no description is
    given a check will be made for "description.txt" in the template folder. If this is present
    and non empty, the contents will be used. Failing this, the directory name will be used.

    template_set
    ============
    What the default template set is. The folder element should contain the corresponding dirname.
    This does not have to be a "full" set of templates, ie it could be one with simply a header/footer.

    -->

    <hostinfo>

      <description>TBN Family Media Partners' Mail</description>
      <allow_html_email       type="boolean">true</allow_html_email>
      <strip_unsafe_tags      type="boolean">true</strip_unsafe_tags>
      <remove_external_images type="boolean">true</remove_external_images>
      <add_username_server    type="boolean">false</add_username_server>
      <allow_changeable_email type="boolean">false</allow_changeable_email>
      <username_is_email      type="boolean">true</username_is_email>
      <http_compression       type="boolean">false</http_compression>

      <cache_email_list       type="boolean">true</cache_email_list>
      <refresh_email_list     type="boolean">true</refresh_email_list>
      <cache_email_folders    type="boolean">true</cache_email_folders>

      <add_ip_header          type="boolean">false</add_ip_header>

      <outgoing_append>v-webmail.txt</outgoing_append>
      <x_mailer></x_mailer>

      <allow_identities       type="boolean">true</allow_identities>
      <allow_fetchmail        type="boolean">true</allow_fetchmail>
      <allow_blacklists       type="boolean">true</allow_blacklists>
      <allow_quicksearch      type="boolean">true</allow_quicksearch>

      <templates>

        <template_set multiple="true">
          <description>TBN Family Media Partners' Mail</description>
          <folder>v-webmail</folder>
        </template_set>

        <default>v-webmail</default>

      </templates>

    </hostinfo>


    <!--
    ====================================================================================================
     This part is used if you want to only allow access to a certain set of servers.
     For example if you have three servers, and you only want your users to use these
     three, you would specify them here and set servers_strict to 'true'. If you're
     not bothered then you can set servers_strict to 'false', however the default settings
     for the login page server/type/port will be taken from the first set of server
     settings (the "Default Server"). It's therefore very important that you have at
     least one set of server settings in here.
    ====================================================================================================
     -->

    <!--

    hostname
    ========
    This is the IP address or hostname (preferably) of the IMAP/POP3 server you're connecting to.

    port
    ====
    This is the port of the IMAP/POP3 server you're connecting to. It's usually 143 for IMAP and
    110 for POP3.

    type
    ====
    This is the type of protocol to use. This can be one of the following:

    imap                     - Regular IMAP server
    imap/notls               - If you're using a recent version of PHP (4.1.0+) and also
                               the 2001 version of the c-client library, then if you're IMAP
                               server advertises SSL support it will be used if you set the
                               protocol to "imap". If this is the case (an example is the
                               bundled IMAP/PHP RPMS with RedHat Linux 7.3), then you should
                               use this option
    imap/ssl                 - IMAP over SSL where the server has a *valid* SSL certificate
    imap/ssl/novalidate-cert - IMAP over SSL where the server has a self-signed certificate
    pop3                     - Regular POP3 server
    pop3/notls               - See imap/notls
    pop3/ssl                 - POP3 over SSL where the server has a *valid* SSL certificate
    pop3/ssl/novalidate-cert - POP3 over SSL where the server has a self-signed certificate

    capabilities
    ============
    Overwrite default IMAP capabilities, like folders and search.

    "folders search"           - Default subfolders visible and search capability.
    "search"                   - Search only.
    ""                         - No subfolders and no search.

    folder_prefix
    =============
    If you're using IMAP then you should set this to the folder prefix appropriate for your server.
    With UW-Imap this is usually "mail/" or "Mail/", whilst with Courier or Cyrus this is usually
    "INBOX."

    domain
    ======
    When using allow_changeable_email set to 'false', this option will be used to build the email address
    instead of the mail server hostname. Eg if you have a mail server at mail.example.com but your
    email addresses are of the form username@example.com (and not username@mail.example.com) then you
    would enter "example.com" here.

    smtp
    ====
    This is your smtp server. It can be the same as or different to your imap/pop3 server. If not
    specified the application will use built in PHP functionality to send mail, usually meaning
    a sendmail binary (eg. /usr/sbin/sendmail) will be required and correctly configured in your
    php.ini files.

    helo
    ====
    This setting determines who V-webmail says it is when connecting to the SMTP server. If not specified
    then the current SERVER_NAME will be used, ie the server name displayed in the browsers address bar.

    authentication
    ==============
    This setting determines whether SMTP authentication will be used or not when connecting to the smtp
    server. Should be set to either "On" or "Off". If you use this setting, your server MUST support
    basic authentication or the app WILL NOT send email!

    use_uids
    ========
    Some performance options.

    o use_uids  Determines whether to use the UID for referencing messages, or the message number. This
                can increase performance, especially over remote links, or with large mailboxes. The trade
                off is that it's theoretically possible to click a message in the list page, and be presented
                with a different message  as message numbers are not unique to a message and can change
                between connections. If this change occurs then caching can also affect what is presented if
                for example, you delete a message and another message is added to your mailbox at the same
                time. This occurs because the number of messages hasn't changed, and thus the cache isn't
                cleared.

    o extended_listing  Determines whether extended information is presented in the mailbox listing. This includes
                        importance detection and attachment detection. Using this means all of the headers of the
                        message headers are requested by the application, so turning it off can significantly
                        improve performance, particularly on large listings.

    -->

    <servers>

      <server multiple="true">

        <description>TBN Family Media Partners' Mail</description>
        <hostname>70.85.248.162</hostname>
        <port>110</port>
        <type>pop3</type>
        <capabilities>folders search</capabilities>
        <folder_prefix></folder_prefix>
        <domain>partner.familykenya.com</domain>

        <smtp>
          <enabled type="boolean">false</enabled>
          <hostname></hostname>

          <!--
          This is the port for the smtp server. If not specified port 25 will be used.
          -->
          <port type="integer">25</port>
          <helo></helo>

          <authentication>
            <enabled type="boolean">true</enabled>

            <!--
            The username and password to be used for smtp authentication. If left blank and smtp_auth is set to
            'true' then the username/password used to login will be used for smtp authentication.
            -->
            <username></username>
            <password></password>
          </authentication>
        </smtp>

        <use_uids         type="boolean">true</use_uids>
        <extended_listing type="boolean">true</extended_listing>

      </server>

    </servers>

  </configuration>


  <!-- Available translations -->
  <languages>
    <language multiple="true">
      <filename>lang.big5.php</filename>
      <description>Chinese (big5)</description>
    </language>

    <language multiple="true">
      <filename>lang.br.php</filename>
      <description>Portugu&amp;ecirc;s Brasileiro</description>
    </language>

    <language multiple="true">
      <filename>lang.de.php</filename>
      <description>Deutsch</description>
    </language>

    <language multiple="true">
      <filename>lang.es.php</filename>
      <description>Espa&amp;ntilde;ol</description>
    </language>

    <language multiple="true">
      <filename></filename>
      <description>English</description>
    </language>

    <language multiple="true">
      <filename>lang.fr.php</filename>
      <description>Fran&amp;ccedil;ais</description>
    </language>

    <language multiple="true">
      <filename>lang.hu.php</filename>
      <description>Hungarian</description>
    </language>

    <language multiple="true">
      <filename>lang.id.php</filename>
      <description>Indonesian</description>
    </language>

    <language multiple="true">
      <filename>lang.it.php</filename>
      <description>Italiano</description>
    </language>

    <language multiple="true">
      <filename>lang.mn.php</filename>
      <description>Mongolian</description>
    </language>

    <language multiple="true">
      <filename>lang.nl.php</filename>
      <description>Nederlands</description>
    </language>

    <language multiple="true">
      <filename>lang.pl.php</filename>
      <description>Polski</description>
    </language>

    <language multiple="true">
      <filename>lang.ru.php</filename>
      <description>Russian</description>
    </language>

    <language multiple="true">
      <filename>lang.se.php</filename>
      <description>Svensk</description>
    </language>
  </languages>

</v-webmail>