Index: openacs-4/packages/directory/www/doc/index.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/directory/www/doc/index.adp,v diff -u -r1.2 -r1.3 --- openacs-4/packages/directory/www/doc/index.adp 26 Aug 2015 18:03:36 -0000 1.2 +++ openacs-4/packages/directory/www/doc/index.adp 12 Sep 2016 06:03:47 -0000 1.3 @@ -18,29 +18,29 @@ Bonnet

-Installation +Installation

This is the Directory Package. It is a very simple (1 page) package for listing and searching through the members of a subsite. It is fully subsite-aware, using the application_groups -functionality in ACS4.2 to define subsite membership.

If you're reading this, then you probably have the package +functionality in ACS4.2 to define subsite membership.

If you're reading this, then you probably have the package installed already. If not, load the .apm file into the package manager (/acs-admin/apm/) and click install. The data model for this package is very minimal (3 views) and should load very quickly. If there are any errors loading this package, make sure you are using ACS4.2, since this package requires the new -subsite-scoping features. If you geta "query returned no rows" -error, visit the admin/groups page for your subsite, so that it can -configure itself as necessary, and then try the Directory package -again.

+subsite-scoping features. If you geta "query returned no +rows" error, visit the admin/groups page for your subsite, so +that it can configure itself as necessary, and then try the +Directory package again.

-Using the Directory -Package +Using the Directory +Package

Now that you have the package installed, you need to mount it somewhere. If you only have one instance of the acs-subsite package -mounted (the "Main Site") you can mount it anyhwere under that -package. If you have multiple instances of acs-subsite, you can -mount an instance of Directory under each subsite.

When listing users, the Directory package will find the nearest +mounted (the "Main Site") you can mount it anyhwere under +that package. If you have multiple instances of acs-subsite, you +can mount an instance of Directory under each subsite.

When listing users, the Directory package will find the nearest subsite above it on the site_nodes tree. It will then list everybody that is a member of that subsite (based on membership in the application_group associated with that subsite, see @@ -56,13 +56,13 @@ their last name starts with, or a search criteria. The search shows users that have the search criteria anywhere in their first name, last name, or email address (case-insensitive). When searching, a -"browse by letter" link will appear next to the search box, to -allow you to go back to browse mode. When searching or browsing, -the number of results per page can be restricted by clicking one of -the "show" links on the left side. You also have the choice of -viewing "subsite members" (people who have been explicitly made a -member of the current subsite) or "all users" (all registered users -of the site).

+"browse by letter" link will appear next to the search +box, to allow you to go back to browse mode. When searching or +browsing, the number of results per page can be restricted by +clicking one of the "show" links on the left side. You +also have the choice of viewing "subsite members" (people +who have been explicitly made a member of the current subsite) or +"all users" (all registered users of the site).