[Sommaire] [Imprimer]

   1  <?xml version="1.0"?>
   2  <!-- $Horde: horde/config/conf.xml,v 1.74.2.41 2006/08/04 17:13:25 jan Exp $ -->
   3  <configuration>
   4   <configtab name="general" desc="General">
   5    <configheader>General Horde Settings</configheader>
   6    <configphp name="debug_level" desc="The value to set
   7    error_reporting() to.
   8    See http://www.php.net/manual/function.error-reporting.php for more
   9    information and possible values.">E_ALL &amp; ~E_NOTICE</configphp>
  10    <configinteger name="max_exec_time" desc="If we need to perform a long
  11    operation, what should we set max_execution_time to (in seconds)? 0 means no
  12    limit; however, a value of 0 will cause a warning if you are running in safe
  13    mode. See http://www.php.net/manual/function.set-time-limit.php for more
  14    information.">0</configinteger>
  15    <configenum name="use_ssl" quote="false" desc="Determines how we generate
  16    full URLs (for location headers and such).&lt;br /&gt;NOTE: If you choose to
  17    always generate https URLs, you MUST hardcode the correct HTTPS port number
  18    in the server port setting below. Otherwise Horde will be unable to generate
  19    correct HTTPS URLs when a user tries to access Horde via a non-HTTPS port.">2
  20     <values>
  21      <value desc="Assume that we are not using SSL and never generate https URLs.">0</value>
  22      <value desc="Assume that we are using SSL and always generate https URLs.">1</value>
  23      <value desc="Attempt to auto-detect, and generate URLs appropriately">2</value>
  24      <value desc="Assume that we are not using SSL and generate https URLs only
  25      for login.">3</value>
  26     </values>
  27    </configenum>
  28    <configsection name="server">
  29     <configphp name="name" desc="What server name should we use? You'll probably
  30     know if you need to change this default; only in situations where you need to
  31     override what Apache thinks the server name
  32     is.">$_SERVER['SERVER_NAME']</configphp>
  33     <configphp name="port" desc="What port number is the webserver running on?
  34     Again, you shouldn't need to change the default, and you probably know it if
  35     you do. The exception is if you have chosen to always generate https URLs, as
  36     described above.">$_SERVER['SERVER_PORT']</configphp>
  37    </configsection>
  38    <configboolean name="compress_pages" desc="If this option is set to true, and
  39    you have the php zlib extension, pages over a certain size will be compressed
  40    and sent to the browser as gzip-encoded data in order to save
  41    bandwidth. There is a CPU-usage penalty to pay for this, but the decrease in
  42    page size can be dramatic (70k to under 10k for a full mailbox page), and is
  43    more than worth it over anything but an extremely fast
  44    link.">true</configboolean>
  45    <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>
  46    <configstring name="tmpdir" required="false" desc="If you want to use a
  47    temporary directory other than the system default or the one specified in
  48    php's upload_tmp_dir value, enter it here."/>
  49    <configsection name="session">
  50     <configstring name="name" desc="What name should we use for the session that
  51     Horde apps share? If you want to share sessions with other applications on
  52     your webserver, you will need to make sure that they are using the same
  53     session name.  Note: Session names must consist of only alphanumeric
  54     characters.">Horde</configstring>
  55     <configboolean name="use_only_cookies" desc="Should we only allow session
  56     information to be stored in a session cookie and not be passed by URL (GET)
  57     parameters? This is on by default because passing session information in
  58     the URL is a security risk. Consider carefully before turning it off.">
  59     true</configboolean>
  60     <configstring name="cache_limiter" desc="What caching level should we use
  61     for the session? DO NOT CHANGE THIS UNLESS YOU &lt;strong&gt;REALLY&lt;/strong&gt; KNOW
  62     WHAT YOU ARE DOING. Setting this to anything other than 'nocache' will almost
  63     certainly result in severely broken script behavior.">nocache</configstring>
  64     <configinteger name="timeout" desc="How long should sessions last (in seconds)? 0 means
  65     that the session ends when the user closes their browser. Set other values
  66     with care - see
  67     http://www.php.net/manual/en/function.session-set-cookie-params.php.">0</configinteger>
  68    </configsection>
  69    <configsection name="cookie">
  70     <configphp name="domain" desc="What domain should we set cookies from? If
  71     you have a cluster that needs to share cookies, this might be '.example.com'
  72     - the leading '.' is important. Most likely, though, you won't have to change
  73     the default.">$_SERVER['SERVER_NAME']</configphp>
  74     <configstring name="path" desc="What path should we set cookies to? This
  75     should match where Horde is on your webserver - if it is at /horde, then this
  76     should be '/horde'. If Horde is installed as the document root, then this
  77     needs to be '/' - NOT ''.&lt;br /&gt;&lt;strong&gt;BUT&lt;/strong&gt;, if IE will be
  78     used to access Horde modules, you should read this first (discussing issues
  79     with IE's Content Advisor):
  80     http://lists.horde.org/archives/imp/Week-of-Mon-20030113/029149.html">/horde</configstring>
  81    </configsection>
  82   </configtab>
  83  
  84   <configtab name="sql" desc="Database">
  85    <configsection name="sql">
  86     <configheader>Horde Database Settings</configheader>
  87     <configdescription>&lt;strong&gt;NOTE:&lt;/strong&gt; These are only the
  88     &lt;em&gt;default&lt;/em&gt; values for any database driven backends. You
  89     still need to configure the different systems like "Preferences" or
  90     "DataTree" to actually &lt;em&gt;use&lt;/em&gt; a database
  91     backend.</configdescription>
  92     <configsql switchname="phptype" baseconfig="true" />
  93    </configsection>
  94   </configtab>
  95  
  96   <configtab name="auth" desc="Authentication">
  97    <configsection name="auth">
  98     <configheader>Horde Authentication</configheader>
  99     <configlist name="admins" desc="Which users should be treated as
 100     administrators (root, super-user) by Horde?" required="false"/>
 101     <configboolean name="checkip" desc="Should we always store and validate
 102     the IP address of the client (as seen by the web server) in the session?
 103     Doing so will help increase security by ensuring that an attacker from
 104     another host cannot try to hijack the session.">true</configboolean>
 105     <configboolean name="checkbrowser" desc="Should we always store and validate
 106     the browser string of the client (as seen by the web server) in the session?
 107     Doing so will help increase security by ensuring that an attacker from
 108     another host cannot try to hijack the session.">true</configboolean>
 109     <configstring name="alternate_login" desc="If this is not false, it is
 110     assumed to be the URL of an alternate login screen which will be used in
 111     place of horde's default login screen.">false</configstring>
 112     <configstring name="redirect_on_logout" desc="If this is not false, it is
 113     assumed to be the URL of an alternate logout page which users will be sent
 114     to when they log out.">false</configstring>
 115     <configswitch name="driver" desc="What backend should we use for
 116     authenticating users to Horde?">
 117  
 118      <case name="application" desc="Let a Horde application handle
 119      authentication">
 120       <configsection name="params">
 121        <configenum name="app" desc="The application which is providing
 122        authentication">imp
 123         <values>
 124          <configspecial name="list-horde-apps"/>
 125         </values>
 126        </configenum>
 127       </configsection>
 128      </case>
 129  
 130      <case name="auto" desc="Automatic authentication as a certain user">
 131       <configsection name="params">
 132        <configstring name="username" desc="The username to authenticate everyone as">horde_user</configstring>
 133        <configstring name="password" desc="The password to use for the user's credentials" required="false"/>
 134        <configboolean name="requestuser" desc="Allow username to be passed by GET, POST or cookie?">false</configboolean>
 135       </configsection>
 136      </case>
 137  
 138      <case name="composite" desc="Composite authentication">
 139       <configdescription>
 140        This authentication driver needs manual configuration not possible
 141        through this interface. Add the appropriate configuration lines at the
 142        end of the generated configuration file.
 143       </configdescription>
 144      </case>
 145  
 146      <case name="ftp" desc="FTP authentication">
 147       <configsection name="params">
 148        <configstring name="hostspec" desc="The hostname or IP address of the FTP
 149        server">localhost</configstring>
 150        <configinteger name="port" desc="The server port to connect
 151        to">21</configinteger>
 152       </configsection>
 153      </case>
 154  
 155      <case name="http" desc="HTTP (Basic Authentication/.htpasswd)
 156      authentication">
 157       <configsection name="params">
 158        <configstring name="htpasswd_file" required="false" desc="The location of
 159        the htpasswd file containing the user names and passwords"/>
 160        <configenum name="encryption" desc="Specifies what kind of passwords are
 161        in the htpasswd file">des
 162         <values>
 163          <value>aprmd5</value>
 164          <value>crypt</value>
 165          <value>crypt-blowfish</value>
 166          <value>crypt-des</value>
 167          <value>crypt-md5</value>
 168          <value>md5-base64</value>
 169          <value>md5-hex</value>
 170          <value>plain</value>
 171          <value>sha</value>
 172          <value>smd5</value>
 173          <value>ssha</value>
 174         </values>
 175        </configenum>
 176       </configsection>
 177      </case>
 178  
 179      <case name="imap" desc="IMAP authentication">
 180       <configsection name="params">
 181        <configswitch name="imapconfig" desc="Configuration type">
 182         <case name="dsn" desc="DSN">
 183          <configstring name="dsn" desc="The full IMAP connection
 184          string">{localhost:143/imap/notls}</configstring>
 185         </case>
 186         <case name="separate" desc="Separate values">
 187          <configstring name="hostspec" desc="The hostname or IP address of the
 188          server">localhost</configstring>
 189          <configinteger name="port" desc="The server port to which we will
 190          connect. IMAP is generally 143, while IMAP-SSL is generally
 191          993.">143</configinteger>
 192          <configenum name="protocol" desc="The connection protocol">imap/notls
 193           <values>
 194            <value>imap</value>
 195            <value>imap/novalidate-cert</value>
 196            <value>imap/notls</value>
 197            <value>imap/tls</value>
 198            <value>imap/tls/novalidate-cert</value>
 199            <value>imap/ssl</value>
 200            <value>imap/ssl/novalidate-cert</value>
 201           </values>
 202          </configenum>
 203         </case>
 204        </configswitch>
 205       </configsection>
 206      </case>
 207  
 208      <case name="imsp" desc="IMSP server authentication" />
 209  
 210      <case name="ipbasic" desc="Simple IP based authentication">
 211       <configsection name="params">
 212        <configlist name="blocks" desc="A list of CIDR masks which are allowed
 213        access"/>
 214       </configsection>
 215      </case>
 216  
 217      <case name="ipmap" desc="IP based authentication">
 218       <configsection name="params">
 219        <configlist name="blocks" desc="A list of CIDR masks which are allowed
 220        access"/>
 221       </configsection>
 222      </case>
 223  
 224      <case name="krb5" desc="Kerberos authentication"/>
 225  
 226      <case name="kolab" desc="Kolab authentication">
 227       <configsection name="params">
 228        <configboolean name="login_block" desc="Should the login be blocked after a given number of failed logins?">
 229        false</configboolean>
 230        <configinteger name="login_block_count" desc="After howmany failed logins the login should be blocked?">3</configinteger>
 231        <configinteger name="login_block_time" desc="Howmany minutes the login should be blocked?">5</configinteger>
 232       </configsection>
 233      </case>
 234  
 235      <case name="ldap" desc="LDAP authentication">
 236       <configsection name="params">
 237        <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
 238        <configstring name="basedn" desc="The base DN for the LDAP server"/>
 239        <configstring name="binddn" required="false" desc="The DN used to bind to the LDAP server"/>
 240        <configstring name="password" required="false" desc="The password used to bind to the LDAP server"/>
 241        <configenum name="version" desc="LDAP Protocol Version">3
 242         <values>
 243          <value desc="LDAPv2 (Deprecated)">2</value>
 244          <value desc="LDAPv3">3</value>
 245         </values>
 246        </configenum>
 247        <configboolean name="ad" desc="Is this an AD server?">false</configboolean>
 248        <configstring name="uid" desc="The username search key (set to samaccountname for AD)"/>
 249        <configenum name="encryption" desc="Algorithm to encrypt passwords">md5-hex
 250         <values>
 251          <value desc="aprmd5">aprmd5</value>
 252          <value desc="crypt">crypt</value>
 253          <value desc="crypt-des">crypt-des</value>
 254          <value desc="crypt-md5">crypt-md5</value>
 255          <value desc="crypt-blowfish">crypt-blowfish</value>
 256          <value desc="md5-base64">md5-base64</value>
 257          <value desc="md5-hex">md5-hex</value>
 258          <value desc="msad">msad</value>
 259          <value desc="plain">plain</value>
 260          <value desc="ssha">ssha</value>
 261          <value desc="smd5">smd5</value>
 262         </values>
 263        </configenum>
 264  
 265        <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>
 266  
 267        <configswitch name="filter_type" desc="How to specify a filter for the user lists">objectclass
 268         <case name="objectclass" desc="One or more objectclass filters">
 269          <configlist name="objectclass" desc="The objectclass filter used to search for users. Can be a single objectclass or a list."/>
 270         </case>
 271         <case name="free" desc="A complete LDAP filter expression">
 272          <configstring name="filter" desc="The LDAP RFC formatted filter used to search for users."/>
 273         </case>
 274        </configswitch>
 275  
 276        <configswitch name="password_expiration" desc="Enable the creating of accounts with expiring passwords? (Note: New users should have the shadowAccount objectclass)">no
 277         <case name="no" desc="no" />
 278         <case name="yes" desc="yes">
 279          <configstring name="minage" desc="After how many days may a password be changed again?">5</configstring>
 280          <configstring name="maxage" desc="How many days will a password remain valid?">30</configstring>
 281          <configstring name="warnage" desc="How many days before expirery should a user be warned?">5</configstring>
 282         </case>
 283        </configswitch>
 284       </configsection>
 285      </case>
 286  
 287      <case name="login" desc="Login (su) authentication">
 288       <configsection name="params">
 289        <configstring name="location" desc="Location of the su binary">/bin/su</configstring>
 290       </configsection>
 291      </case>
 292  
 293      <case name="mcal" desc="MCAL authentication">
 294       <configsection name="params">
 295        <configstring name="calendar" desc="The MCAL calendar name"/>
 296       </configsection>
 297      </case>
 298  
 299      <case name="pam" desc="PAM (Pluggable Authentication Modules) authentication">
 300       <configsection name="params">
 301        <configstring name="service" desc="The name of the PAM service to use when authenticating">php</configstring>
 302       </configsection>
 303      </case>
 304  
 305      <case name="passwd" desc="passwd file authentication">
 306       <configsection name="params">
 307        <configstring name="filename" desc="The passwd file to use">/etc/passwd</configstring>
 308        <configboolean name="lock" desc="Should we lock the passwd file?">false</configboolean>
 309       </configsection>
 310      </case>
 311  
 312      <case name="radius" desc="Radius authentication">
 313       <configsection name="params">
 314        <configstring name="host" desc="The RADIUS host to use (IP address or fully qualified hostname)">localhost</configstring>
 315        <configinteger name="port" required="false" desc="The port to use on the RADIUS server"/>
 316        <configenum name="method" desc="The RADIUS method to use for validating the request">PAP
 317         <values>
 318          <value desc="PAP">PAP</value>
 319          <value desc="CHAP_MD5 (not supported at the moment)">CHAP_MD5</value>
 320          <value desc="MSCHAPv1 (not supported at the moment)">MSCHAPv1</value>
 321          <value desc="MSCHAPv2 (not supported at the moment)">MSCHAPv2</value>
 322         </values>
 323        </configenum>
 324        <configstring name="nas" required="false" desc="The RADIUS NAS identifier to use." />
 325        <configstring name="secret" desc="The RADIUS shared secret string for the
 326        host. The RADIUS protocol ignores all but the leading 128 bytes of the
 327        shared secret."/>
 328        <configinteger name="retries" required="false" desc="The maximum number
 329        of repeated requests to make before giving up [3]"/>
 330        <configstring name="suffix" required="false" desc="The domain name to add
 331        to unqualified user names"/>
 332        <configinteger name="timeout" required="false" desc="The timeout for
 333        receiving replies from the server (in seconds) [3]"/>
 334       </configsection>
 335      </case>
 336  
 337      <case name="sasl" desc="SASL authentication">
 338       <configsection name="params">
 339        <configstring name="app" desc="The name of the authenticating
 340        application">horde</configstring>
 341        <configstring name="service" desc="The name of the SASL service to use
 342        when authenticating">php</configstring>
 343       </configsection>
 344      </case>
 345  
 346      <case name="smb" desc="SMB authentication">
 347       <configsection name="params">
 348        <configstring name="hostspec" desc="IP, DNS Name, or NetBios Name of the
 349        SMB server to authenticate with">localhost</configstring>
 350        <configstring name="domain" desc="The domain name to authenticate with"/>
 351        <configstring name="group" required="false" desc="Optional group name
 352        that the user must be a member of"/>
 353       </configsection>
 354      </case>
 355  
 356      <case name="sql" desc="SQL authentication">
 357       <configsection name="params">
 358        <configsql switchname="driverconfig" />
 359        <configstring name="table" required="false" desc="The name of the auth
 360        table in the database [horde_users]"/>
 361        <configstring name="username_field" required="false" desc="The name of the
 362        username field in the auth table [user_uid]"/>
 363        <configstring name="password_field" required="false" desc="The name of the
 364        password field in the auth table [user_pass]"/>
 365        <configstring name="soft_expiration_field" required="false" desc="The
 366        name of a field containing a UNIX timestamp.  When a user logs in after
 367        the specified time, if 'passwd' is installed, that user will be asked to
 368        change his or her password.  This feature is disabled by default."/>
 369        <configstring name="hard_expiration_field" required="false" desc="The
 370        name of a field containing a UNIX timestamp.  A user will not be able to
 371        log in after the specified time.  This feature is disabled by default."/>
 372        <configinteger name="soft_expiration_window" required="false"
 373        desc="This is how often, in days, the user must change his or her
 374        password.  When the user's password is updated, the &quot;soft&quot;
 375        expiration is set this many days in the future.  If not provided,
 376        the user's password will not expire by default."/>
 377        <configinteger name="hard_expiration_window" required="false" desc="The
 378        number of days in the grace period the user has to change his or her
 379        password after it has expired.  If not provided, the grace period will
 380        not expire."/>
 381        <configenum name="encryption" required="false" desc="The encryption to use
 382        to store the password in the table">md5-hex
 383         <values>
 384          <value>crypt</value>
 385          <value>crypt-blowfish</value>
 386          <value>crypt-des</value>
 387          <value>crypt-md5</value>
 388          <value>md5-base64</value>
 389          <value>md5-hex</value>
 390          <value>plain</value>
 391          <value>sha</value>
 392          <value>smd5</value>
 393          <value>ssha</value>
 394         </values>
 395        </configenum>
 396        <configboolean name="show_encryption" required="false" desc="Prepend the
 397        encryption in the password field?">false</configboolean>
 398       </configsection>
 399      </case>
 400  
 401      <case name="customsql" desc="SQL authentication w/custom-made queries">
 402       <configsection name="params">
 403        <configenum name="phptype" desc="The name of the database">mysql
 404         <values>
 405          <value desc="Microsoft SQL Server">mssql</value>
 406          <value desc="MySQL">mysql</value>
 407          <value desc="ODBC">odbc</value>
 408          <value desc="Oracle 8">oci8</value>
 409          <value desc="PostgreSQL">pgsql</value>
 410         </values>
 411        </configenum>
 412        <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
 413         <case name="unix" desc="UNIX Sockets">
 414          <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
 415         </case>
 416         <case name="tcp" desc="TCP/IP">
 417          <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
 418         </case>
 419        </configswitch>
 420        <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>
 421        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
 422        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
 423        <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
 424        <configdescription>
 425         Some special tokens can be used in the sql query. They are replaced at
 426         the query stage:&lt;ul&gt;
 427         &lt;li&gt;"\L" will be replaced by the user's login&lt;/li&gt;
 428         &lt;li&gt;"\P" will be replaced by the user's password&lt;/li&gt;
 429         &lt;li&gt;"\O" will be replaced by the old user's login (required for
 430         update)&lt;/li&gt;&lt;/ul&gt;
 431         Eg: "SELECT * FROM users WHERE uid = \L AND passwd = \P AND billing =
 432         'paid'"
 433        </configdescription>
 434        <configstring name="query_auth" desc="Authenticate the user"/>
 435        <configstring name="query_add" desc="Add user"/>
 436        <configstring name="query_update" desc="Update user"/>
 437        <configstring name="query_remove" desc="Remove user"/>
 438        <configstring name="query_list" desc="List users"/>
 439        <configenum name="encryption" desc="The encryption to use to store the
 440        password in the table">md5-hex
 441         <values>
 442          <value>aprmd5</value>
 443          <value>crypt</value>
 444          <value>crypt-blowfish</value>
 445          <value>crypt-des</value>
 446          <value>crypt-md5</value>
 447          <value>md5-base64</value>
 448          <value>md5-hex</value>
 449          <value>plain</value>
 450          <value>sha</value>
 451          <value>smd5</value>
 452          <value>ssha</value>
 453         </values>
 454        </configenum>
 455        <configboolean name="show_encryption" desc="Prepend the encryption in the
 456        password field?">false</configboolean>
 457       </configsection>
 458      </case>
 459  
 460      <case name="cyrsql" desc="SQL implementation for the Cyrus IMAP server">
 461       <configsection name="params">
 462        <configstring name="cyradmin" desc="The username of the cyrus
 463        administrator"/>
 464        <configstring name="cyrpass" desc="The password for the cyrus
 465        administrator"/>
 466        <configstring name="imap_dsn" desc="The full IMAP DSN
 467        (i.e. {localhost:993/imap/ssl/novalidate-cert})"/>
 468        <configenum name="phptype" desc="The name of the database">mysql
 469         <values>
 470          <value desc="Microsoft SQL Server">mssql</value>
 471          <value desc="MySQL">mysql</value>
 472          <value desc="MySQL (mysqli)">mysqli</value>
 473          <value desc="ODBC">odbc</value>
 474          <value desc="Oracle 8">oci8</value>
 475          <value desc="PostgreSQL">pgsql</value>
 476         </values>
 477        </configenum>
 478        <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
 479         <case name="unix" desc="UNIX Sockets">
 480          <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
 481         </case>
 482         <case name="tcp" desc="TCP/IP">
 483          <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
 484         </case>
 485        </configswitch>
 486        <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>
 487        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
 488        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
 489        <configstring name="database" desc="What database name/tablespace are we
 490        using?">horde</configstring>
 491        <configstring name="table" desc="The name of the auth table in the
 492        database">horde_users</configstring>
 493        <configstring name="username_field" desc="The name of the username field
 494        in the auth table">user_uid</configstring>
 495        <configstring name="password_field" desc="The name of the password field
 496        in the auth table">user_pass</configstring>
 497        <configstring name="domain_field" desc="If set to anything other than
 498        'none' this is used as field name where domain is
 499        stored">none</configstring>
 500        <configenum name="encryption" desc="The encryption to use to store the
 501        password in the table">md5-hex
 502         <values>
 503          <value>aprmd5</value>
 504          <value>crypt</value>
 505          <value>crypt-blowfish</value>
 506          <value>crypt-des</value>
 507          <value>crypt-md5</value>
 508          <value>md5-base64</value>
 509          <value>md5-hex</value>
 510          <value>plain</value>
 511          <value>sha</value>
 512          <value>smd5</value>
 513          <value>ssha</value>
 514         </values>
 515        </configenum>
 516        <configlist name="folders" required="false" desc="A list of folders to create under
 517        username"/>
 518        <configinteger name="quota" required="false" desc="The quota (in
 519        kilobytes) to grant on the mailbox"/>
 520        <configboolean name="unixhier" desc="The value of imapd.conf's
 521        unixhierarchysep setting. Check this if the value is true in
 522        imapd.conf.">false</configboolean>
 523       </configsection>
 524      </case>
 525  
 526      <case name="yahoo" desc="Yahoo! authentication"/>
 527     </configswitch>
 528    </configsection>
 529   </configtab>
 530  
 531   <configtab name="signup" desc="Sign Up">
 532    <configsection name="signup">
 533     <configheader>Horde Sign Up</configheader>
 534     <configswitch name="allow" desc="Allow non-registered users to register and
 535     provide a link on the login screen?">false
 536      <case name="true" desc="Yes">
 537       <configboolean name="approve" desc="Admin has to approve any user submitted
 538       registration requests? (WARNING: Setting to false would mean that every user
 539       who signs up would have automatic access to your horde system.)">true</configboolean>
 540       <configboolean name="preprocess" desc="Pass the user submitted information
 541       through the _horde_hook_signup_preprocess function in hooks.php before
 542       processing the request?">false</configboolean>
 543       <configboolean name="queue" desc="Pass the user submitted information
 544       through the _horde_hook_signup_queue function in hooks.php after processing
 545       the request but before actually queueing it?">false</configboolean>
 546      </case>
 547      <case name="false" desc="No" />
 548     </configswitch>
 549    </configsection>
 550   </configtab>
 551  
 552   <configtab name="log" desc="Logging">
 553    <configsection name="log">
 554     <configheader>Horde Logging</configheader>
 555     <configswitch name="enabled" quote="false" desc="Should Horde log errors and other useful
 556     information?">true
 557      <case name="true" desc="Yes">
 558       <configenum name="priority" quote="false" desc="What level of messages
 559       should we log? Each level logs itself and all those that come before it:
 560       PEAR_LOG_ALERT would only log alerts and emergencies, but PEAR_LOG_DEBUG
 561       would log everything.">PEAR_LOG_NOTICE
 562        <values>
 563         <value desc="PEAR_LOG_EMERG">PEAR_LOG_EMERG</value>
 564         <value desc="PEAR_LOG_ALERT">PEAR_LOG_ALERT</value>
 565         <value desc="PEAR_LOG_CRIT">PEAR_LOG_CRIT</value>
 566         <value desc="PEAR_LOG_ERR">PEAR_LOG_ERR</value>
 567         <value desc="PEAR_LOG_WARNING">PEAR_LOG_WARNING</value>
 568         <value desc="PEAR_LOG_NOTICE">PEAR_LOG_NOTICE</value>
 569         <value desc="PEAR_LOG_INFO">PEAR_LOG_INFO</value>
 570         <value desc="PEAR_LOG_DEBUG">PEAR_LOG_DEBUG</value>
 571        </values>
 572       </configenum>
 573       <configstring name="ident" desc="What identifier should we use in the
 574       logs?">HORDE</configstring>
 575  
 576       <configsection name="params">
 577        <configplaceholder/>
 578       </configsection>
 579  
 580       <configswitch name="type" desc="What log driver should we use?">file
 581        <case name="console" desc="Console">
 582         <configsection name="params">
 583          <configphp name="stream" required="false" desc="The output stream to
 584          use"/>
 585          <configboolean name="buffering" required="false" desc="Should the
 586          output be buffered until shutdown?">false</configboolean>
 587          <configstring name="lineFormat" required="false" desc="Log line format
 588          specification"/>
 589          <configstring name="timeFormat" required="false" desc="Time stamp
 590          format"/>
 591         </configsection>
 592        </case>
 593  
 594        <case name="display" desc="Display">
 595         <configsection name="params">
 596          <configstring name="error_prepend" required="false" desc="This string
 597          will be prepended to the log output"/>
 598          <configstring name="error_append" required="false" desc="This string
 599          will be appended to the log output"/>
 600         </configsection>
 601        </case>
 602  
 603        <case name="error_log" desc="Error Log">
 604         <configsection name="params">
 605          <configstring name="destination" required="false" desc="Optional
 606          destination value for error_log(). See
 607          http://www.indelible.org/pear/Log/guide.html#error-log-types for more
 608          details."/>
 609          <configstring name="extra_headers" required="false" desc="Additional
 610          headers to pass to the mail() function when the PEAR_LOG_TYPE_MAIL type
 611          is specified"/>
 612         </configsection>
 613        </case>
 614  
 615        <case name="file" desc="File">
 616         <configstring name="name" desc="Path to the log
 617         file">/tmp/horde.log</configstring>
 618         <configsection name="params">
 619          <configboolean name="append" required="false" desc="Should new log
 620          entries be appended to an existing log file? If this is false, new log files
 621          will overwrite existing ones.">true</configboolean>
 622          <configinteger name="mode" octal="true" required="false" desc="Octal
 623          representation of the log file's permissions mode"/>
 624          <configphp name="eol" required="false" desc="The end-of-line character
 625          sequence"/>
 626          <configstring name="lineFormat" required="false" desc="Log line format
 627          specification"/>
 628          <configstring name="timeFormat" required="false" desc="Time stamp
 629          format"/>
 630         </configsection>
 631        </case>
 632  
 633        <case name="mail" desc="Mail">
 634         <configstring name="name" desc="The recipient for the message"/>
 635         <configsection name="params">
 636          <configstring name="from" required="false" desc="Value for the
 637          message's From: header"/>
 638          <configstring name="subject" required="false" desc="Value for the
 639          message's Subject: header"/>
 640          <configstring name="preamble" required="false" desc="Preamble for the
 641          message"/>
 642         </configsection>
 643        </case>
 644  
 645        <case name="mcal" desc="Mcal">
 646         <configsection name="params">
 647          <configstring name="calendar" desc="The MCAL calendar name"/>
 648          <configstring name="username" desc="Connect to MCAL as"/>
 649          <configstring name="password" desc="Password to connect with"/>
 650         </configsection>
 651        </case>
 652  
 653        <case name="null" desc="Null"/>
 654  
 655        <case name="sql" desc="SQL">
 656         <configstring name="name" desc="The table to log
 657         to">log_table</configstring>
 658         <configsection name="params">
 659          <configphp name="dsn" desc="A Data Source
 660          Name">$conf['sql']</configphp>
 661         </configsection>
 662        </case>
 663  
 664        <case name="sqlite" desc="SQLite">
 665         <configstring name="name" desc="The table to log
 666         to">log_table</configstring>
 667         <configsection name="params">
 668          <configstring name="filename" desc="Path to an Sqlite database"/>
 669          <configinteger name="mode" octal="true" required="false" desc="Octal
 670          mode used to open the database [0666]"/>
 671          <configboolean name="persistent" required="false" desc="Use a
 672          persistent connection">false</configboolean>
 673         </configsection>
 674        </case>
 675  
 676        <case name="syslog" desc="Syslog">
 677         <configphp name="name" quote="false" desc="Syslog facility to use"/>
 678        </case>
 679  
 680        <case name="win" desc="Window">
 681         <configstring name="name" desc="Name of the opened window"/>
 682         <configsection name="params">
 683          <configstring name="title" required="false" desc="The title of the
 684          output window"/>
 685         </configsection>
 686        </case>
 687       </configswitch>
 688  
 689      </case>
 690      <case name="false" desc="No"/>
 691     </configswitch>
 692    </configsection>
 693    <configboolean name="log_accesskeys" desc="Should Horde log statistics about
 694     used access keys? This is only useful for translators of the
 695     UI. You also need to set the log level to at least
 696     PEAR_LOG_INFO.">false</configboolean>
 697   </configtab>
 698  
 699   <configtab name="prefs" desc="Preference System">
 700    <configsection name="prefs">
 701     <configheader>Preference System Settings</configheader>
 702     <configinteger name="maxsize" required="false" desc="The size of the
 703     preferences field in your backend in bytes. Horde will reject any write to
 704     the preferences backend if its length exceeds this value. Leave empty to
 705     skip this checking. E.g. MySQL stores the preference data in a LONGTEXT
 706     field. This field can hold 4294967295 bytes so most likely checking is not
 707     needed. However other DB installations may only have a storage size of 64
 708     KB (65535 bytes). These installations would want to turn checking on."/>
 709     <configswitch name="driver" desc="What preferences driver should we use?">session
 710       <case name="sql" desc="SQL Database">
 711        <configsection name="params">
 712         <configsql switchname="driverconfig">
 713          <configstring name="table" required="false" desc="The name of the
 714          preference table in the database [horde_prefs]"/>
 715         </configsql>
 716        </configsection>
 717       </case>
 718       <case name="ldap" desc="LDAP">
 719        <configsection name="params">
 720         <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
 721         <configinteger name="port" desc="The port of the LDAP server">389</configinteger>
 722         <configenum name="version" desc="LDAP Protocol Version">3
 723          <values>
 724           <value desc="LDAPv2 (Deprecated)">2</value>
 725           <value desc="LDAPv3">3</value>
 726          </values>
 727         </configenum>
 728         <configstring name="basedn" desc="The base DN for the LDAP server"/>
 729         <configboolean name="fetchdn" required="false" desc="Should Horde bind
 730  as each user for that user's write operations?"/>
 731         <configstring name="rootdn" required="false" desc="If not, provide the
 732  DN of the root (administrative) account to bind for write operations"/>
 733         <configstring name="password" required="false" desc="The password of the root DN for bind authentication"/>
 734         <configstring name="uid" desc="The username search key"/>
 735        </configsection>
 736       </case>
 737       <case name="session" desc="PHP Sessions"/>
 738       <case name="kolab" desc="Kolab (LDAP)" />
 739       <case name="imsp" desc="IMSP Server" />
 740     </configswitch>
 741    </configsection>
 742   </configtab>
 743  
 744   <configtab name="datatree" desc="DataTree System">
 745    <configsection name="datatree">
 746     <configheader>DataTree System Settings</configheader>
 747     <configswitch name="driver" desc="What backend should we use for Horde
 748     DataTree storage?">null
 749       <case name="null" desc="None"/>
 750       <case name="sql" desc="SQL Database">
 751        <configsection name="params">
 752         <configsql switchname="driverconfig">
 753          <configstring name="table" required="false" desc="The name of the
 754          data table in the database [horde_datatree]"/>
 755          <configstring name="table_attributes" required="false" desc="The name
 756          of the data attributes table in the database
 757          [horde_datatree_attributes]"/>
 758         </configsql>
 759        </configsection>
 760       </case>
 761     </configswitch>
 762    </configsection>
 763   </configtab>
 764  
 765   <configtab name="group" desc="Groups">
 766    <configsection name="group">
 767     <configheader>Groups Settings</configheader>
 768     <configdescription>
 769      The Hooks backend extends the DataTree backend to allow hooks to extend a
 770      group to dynamically include members into a group.  See hooks.php.dist for
 771      an example.
 772     </configdescription>
 773     <configswitch name="driver" desc="What backend should we use for Horde
 774     Groups?">datatree
 775       <case name="datatree" desc="DataTree"/>
 776       <case name="hooks" desc="Hooks"/>
 777  
 778       <case name="ldap" desc="LDAP">
 779         <configsection name="params">
 780          <configstring name="hostspec" desc="The hostname of the LDAP server">localhost</configstring>
 781          <configstring name="basedn" desc="The base DN for the LDAP server"/>
 782          <configstring name="binddn" required="false" desc="The DN used to bind to the LDAP server"/>
 783          <configstring name="password" required="false" desc="The password used to bind to the LDAP server"/>
 784          <configenum name="version" desc="LDAP Protocol Version">3
 785           <values>
 786            <value desc="LDAPv2 (Deprecated)">2</value>
 787            <value desc="LDAPv3">3</value>
 788           </values>
 789          </configenum>
 790          <configstring name="gid" desc="The group search key">cn</configstring>
 791          <configstring name="memberuid" desc="Group membership field">memberUid</configstring>
 792          <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>
 793          <configswitch name="filter_type" desc="How to specify a filter for the group lists">objectclass
 794           <case name="objectclass" desc="One or more objectclass filters">
 795            <configlist name="objectclass" desc="The objectclass filter used to search for groups. Can be a single objectclass or a list.">posixGroup</configlist>
 796           </case>
 797           <case name="free" desc="A complete LDAP filter expression">
 798            <configstring name="filter" desc="The LDAP RFC formatted filter used to search for groups."/>
 799           </case>
 800          </configswitch>
 801        </configsection>
 802       </case>
 803  
 804     </configswitch>
 805    </configsection>
 806   </configtab>
 807  
 808   <configtab name="cache" desc="Cache System">
 809    <configsection name="cache">
 810     <configheader>Cache System Settings</configheader>
 811     <configinteger name="default_lifetime" desc="How long, in seconds, should
 812     objects be cached by default?">1800</configinteger>
 813     <configswitch name="driver" desc="If you want to enable the Horde Cache,
 814     select a driver here. This is used to speed up portions of Horde by storing
 815     commonly processed objects to disk.">file
 816      <case name="none" desc="Don't cache any objects"/>
 817      <case name="file" desc="Store objects in filesystem">
 818       <configsection name="params">
 819        <configphp name="dir" required="false" desc="The location to store the
 820        cached files">Horde::getTempDir()</configphp>
 821        <configstring name="prefix" required="false" desc="The filename prefix to
 822        use for the cache files."/>
 823        <configinteger name="gc" required="false" desc="Perform garbage
 824        collection on cache files? Input the number of seconds old the file has
 825        to be without modification before the cache system can delete the file.
 826        Input 0 to skip garbage collection.">86400</configinteger>
 827        after which cache
 828       </configsection>
 829      </case>
 830      <case name="zps4" desc="Use the Zend Performance Suite output cache"/>
 831     </configswitch>
 832    </configsection>
 833   </configtab>
 834  
 835   <configtab name="token" desc="Token System">
 836    <configsection name="token">
 837     <configheader>Token System Settings</configheader>
 838     <configinteger name="timeout" required="false" desc="The period (in
 839     seconds) after which an id is purged"/>
 840     <configswitch name="driver" desc="If you want to enable Form Tokens, select
 841     a driver here. This is used by the Horde::Form:: API and some other parts
 842     of Horde to ensure that a form can only be submitted once.">none
 843      <case name="none" desc="Disable Form Tokens"/>
 844      <case name="file" desc="Local filesystem token storage">
 845       <configstring name="token_dir" required="false" desc="The directory where
 846       to keep token files"/>
 847      </case>
 848      <case name="sql" desc="SQL-based token storage">
 849       <configsection name="params">
 850        <configsql switchname="driverconfig">
 851         <configstring name="table" required="false" desc="The name of the
 852         tokens table in the database [horde_tokens]"/>
 853        </configsql>
 854       </configsection>
 855      </case>
 856     </configswitch>
 857    </configsection>
 858   </configtab>
 859  
 860   <configtab name="mailer" desc="Mailer">
 861    <configsection name="mailer">
 862     <configheader>Mailer</configheader>
 863     <configswitch name="type" desc="What method should we use for sending
 864     mail?">sendmail
 865      <case name="null" desc="Disable mailing" />
 866      <case name="sendmail" desc="Use the local sendmail binary">
 867       <configsection name="params">
 868        <configstring name="sendmail_path" required="false" desc="The location
 869        of the sendmail binary on the filesystem
 870        [/usr/sbin/sendmail]">/usr/lib/sendmail</configstring>
 871        <configstring name="sendmail_args" required="false" desc="Any extra
 872        parameters to pass to the sendmail or sendmail wrapper
 873        binary">-oi</configstring>
 874       </configsection>
 875      </case>
 876      <case name="smtp" desc="Use a SMTP server">
 877       <configsection name="params">
 878        <configstring name="host" required="false" desc="The server to connect
 879        to [localhost]"/>
 880        <configinteger name="port" required="false" desc="The port to connect
 881        to [25]"/>
 882        <configstring name="localhost" required="false" desc="The local hostname
 883        / domain [localhost]"/>
 884        <configenum name="auth" desc="SMTP authentication">0
 885         <values>
 886          <value desc="No authentication">0</value>
 887          <value desc="Best available authentication">1</value>
 888          <value>DIGEST-MD5</value>
 889          <value>CRAM-MD5</value>
 890          <value>LOGIN</value>
 891          <value>PLAIN</value>
 892         </values>
 893        </configenum>
 894        <configstring name="username" required="false" desc="The username to use for SMTP auth"/>
 895        <configstring name="password" required="false" desc="The password to use for SMTP auth"/>
 896       </configsection>
 897      </case>
 898     </configswitch>
 899    </configsection>
 900   </configtab>
 901  
 902   <configtab name="vfs" desc="Virtual File Storage">
 903    <configsection name="vfs">
 904     <configheader>Virtual File Storage</configheader>
 905     <configswitch name="type" desc="If a VFS (virtual filesystem) backend is
 906     required, which one should we use?">file
 907      <case name="file" desc="Files on the local system">
 908       <configsection name="params">
 909        <configstring name="vfsroot" desc="Where on the real filesystem should
 910        Horde use as root of the virtual filesystem?">/tmp</configstring>
 911       </configsection>
 912      </case>
 913      <case name="sql" desc="SQL database">
 914       <configsection name="params">
 915        <configsql switchname="driverconfig">
 916         <configstring name="vfs_table" desc="The name of the VFS table in the
 917         database [horde_vfs]" required="false"/>
 918        </configsql>
 919       </configsection>
 920      </case>
 921     </configswitch>
 922    </configsection>
 923   </configtab>
 924  
 925   <configtab name="session" desc="Custom Session Handler">
 926    <configsection name="sessionhandler">
 927     <configheader>Custom Session Handler</configheader>
 928     <configswitch name="type" desc="What sessionhandler driver should we
 929     use?">none
 930      <case name="none" desc="Use the default PHP (file-based) session handler"/>
 931      <case name="external" desc="Use your own custom session handler">
 932       <configsection name="params">
 933        <configstring name="open" desc="Your open() function"/>
 934        <configstring name="close" desc="Your close() function"/>
 935        <configstring name="read" desc="Your read() function"/>
 936        <configstring name="write" desc="Your write() function"/>
 937        <configstring name="destroy" desc="Your destroy() function"/>
 938        <configstring name="gc" desc="Your gc() function"/>
 939       </configsection>
 940      </case>
 941      <case name="dbm" desc="DBM based sessions"/>
 942      <case name="mysql" desc="MySQL based sessions">
 943       <configsection name="params">
 944        <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
 945        <configboolean name="rowlocking" desc="Should we use row-level locking
 946        and transactions? This is strongly recommended, but requires a table
 947        type that is transaction-safe and supports row-level locking, like
 948        InnoDB. If you don't have such a table type, disable this setting and we
 949        will use table-level locking and no locking
 950        instead.">true</configboolean>
 951        <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
 952         <case name="unix" desc="UNIX Sockets">
 953          <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
 954         </case>
 955         <case name="tcp" desc="TCP/IP">
 956          <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">3306</configinteger>
 957         </case>
 958        </configswitch>
 959        <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>
 960        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
 961        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
 962        <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
 963        <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
 964       </configsection>
 965      </case>
 966      <case name="oci8" desc="Oracle based sessions">
 967       <configsection name="params">
 968        <configboolean name="persistent" desc="Request persistent connections?">
 969        false</configboolean>
 970        <configstring name="hostspec" desc="Database name or Easy Connect
 971        parameter">horde</configstring>
 972        <configstring name="username" desc="What username do we authenticate to
 973        the database server as?">horde</configstring>
 974        <configstring name="password" required="false" desc="What password do we
 975        authenticate to the database server with?"/>
 976        <configstring name="table" required="false" desc="The name of the session
 977        table in the database [horde_sessionhandler]"/>
 978       </configsection>
 979      </case>
 980      <case name="pgsql" desc="PostgreSQL based sessions">
 981       <configsection name="params">
 982        <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
 983        <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
 984         <case name="unix" desc="UNIX Sockets">
 985          <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
 986         </case>
 987         <case name="tcp" desc="TCP/IP">
 988          <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
 989         </case>
 990        </configswitch>
 991        <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>
 992        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
 993        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
 994        <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
 995        <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
 996       </configsection>
 997      </case>
 998      <case name="sapdb" desc="Use PEAR's DB abstraction layer w/ODBC">
 999       <configsection name="params">
