<?xml version="1.0"?>
<!-- $Horde: horde/config/conf.xml,v 1.74.2.41 2006/08/04 17:13:25 jan Exp $ -->
<configuration>
 <configtab name="general" desc="General">
  <configheader>General Horde Settings</configheader>
  <configphp name="debug_level" desc="The value to set
  error_reporting() to.
  See http://www.php.net/manual/function.error-reporting.php for more
  information and possible values.">E_ALL &amp; ~E_NOTICE</configphp>
  <configinteger name="max_exec_time" desc="If we need to perform a long
  operation, what should we set max_execution_time to (in seconds)? 0 means no
  limit; however, a value of 0 will cause a warning if you are running in safe
  mode. See http://www.php.net/manual/function.set-time-limit.php for more
  information.">0</configinteger>
  <configenum name="use_ssl" quote="false" desc="Determines how we generate
  full URLs (for location headers and such).&lt;br /&gt;NOTE: If you choose to
  always generate https URLs, you MUST hardcode the correct HTTPS port number
  in the server port setting below. Otherwise Horde will be unable to generate
  correct HTTPS URLs when a user tries to access Horde via a non-HTTPS port.">2
   <values>
    <value desc="Assume that we are not using SSL and never generate https URLs.">0</value>
    <value desc="Assume that we are using SSL and always generate https URLs.">1</value>
    <value desc="Attempt to auto-detect, and generate URLs appropriately">2</value>
    <value desc="Assume that we are not using SSL and generate https URLs only
    for login.">3</value>
   </values>
  </configenum>
  <configsection name="server">
   <configphp name="name" desc="What server name should we use? You'll probably
   know if you need to change this default; only in situations where you need to
   override what Apache thinks the server name
   is.">$_SERVER['SERVER_NAME']</configphp>
   <configphp name="port" desc="What port number is the webserver running on?
   Again, you shouldn't need to change the default, and you probably know it if
   you do. The exception is if you have chosen to always generate https URLs, as
   described above.">$_SERVER['SERVER_PORT']</configphp>
  </configsection>
  <configboolean name="compress_pages" desc="If this option is set to true, and
  you have the php zlib extension, pages over a certain size will be compressed
  and sent to the browser as gzip-encoded data in order to save
  bandwidth. There is a CPU-usage penalty to pay for this, but the decrease in
  page size can be dramatic (70k to under 10k for a full mailbox page), and is
  more than worth it over anything but an extremely fast
  link.">true</configboolean>
  <configinteger name="umask" octal="true" desc="What umask should we run with? This will affect the permissions on any temporary files that are created. This value is an integer.">077</configinteger>
  <configstring name="tmpdir" required="false" desc="If you want to use a
  temporary directory other than the system default or the one specified in
  php's upload_tmp_dir value, enter it here."/>
  <configsection name="session">
   <configstring name="name" desc="What name should we use for the session that
   Horde apps share? If you want to share sessions with other applications on
   your webserver, you will need to make sure that they are using the same
   session name.  Note: Session names must consist of only alphanumeric
   characters.">Horde</configstring>
   <configboolean name="use_only_cookies" desc="Should we only allow session
   information to be stored in a session cookie and not be passed by URL (GET)
   parameters? This is on by default because passing session information in
   the URL is a security risk. Consider carefully before turning it off.">
   true</configboolean>
   <configstring name="cache_limiter" desc="What caching level should we use
   for the session? DO NOT CHANGE THIS UNLESS YOU &lt;strong&gt;REALLY&lt;/strong&gt; KNOW
   WHAT YOU ARE DOING. Setting this to anything other than 'nocache' will almost
   certainly result in severely broken script behavior.">nocache</configstring>
   <configinteger name="timeout" desc="How long should sessions last (in seconds)? 0 means
   that the session ends when the user closes their browser. Set other values
   with care - see
   http://www.php.net/manual/en/function.session-set-cookie-params.php.">0</configinteger>
  </configsection>
  <configsection name="cookie">
   <configphp name="domain" desc="What domain should we set cookies from? If
   you have a cluster that needs to share cookies, this might be '.example.com'
   - the leading '.' is important. Most likely, though, you won't have to change
   the default.">$_SERVER['SERVER_NAME']</configphp>
   <configstring name="path" desc="What path should we set cookies to? This
   should match where Horde is on your webserver - if it is at /horde, then this
   should be '/horde'. If Horde is installed as the document root, then this
   needs to be '/' - NOT ''.&lt;br /&gt;&lt;strong&gt;BUT&lt;/strong&gt;, if IE will be
   used to access Horde modules, you should read this first (discussing issues
   with IE's Content Advisor):
   http://lists.horde.org/archives/imp/Week-of-Mon-20030113/029149.html">/horde</configstring>
  </configsection>
 </configtab>

 <configtab name="sql" desc="Database">
  <configsection name="sql">
   <configheader>Horde Database Settings</configheader>
   <configdescription>&lt;strong&gt;NOTE:&lt;/strong&gt; These are only the
   &lt;em&gt;default&lt;/em&gt; values for any database driven backends. You
   still need to configure the different systems like "Preferences" or
   "DataTree" to actually &lt;em&gt;use&lt;/em&gt; a database
   backend.</configdescription>
   <configsql switchname="phptype" baseconfig="true" />
  </configsection>
 </configtab>

 <configtab name="auth" desc="Authentication">
  <configsection name="auth">
   <configheader>Horde Authentication</configheader>
   <configlist name="admins" desc="Which users should be treated as
   administrators (root, super-user) by Horde?" required="false"/>
   <configboolean name="checkip" desc="Should we always store and validate
   the IP address of the client (as seen by the web server) in the session?
   Doing so will help increase security by ensuring that an attacker from
   another host cannot try to hijack the session.">true</configboolean>
   <configboolean name="checkbrowser" desc="Should we always store and validate
   the browser string of the client (as seen by the web server) in the session?
   Doing so will help increase security by ensuring that an attacker from
   another host cannot try to hijack the session.">true</configboolean>
   <configstring name="alternate_login" desc="If this is not false, it is
   assumed to be the URL of an alternate login screen which will be used in
   place of horde's default login screen.">false</configstring>
   <configstring name="redirect_on_logout" desc="If this is not false, it is
   assumed to be the URL of an alternate logout page which users will be sent
   to when they log out.">false</configstring>
   <configswitch name="driver" desc="What backend should we use for
   authenticating users to Horde?">

    <case name="application" desc="Let a Horde application handle
    authentication">
     <configsection name="params">
      <configenum name="app" desc="The application which is providing
      authentication">imp
       <values>
        <configspecial name="list-horde-apps"/>
       </values>
      </configenum>
     </configsection>
    </case>

    <case name="auto" desc="Automatic authentication as a certain user">
     <configsection name="params">
      <configstring name="username" desc="The username to authenticate everyone as">horde_user</configstring>
      <configstring name="password" desc="The password to use for the user's credentials" required="false"/>
      <configboolean name="requestuser" desc="Allow username to be passed by GET, POST or cookie?">false</configboolean>
     </configsection>
    </case>

    <case name="composite" desc="Composite authentication">
     <configdescription>
      This authentication driver needs manual configuration not possible
      through this interface. Add the appropriate configuration lines at the
      end of the generated configuration file.
     </configdescription>
    </case>

    <case name="ftp" desc="FTP authentication">
     <configsection name="params">
      <configstring name="hostspec" desc="The hostname or IP address of the FTP
      server">localhost</configstring>
      <configinteger name="port" desc="The server port to connect
      to">21</configinteger>
     </configsection>
    </case>

    <case name="http" desc="HTTP (Basic Authentication/.htpasswd)
    authentication">
     <configsection name="params">
      <configstring name="htpasswd_file" required="false" desc="The location of
      the htpasswd file containing the user names and passwords"/>
      <configenum name="encryption" desc="Specifies what kind of passwords are
      in the htpasswd file">des
       <values>
        <value>aprmd5</value>
        <value>crypt</value>
        <value>crypt-blowfish</value>
        <value>crypt-des</value>
        <value>crypt-md5</value>
        <value>md5-base64</value>
        <value>md5-hex</value>
        <value>plain</value>
        <value>sha</value>
        <value>smd5</value>
        <value>ssha</value>
       </values>
      </configenum>
     </configsection>
    </case>

    <case name="imap" desc="IMAP authentication">
     <configsection name="params">
      <configswitch name="imapconfig" desc="Configuration type">
       <case name="dsn" desc="DSN">
        <configstring name="dsn" desc="The full IMAP connection
        string">{localhost:143/imap/notls}</configstring>
       </case>
       <case name="separate" desc="Separate values">
        <configstring name="hostspec" desc="The hostname or IP address of the
        server">localhost</configstring>
        <configinteger name="port" desc="The server port to which we will
        connect. IMAP is generally 143, while IMAP-SSL is generally
        993.">143</configinteger>
        <configenum name="protocol" desc="The connection protocol">imap/notls
         <values>
          <value>imap</value>
          <value>imap/novalidate-cert</value>
          <value>imap/notls</value>
          <value>imap/tls</value>
          <value>imap/tls/novalidate-cert</value>
          <value>imap/ssl</value>
          <value>imap/ssl/novalidate-cert</value>
         </values>
        </configenum>
       </case>
      </configswitch>
     </configsection>
    </case>

    <case name="imsp" desc="IMSP server authentication" />

    <case name="ipbasic" desc="Simple IP based authentication">
     <configsection name="params">
      <configlist name="blocks" desc="A list of CIDR masks which are allowed
      access"/>
     </configsection>
    </case>

    <case name="ipmap" desc="IP based authentication">
     <configsection name="params">
      <configlist name="blocks" desc="A list of CIDR masks which are allowed
      access"/>
     </configsection>
    </case>

    <case name="krb5" desc="Kerberos authentication"/>

    <case name="kolab" desc="Kolab authentication">
     <configsection name="params">
      <configboolean name="login_block" desc="Should the login be blocked after a given number of failed logins?">
      false</configboolean>
      <configinteger name="login_block_count" desc="After howmany failed logins the login should be blocked?">3</configinteger>
      <configinteger name="login_block_time" desc="Howmany minutes the login should be blocked?">5</configinteger>
     </configsection>
    </case>

    <case name="ldap" desc="LDAP authentication">
     <configsection name="params">
      <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
      <configstring name="basedn" desc="The base DN for the LDAP server"/>
      <configstring name="binddn" required="false" desc="The DN used to bind to the LDAP server"/>
      <configstring name="password" required="false" desc="The password used to bind to the LDAP server"/>
      <configenum name="version" desc="LDAP Protocol Version">3
       <values>
        <value desc="LDAPv2 (Deprecated)">2</value>
        <value desc="LDAPv3">3</value>
       </values>
      </configenum>
      <configboolean name="ad" desc="Is this an AD server?">false</configboolean>
      <configstring name="uid" desc="The username search key (set to samaccountname for AD)"/>
      <configenum name="encryption" desc="Algorithm to encrypt passwords">md5-hex
       <values>
        <value desc="aprmd5">aprmd5</value>
        <value desc="crypt">crypt</value>
        <value desc="crypt-des">crypt-des</value>
        <value desc="crypt-md5">crypt-md5</value>
        <value desc="crypt-blowfish">crypt-blowfish</value>
        <value desc="md5-base64">md5-base64</value>
        <value desc="md5-hex">md5-hex</value>
        <value desc="msad">msad</value>
        <value desc="plain">plain</value>
        <value desc="ssha">ssha</value>
        <value desc="smd5">smd5</value>
       </values>
      </configenum>

      <configlist name="newuser_objectclass" desc="What objectclasses should a new user account be member of? These objectclasses should cover the cn,sn,userPassword attributes as well as the username search key">shadowAccount,inetOrgPerson</configlist>

      <configswitch name="filter_type" desc="How to specify a filter for the user lists">objectclass
       <case name="objectclass" desc="One or more objectclass filters">
        <configlist name="objectclass" desc="The objectclass filter used to search for users. Can be a single objectclass or a list."/>
       </case>
       <case name="free" desc="A complete LDAP filter expression">
        <configstring name="filter" desc="The LDAP RFC formatted filter used to search for users."/>
       </case>
      </configswitch>

      <configswitch name="password_expiration" desc="Enable the creating of accounts with expiring passwords? (Note: New users should have the shadowAccount objectclass)">no
       <case name="no" desc="no" />
       <case name="yes" desc="yes">
        <configstring name="minage" desc="After how many days may a password be changed again?">5</configstring>
        <configstring name="maxage" desc="How many days will a password remain valid?">30</configstring>
        <configstring name="warnage" desc="How many days before expirery should a user be warned?">5</configstring>
       </case>
      </configswitch>
     </configsection>
    </case>

    <case name="login" desc="Login (su) authentication">
     <configsection name="params">
      <configstring name="location" desc="Location of the su binary">/bin/su</configstring>
     </configsection>
    </case>

    <case name="mcal" desc="MCAL authentication">
     <configsection name="params">
      <configstring name="calendar" desc="The MCAL calendar name"/>
     </configsection>
    </case>

    <case name="pam" desc="PAM (Pluggable Authentication Modules) authentication">
     <configsection name="params">
      <configstring name="service" desc="The name of the PAM service to use when authenticating">php</configstring>
     </configsection>
    </case>

    <case name="passwd" desc="passwd file authentication">
     <configsection name="params">
      <configstring name="filename" desc="The passwd file to use">/etc/passwd</configstring>
      <configboolean name="lock" desc="Should we lock the passwd file?">false</configboolean>
     </configsection>
    </case>

    <case name="radius" desc="Radius authentication">
     <configsection name="params">
      <configstring name="host" desc="The RADIUS host to use (IP address or fully qualified hostname)">localhost</configstring>
      <configinteger name="port" required="false" desc="The port to use on the RADIUS server"/>
      <configenum name="method" desc="The RADIUS method to use for validating the request">PAP
       <values>
        <value desc="PAP">PAP</value>
        <value desc="CHAP_MD5 (not supported at the moment)">CHAP_MD5</value>
        <value desc="MSCHAPv1 (not supported at the moment)">MSCHAPv1</value>
        <value desc="MSCHAPv2 (not supported at the moment)">MSCHAPv2</value>
       </values>
      </configenum>
      <configstring name="nas" required="false" desc="The RADIUS NAS identifier to use." />
      <configstring name="secret" desc="The RADIUS shared secret string for the
      host. The RADIUS protocol ignores all but the leading 128 bytes of the
      shared secret."/>
      <configinteger name="retries" required="false" desc="The maximum number
      of repeated requests to make before giving up [3]"/>
      <configstring name="suffix" required="false" desc="The domain name to add
      to unqualified user names"/>
      <configinteger name="timeout" required="false" desc="The timeout for
      receiving replies from the server (in seconds) [3]"/>
     </configsection>
    </case>

    <case name="sasl" desc="SASL authentication">
     <configsection name="params">
      <configstring name="app" desc="The name of the authenticating
      application">horde</configstring>
      <configstring name="service" desc="The name of the SASL service to use
      when authenticating">php</configstring>
     </configsection>
    </case>

    <case name="smb" desc="SMB authentication">
     <configsection name="params">
      <configstring name="hostspec" desc="IP, DNS Name, or NetBios Name of the
      SMB server to authenticate with">localhost</configstring>
      <configstring name="domain" desc="The domain name to authenticate with"/>
      <configstring name="group" required="false" desc="Optional group name
      that the user must be a member of"/>
     </configsection>
    </case>

    <case name="sql" desc="SQL authentication">
     <configsection name="params">
      <configsql switchname="driverconfig" />
      <configstring name="table" required="false" desc="The name of the auth
      table in the database [horde_users]"/>
      <configstring name="username_field" required="false" desc="The name of the
      username field in the auth table [user_uid]"/>
      <configstring name="password_field" required="false" desc="The name of the
      password field in the auth table [user_pass]"/>
      <configstring name="soft_expiration_field" required="false" desc="The
      name of a field containing a UNIX timestamp.  When a user logs in after
      the specified time, if 'passwd' is installed, that user will be asked to
      change his or her password.  This feature is disabled by default."/>
      <configstring name="hard_expiration_field" required="false" desc="The
      name of a field containing a UNIX timestamp.  A user will not be able to
      log in after the specified time.  This feature is disabled by default."/>
      <configinteger name="soft_expiration_window" required="false"
      desc="This is how often, in days, the user must change his or her
      password.  When the user's password is updated, the &quot;soft&quot;
      expiration is set this many days in the future.  If not provided,
      the user's password will not expire by default."/>
      <configinteger name="hard_expiration_window" required="false" desc="The
      number of days in the grace period the user has to change his or her
      password after it has expired.  If not provided, the grace period will
      not expire."/>
      <configenum name="encryption" required="false" desc="The encryption to use
      to store the password in the table">md5-hex
       <values>
        <value>crypt</value>
        <value>crypt-blowfish</value>
        <value>crypt-des</value>
        <value>crypt-md5</value>
        <value>md5-base64</value>
        <value>md5-hex</value>
        <value>plain</value>
        <value>sha</value>
        <value>smd5</value>
        <value>ssha</value>
       </values>
      </configenum>
      <configboolean name="show_encryption" required="false" desc="Prepend the
      encryption in the password field?">false</configboolean>
     </configsection>
    </case>

    <case name="customsql" desc="SQL authentication w/custom-made queries">
     <configsection name="params">
      <configenum name="phptype" desc="The name of the database">mysql
       <values>
        <value desc="Microsoft SQL Server">mssql</value>
        <value desc="MySQL">mysql</value>
        <value desc="ODBC">odbc</value>
        <value desc="Oracle 8">oci8</value>
        <value desc="PostgreSQL">pgsql</value>
       </values>
      </configenum>
      <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
       <case name="unix" desc="UNIX Sockets">
        <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
       </case>
       <case name="tcp" desc="TCP/IP">
        <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
       </case>
      </configswitch>
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
      <configdescription>
       Some special tokens can be used in the sql query. They are replaced at
       the query stage:&lt;ul&gt;
       &lt;li&gt;"\L" will be replaced by the user's login&lt;/li&gt;
       &lt;li&gt;"\P" will be replaced by the user's password&lt;/li&gt;
       &lt;li&gt;"\O" will be replaced by the old user's login (required for
       update)&lt;/li&gt;&lt;/ul&gt;
       Eg: "SELECT * FROM users WHERE uid = \L AND passwd = \P AND billing =
       'paid'"
      </configdescription>
      <configstring name="query_auth" desc="Authenticate the user"/>
      <configstring name="query_add" desc="Add user"/>
      <configstring name="query_update" desc="Update user"/>
      <configstring name="query_remove" desc="Remove user"/>
      <configstring name="query_list" desc="List users"/>
      <configenum name="encryption" desc="The encryption to use to store the
      password in the table">md5-hex
       <values>
        <value>aprmd5</value>
        <value>crypt</value>
        <value>crypt-blowfish</value>
        <value>crypt-des</value>
        <value>crypt-md5</value>
        <value>md5-base64</value>
        <value>md5-hex</value>
        <value>plain</value>
        <value>sha</value>
        <value>smd5</value>
        <value>ssha</value>
       </values>
      </configenum>
      <configboolean name="show_encryption" desc="Prepend the encryption in the
      password field?">false</configboolean>
     </configsection>
    </case>

    <case name="cyrsql" desc="SQL implementation for the Cyrus IMAP server">
     <configsection name="params">
      <configstring name="cyradmin" desc="The username of the cyrus
      administrator"/>
      <configstring name="cyrpass" desc="The password for the cyrus
      administrator"/>
      <configstring name="imap_dsn" desc="The full IMAP DSN
      (i.e. {localhost:993/imap/ssl/novalidate-cert})"/>
      <configenum name="phptype" desc="The name of the database">mysql
       <values>
        <value desc="Microsoft SQL Server">mssql</value>
        <value desc="MySQL">mysql</value>
        <value desc="MySQL (mysqli)">mysqli</value>
        <value desc="ODBC">odbc</value>
        <value desc="Oracle 8">oci8</value>
        <value desc="PostgreSQL">pgsql</value>
       </values>
      </configenum>
      <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
       <case name="unix" desc="UNIX Sockets">
        <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
       </case>
       <case name="tcp" desc="TCP/IP">
        <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
       </case>
      </configswitch>
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we
      using?">horde</configstring>
      <configstring name="table" desc="The name of the auth table in the
      database">horde_users</configstring>
      <configstring name="username_field" desc="The name of the username field
      in the auth table">user_uid</configstring>
      <configstring name="password_field" desc="The name of the password field
      in the auth table">user_pass</configstring>
      <configstring name="domain_field" desc="If set to anything other than
      'none' this is used as field name where domain is
      stored">none</configstring>
      <configenum name="encryption" desc="The encryption to use to store the
      password in the table">md5-hex
       <values>
        <value>aprmd5</value>
        <value>crypt</value>
        <value>crypt-blowfish</value>
        <value>crypt-des</value>
        <value>crypt-md5</value>
        <value>md5-base64</value>
        <value>md5-hex</value>
        <value>plain</value>
        <value>sha</value>
        <value>smd5</value>
        <value>ssha</value>
       </values>
      </configenum>
      <configlist name="folders" required="false" desc="A list of folders to create under
      username"/>
      <configinteger name="quota" required="false" desc="The quota (in
      kilobytes) to grant on the mailbox"/>
      <configboolean name="unixhier" desc="The value of imapd.conf's
      unixhierarchysep setting. Check this if the value is true in
      imapd.conf.">false</configboolean>
     </configsection>
    </case>

    <case name="yahoo" desc="Yahoo! authentication"/>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="signup" desc="Sign Up">
  <configsection name="signup">
   <configheader>Horde Sign Up</configheader>
   <configswitch name="allow" desc="Allow non-registered users to register and
   provide a link on the login screen?">false
    <case name="true" desc="Yes">
     <configboolean name="approve" desc="Admin has to approve any user submitted
     registration requests? (WARNING: Setting to false would mean that every user
     who signs up would have automatic access to your horde system.)">true</configboolean>
     <configboolean name="preprocess" desc="Pass the user submitted information
     through the _horde_hook_signup_preprocess function in hooks.php before
     processing the request?">false</configboolean>
     <configboolean name="queue" desc="Pass the user submitted information
     through the _horde_hook_signup_queue function in hooks.php after processing
     the request but before actually queueing it?">false</configboolean>
    </case>
    <case name="false" desc="No" />
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="log" desc="Logging">
  <configsection name="log">
   <configheader>Horde Logging</configheader>
   <configswitch name="enabled" quote="false" desc="Should Horde log errors and other useful
   information?">true
    <case name="true" desc="Yes">
     <configenum name="priority" quote="false" desc="What level of messages
     should we log? Each level logs itself and all those that come before it:
     PEAR_LOG_ALERT would only log alerts and emergencies, but PEAR_LOG_DEBUG
     would log everything.">PEAR_LOG_NOTICE
      <values>
       <value desc="PEAR_LOG_EMERG">PEAR_LOG_EMERG</value>
       <value desc="PEAR_LOG_ALERT">PEAR_LOG_ALERT</value>
       <value desc="PEAR_LOG_CRIT">PEAR_LOG_CRIT</value>
       <value desc="PEAR_LOG_ERR">PEAR_LOG_ERR</value>
       <value desc="PEAR_LOG_WARNING">PEAR_LOG_WARNING</value>
       <value desc="PEAR_LOG_NOTICE">PEAR_LOG_NOTICE</value>
       <value desc="PEAR_LOG_INFO">PEAR_LOG_INFO</value>
       <value desc="PEAR_LOG_DEBUG">PEAR_LOG_DEBUG</value>
      </values>
     </configenum>
     <configstring name="ident" desc="What identifier should we use in the
     logs?">HORDE</configstring>

     <configsection name="params">
      <configplaceholder/>
     </configsection>

     <configswitch name="type" desc="What log driver should we use?">file
      <case name="console" desc="Console">
       <configsection name="params">
        <configphp name="stream" required="false" desc="The output stream to
        use"/>
        <configboolean name="buffering" required="false" desc="Should the
        output be buffered until shutdown?">false</configboolean>
        <configstring name="lineFormat" required="false" desc="Log line format
        specification"/>
        <configstring name="timeFormat" required="false" desc="Time stamp
        format"/>
       </configsection>
      </case>

      <case name="display" desc="Display">
       <configsection name="params">
        <configstring name="error_prepend" required="false" desc="This string
        will be prepended to the log output"/>
        <configstring name="error_append" required="false" desc="This string
        will be appended to the log output"/>
       </configsection>
      </case>

      <case name="error_log" desc="Error Log">
       <configsection name="params">
        <configstring name="destination" required="false" desc="Optional
        destination value for error_log(). See
        http://www.indelible.org/pear/Log/guide.html#error-log-types for more
        details."/>
        <configstring name="extra_headers" required="false" desc="Additional
        headers to pass to the mail() function when the PEAR_LOG_TYPE_MAIL type
        is specified"/>
       </configsection>
      </case>

      <case name="file" desc="File">
       <configstring name="name" desc="Path to the log
       file">/tmp/horde.log</configstring>
       <configsection name="params">
        <configboolean name="append" required="false" desc="Should new log
        entries be appended to an existing log file? If this is false, new log files
        will overwrite existing ones.">true</configboolean>
        <configinteger name="mode" octal="true" required="false" desc="Octal
        representation of the log file's permissions mode"/>
        <configphp name="eol" required="false" desc="The end-of-line character
        sequence"/>
        <configstring name="lineFormat" required="false" desc="Log line format
        specification"/>
        <configstring name="timeFormat" required="false" desc="Time stamp
        format"/>
       </configsection>
      </case>

      <case name="mail" desc="Mail">
       <configstring name="name" desc="The recipient for the message"/>
       <configsection name="params">
        <configstring name="from" required="false" desc="Value for the
        message's From: header"/>
        <configstring name="subject" required="false" desc="Value for the
        message's Subject: header"/>
        <configstring name="preamble" required="false" desc="Preamble for the
        message"/>
       </configsection>
      </case>

      <case name="mcal" desc="Mcal">
       <configsection name="params">
        <configstring name="calendar" desc="The MCAL calendar name"/>
        <configstring name="username" desc="Connect to MCAL as"/>
        <configstring name="password" desc="Password to connect with"/>
       </configsection>
      </case>

      <case name="null" desc="Null"/>

      <case name="sql" desc="SQL">
       <configstring name="name" desc="The table to log
       to">log_table</configstring>
       <configsection name="params">
        <configphp name="dsn" desc="A Data Source
        Name">$conf['sql']</configphp>
       </configsection>
      </case>

      <case name="sqlite" desc="SQLite">
       <configstring name="name" desc="The table to log
       to">log_table</configstring>
       <configsection name="params">
        <configstring name="filename" desc="Path to an Sqlite database"/>
        <configinteger name="mode" octal="true" required="false" desc="Octal
        mode used to open the database [0666]"/>
        <configboolean name="persistent" required="false" desc="Use a
        persistent connection">false</configboolean>
       </configsection>
      </case>

      <case name="syslog" desc="Syslog">
       <configphp name="name" quote="false" desc="Syslog facility to use"/>
      </case>

      <case name="win" desc="Window">
       <configstring name="name" desc="Name of the opened window"/>
       <configsection name="params">
        <configstring name="title" required="false" desc="The title of the
        output window"/>
       </configsection>
      </case>
     </configswitch>

    </case>
    <case name="false" desc="No"/>
   </configswitch>
  </configsection>
  <configboolean name="log_accesskeys" desc="Should Horde log statistics about
   used access keys? This is only useful for translators of the
   UI. You also need to set the log level to at least
   PEAR_LOG_INFO.">false</configboolean>
 </configtab>

 <configtab name="prefs" desc="Preference System">
  <configsection name="prefs">
   <configheader>Preference System Settings</configheader>
   <configinteger name="maxsize" required="false" desc="The size of the
   preferences field in your backend in bytes. Horde will reject any write to
   the preferences backend if its length exceeds this value. Leave empty to
   skip this checking. E.g. MySQL stores the preference data in a LONGTEXT
   field. This field can hold 4294967295 bytes so most likely checking is not
   needed. However other DB installations may only have a storage size of 64
   KB (65535 bytes). These installations would want to turn checking on."/>
   <configswitch name="driver" desc="What preferences driver should we use?">session
     <case name="sql" desc="SQL Database">
      <configsection name="params">
       <configsql switchname="driverconfig">
        <configstring name="table" required="false" desc="The name of the
        preference table in the database [horde_prefs]"/>
       </configsql>
      </configsection>
     </case>
     <case name="ldap" desc="LDAP">
      <configsection name="params">
       <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
       <configinteger name="port" desc="The port of the LDAP server">389</configinteger>
       <configenum name="version" desc="LDAP Protocol Version">3
        <values>
         <value desc="LDAPv2 (Deprecated)">2</value>
         <value desc="LDAPv3">3</value>
        </values>
       </configenum>
       <configstring name="basedn" desc="The base DN for the LDAP server"/>
       <configboolean name="fetchdn" required="false" desc="Should Horde bind
