You are here

README.txt in Taxonomy Access Control 7

Same filename and directory in other branches
  1. 5.2 README.txt
  2. 5 README.txt
  3. 6 README.txt
-----------------------
GENERAL DESCRIPTION
-----------------------
This module allows you to set access permissions for various taxonomy 
categories based on user role.  

There are permissions to VIEW, UPDATE, and DELETE nodes in each category.
Additionally, the ADD TAG permission control whether the user can add a 
taxonomy term to a node, and the VIEW TAG permission controls whether the user
can see the taxonomy term listed on the node.


-----------------------
HELP PAGES
-----------------------
For more information about how to control access permissions with the Taxonomy
access control module (TAC), see the module's help page at:
"Administration >> Help >> Taxonomy access control"
(admin/help/taxonomy_access).

Also see the help pages at drupal.org: http://drupal.org/node/31601


-----------------------
DATABASE TABLES
-----------------------
Module creates two tables in database: 'taxonomy_access_term' and
'taxonomy_access_default'


-----------------------
TROUBLESHOOTING
-----------------------

If users can view or edit pages that they do not have permission for:

1. Make sure the user role does not have "administer nodes" permission.  This 
   permission will override any settings from Taxonomy Access.

2. Check whether the user role has "edit any [type] content" permissions 
   under "node module" on the page: 
   "Administration >> People >> Permissions"
   (http://www.example.com/admin/people/permissions).

   Granting this permission overrides TAC's "Update" permissions for the given 
   content type, so you will not be able to deny the role edit access to any 
   nodes in that type.  (The same is true of "delete any [type] content" 
   permissions.)

3. Check to see if the user has other roles that may be granting other 
   permissions. Remember: Deny overrides Allow within a role, but Allow from 
   one role can override Deny from another.

4. Review the configuration for the authenticated user role on page:
   "Administration >> People >> Permissions"
   (http://www.example.com/admin/people/permissions).

   Remember that users with custom roles also have the authenticated role, so 
   they gain any permissions granted that role.

5. Check whether you have ANY OTHER node access modules installed.
   Other modules can override TAC's grants.

6. Do a General Database Housekeeping
  (Tables: 'node_access','taxonomy_access_term' and 'taxonomy_access_default'):

   First DISABLE, then RE-ENABLE the Taxonomy access module on page:
   "Administration >> Modules"
   (http://www.example.com/admin/modules).
    
  This will force the complete rebuild of the 'node_access' table.
  
7. For debugging, install devel_node_access module (Devel project).
   This can show you some information about node_access values in 
   the database when viewing a node page.

8. Force rebuilding of the permissions cache (table 'node_access'):
   "Rebuild permissions" button on page:
   "Administration >> Reports >> Status report >> Node Access Permissions"
   (http://www.example.com/admin/reports/status/rebuild).

   If the site is experiencing problems with permissions to content, you may
   have to rebuild the permissions cache. Possible causes for permission
   problems are disabling modules or configuration changes to permissions.
   Rebuilding will remove all privileges to posts, and replace them with
   permissions based on the current modules and settings.

-----------------------
UNINSTALLING
-----------------------

1. First DISABLE the Taxonomy access module on page:
   "Administration >> Modules"
   (http://www.example.com/admin/modules).

2. After disabling, you can uninstall completely by choosing Taxonomy
   Access on page: 
   "Administration >> Modules >> Uninstall"
   (http://www.example.com/admin/modules/uninstall).

   This will remove all your settings of Taxonomy Access: variables and tables
   ('taxonomy_access_term' and 'taxonomy_access_default').

3. After uninstalling, if the site is experiencing problems with permissions to
   content, you can rebuild the permission cache.
   See "Troubleshooting" #8.

File

README.txt
View source
  1. -----------------------
  2. GENERAL DESCRIPTION
  3. -----------------------
  4. This module allows you to set access permissions for various taxonomy
  5. categories based on user role.
  6. There are permissions to VIEW, UPDATE, and DELETE nodes in each category.
  7. Additionally, the ADD TAG permission control whether the user can add a
  8. taxonomy term to a node, and the VIEW TAG permission controls whether the user
  9. can see the taxonomy term listed on the node.
  10. -----------------------
  11. HELP PAGES
  12. -----------------------
  13. For more information about how to control access permissions with the Taxonomy
  14. access control module (TAC), see the module's help page at:
  15. "Administration >> Help >> Taxonomy access control"
  16. (admin/help/taxonomy_access).
  17. Also see the help pages at drupal.org: http://drupal.org/node/31601
  18. -----------------------
  19. DATABASE TABLES
  20. -----------------------
  21. Module creates two tables in database: 'taxonomy_access_term' and
  22. 'taxonomy_access_default'
  23. -----------------------
  24. TROUBLESHOOTING
  25. -----------------------
  26. If users can view or edit pages that they do not have permission for:
  27. 1. Make sure the user role does not have "administer nodes" permission. This
  28. permission will override any settings from Taxonomy Access.
  29. 2. Check whether the user role has "edit any [type] content" permissions
  30. under "node module" on the page:
  31. "Administration >> People >> Permissions"
  32. (http://www.example.com/admin/people/permissions).
  33. Granting this permission overrides TAC's "Update" permissions for the given
  34. content type, so you will not be able to deny the role edit access to any
  35. nodes in that type. (The same is true of "delete any [type] content"
  36. permissions.)
  37. 3. Check to see if the user has other roles that may be granting other
  38. permissions. Remember: Deny overrides Allow within a role, but Allow from
  39. one role can override Deny from another.
  40. 4. Review the configuration for the authenticated user role on page:
  41. "Administration >> People >> Permissions"
  42. (http://www.example.com/admin/people/permissions).
  43. Remember that users with custom roles also have the authenticated role, so
  44. they gain any permissions granted that role.
  45. 5. Check whether you have ANY OTHER node access modules installed.
  46. Other modules can override TAC's grants.
  47. 6. Do a General Database Housekeeping
  48. (Tables: 'node_access','taxonomy_access_term' and 'taxonomy_access_default'):
  49. First DISABLE, then RE-ENABLE the Taxonomy access module on page:
  50. "Administration >> Modules"
  51. (http://www.example.com/admin/modules).
  52. This will force the complete rebuild of the 'node_access' table.
  53. 7. For debugging, install devel_node_access module (Devel project).
  54. This can show you some information about node_access values in
  55. the database when viewing a node page.
  56. 8. Force rebuilding of the permissions cache (table 'node_access'):
  57. "Rebuild permissions" button on page:
  58. "Administration >> Reports >> Status report >> Node Access Permissions"
  59. (http://www.example.com/admin/reports/status/rebuild).
  60. If the site is experiencing problems with permissions to content, you may
  61. have to rebuild the permissions cache. Possible causes for permission
  62. problems are disabling modules or configuration changes to permissions.
  63. Rebuilding will remove all privileges to posts, and replace them with
  64. permissions based on the current modules and settings.
  65. -----------------------
  66. UNINSTALLING
  67. -----------------------
  68. 1. First DISABLE the Taxonomy access module on page:
  69. "Administration >> Modules"
  70. (http://www.example.com/admin/modules).
  71. 2. After disabling, you can uninstall completely by choosing Taxonomy
  72. Access on page:
  73. "Administration >> Modules >> Uninstall"
  74. (http://www.example.com/admin/modules/uninstall).
  75. This will remove all your settings of Taxonomy Access: variables and tables
  76. ('taxonomy_access_term' and 'taxonomy_access_default').
  77. 3. After uninstalling, if the site is experiencing problems with permissions to
  78. content, you can rebuild the permission cache.
  79. See "Troubleshooting" #8.