1000        <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>
1001        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
1002        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
1003        <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
1004        <configstring name="table" desc="The name of the session table in the database"/>
1005       </configsection>
1006      </case>
1007      <case name="sql" desc="Use PEAR's DB abstraction layer">
1008       <configsection name="params">
1009        <configboolean name="persistent" desc="Request persistent connections?">false</configboolean>
1010        <configswitch name="protocol" desc="What protocol will we use to connect to the database?">unix
1011         <case name="unix" desc="UNIX Sockets">
1012          <configstring name="socket" required="false" desc="Location of UNIX socket"></configstring>
1013         </case>
1014         <case name="tcp" desc="TCP/IP">
1015          <configinteger name="port" required="false" desc="Port the DB is running on, if non-standard">5432</configinteger>
1016         </case>
1017        </configswitch>
1018        <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>
1019        <configstring name="username" desc="What username do we authenticate to the database server as?">horde</configstring>
1020        <configstring name="password" required="false" desc="What password do we authenticate to the database server with?"/>
1021        <configstring name="database" desc="What database name/tablespace are we using?">horde</configstring>
1022        <configstring name="table" required="false" desc="The name of the session table in the database [horde_sessionhandler]"/>
1023       </configsection>
1024      </case>
1025      <case name="memcache" desc="Memcache server">
1026       <configsection name="params">
1027        <configlist name="hostspec" desc="What hostname is the memcache server
1028        running on, or what is the name of the system DSN to use?  Specify
1029        multiple servers separated by commas.">localhost</configlist>
1030        <configlist name="port" required="false" desc="Port(s) the memcache
1031        server is running on. If more than one host is used, specify ports for
1032        respective servers, separated by commas">11211</configlist>
1033        <configboolean name="persistent" required="false" desc="Request
1034        persistent connection to server.">false</configboolean>
1035        <configboolean name="compression" required="false" desc="Enable
1036        compression for storing entries on server.">false</configboolean>
1037        <configstring name="lock_dir" desc="Specify a directory to which the
1038        session locks should be written">/tmp</configstring>
1039       </configsection>
1040      </case>
1041     </configswitch>
1042    </configsection>
1043   </configtab>
1044  
1045   <configtab name="image" desc="Image Manipulation">
1046    <configsection name="image">
1047     <configheader>Image Manipulation</configheader>
1048     <configstring name="convert" required="false" desc="Horde requires either
1049     GD support built-in to PHP (--with-gd) or the ImageMagick software
1050     package (http://www.imagemagick.org/) to do image
1051     manipulation/creation. If using ImageMagick, specify the full path
1052     name to the 'convert' program. On Windows, this path *cannot* have
1053     spaces in it. Use DOS-style abbreviations if necessary: Progra~1
1054     instead of Program Files, for instance. If using GD, or using
1055     neither, leave this field blank."/>
1056    </configsection>
1057   </configtab>
1058  
1059   <configtab name="mime" desc="MIME Detection">
1060    <configsection name="mime">
1061     <configheader>MIME Detection</configheader>
1062     <configstring name="magic_db" required="false" desc="Location of the MIME
1063     magic database. Usually /usr/share/misc/magic or /etc/magic."/>
1064    </configsection>
1065   </configtab>
1066  
1067   <configtab name="geoip" desc="Hostname-&gt;Country Lookup">
1068    <configsection name="geoip">
1069     <configheader>Hostname-&gt;Country Lookup</configheader>
1070     <configstring name="datafile" required="false" desc="Horde, by default, can
1071     do Hostname -&gt; Country lookup using the top level domain (e.g. 'uk',
1072     'de') of the hostname.  However, many popular top level domains
1073     (e.g. 'com', 'net') span more than one country.  In these instances, Horde
1074     can use the MaxMind GeoIP Hostname to Country lookup to try to determine
1075     the correct country.  To activate this functionality, the GeoIP.dat country
1076     database must be present on your local system.  This file can be downloaded
1077     free of charge from http://www.maxmind.com/download/geoip/database/.  If
1078     this database is present, specify the full path name to the database below.
1079     If empty, the GeoIP lookup will not be performed."/>
1080    </configsection>
1081   </configtab>
1082  
1083   <configtab name="problems" desc="Problem Reporting">
1084    <configsection name="problems">
1085     <configheader>Problem Reporting</configheader>
1086     <configswitch name="tickets" desc="If a ticket system with a
1087     tickets/addTicket API method is present, should we create tickets for
1088     problem reports instead of emailing them?">false
1089      <case name="true" desc="Yes">
1090       <configphp name="ticket_params" desc="Enter as a PHP array any
1091       additional arguments for the created ticket (queue, state, priority,
1092       etc). Example for Whups: array('queue' => 2, 'state' => 1, 'priority' => 1,
1093       'type' => 1). You will need to look up the appropriate IDs in Whups's
1094       database, or whatever is appropriate for the ticket system you are
1095       using.">array()</configphp>
1096      </case>
1097      <case name="false" desc="No">
1098       <configstring name="email" desc="Where should problem report emails be sent?">
1099       webmaster@example.com</configstring>
1100       <configstring name="maildomain" desc="If Horde cannot determine a user's
1101       email address, this domain will be appended to their
1102       username.">example.com</configstring>
1103       <configstring name="username" required="false" desc="If requiring SMTP
1104       authentication without a global SMTP user (in section &quot;Mailer&quot;
1105       and allowing problem reporting for not authenticated users (in section
1106       &quot;Menu Settings&quot;), what username should be use for SMTP
1107       authentication?"/>
1108       <configstring name="password" required="false" desc="The password to use"/>
1109      </case>
1110     </configswitch>
1111    </configsection>
1112   </configtab>
1113  
1114   <configtab name="menu" desc="Menu Settings">
1115    <configheader>Menu Settings</configheader>
1116    <configsection name="menu">
1117     <configmultienum name="apps" desc="Select any applications that should be
1118     linked in Horde's menu">
1119      <values>
1120       <configspecial name="list-horde-apps" />
1121      </values>
1122     </configmultienum>
1123  
1124     <configboolean name="always" desc="Should we
1125     &lt;strong&gt;always&lt;/strong&gt; display the Horde
1126     frameset?">false</configboolean>
1127  
1128     <configsection name="links">
1129      <configenum name="help" desc="Should we display help links in the
1130      menu?">all
1131       <values>
1132        <value desc="All users">all</value>
1133        <value desc="Authenticated users">authenticated</value>
1134        <value desc="Never">never</value>
1135       </values>
1136      </configenum>
1137      <configboolean name="help_about" desc="Should we display the about link in
1138      the help menu?">true</configboolean>
1139      <configenum name="options" desc="Should we display options links in the
1140      menu? You still need to configure a preference backend in the
1141      &quot;Preference System&quot; section.">authenticated
1142       <values>
1143        <value desc="All users">all</value>
1144        <value desc="Authenticated users">authenticated</value>
1145        <value desc="Never">never</value>
1146       </values>
1147      </configenum>
1148      <configenum name="problem" desc="Should we display problem reporting links
1149      in the menu?">all
1150       <values>
1151        <value desc="All users">all</value>
1152        <value desc="Authenticated users">authenticated</value>
1153        <value desc="Never">never</value>
1154       </values>
1155      </configenum>
1156      <configenum name="login" desc="Should we display a login link in the menu
1157      when not logged in?">all
1158       <values>
1159        <value desc="All users">all</value>
1160        <value desc="Never">never</value>
1161       </values>
1162      </configenum>
1163      <configenum name="logout" desc="Should we display a logout link in the
1164      menu when logged in?">authenticated
1165       <values>
1166        <value desc="Authenticated users">authenticated</value>
1167        <value desc="Never">never</value>
1168       </values>
1169      </configenum>
1170      <configenum name="login" desc="Should we display a login link in the menu
1171      when not logged in?">all
1172       <values>
1173        <value desc="All users">all</value>
1174        <value desc="Never">never</value>
1175       </values>
1176      </configenum>
1177      <configenum name="logout" desc="Should we display a logout link in the
1178      menu when logged in?">authenticated
1179       <values>
1180        <value desc="Authenticated users">authenticated</value>
1181        <value desc="Never">never</value>
1182       </values>
1183      </configenum>
1184     </configsection>
1185    </configsection>
1186  
1187    <configsection name="logo">
1188     <configstring name="image" required="false" desc="The URL of an image for
1189     the top of the Horde menu. The image should be no larger than 140 pixels
1190     wide by 40 pixels high to prevent the frame from scrolling."/>
1191     <configstring name="link" required="false" desc="If a logo is displayed in
1192     the Horde menu, what URL (if any) should it link to?"/>
1193    </configsection>
1194   </configtab>
1195  
1196   <configtab name="hooks" desc="Custom Function Hooks">
1197    <configsection name="hooks">
1198     <configheader>Custom Function Hooks</configheader>
1199     <configdescription>
1200      There are example functions for all hooks in horde/config/hooks.php.dist.
1201     </configdescription>
1202     <configboolean name="permsdenied" desc="If this is checked, the
1203     function _perms_hook_denied() will be called to return an error message if
1204     a permission has been denied. Otherwise a standard message will be shown
1205     and the user won't see any action widgets that he doesn't have access
1206     to.">false</configboolean>
1207     <configboolean name="username" desc="If this is checked, the function
1208     _username_hook_frombackend() will be used to set the user name at login
1209     time. The counterpart function _username_hook_tobackend() will be used to
1210     convert user names back, for example when showing name lists to the
1211     user.">false</configboolean>
1212     <configboolean name="preauthenticate" desc="If this is checked and the
1213     function _horde_hook_preauthenticate() returns false, authentication will
1214     fail.">false</configboolean>
1215     <configboolean name="postauthenticate" desc="If this is checked and the
1216     function _horde_hook_postauthenticate() returns false, authentication will
1217     fail.">false</configboolean>
1218     <configboolean name="authldap" desc="If this is checked, the function
1219     _horde_hook_authldap() will be used to create and set the attributes needed
1220     to add/edit/delete users by the LDAP Auth driver.">false</configboolean>
1221    </configsection>
1222   </configtab>
1223  
1224   <configtab name="block" desc="Portal Block Configuration">
1225    <configsection name="portal">
1226     <configheader>Fixed Blocks</configheader>
1227     <configmultienum name="fixed_blocks" muldesc="Which blocks should always be
1228      displayed in the portal?">
1229      <values>
1230       <configspecial name="list-blocks" />
1231      </values>
1232     </configmultienum>
1233    </configsection>
1234    <configheader>weather.com Configuration</configheader>
1235    <configsection name="weatherdotcom">
1236     <configdescription>
1237      Use of the weather.com block requires free registration for the XML
1238      feed at http://www.weather.com/services/xmloap.html.
1239      After registration, an email will be returned with the Partner ID and
1240      license key.&lt;br /&gt;
1241      NOTE: weather.com guidelines require registration and use of the returned
1242      values, but the application appears to function with any string values.
1243     </configdescription>
1244     <configstring name="partner_id" required="false" desc="The partner I.D.
1245     from weather.com"/>
1246     <configstring name="license_key" required="false" desc="The license key
1247     from weather.com"/>
1248    </configsection>
1249  
1250    <configheader>Fortune Configuration</configheader>
1251    <configsection name="fortune">
1252     <configstring name="exec_path" required="false" desc="Path to fortune
1253     executable, e.g. /usr/games/fortune"/>
1254    </configsection>
1255  
1256    <configheader>Account Info Configuration</configheader>
1257    <configsection name="accounts">
1258     <configswitch name="driver" desc="What  driver should we use?">null
1259      <case name="null" desc="null"/>
1260      <case name="localhost" desc="localhost">
1261       <configsection name="params">
1262        <configstring name="quota_path" desc="Path to the quota program">/usr/bin/quota</configstring>
1263        <configstring name="grep_path" desc="Path to the grep program">/bin/grep</configstring>
1264        <configboolean name="translateMountPoint" desc="Should we translate home directories to mount point device names?">false</configboolean>
1265        <configstring name="translationTable" desc="File to translate directory names to mount point device names?">/etc/mtab</configstring>
1266       </configsection>
1267      </case>
1268      <case name="ldap" desc="LDAP">
1269       <configsection name="params">
1270        <configstring name="host" desc="LDAP server/host">localhost</configstring>
1271        <configinteger name="port" required="false" desc="Port LDAP is running on, if non-standard">389</configinteger>
1272        <configstring name="basedn" desc="basedn string">o=example.com,c=US</configstring>
1273        <configstring name="attr" desc="LDAP attribute to search on">uid</configstring>
1274        <configenum name="version" desc="LDAP Protocol Version">3
1275         <values>
1276          <value desc="LDAPv2 (Deprecated)">2</value>
1277          <value desc="LDAPv3">3</value>
1278         </values>
1279        </configenum>
1280       </configsection>
1281      </case>
1282     </configswitch>
1283    </configsection>
1284   </configtab>
1285   <configtab name="imsp" desc="IMSP server settings">
1286    <configsection name="imsp">
1287     <configdescription>
1288         If you plan to use any of Horde's IMSP server support, enable this option and
1289         configure the server settings below.  Note that you must still configure/enable
1290         specific IMSP support in the appropriate section.
1291     </configdescription>
1292     <configswitch name="enabled">false
1293      <case name="false" desc="Disabled" />
1294      <case name="true" desc="Enabled">
1295       <configheader>IMSP Server Settings</configheader>
1296       <configstring name="server" desc="Server Address:">localhost</configstring>
1297       <configstring name="port" desc="Server port:">406</configstring>
1298       <configswitch name="auth_method" desc="The authentication method to use">plaintext
1299        <case name="plaintext" desc="Plaintext" />
1300        <case name="cram_md5" desc="CRAM-MD5" />
1301        <case name="imtest" desc="Cyrus imtest">
1302         <configstring name="socket" desc="Path to the directory that will hold the socket.
1303         (The socket will be named 'imsp_username.sck').">/tmp/</configstring>
1304         <configstring name="command" desc="Path to imtest binary">/cyrus/usr/cyrus/bin/imtest</configstring>
1305         <configenum name="auth_mechanism" description="What authentication method do you want
1306         to use with the imtest utility?">
1307          <values>
1308           <value desc="Plaintext (LOGIN)">LOGIN</value>
1309           <value desc="GSSAPI">gssapi</value>
1310          </values>
1311         </configenum>
1312        </case>
1313       </configswitch>
1314      </case>
1315     </configswitch>
1316    </configsection>
1317   </configtab>
1318  
1319   <configtab name="kolab" desc="Kolab Groupware Server">
1320    <configsection name="kolab">
1321     <configdescription>
1322      &lt;strong&gt;*** IF YOU HAVE NO IDEA WHAT KOLAB IS THEN YOU CAN SAFELY
1323      IGNORE THIS TAB ***&lt;/strong&gt;&lt;br /&gt;
1324      Kolab is in no way required for normal Horde usage. If, however, you
1325      intend to use Horde as a webclient for Kolab then you will need to ensure
1326      that the following fields correspond to those required by your Kolab
1327      installation.  You can find some of the required values in the
1328      &lt;code&gt; $KOLAB_ROOT/etc/kolab/kolab.conf&lt;/code&gt; configuration
1329      file. Please note that the old iCal/vCard storage format has been dropped
1330      in favour of the new XML storage format &amp;amp; IMAP folder annotations;
1331      subsequently the Horde Kolab modules will only work with version 2 of the
1332      Kolab server.&lt;br /&gt;
1333      If you would like to find out more about Kolab then please visit the Kolab
1334      community website at http://www.kolab.org/
1335     </configdescription>
1336     <configswitch name="enabled" quote="false" desc="Horde/Kolab integration
1337      status">false
1338      <case name="false" desc="Disabled" />
1339      <case name="true" desc="Enabled">
1340       <configheader>Kolab LDAP Server Settings</configheader>
1341       <configsection name="ldap">
1342        <configstring name="server" desc="Server
1343        address:">localhost</configstring>
1344        <configinteger name="port" desc="Server port:">389</configinteger>
1345        <configstring name="basedn" desc="Base DN:">dc=example,
1346        dc=com</configstring>
1347        <configstring name="binddn" desc="Bind DN:">cn=manager, cn=internal,
1348        dc=example, dc=com</configstring>
1349        <configstring name="bindpw" desc="Bind Password:">password</configstring>
1350        <configstring name="phpdn" desc="Search DN:">cn=nobody, cn=internal,
1351        dc=example, dc=com</configstring>
1352        <configstring name="phppw" desc="Search
1353        Password:">password</configstring>
1354       </configsection>
1355       <configheader>Kolab Cyrus IMAP Server Settings</configheader>
1356       <configsection name="imap">
1357        <configstring name="server" desc="Server
1358        address:">mail.example.com</configstring>
1359        <configinteger name="port" desc="Server port:">143</configinteger>
1360        <configinteger name="sieveport" desc="Sieve port:">2000</configinteger>
1361        <configstring name="maildomain" desc="Default
1362        maildomain:">example.com</configstring>
1363        <configstring name="adminuser" desc="Administrator
1364        user:">manager</configstring>
1365        <configstring name="adminpw" desc="Administrator
1366        password:">password</configstring>
1367        <configboolean name="virtdomains" desc="Virtual
1368        domains:">true</configboolean>
1369       </configsection>
1370     <configboolean name="groupldap" desc="If this is checked, the function
1371     _horde_hook_groupldap() will be used to create and set the attributes needed
1372     to add/edit/delete groups by the LDAP Group driver.">false</configboolean>
1373       <configheader>Kolab SMTP Server Settings</configheader>
1374       <configsection name="smtp">
1375        <configstring name="server" desc="Server
1376        address:">localhost</configstring>
1377        <configinteger name="port" desc="Server port:">25</configinteger>
1378       </configsection>
1379      </case>
1380     </configswitch>
1381    </configsection>
1382   </configtab>
1383  </configuration>