as each user for that user's write operations?"/>
       <configstring name="rootdn" required="false" desc="If not, provide the
DN of the root (administrative) account to bind for write operations"/>
       <configstring name="password" required="false" desc="The password of the root DN for bind authentication"/>
       <configstring name="uid" desc="The username search key"/>
      </configsection>
     </case>
     <case name="session" desc="PHP Sessions"/>
     <case name="kolab" desc="Kolab (LDAP)" />
     <case name="imsp" desc="IMSP Server" />
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="datatree" desc="DataTree System">
  <configsection name="datatree">
   <configheader>DataTree System Settings</configheader>
   <configswitch name="driver" desc="What backend should we use for Horde
   DataTree storage?">null
     <case name="null" desc="None"/>
     <case name="sql" desc="SQL Database">
      <configsection name="params">
       <configsql switchname="driverconfig">
        <configstring name="table" required="false" desc="The name of the
        data table in the database [horde_datatree]"/>
        <configstring name="table_attributes" required="false" desc="The name
        of the data attributes table in the database
        [horde_datatree_attributes]"/>
       </configsql>
      </configsection>
     </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="group" desc="Groups">
  <configsection name="group">
   <configheader>Groups Settings</configheader>
   <configdescription>
    The Hooks backend extends the DataTree backend to allow hooks to extend a
    group to dynamically include members into a group.  See hooks.php.dist for
    an example.
   </configdescription>
   <configswitch name="driver" desc="What backend should we use for Horde
   Groups?">datatree
     <case name="datatree" desc="DataTree"/>
     <case name="hooks" desc="Hooks"/>

     <case name="ldap" desc="LDAP">
       <configsection name="params">
        <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
        <configstring name="basedn" desc="The base DN for the LDAP server"/>
        <configstring name="binddn" required="false" desc="The DN used to bind to the LDAP server"/>
        <configstring name="password" required="false" desc="The password used to bind to the LDAP server"/>
        <configenum name="version" desc="LDAP Protocol Version">3
         <values>
          <value desc="LDAPv2 (Deprecated)">2</value>
          <value desc="LDAPv3">3</value>
         </values>
        </configenum>
        <configstring name="gid" desc="The group search key">cn</configstring>
        <configstring name="memberuid" desc="Group membership field">memberUid</configstring>
        <configlist name="newgroup_objectclass" desc="What objectclasses should a new group be member of? These objectclasses should cover the mail and gidnumber attributes as well as the group search key">posixGroup,hordeGroup</configlist>
        <configswitch name="filter_type" desc="How to specify a filter for the group lists">objectclass
         <case name="objectclass" desc="One or more objectclass filters">
          <configlist name="objectclass" desc="The objectclass filter used to search for groups. Can be a single objectclass or a list.">posixGroup</configlist>
         </case>
         <case name="free" desc="A complete LDAP filter expression">
          <configstring name="filter" desc="The LDAP RFC formatted filter used to search for groups."/>
         </case>
        </configswitch>
      </configsection>
     </case>

   </configswitch>
  </configsection>
 </configtab>

 <configtab name="cache" desc="Cache System">
  <configsection name="cache">
   <configheader>Cache System Settings</configheader>
   <configinteger name="default_lifetime" desc="How long, in seconds, should
   objects be cached by default?">1800</configinteger>
   <configswitch name="driver" desc="If you want to enable the Horde Cache,
   select a driver here. This is used to speed up portions of Horde by storing
   commonly processed objects to disk.">file
    <case name="none" desc="Don't cache any objects"/>
    <case name="file" desc="Store objects in filesystem">
     <configsection name="params">
      <configphp name="dir" required="false" desc="The location to store the
      cached files">Horde::getTempDir()</configphp>
      <configstring name="prefix" required="false" desc="The filename prefix to
      use for the cache files."/>
      <configinteger name="gc" required="false" desc="Perform garbage
      collection on cache files? Input the number of seconds old the file has
      to be without modification before the cache system can delete the file.
      Input 0 to skip garbage collection.">86400</configinteger>
      after which cache
     </configsection>
    </case>
    <case name="zps4" desc="Use the Zend Performance Suite output cache"/>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="token" desc="Token System">
  <configsection name="token">
   <configheader>Token System Settings</configheader>
   <configinteger name="timeout" required="false" desc="The period (in
   seconds) after which an id is purged"/>
   <configswitch name="driver" desc="If you want to enable Form Tokens, select
   a driver here. This is used by the Horde::Form:: API and some other parts
   of Horde to ensure that a form can only be submitted once.">none
    <case name="none" desc="Disable Form Tokens"/>
    <case name="file" desc="Local filesystem token storage">
     <configstring name="token_dir" required="false" desc="The directory where
     to keep token files"/>
    </case>
    <case name="sql" desc="SQL-based token storage">
     <configsection name="params">
      <configsql switchname="driverconfig">
       <configstring name="table" required="false" desc="The name of the
       tokens table in the database [horde_tokens]"/>
      </configsql>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="mailer" desc="Mailer">
  <configsection name="mailer">
   <configheader>Mailer</configheader>
   <configswitch name="type" desc="What method should we use for sending
   mail?">sendmail
    <case name="null" desc="Disable mailing" />
    <case name="sendmail" desc="Use the local sendmail binary">
     <configsection name="params">
      <configstring name="sendmail_path" required="false" desc="The location
      of the sendmail binary on the filesystem
      [/usr/sbin/sendmail]">/usr/lib/sendmail</configstring>
      <configstring name="sendmail_args" required="false" desc="Any extra
      parameters to pass to the sendmail or sendmail wrapper
      binary">-oi</configstring>
     </configsection>
    </case>
    <case name="smtp" desc="Use a SMTP server">
     <configsection name="params">
      <configstring name="host" required="false" desc="The server to connect
      to [localhost]"/>
      <configinteger name="port" required="false" desc="The port to connect
      to [25]"/>
      <configstring name="localhost" required="false" desc="The local hostname
      / domain [localhost]"/>
      <configenum name="auth" desc="SMTP authentication">0
       <values>
        <value desc="No authentication">0</value>
        <value desc="Best available authentication">1</value>
        <value>DIGEST-MD5</value>
        <value>CRAM-MD5</value>
        <value>LOGIN</value>
        <value>PLAIN</value>
       </values>
      </configenum>
      <configstring name="username" required="false" desc="The username to use for SMTP auth"/>
      <configstring name="password" required="false" desc="The password to use for SMTP auth"/>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="vfs" desc="Virtual File Storage">
  <configsection name="vfs">
   <configheader>Virtual File Storage</configheader>
   <configswitch name="type" desc="If a VFS (virtual filesystem) backend is
   required, which one should we use?">file
    <case name="file" desc="Files on the local system">
     <configsection name="params">
      <configstring name="vfsroot" desc="Where on the real filesystem should
      Horde use as root of the virtual filesystem?">/tmp</configstring>
     </configsection>
    </case>
    <case name="sql" desc="SQL database">
     <configsection name="params">
      <configsql switchname="driverconfig">
       <configstring name="vfs_table" desc="The name of the VFS table in the
       database [horde_vfs]" required="false"/>
      </configsql>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="session" desc="Custom Session Handler">
  <configsection name="sessionhandler">
   <configheader>Custom Session Handler</configheader>
   <configswitch name="type" desc="What sessionhandler driver should we
   use?">none
    <case name="none" desc="Use the default PHP (file-based) session handler"/>
    <case name="external" desc="Use your own custom session handler">
     <configsection name="params">
      <configstring name="open" desc="Your open() function"/>
      <configstring name="close" desc="Your close() function"/>
      <configstring name="read" desc="Your read() function"/>
      <configstring name="write" desc="Your write() function"/>
      <configstring name="destroy" desc="Your destroy() function"/>
      <configstring name="gc" desc="Your gc() function"/>
     </configsection>
    </case>
    <case name="dbm" desc="DBM based sessions"/>
    <case name="mysql" desc="MySQL based sessions">
     <configsection name="params">
      <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
      <configboolean name="rowlocking" desc="Should we use row-level locking
      and transactions? This is strongly recommended, but requires a table
      type that is transaction-safe and supports row-level locking, like
      InnoDB. If you don't have such a table type, disable this setting and we
      will use table-level locking and no locking
      instead.">true</configboolean>
      <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
       <case name="unix" desc="UNIX Sockets">
        <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
       </case>
       <case name="tcp" desc="TCP/IP">
        <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">3306</configinteger>
       </case>
      </configswitch>
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
      <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
     </configsection>
    </case>
    <case name="oci8" desc="Oracle based sessions">
     <configsection name="params">
      <configboolean name="persistent" desc="Request persistent connections?">
      false</configboolean>
      <configstring name="hostspec" desc="Database name or Easy Connect
      parameter">horde</configstring>
      <configstring name="username" desc="What username do we authenticate to
      the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we
      authenticate to the database server with?"/>
      <configstring name="table" required="false" desc="The name of the session
      table in the database [horde_sessionhandler]"/>
     </configsection>
    </case>
    <case name="pgsql" desc="PostgreSQL based sessions">
     <configsection name="params">
      <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
      <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
       <case name="unix" desc="UNIX Sockets">
        <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
       </case>
       <case name="tcp" desc="TCP/IP">
        <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
       </case>
      </configswitch>
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
      <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
     </configsection>
    </case>
    <case name="sapdb" desc="Use PEAR's DB abstraction layer w/ODBC">
     <configsection name="params">
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
      <configstring name="table" desc="The name of the session table in the database"/>
     </configsection>
    </case>
    <case name="sql" desc="Use PEAR's DB abstraction layer">
     <configsection name="params">
      <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
      <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
       <case name="unix" desc="UNIX Sockets">
        <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
       </case>
       <case name="tcp" desc="TCP/IP">
        <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
       </case>
      </configswitch>
      <configstring name="hostspec" desc="What hostname is the database server running on, or what is the name of the system DSN to use?">localhost</configstring>
      <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
      <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
      <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
      <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
     </configsection>
    </case>
    <case name="memcache" desc="Memcache server">
     <configsection name="params">
      <configlist name="hostspec" desc="What hostname is the memcache server
      running on, or what is the name of the system DSN to use?  Specify
      multiple servers separated by commas.">localhost</configlist>
      <configlist name="port" required="false" desc="Port(s) the memcache
      server is running on. If more than one host is used, specify ports for
      respective servers, separated by commas">11211</configlist>
      <configboolean name="persistent" required="false" desc="Request
      persistent connection to server.">false</configboolean>
      <configboolean name="compression" required="false" desc="Enable
      compression for storing entries on server.">false</configboolean>
      <configstring name="lock_dir" desc="Specify a directory to which the
      session locks should be written">/tmp</configstring>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="image" desc="Image Manipulation">
  <configsection name="image">
   <configheader>Image Manipulation</configheader>
   <configstring name="convert" required="false" desc="Horde requires either
   GD support built-in to PHP (--with-gd) or the ImageMagick software
   package (http://www.imagemagick.org/) to do image
   manipulation/creation. If using ImageMagick, specify the full path
   name to the 'convert' program. On Windows, this path *cannot* have
   spaces in it. Use DOS-style abbreviations if necessary: Progra~1
   instead of Program Files, for instance. If using GD, or using
   neither, leave this field blank."/>
  </configsection>
 </configtab>

 <configtab name="mime" desc="MIME Detection">
  <configsection name="mime">
   <configheader>MIME Detection</configheader>
   <configstring name="magic_db" required="false" desc="Location of the MIME
   magic database. Usually /usr/share/misc/magic or /etc/magic."/>
  </configsection>
 </configtab>

 <configtab name="geoip" desc="Hostname-&gt;Country Lookup">
  <configsection name="geoip">
   <configheader>Hostname-&gt;Country Lookup</configheader>
   <configstring name="datafile" required="false" desc="Horde, by default, can
   do Hostname -&gt; Country lookup using the top level domain (e.g. 'uk',
   'de') of the hostname.  However, many popular top level domains
   (e.g. 'com', 'net') span more than one country.  In these instances, Horde
   can use the MaxMind GeoIP Hostname to Country lookup to try to determine
   the correct country.  To activate this functionality, the GeoIP.dat country
   database must be present on your local system.  This file can be downloaded
   free of charge from http://www.maxmind.com/download/geoip/database/.  If
   this database is present, specify the full path name to the database below.
   If empty, the GeoIP lookup will not be performed."/>
  </configsection>
 </configtab>

 <configtab name="problems" desc="Problem Reporting">
  <configsection name="problems">
   <configheader>Problem Reporting</configheader>
   <configswitch name="tickets" desc="If a ticket system with a
   tickets/addTicket API method is present, should we create tickets for
   problem reports instead of emailing them?">false
    <case name="true" desc="Yes">
     <configphp name="ticket_params" desc="Enter as a PHP array any
     additional arguments for the created ticket (queue, state, priority,
     etc). Example for Whups: array('queue' => 2, 'state' => 1, 'priority' => 1,
     'type' => 1). You will need to look up the appropriate IDs in Whups's
     database, or whatever is appropriate for the ticket system you are
     using.">array()</configphp>
    </case>
    <case name="false" desc="No">
     <configstring name="email" desc="Where should problem report emails be sent?">
     webmaster@example.com</configstring>
     <configstring name="maildomain" desc="If Horde cannot determine a user's
     email address, this domain will be appended to their
     username.">example.com</configstring>
     <configstring name="username" required="false" desc="If requiring SMTP
     authentication without a global SMTP user (in section &quot;Mailer&quot;
     and allowing problem reporting for not authenticated users (in section
     &quot;Menu Settings&quot;), what username should be use for SMTP
     authentication?"/>
     <configstring name="password" required="false" desc="The password to use"/>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="menu" desc="Menu Settings">
  <configheader>Menu Settings</configheader>
  <configsection name="menu">
   <configmultienum name="apps" desc="Select any applications that should be
   linked in Horde's menu">
    <values>
     <configspecial name="list-horde-apps" />
    </values>
   </configmultienum>

   <configboolean name="always" desc="Should we
   &lt;strong&gt;always&lt;/strong&gt; display the Horde
   frameset?">false</configboolean>

   <configsection name="links">
    <configenum name="help" desc="Should we display help links in the
    menu?">all
     <values>
      <value desc="All users">all</value>
      <value desc="Authenticated users">authenticated</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configboolean name="help_about" desc="Should we display the about link in
    the help menu?">true</configboolean>
    <configenum name="options" desc="Should we display options links in the
    menu? You still need to configure a preference backend in the
    &quot;Preference System&quot; section.">authenticated
     <values>
      <value desc="All users">all</value>
      <value desc="Authenticated users">authenticated</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configenum name="problem" desc="Should we display problem reporting links
    in the menu?">all
     <values>
      <value desc="All users">all</value>
      <value desc="Authenticated users">authenticated</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configenum name="login" desc="Should we display a login link in the menu
    when not logged in?">all
     <values>
      <value desc="All users">all</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configenum name="logout" desc="Should we display a logout link in the
    menu when logged in?">authenticated
     <values>
      <value desc="Authenticated users">authenticated</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configenum name="login" desc="Should we display a login link in the menu
    when not logged in?">all
     <values>
      <value desc="All users">all</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
    <configenum name="logout" desc="Should we display a logout link in the
    menu when logged in?">authenticated
     <values>
      <value desc="Authenticated users">authenticated</value>
      <value desc="Never">never</value>
     </values>
    </configenum>
   </configsection>
  </configsection>

  <configsection name="logo">
   <configstring name="image" required="false" desc="The URL of an image for
   the top of the Horde menu. The image should be no larger than 140 pixels
   wide by 40 pixels high to prevent the frame from scrolling."/>
   <configstring name="link" required="false" desc="If a logo is displayed in
   the Horde menu, what URL (if any) should it link to?"/>
  </configsection>
 </configtab>

 <configtab name="hooks" desc="Custom Function Hooks">
  <configsection name="hooks">
   <configheader>Custom Function Hooks</configheader>
   <configdescription>
    There are example functions for all hooks in horde/config/hooks.php.dist.
   </configdescription>
   <configboolean name="permsdenied" desc="If this is checked, the
   function _perms_hook_denied() will be called to return an error message if
   a permission has been denied. Otherwise a standard message will be shown
   and the user won't see any action widgets that he doesn't have access
   to.">false</configboolean>
   <configboolean name="username" desc="If this is checked, the function
   _username_hook_frombackend() will be used to set the user name at login
   time. The counterpart function _username_hook_tobackend() will be used to
   convert user names back, for example when showing name lists to the
   user.">false</configboolean>
   <configboolean name="preauthenticate" desc="If this is checked and the
   function _horde_hook_preauthenticate() returns false, authentication will
   fail.">false</configboolean>
   <configboolean name="postauthenticate" desc="If this is checked and the
   function _horde_hook_postauthenticate() returns false, authentication will
   fail.">false</configboolean>
   <configboolean name="authldap" desc="If this is checked, the function
   _horde_hook_authldap() will be used to create and set the attributes needed
   to add/edit/delete users by the LDAP Auth driver.">false</configboolean>
  </configsection>
 </configtab>

 <configtab name="block" desc="Portal Block Configuration">
  <configsection name="portal">
   <configheader>Fixed Blocks</configheader>
   <configmultienum name="fixed_blocks" muldesc="Which blocks should always be
    displayed in the portal?">
    <values>
     <configspecial name="list-blocks" />
    </values>
   </configmultienum>
  </configsection>
  <configheader>weather.com Configuration</configheader>
  <configsection name="weatherdotcom">
   <configdescription>
    Use of the weather.com block requires free registration for the XML
    feed at http://www.weather.com/services/xmloap.html.
    After registration, an email will be returned with the Partner ID and
    license key.&lt;br /&gt;
    NOTE: weather.com guidelines require registration and use of the returned
    values, but the application appears to function with any string values.
   </configdescription>
   <configstring name="partner_id" required="false" desc="The partner I.D.
   from weather.com"/>
   <configstring name="license_key" required="false" desc="The license key
   from weather.com"/>
  </configsection>

  <configheader>Fortune Configuration</configheader>
  <configsection name="fortune">
   <configstring name="exec_path" required="false" desc="Path to fortune
   executable, e.g. /usr/games/fortune"/>
  </configsection>

  <configheader>Account Info Configuration</configheader>
  <configsection name="accounts">
   <configswitch name="driver" desc="What  driver should we use?">null
    <case name="null" desc="null"/>
    <case name="localhost" desc="localhost">
     <configsection name="params">
      <configstring name="quota_path" desc="Path to the quota program">/usr/bin/quota</configstring>
      <configstring name="grep_path" desc="Path to the grep program">/bin/grep</configstring>
      <configboolean name="translateMountPoint" desc="Should we translate home directories to mount point device names?">false</configboolean>
      <configstring name="translationTable" desc="File to translate directory names to mount point device names?">/etc/mtab</configstring>
     </configsection>
    </case>
    <case name="ldap" desc="LDAP">
     <configsection name="params">
      <configstring name="host" desc="LDAP server/host">localhost</configstring>
      <configinteger name="port" required="false" desc="Port LDAP is running on, if non-standard">389</configinteger>
      <configstring name="basedn" desc="basedn string">o=example.com,c=US</configstring>
      <configstring name="attr" desc="LDAP attribute to search on">uid</configstring>
      <configenum name="version" desc="LDAP Protocol Version">3
       <values>
        <value desc="LDAPv2 (Deprecated)">2</value>
        <value desc="LDAPv3">3</value>
       </values>
      </configenum>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>
 <configtab name="imsp" desc="IMSP server settings">
  <configsection name="imsp">
   <configdescription>
   	If you plan to use any of Horde's IMSP server support, enable this option and
   	configure the server settings below.  Note that you must still configure/enable
   	specific IMSP support in the appropriate section.
   </configdescription>
   <configswitch name="enabled">false
    <case name="false" desc="Disabled" />
    <case name="true" desc="Enabled">
     <configheader>IMSP Server Settings</configheader>
     <configstring name="server" desc="Server Address:">localhost</configstring>
     <configstring name="port" desc="Server port:">406</configstring>
     <configswitch name="auth_method" desc="The authentication method to use">plaintext
      <case name="plaintext" desc="Plaintext" />
      <case name="cram_md5" desc="CRAM-MD5" />
      <case name="imtest" desc="Cyrus imtest">
       <configstring name="socket" desc="Path to the directory that will hold the socket.
       (The socket will be named 'imsp_username.sck').">/tmp/</configstring>
       <configstring name="command" desc="Path to imtest binary">/cyrus/usr/cyrus/bin/imtest</configstring>
       <configenum name="auth_mechanism" description="What authentication method do you want
       to use with the imtest utility?">
        <values>
         <value desc="Plaintext (LOGIN)">LOGIN</value>
         <value desc="GSSAPI">gssapi</value>
        </values>
       </configenum>
      </case>
     </configswitch>
    </case>
   </configswitch>
  </configsection>
 </configtab>

 <configtab name="kolab" desc="Kolab Groupware Server">
  <configsection name="kolab">
   <configdescription>
    &lt;strong&gt;*** IF YOU HAVE NO IDEA WHAT KOLAB IS THEN YOU CAN SAFELY
    IGNORE THIS TAB ***&lt;/strong&gt;&lt;br /&gt;
    Kolab is in no way required for normal Horde usage. If, however, you
    intend to use Horde as a webclient for Kolab then you will need to ensure
    that the following fields correspond to those required by your Kolab
    installation.  You can find some of the required values in the
    &lt;code&gt; $KOLAB_ROOT/etc/kolab/kolab.conf&lt;/code&gt; configuration
    file. Please note that the old iCal/vCard storage format has been dropped
    in favour of the new XML storage format &amp;amp; IMAP folder annotations;
    subsequently the Horde Kolab modules will only work with version 2 of the
    Kolab server.&lt;br /&gt;
    If you would like to find out more about Kolab then please visit the Kolab
    community website at http://www.kolab.org/
   </configdescription>
   <configswitch name="enabled" quote="false" desc="Horde/Kolab integration
    status">false
    <case name="false" desc="Disabled" />
    <case name="true" desc="Enabled">
     <configheader>Kolab LDAP Server Settings</configheader>
     <configsection name="ldap">
      <configstring name="server" desc="Server
      address:">localhost</configstring>
      <configinteger name="port" desc="Server port:">389</configinteger>
      <configstring name="basedn" desc="Base DN:">dc=example,
      dc=com</configstring>
      <configstring name="binddn" desc="Bind DN:">cn=manager, cn=internal,
      dc=example, dc=com</configstring>
      <configstring name="bindpw" desc="Bind Password:">password</configstring>
      <configstring name="phpdn" desc="Search DN:">cn=nobody, cn=internal,
      dc=example, dc=com</configstring>
      <configstring name="phppw" desc="Search
      Password:">password</configstring>
     </configsection>
     <configheader>Kolab Cyrus IMAP Server Settings</configheader>
     <configsection name="imap">
      <configstring name="server" desc="Server
      address:">mail.example.com</configstring>
      <configinteger name="port" desc="Server port:">143</configinteger>
      <configinteger name="sieveport" desc="Sieve port:">2000</configinteger>
      <configstring name="maildomain" desc="Default
      maildomain:">example.com</configstring>
      <configstring name="adminuser" desc="Administrator
      user:">manager</configstring>
      <configstring name="adminpw" desc="Administrator
      password:">password</configstring>
      <configboolean name="virtdomains" desc="Virtual
      domains:">true</configboolean>
     </configsection>
   <configboolean name="groupldap" desc="If this is checked, the function
   _horde_hook_groupldap() will be used to create and set the attributes needed
   to add/edit/delete groups by the LDAP Group driver.">false</configboolean>
     <configheader>Kolab SMTP Server Settings</configheader>
     <configsection name="smtp">
      <configstring name="server" desc="Server
      address:">localhost</configstring>
      <configinteger name="port" desc="Server port:">25</configinteger>
     </configsection>
    </case>
   </configswitch>
  </configsection>
 </configtab>
</configuration>
