Applying Omega 3.1 HTML5 shiv patch for removing HTTP.
[project/totem.git] / modules / features / totem_user / README.txt
1
2 -- OVERVIEW --
3
4 The Totem User module manages all aspects of community member accounts.  It
5 handles the critical task of permissions management, allowing for controlled
6 access to communities as well as individual items of content within them.  It
7 also manages the additional capabilities granted to community managers.
8
9 -- FEATURES --
10
11 * Modal login, registration, and reset-password forms.
12
13 * Any member can start a new community.  This member thus becomes the owner,
14   with the highest level of permission control over the community. (?)
15
16 * The community owner sets one of three possible levels of access to it:
17   - Open: all site users (not just members of this community) can see all
18     content, but only members can post content.  Anyone can join without
19     approval required.
20   - Restricted: all site users can see content, but must be approved to join.
21   - Closed: only members can view the community and its content, and must be
22     approved to join.
23   Note that all communities can appear even to logged-out site users in search
24   results. (?)
25
26 * Community owners can grant Manager status to members of their community.
27   Managers are granted many of the same permissions over fellow members and
28   community content as owners have.  (See details below.)
29
30 * The community owner and managers can choose to block members from the
31   community.  They may request to rejoin, but will only regain full membership
32   access if the owner or or a manager later unblocks them.
33
34 * Members can invite friends to join their communities, via either email
35   addresses or posts to Facebook. Note: the fboauth module is packaged with 
36   Totem, but disabled by default. In order to use the Facebook integrations on
37   your site, you will need to set up a stub Facebook app, then set the App ID 
38   and App Secret variables. Further reading:
39   - https://developers.facebook.com/apps
40   - https://www.google.com/search?q=create+a+facebook+app+id
41   - http://example.com/admin/config/people/fboauth
42   - http://drupal.org/node/1950294
43
44
45 Following is a comparison of community owner, manager, and member permissions.
46
47   Owner only:
48
49   - grant and revoke Manager status to members
50
51   Owner and Managers:
52
53   - block and unblock members
54   - approve members to join (if the community is restricted or closed)
55   - remove members from the community
56
57   - edit content posted by other members
58   - remove other members' content from the community (but not delete it
59     permanently)
60
61   Members only:
62
63     - permanently delete one's own community content