You are here

Home » API reference » User Relationships 6

README.txt in User Relationships 6

Same filename in this branch
  1. 6 README.txt
  2. 6 user_relationship_elaborations/README.txt
  3. 6 user_relationship_mailer/README.txt
  4. 6 user_relationship_migrate/README.txt
  5. 6 user_relationship_defaults/README.txt
  6. 6 user_relationship_implications/README.txt
  7. 6 user_relationship_invites/README.txt
  8. 6 user_relationship_node_access/README.txt
  9. 6 user_relationship_blocks/README.txt
  10. 6 user_relationships_api/README.txt
Same filename and directory in other branches
  1. 7 user_relationship_node_access/README.txt
User Relationship Node Access
-----------------------------
Lets users set node permissions according to their relationships

The module allows node authors to share their posts with users with whom they have an establish relationship. It's also possible to grant edit and delete rights to related users. If you use Organic Groups, the module allows author's related users who aren't in any selected OG audience to still access the post. This module on its own does not deny access to any content.

Configuration
-----------------
1. Enable the module under Admin -> Site Building -> Modules
2. Under Administer -> Users -> Permissions, enable the "grant view permission to related users" permission to desired user roles that will be sharing their posts with their related users. For example, authenticated users
3. Under Administer -> Content Management -> Posting to social network enable the content types you with to be shareable. For our example, we'll enable Blog entry. Content types that are not checked will not have the "Post to social network" fieldset on the node creation/edit form
4. Now, when a user in the role you set in step 2 goes to create one of the enabled content types, they will see a fieldset called "Post to social network". In it they can check which types of relationships (out of those defined on your site) can see this post.

Advanced usage
-----------------
If you grant additional permissions "grant edit permission to related users" and "grant delete permission to related users", the form component on node creation form will change to a more complicated matrix of checkboxes, where node author can allow certain relationships to also edit and/or delete the node. This can be used for peer review, document approval, and other use cases.

Theming
-----------------
The standard "Post to social network" form component can be themed using standard Drupal form theming approaches. See http://api.drupal.org/api/file/developer/topics/forms_api.html/6.
Advanced form component "User Relationships Node Access" is themed by function theme_user_relationship_node_access_form($form), which you can override in your theme.

File

user_relationship_node_access/README.txt
View source 
  1. 

  2. User Relationship Node Access

  3. -----------------------------

  4. Lets users set node permissions according to their relationships

  5. 

  6. The module allows node authors to share their posts with users with whom they have an establish relationship. It's also possible to grant edit and delete rights to related users. If you use Organic Groups, the module allows author's related users who aren't in any selected OG audience to still access the post. This module on its own does not deny access to any content.

  7. 

  8. Configuration

  9. -----------------

  10. 1. Enable the module under Admin -> Site Building -> Modules

  11. 2. Under Administer -> Users -> Permissions, enable the "grant view permission to related users" permission to desired user roles that will be sharing their posts with their related users. For example, authenticated users

  12. 3. Under Administer -> Content Management -> Posting to social network enable the content types you with to be shareable. For our example, we'll enable Blog entry. Content types that are not checked will not have the "Post to social network" fieldset on the node creation/edit form

  13. 4. Now, when a user in the role you set in step 2 goes to create one of the enabled content types, they will see a fieldset called "Post to social network". In it they can check which types of relationships (out of those defined on your site) can see this post.

  14. 

  15. Advanced usage

  16. -----------------

  17. If you grant additional permissions "grant edit permission to related users" and "grant delete permission to related users", the form component on node creation form will change to a more complicated matrix of checkboxes, where node author can allow certain relationships to also edit and/or delete the node. This can be used for peer review, document approval, and other use cases.

  18. 

  19. Theming

  20. -----------------

  21. The standard "Post to social network" form component can be themed using standard Drupal form theming approaches. See http://api.drupal.org/api/file/developer/topics/forms_api.html/6.

  22. Advanced form component "User Relationships Node Access" is themed by function theme_user_relationship_node_access_form($form), which you can override in your theme.