[wellwell-devel] [SCM] Interchange wellwell catalog branch, master, updated. edaf8d275247fb0934cf2d4746d250fb209ce60a

Stefan Hornburg racke at rt.icdevgroup.org
Mon Mar 30 09:32:54 UTC 2009


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Interchange wellwell catalog".

The branch, master has been updated
       via  edaf8d275247fb0934cf2d4746d250fb209ce60a (commit)
      from  8a7556c3398824f94cc346fed958d8d0f3a32f8f (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit edaf8d275247fb0934cf2d4746d250fb209ce60a
Author: Stefan Hornburg (Racke) <racke at linuxia.de>
Date:   Mon Mar 30 11:32:31 2009 +0200

    expanded the users section

-----------------------------------------------------------------------

Summary of changes and diff:
 README |   65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 63 insertions(+), 2 deletions(-)

diff --git a/README b/README
index bcb5a1f..258c4fd 100755
--- a/README
+++ b/README
@@ -33,10 +33,27 @@ Interchange 5.7.1 and at least:
 	Dispatch.pm 1.103
 	Order.pm 2.104
 
+Users, Roles and Permissions
+****************************
+
 Users
-*****
+-----
+
+Users are stored in the "users" table. The primary key is "uid", quite like
+an Unix user id, which is used to identify the user through the system.
+Other settings, like username and email, can be changed by the user.
+
+Roles
+-----
 
-By default, Wellwell comes with two user roles:
+Roles allow to group users and grant them permissions. Users are allowed
+to be in multiple roles.
+
+Roles are stored in the "roles" table. The primary key is "rid", quite like
+an Unix group id, which the exception of the two default roles (anonymous
+and authenticated). 
+
+The default user roles are:
 
     * Anonymous user: this role is used for users that don't have a user account or that are not authenticated.
     * Authenticated user: this role is automatically granted to all logged in users.
@@ -51,6 +68,34 @@ This matches the following records in the permissions table:
    1 |   0 | anonymous
    2 |   0 | authenticated
 
+The relationship between users and roles is kept in the "user_roles" table,
+e.g.
+
+ uid | rid 
+-----+-----
+   1 |   3
+   1 |   4
+
+Permissions
+-----------
+
+Permissions can be assigned to a role or to an user. If you want
+to restrict some content, you can use the [acl] tag for checking
+for proper permissions.
+
+The following example produces a link only if the current user
+has the "create_content" permission.
+
+[acl check create_content]
+<a href="[area new_content]">Create content</a>
+[/acl] 
+
+[acl] returns its body on success or the permission if body is
+empty.
+
+Please note that [acl check] without a permission is always
+successful.
+
 Automatic components/attributes
 *******************************
 
@@ -105,6 +150,22 @@ wellwell=> select * from form_attributes where component = 'content_edit';
    30 | uri  | content_edit | width     | 200
    31 | body | content_edit | height    | 400
 
+Hooks
+-----
+
+There are two hooks for forms:
+
+form_NAME_load (e.g. form_checkout_load)
+form_NAME_save (e.g. form_checkout_save)
+
+The first parameter for the hook sub is the part name.
+
+The load hook is called for the setup of a form part. It is not
+called if the profile check for the form part has been failed.
+
+The save hook is called if the form part has been successfully
+submitted (e.g. profile check successful).
+
 Theming
 -------
 


hooks/post-receive
-- 
Interchange wellwell catalog



More information about the wellwell-devel mailing list