GenericUserFolder Walkthrough

  This document will take you click-by-click through getting a working
  GUF installation up and running. The result won't be terribly useful,
  but will prove that the product is working and give you a running
  installation to start customizing to your own site.

    1. Extract the GUF distibution at the top of your Zope installation.
       This will create lib/python/Products/GenericUserFolder in the right
       location. This step is operating system depentant.

    2. Confirm the permissions of the extracted files are correct. There
       is no information in the product that needs to be kept secure, so
       setting permissions so everyone can read the files is fine. There
       is no need for anyone to be able to write to the files. This is
       operating system dependant.

    3. Restart Zope. From here on, everything is done within Zope so
       all references to folders are Zope folders.

    4. Connect as the superuser (or other account that has Manager access
       to the root folder), and go to the Management interface.

    5. Confirm that the product exists in the Control Panel -> Products
       folder, and that it appears to be loaded correctly (the icon isn't
       the 'broken product' icon).

    6. Create a folder which you want to be protected using the GUF, ensuring
       'Create public interface' is checked and 'Create user folder' is **not**
       checked. I'll create one called GUFTest in my root folder. 

    7. Select the new folder using the tree. You may need to click on
       'Refresh' at the bottom of the tree before it is visible. When selected,
       the folder should have nothing in it but a document called index_html

    8. Create a GenericUserFolder object in this folder. Accept all the
       defaults. Select the newly created acl_users folder. When selected, 
       the GUF's Contents panel is displayed, and you should see it contains 
       several DTML methods called things like docLogin, userList, 
       userAuthenticate etc.

    9. Click on the User List tab in the GUF's management screen. You
       should see that there are two users defined (fred and jorge).
       
    10. Click on jorge. This will take you to the User Info panel. Note that
        jorge belongs to three roles (Anonymous, defaultrole and specialrole).

    11. Click on the Security tab. Unselect all check boxes in the 'Acquire 
	permission settings' column. In the 'Anonymous' column, enable the
	'Can Login and Logout' and 'Access contents information' boxes.
	When this is done, click on the 'Change' button at the bottom.

    12. Select the folder you created in step 5 (GUFTest in my case). Click
        on its Security tab to select its Security Management screen.

    13. When you scroll down to the bottom of this screem, you will see the
        'User defined roles' controls. Enter 'specialrole' in the text box
	and click on 'Add Role'. Once this is done, you will still be on
	the folder's Security Management screen, but a new column has
	been added for giving permissions to the newly created role.
	Note that roles (like most of Zope) are **case sensitive**.

    14. Uncheck all checkboxes in the 'Acquire permission settings' column.
        In the 'specialrole' column click the checkboxes to grant the 
	'Access contents information' and 'View' permissions. Click on the 
	'Change' button to save these changes, and click on Ok when the next 
	screen pops up.

    15. Close all of your browsers windows and restart it. This is needed
        to ensure that you are no longer logged in as a Manager.

    16. Enter the URL for the folder you created in step 5 (eg. 
	http://mysite:8080/GUFTest).

    17. The default login screen should appear. Enter 'jorge' as the
        username and 'secret' as the password. Click Ok.

    18. The index_html document should display.
