README.txt 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  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.