modules/taxonomy_access/README.txt

-----------------------
GENERAL DESCRIPTION
-----------------------
This module allows you to set access permissions for various categories based
on user role.  

This works as a hook into node_access and follows the same general structure
as the node_access module.  It's got permissions for view, update and delete
for each category on the system.  


-----------------------
API functions
-----------------------

There are two ways you can check whether or not a user has
access for a given taxonomy.

First, you can call node_access() on a given node
and if taxonomy_access module is enabled it will take category permissions into
account when determining whether or not the user has access to the given node.

The second way is to call the function taxonomy_access() which takes two
parameters, an operation and a taxonomy, with a third optional paramater of a
userid to use instead of the current user. It returns whether or not the user
is authorized, almost identical to node_access().


-----------------------
DATABASE TABLES
-----------------------
Module creates two tables in database: 'term_access' and
'term_access_defaults'


-----------------------
HELP PAGES
-----------------------
For more information about how to control access permissions with the Taxonomy
Access Control module, see the module's help page (admin/help/taxonomy_access).

Also see, help page at drupal.org: http://drupal.org/node/31601


-----------------------
TROUBLESHOOTING:
-----------------------

When users can view/edit pages, they do not have permission:

1. Check if user role have 'administer nodes' permission.

2. Check if you have ANY 'node access' module installed on your system. 
    IMPORTANT: When using more 'node access' type module, 
      Permissions are ALWAYS OR-ed together.
      If one module grants permissions for a given user (role) for a node ,
      then user CAN view/edit/delete even if other module DENIES it.

3 Do a General Database Housekeeping
  (Tables: 'node_access','term_access' and 'term_access_defaults'):

  - First 'DISABLE', then 'RE-ENABLE' the 'Taxonomy Access Module' on page:
    "Administer >> Site building >> Modules".
    
  This will force the complete rebuild of the 'node_access' table.
  
4. For debugging, please install deve_node_access module (Devel module)
   This can show you some information about node_access values in 
   the database when viewing a node page.

5. Force rebuilding of the permissions cache (table 'node_access'):
    "Rebuild permissions" button on page: 
    "Administer >> Content Management >> Post settings".

    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.

-----------------------
UNINSTALL
-----------------------

1. After disabling module, you can make complete uninstall by choosing Taxonomy
   Access on page: "Administer >> Site building >> Modules >> Uninstall".

   This will remove all your settings of Taxonomy Access: variables and tables
   ('term_access' and 'term_access_defaults')

2. After uninstall, if the site is experiencing problems with permissions to
   content, you can rebuild the permission cache.
   See "Troubleshooting Section 5".

-----------------------
CONTACT
-----------------------

Please, send bug reports, feature requests, or other comments about Taxonomy
Access Control module: http://drupal.org/project/issues/taxonomy_access

You can also contact me personally:
Keve  ( http://drupal.org/user/13163/contact )
1	-----------------------
2	GENERAL DESCRIPTION
3	-----------------------
4	This module allows you to set access permissions for various categories based
5	on user role.
6
7	This works as a hook into node_access and follows the same general structure
8	as the node_access module. It's got permissions for view, update and delete
9	for each category on the system.
10
11
12	-----------------------
13	API functions
14	-----------------------
15
16	There are two ways you can check whether or not a user has
17	access for a given taxonomy.
18
19	First, you can call node_access() on a given node
20	and if taxonomy_access module is enabled it will take category permissions into
21	account when determining whether or not the user has access to the given node.
22
23	The second way is to call the function taxonomy_access() which takes two
24	parameters, an operation and a taxonomy, with a third optional paramater of a
25	userid to use instead of the current user. It returns whether or not the user
26	is authorized, almost identical to node_access().
27
28
29	-----------------------
30	DATABASE TABLES
31	-----------------------
32	Module creates two tables in database: 'term_access' and
33	'term_access_defaults'
34
35
36	-----------------------
37	HELP PAGES
38	-----------------------
39	For more information about how to control access permissions with the Taxonomy
40	Access Control module, see the module's help page (admin/help/taxonomy_access).
41
42	Also see, help page at drupal.org: http://drupal.org/node/31601
43
44
45	-----------------------
46	TROUBLESHOOTING:
47	-----------------------
48
49	When users can view/edit pages, they do not have permission:
50
51	1. Check if user role have 'administer nodes' permission.
52
53	2. Check if you have ANY 'node access' module installed on your system.
54	IMPORTANT: When using more 'node access' type module,
55	Permissions are ALWAYS OR-ed together.
56	If one module grants permissions for a given user (role) for a node ,
57	then user CAN view/edit/delete even if other module DENIES it.
58
59	3 Do a General Database Housekeeping
60	(Tables: 'node_access','term_access' and 'term_access_defaults'):
61
62	- First 'DISABLE', then 'RE-ENABLE' the 'Taxonomy Access Module' on page:
63	"Administer >> Site building >> Modules".
64
65	This will force the complete rebuild of the 'node_access' table.
66
67	4. For debugging, please install deve_node_access module (Devel module)
68	This can show you some information about node_access values in
69	the database when viewing a node page.
70
71	5. Force rebuilding of the permissions cache (table 'node_access'):
72	"Rebuild permissions" button on page:
73	"Administer >> Content Management >> Post settings".
74
75	If the site is experiencing problems with permissions to content, you may
76	have to rebuild the permissions cache. Possible causes for permission
77	problems are disabling modules or configuration changes to permissions.
78	Rebuilding will remove all privileges to posts, and replace them with
79	permissions based on the current modules and settings.
80
81	-----------------------
82	UNINSTALL
83	-----------------------
84
85	1. After disabling module, you can make complete uninstall by choosing Taxonomy
86	Access on page: "Administer >> Site building >> Modules >> Uninstall".
87
88	This will remove all your settings of Taxonomy Access: variables and tables
89	('term_access' and 'term_access_defaults')
90
91	2. After uninstall, if the site is experiencing problems with permissions to
92	content, you can rebuild the permission cache.
93	See "Troubleshooting Section 5".
94
95	-----------------------
96	CONTACT
97	-----------------------
98
99	Please, send bug reports, feature requests, or other comments about Taxonomy
100	Access Control module: http://drupal.org/project/issues/taxonomy_access
101
102	You can also contact me personally:
103	Keve ( http://drupal.org/user/13163/contact )