[Summary view] [Print] [Text view]

   1  $Id: README.txt,v 1.1.2.1.2.2 2009/01/02 20:05:27 fago Exp $
   2  
   3  Content Access Module
   4  -----------------------
   5  by Wolfgang Ziegler, nuppla@zites.net
   6  
   7  Yet another node access module.
   8  This module allows you to manage permissions for content types by role. It allows you to specifiy
   9  custom view, view own, edit, edit own, delete and delete own permissions for each content type.
  10  Optionally you can enable per content access settings, so you can customize the access for each
  11  content node.
  12  
  13  In particular
  14    * it comes with sensible defaults, so you need not configure anything and everything stays working
  15    * it is as flexible as you want. It can work with per content type settings, per content node settings
  16      as well as with flexible Access Control Lists (with the help of the ACL module).
  17    * it trys to reuse existing functionality instead of reimplementing it. So one can install the ACL
  18      module and set per user access control settings per content node.
  19      Furthermore the module provides conditions and actions for the rules module, which allows one
  20      to configure even rule-based access permissions.
  21    * it optimizes the written content node grants, so that only the really necessary grants are written.
  22      This is important for the performance of your site.
  23    * it takes access control as important as it is. E.g. the module has a bunch of simpletests to ensure
  24      everything is working right.
  25    * it respects and makes use of drupal's built in permissions as far as possible. Which means the
  26      access control tab provided by this module takes them into account and provides you a good overview
  27      about the really applied access control settings. [1]
  28  
  29  
  30  So the module is simple to use, but can be configured to provide really fine-grained permissions!
  31  
  32  
  33  Installation
  34  ------------
  35   * Copy the content access module's directory to your modules directory and activate the module.
  36   * Optionally download and install the ACL module too.
  37   * Edit a content type at admin/content/types. There will be a new tab "Access Control".
  38  
  39  
  40  ACL Module
  41  -----------
  42  You can find the ACL module at http://drupal.org/project/acl. To make use of Access Control Lists
  43  you'll need to enable per content node access control settings for a content type. At the access
  44  control tab of such a content node you are able to grant view, edit or delete permission for specific
  45  users.
  46  
  47  
  48  Running multiple node access modules on a site (Advanced!)
  49  -----------------------------------------------------------
  50  A drupal node access module can only grant access to content nodes, but not deny it. So if you
  51  are using multiple node access modules, access will be granted to a node as soon as one of the
  52  module grants access to it.
  53  However you can influence the behaviour by changing the priority of the content access module as
  54  drupal applies *only* the grants with the highest priority. So if content access has the highest
  55  priority *alone*, only its grants will be applied. 
  56  
  57  By default node access modules use priority 0.
  58  
  59  
  60  
  61  Footnotes
  62  ----------
  63  
  64  [1] Note that this overview can't take other modules into account, which might also alter node access.
  65      If you have multiple modules installed that alter node access, read the paragraph about "Running 
  66      multiple node access modules on a site".