Installing the LDAPUserFolder Product

    The former CMFLDAP product has been folded into the LDAPUserFolder 
    package. The CMF-related pieces and their unit tests run on Zope 
    version > 2.8 and CMF 1.5 and up.

    You will also need a (working) python-ldap module installed for the 
    Python binary that is used to run your Zope install, see 
    "Important Hints" below.

    This product does not require any special handling after unzipping
    and untarring it in the Zope Products directory. You should do 
    something like::

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

    Windows users can use WinZip or similar, it can handle tarred 
    gzip files. Make sure to move the extracted LDAPUserFolder 
    folder to your Zope installation's lib/python/Products-folder.

    That's all. Do not forget to restart Zope afterwards.


    **Installing the CMF-related pieces into your CMF site**

    When you create a new CMF Site you can activate CMFLDAP
    by checking the CMFLDAP checkbox after selecting
    'Configured CMF Site' from the Add List dropdown in the ZMI.

    To activate CMFLDAP in an existing CMF site you need to
    visit the portal_setup tool at the root of your CMF site from
    the ZMI. On the 'Properties' tab, select 'CMFLDAP' in the
    'Active site configuration' dropdown list. Then visit the
    'Import' tab and click on 'Import all steps' at the bottom.


    **Upgraders beware**

    In order to avoid problems everyone who upgrades from a prior 
    version of the LDAPUserFolder should delete and recreate any
    LDAPUserFolder instance they have!

    
    **Important Hints**

    Depending on your choice of Zope install (e.g. compiled from source
    or binary version) you need to make sure that the python-ldap 
    module (see README.txt) can be found by Zope.

    The first step after compiling the python-ldap module is to find 
    out if it works correctly by firing up your Python interpreter 
    (the same one that runs your Zope, that is) and typing "import ldap". 
    Then hit return. If no error message shows up the module is compiled 
    and installed correctly. Many people get tripped up by the fact that
    Zope binary distributions come with their own Python binaries, you must
    install python-ldap using that specific Python binary that is used
    by Zope.

    If you for some reason decide to run Zope on a certain OS from Redmond
    you might have difficulties getting python-ldap in a precompiled 
    version. The official python-ldap website lists some sources::

      http://python-ldap.sourceforge.net/

    See README.txt for any other dependencies and requirements.

