function tac_fields_help in Taxonomy Access Control 6

Implements hook_help().

File

tac_fields/tac_fields.module, line 12

Allows administrators to control access to individual CCK fields based on the node's taxonomy categories.

Code

function tac_fields_help($path, $arg) {
  switch ($path) {
    case 'admin/help#tac_fields':
      drupal_set_message(t("Warning: The TAC Fields module is experimental.  Do not use on a production site."), 'warning', FALSE);

      // @todo Add more help.
      $message .= '' . '<p>' . t('This module provides taxonomy-based view and edit grants similar to those used in Taxonomy Access Control, but on a per-field basis. (Refer to the <a href="@tac_help">Taxonomy Access Control help page</a> for more information.)', array(
        '@tac_help' => url('admin/help', array(
          'fragment' => 'taxonomy_access',
        )),
      )) . '</p>' . '<p>' . t("Unlike node access, CCK's field access is subtractive.  That is, if even one module indicates that a user should be denied access to the field, then the user is denied access.  For example, if you have the Content Permissions module that comes with CCK enabled, you must check <em>edit field_name</em> or <em>view field_name</em> in addition to granting permission through this module.") . '</p>' . '<p>' . t('In order to control access to a field with TAC fields, you must first add that field on the administration page.  Fields that are not listed will fall back on whatever permissions for the field have been configured with other modules.') . '</p>' . '<p>' . t('Once you have enabled a field in TAC fields, you can then configure access to that field in much the same way that you would configure Taxonomy Access for nodes in general.  The same rules for determining whether or not a permission is granted apply.  See the <a href="@tac_help">Taxonomy Access Control help page</a> for more information.  (Unlike Taxonomy Access, only <em>view</em> and <em>edit</em> permissions are available; the rest are not applicable to fields.)', array(
        '@tac_help' => url('admin/help', array(
          'fragment' => 'taxonomy_access',
        )),
      )) . '</p>';
      return $message;
      break;
  }
}