<?xml version="1.0"?>
<!-- $Horde: forwards/config/conf.xml,v 1.7.2.1 2008/10/09 17:36:36 jan Exp $ -->
<configuration>
 <configsection name="server">
  <configheader>Server configuration</configheader>
  <configdescription>
    If not using realms (multiple domains or virtual hosting) then there is
    only one possible default configuration. Even if you are using
    realms/hosting, you have to set a default configuration. This may be
    overriden by realm/domain specific values by defining additional arrays,
    one per realm/domain, with the realm/domain name as the key instead of the
    key 'default'. This not possible with this interface though.
  </configdescription>
  <configswitch name="driver" desc="The driver to use">forwards
   <case name="customsql" desc="Custom SQL based forwarding driver">
    <configsection name="params">
     <configsql switchname="driverconfig"/>
     <configdescription>
       This driver allows for custom SQL queries into which variables will be
       substituted. The current FULL username will be provided as \U, target
       address will be provided as \T, the given password will be provided as
       \P, and the option to keep a local copy of forwarded addresses will be
       a "Y" or "N" value provided as \L. If the query to check the forwarding
       status returns no rows, it will be assumed that forwarding is not
       enabled.
     </configdescription>
     <configstring name="query_select" desc="Query to retrieve forwarding
     status"/>
     <configstring name="query_set" desc="Query to set forwarding address"/>
     <configstring name="query_disable" desc="Query to disable forwarding"/>
     <configstring name="column_target" desc="Column specifying the target
     forwarding address"/>
     <configstring name="column_keeplocal" desc="Column telling us if we are
     keeping a local copy"/>
    </configsection>
   </case>

   <case name="sql" desc="Exim mailer based SQL driver">
    <configsection name="params">
     <configsection name="default">
      <configsql switchname="driverconfig">
       <configstring name="table" desc="Database table">users</configstring>
       <configstring name="user_col" desc="Column which contains user
       names">user</configstring>
       <configstring name="pass_col" desc="Column with
       passwords">password</configstring>
       <configstring name="altemail" desc="Alternative email column name"/>
       <configstring name="forward" desc="Email forward yes or no"/>
      </configsql>
     </configsection>
    </configsection>
   </case>

   <case name="forwards" desc="FTP driver for dot-forward compliant mailers">
    <configsection name="params">
     <configsection name="default">
      <configstring name="host" desc="Hostname where the FTP server is running
      on">localhost</configstring>
      <configinteger name="port" desc="Port that the FTP server is
      using">21</configinteger>
      <configenum name="pasv" desc="Use FTP passive mode?">false
       <values>
        <value desc="No">false</value>
        <value desc="Yes">true</value>
       </values>
      </configenum>
      <configboolean name="ssl" required="false" desc="Use a secure SSL FTP
      connection?"/>
     </configsection>
    </configsection>
   </case>

   <case name="qmail" desc="FTP driver for qmail compliant mailers">
    <configsection name="params">
     <configsection name="default">
      <configstring name="host" desc="Hostname where the FTP server is running
      on">localhost</configstring>
      <configinteger name="port" desc="Port that the FTP server is
      using">21</configinteger>
      <configenum name="pasv" desc="Use FTP passive mode?">false
       <values>
        <value desc="No">false</value>
        <value desc="Yes">true</value>
       </values>
      </configenum>
      <configboolean name="ssl" required="false" desc="Use a secure SSL FTP
      connection?"/>
     </configsection>
    </configsection>
   </case>

   <case name="ldap" desc="LDAP driver">
    <configsection name="params">
     <configsection name="default">
      <configswitch name="schema" desc="LDAP schema to use">
       <configdescription>
        Select the schema your mail server expects to see in LDAP.
       </configdescription>
       <case name="qmail-ldap" desc="qmail+ldap schema from
       http://www.nrg4u.com" />
       <case name="sunone" desc="SunONE Directory Server schema" />
       <case name="exim" desc="Exim-based schema" />
       <case name="custom" desc="Custom attribute for forwarding addresses">
        <configstring name="attribute" desc="Custom attribute name">
         mailForwardingAddress
        </configstring>
       </case>
      </configswitch>
      <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 LDAP preference
      searches"/>
      <configstring name="searchdn" required="false" desc="DN with which to
      bind for searches - blank for anonymous"/>
      <configstring name="searchpw" required="false"  desc="Password with
      which to bind for searches - blank for anonymous"/>
      <configswitch name="writedn" desc="Bind to LDAP as which user when
      writing permissions to LDAP">
        <case name="user" desc="Bind as User" />
        <case name="admin" desc="Bind as Admin">
          <configstring name="admindn" desc="DN of the administrative account
          with which to bind for write operations"/>
          <configstring name="adminpw" desc="Password of the administrative
          DN"/>
        </case>
        <case name="searchdn" desc="Use search credentials"/>
      </configswitch>
      <configstring name="uid" desc="The username search key"/>
     </configsection>
    </configsection>
   </case>

   <case name="mdaemon" desc="MDaemon mail server driver">
    <configsection name="params">
     <configsection name="default">
      <configstring name="location" desc="Directory where MDaemon is
      installed"/>
     </configsection>
    </configsection>
   </case>

   <case name="plesk" desc="Plesk driver">
    <configsection name="params">
     <configsection name="default">
      <configphp name="host" desc="Hostname where the Plesk server is running
       on">$_SERVER['SERVER_NAME']</configphp>
      <configstring name="user" desc="Administrator or client user"/>
      <configstring name="pass" desc="Password"/>
     </configsection>
    </configsection>
   </case>

   <case name="soap" desc="SOAP based forwarding driver">
    <configsection name="params">
     <configdescription>
       This driver allows querying a SOAP server for retrieving/modifying of
       the forwarding options. Providing a password is optional.
     </configdescription>
     <configstring name="soap_proxy" desc="address of the soap server"/>
     <configstring name="soap_uri" desc="Namespace"/>
     <configstring name="fwd_fetch_func" desc="name of the SOAP function to
     get current settings"/>
     <configstring name="fwd_enable_func" desc="name of the SOAP function to
     set forwarding"/>
     <configstring name="fwd_disable_func" desc="name of the SOAP function to
     reset forwarding"/>
     <configstring name="username_varname" desc="SOAP argument name holding
     the mailbox"/>
     <configstring name="password_varname" required="false" desc="SOAP
     argument name holding the password"/>
     <configstring name="target_varname" desc="SOAP argument name holding the
     target email address"/>
     <configstring name="keeplocal_varname" desc="SOAP argument name holding
     whether or not to keep a local copy"/>
    </configsection>
   </case>
  </configswitch>
 </configsection>

 <configsection name="enabled">
  <configheader>General Options</configheader>
  <configboolean name="keeplocal" desc="Setting this option will allow a user
  the choice of keeping a local copy of forwarded mail.">true</configboolean>
  <configboolean name="authenticate" desc="Setting this option will force the
  user to provide a password.">true</configboolean>
  <configboolean name="fullemail" desc="Use the full email address as the user
  ID?">true</configboolean>
 </configsection>

 <configsection name="user">
  <configheader>Refused user names</configheader>
   <configlist name="refused" desc="Define usernames for which we will refuse
   to forward
   mails.">root,bin,daemon,adm,lp,shutdown,halt,uucp,ftp,anonymous,nobody,httpd,operator,guest,diginext,bind,cyrus,courier,games,kmem,mailnull,man,mysql,news,postfix,sshd,tty,www</configlist>
 </configsection>

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