GenericUserFolder Walkthrough (GUF)

Created by . Last modified on 2003/08/01.

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 dependant.
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 two roles (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).
    1. The default login screen should appear. Enter jorge as the username and secret as the password. Click Ok.
    2. The index_html document should display.