 
INTRODUCTION
------------

The Passwd module is a module that allows the user to change their own
password via a poppassd server.  It also allows administrators to change
other people's passwords (assuming they know the old password).

Note that poppassd uses clear text password transmissions.  This can be
considered somewhat safe if the server is on the same machine and the
connection uses the loopback (localhost) interace.  It is up to the
installer to evaluate the security implications of using this module. 

PREREQUISITES
-------------

The following prerequisites are REQUIRED.

  1. A successful HORDE 2.0 installation and all which that entails.

  2. A poppassd server installed, running, and working on a system.

  3. You are not using the "realm" feature in horde/imp/config/servers.php
     or have a poppassd that will accept username@host.domain users.

INSTALLING PASSWD
-----------------

Passwd is intended to be installed inside the HORDE package directory.

Since Passwd is written in PHP, there is no compilation necessary;
simply expand the distribution where you want it to reside (normally
into a directory inside the HORDE directory). 

For example, with the Apache webserver's default document
root of '/usr/local/apache/htdocs'  and your HORDE install in a directory
under that called 'horde' you would type:

   cd /usr/local/apache/htdocs/horde
   tar zxvf /path/to/passwd.tgz

CONFIGURING PASSWD
------------------

1. We assume that you already have a working HORDE installation.

2. Configuring Passwd

   To configure passwd, change to the config/ directory of the
   installed distribution, and make copies of all of the configuration
   "dist" files without the "dist" suffix:

      cd config/
      for foo in *.dist; do cp $foo `basename $foo .dist`; done

   Documentation on the format of those files can be found in each
   file; open each in an editor and make changes as suggested within.
   The default values are reasonable, but may not be appropriate for
   your site.

3. Configuring HORDE

   To make Passwd appear in HORDE, you need to add an entry to the HORDE
   horde/config/registry.php file. You want to add a section that looks
   like:

$this->applications['passwd'] = array(
    'fileroot' => dirname(__FILE__) . '/../passwd',
    'webroot' => $this->applications['horde']['webroot'] . '/passwd',
    'icon' => $this->applications['horde']['webroot'] . '/passwd/graphics/lock.gif',
    'name' => _("Password"),
    'allow_guests' => false,
    'show' => true
);


   If you want administrator's to be able to change other people's passwords,
   then you need to define those administrators in HORDE's config files.
   For example, in horde/config/horde.php:

   $conf['auth']['admins'] = array('eric','admin');

4. Optional Configuration of IMP

   If you have IMP installed, and want to include Passwd in the IMP menu
   bar, you can add the application to IMP as well.  Edit the file
   horde/imp/config/conf.php and include 'passwd' in the list of menu apps,
   for example, it might look like the following:

   $conf['menu']['apps'] = array('turba','passwd');

OBTAINING SUPPORT
-----------------

You can email me at rostetter@mail.utexas.edu.

CREDITS
-------

See the seperate CREDITS file under the docs/ directory.

