DrupalAPI.de

1. drupal
   1. drupal6
   2. drupal7 node.api.php

Set permissions for a node to be written to the database.

When a node is saved, a module implementing hook_node_access_records() will be asked if it is interested in the access permissions for a node. If it is interested, it must respond with an array of permissions arrays for that node.

Each permissions item in the array is an array with the following elements:

• 'realm': The name of a realm that the module has defined in hook_node_grants().
• 'gid': A 'grant ID' from hook_node_grants().
• 'grant_view': If set to TRUE a user that has been identified as a member of this gid within this realm can view this node.
• 'grant_update': If set to TRUE a user that has been identified as a member of this gid within this realm can edit this node.
• 'grant_delete': If set to TRUE a user that has been identified as a member of this gid within this realm can delete this node.
• 'priority': If multiple modules seek to set permissions on a node, the realms that have the highest priority will win out, and realms with a lower priority will not be written. If there is any doubt, it is best to leave this 0.

Verwandte Themen

Hooks

Allow modules to interact with the Drupal core.

Node access rights

The node access system determines who can do what to which nodes.

Code

developer-docs/hooks/core.php, line 1360

<?php
function hook_node_access_records($node) {
  if (node_access_example_disabling()) {
    return;
  }

  // We only care about the node if it's been marked private. If not, it is
  // treated just like any other node and we completely ignore it.
  if ($node->private) {
    $grants = array();
    $grants[] = array(
      'realm' => 'example',
      'gid' => 1,
      'grant_view' => TRUE,
      'grant_update' => FALSE,
      'grant_delete' => FALSE,
      'priority' => 0,
    );

    // For the example_author array, the GID is equivalent to a UID, which
    // means there are many many groups of just 1 user.
    $grants[] = array(
      'realm' => 'example_author',
      'gid' => $node->uid,
      'grant_view' => TRUE,
      'grant_update' => TRUE,
      'grant_delete' => TRUE,
      'priority' => 0,
    );
    return $grants;
  }
}
?>