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

The Passwd module is a module that allows the user to change their own
password via a poppassd server.  

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.x installation and all which that entails.

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


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.  In particular if you use realms or virtual hosts you
   will need to change the configuration substantially.

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
);


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
-----------------

There is a mailing list for support:
  sork@lists.horde.org 

You can subscribe or view the archives at: 
  http://lists.horde.org/mailman/listinfo/sork/


CREDITS
-------

See the seperate CREDITS file under the docs/ directory.

POPPASSD SERVER SOFTWARE
------------------------

The following are some links that users have submitted.  No warrenty
is made for the following links or any software obtained from then.  These
are all user submitted links, and have not been tested or verified.  Use
these links are your own risk!

http://www.ceti.com.pl/~kravietz/prog.html
http://www.samera.net/rpm/
http://netwinsite.com/poppassd/
http://echelon.pl/pubs/poppassd-1.8.1.tar.gz

