You are here

README.txt in Nodeaccess 5

Same filename and directory in other branches
  1. 8.2 README.txt
  2. 8 README.txt
  3. 6.2 README.txt
  4. 6 README.txt
  5. 7 README.txt
Node Access Module

This module allows you to manage permissions for nodes by role and user. In other words,
it implements per node access control for users and groups. With this module, you can
restrict access to any individual node without having to use taxonomy. You can assign 
permission to view, edit or delete each individual node by user or role. Once enabled,
a 'grant' tab will appear on node pages. You can click this and assign permissions for 
that node.

WARNINGS!

This is a development version for drupal 5.x. It has not been tested
extensively, and the upgrade process is rather complicated. Please do not throw
it on a production system. If you really need this module ASAP, please test it
out on a development copy of your website first.

INSTALLATION:

Put the module in your drupal modules directory and enable it in admin/modules.

If you are upgrading, be sure to run update.php as several changes are
required. This attempts to migrate your previous settings to the new setup in
drupal 5. I would strongly recommend backing up your database before installing
this module...

IMPORTANT!

Once you check the enable box and submit the page, no nodes will be accessible to anyone
other than the admin user. You just set permissions on the nodeaccess settings page 
(admin/settings/nodeaccess) to enable access to your site.

The settings page has a section for roles, and then a section for every node type you 
have on your site.

ALLOWED ROLES:

The allowed roles section allows you to choose what roles will appear on the node grant
tab. Just check each role you want to appear. Note that you can still set defaults for
all roles as the admin user, these options just hide what is available on each node
page.

NODE TYPE SETTINGS:

For each node type on your site, you can set default role access permissions and choose
if the grant tab should be available on that page. If the show grant tab option is 
not checked, the grant tab will not appear on the node page regardless of user permissions.

For each node type, you can also choose the default permissions for that type. To emulate 
standard drupal permissions, you would give anonymous user and authenticated user view permissions
for each node type. Note that once this module is first enabled, no permissions are granted, so
it is important to set defaults.

The default permissions for each node type will apply to any node which does not have
permissions set, either at the time you submit the settings or when any new node is
created. For already existing nodes, the defaults will apply only to those nodes which
have not had custom permissions set on the node grants tab. 

TIPS:

If you grant authenticated users edit permission, you cannot revoke that for any user
who is a member of authenticated users. For example, if you wanted all users to be able
to edit a node except for one user, you cannot do this by granted edit permission to 
authenticated users, then adding the user to the node without view permissions. Drupal
doesn't let you do that.

I haven't fully explored using this with multiple access control modules in
drupal 5 yet, so YMMV.

File

README.txt
View source
  1. Node Access Module
  2. This module allows you to manage permissions for nodes by role and user. In other words,
  3. it implements per node access control for users and groups. With this module, you can
  4. restrict access to any individual node without having to use taxonomy. You can assign
  5. permission to view, edit or delete each individual node by user or role. Once enabled,
  6. a 'grant' tab will appear on node pages. You can click this and assign permissions for
  7. that node.
  8. WARNINGS!
  9. This is a development version for drupal 5.x. It has not been tested
  10. extensively, and the upgrade process is rather complicated. Please do not throw
  11. it on a production system. If you really need this module ASAP, please test it
  12. out on a development copy of your website first.
  13. INSTALLATION:
  14. Put the module in your drupal modules directory and enable it in admin/modules.
  15. If you are upgrading, be sure to run update.php as several changes are
  16. required. This attempts to migrate your previous settings to the new setup in
  17. drupal 5. I would strongly recommend backing up your database before installing
  18. this module...
  19. IMPORTANT!
  20. Once you check the enable box and submit the page, no nodes will be accessible to anyone
  21. other than the admin user. You just set permissions on the nodeaccess settings page
  22. (admin/settings/nodeaccess) to enable access to your site.
  23. The settings page has a section for roles, and then a section for every node type you
  24. have on your site.
  25. ALLOWED ROLES:
  26. The allowed roles section allows you to choose what roles will appear on the node grant
  27. tab. Just check each role you want to appear. Note that you can still set defaults for
  28. all roles as the admin user, these options just hide what is available on each node
  29. page.
  30. NODE TYPE SETTINGS:
  31. For each node type on your site, you can set default role access permissions and choose
  32. if the grant tab should be available on that page. If the show grant tab option is
  33. not checked, the grant tab will not appear on the node page regardless of user permissions.
  34. For each node type, you can also choose the default permissions for that type. To emulate
  35. standard drupal permissions, you would give anonymous user and authenticated user view permissions
  36. for each node type. Note that once this module is first enabled, no permissions are granted, so
  37. it is important to set defaults.
  38. The default permissions for each node type will apply to any node which does not have
  39. permissions set, either at the time you submit the settings or when any new node is
  40. created. For already existing nodes, the defaults will apply only to those nodes which
  41. have not had custom permissions set on the node grants tab.
  42. TIPS:
  43. If you grant authenticated users edit permission, you cannot revoke that for any user
  44. who is a member of authenticated users. For example, if you wanted all users to be able
  45. to edit a node except for one user, you cannot do this by granted edit permission to
  46. authenticated users, then adding the user to the node without view permissions. Drupal
  47. doesn't let you do that.
  48. I haven't fully explored using this with multiple access control modules in
  49. drupal 5 yet, so YMMV.