Installing the CMFLDAP Product

    You will need Zope version 2.3.0 or higher and a CMF-based site.

    This is a companion product for the LDAPLoginAdapter (see 
    http://www.dataflake.org/software/ldaploginadapter for info) and 
    the LDAPUserManager (http://www.dataflake.org/software/ldapusermanager).
    It is is of no use by itself. Making sure you have those products
    installed and working will save you a lot of grief and me unnecessary
    questions.


    **Installing**

    Unzip / untar the compressed archive in your Zope Products directory.
    You should follow steps like::

        $ cp CMFLDAP-xyz.tgz <zope_root>/lib/python/Products
        $ cd <zope_root>/lib/python/Products
        $ tar zxvf CMFLDAP-xyz.tgz
        <watch files being decompressed>

    After the files have been uncompressed you will need to edit the file
    *cmfldap_conf.py* and then restart your Zope server. The *cmfldap_conf.py*
    configuration file will point the product at the LDAPUserManager instance
    you wish to use. Go to the first line that does not start with a hash (#)
    character. Replace /acl_manager with the path to your LDAPUserManager
    instance.

    When the site has been restarted you need to go into the management
    interface and navigate into your CMF instance. In the CMF root instantiate
    an External Method by selecting *External Method* from the dropdown list
    on the top right and fill in the following values::

      Id: Any id that is not yet taken
      Title: This is an optional field
      Module Name: CMFLDAP.Move2LDAP
      Function Name: Move2LDAP

    After hitting the *Add* button you will be back in the CMF site's root
    management view. Click on the external method you just created to see
    its management view.

    This method is run by selecting the "Test" tab at the top. It will 
    return a small log of modifications. This script can be re-run as
    often as you like to e.g. reinstall deleted components.

    The last step consists of adjusting the portal skins so that your 
    members will see the customized forms that are installed in the Skins
    Tool under the *cmfldap* Directory View:

      * Go into the Skins Tool by clicking on *portal_skins* in your CMF
        root management screen.

      * Select the *Properties* tab to view the currently available Skins.

      * You will need to insert *cmfldap* into the comma-separated list
        for every skin selection. Make sure you insert it to the right of
        *custom* (so that custom still has precedence) but to the left of
        both *generic* and *control* since *cmfldap* overrides some forms
        and methods within those.

      * Hit *Save* at the bottom of the form and you should be done.

    As a convenient example the external method you ran previously will 
    install a skin selection named *CMF-LDAP* as well. It is the same as
    *Basic*, but has the *cmfldap* directory view inserted in the right
    spot.

    See README.txt for any other dependencies and requirements.


    **Upgrading**
 
      If you upgrade this product you will need to re-run the external 
      method as described above.