node_access_acquire_grants

• Drupal 5
• Drupal 6
• Drupal 7

• View documentation
• List references

Definition

node_access_acquire_grants($node)
modules/node/node.module, line 2247

Description

This function will call module invoke to get a list of grants and then write them to the database. It is called at node save, and should be called by modules whenever something other than a node_save causes the permissions on a node to change.

This function is the only function that should write to the node_access table.

Parameters

$node The $node to acquire grants for.

Related topics

Name	Description
Node access rights	The node access system determines who can do what to which nodes.

Code

<?php
function node_access_acquire_grants($node) {
  $grants = module_invoke_all('node_access_records', $node);
  if (empty($grants)) {
    $grants[] = array('realm' => 'all', 'gid' => 0, 'grant_view' => 1, 'grant_update' => 0, 'grant_delete' => 0);
  }
  else {
    // retain grants by highest priority
    $grant_by_priority = array();
    foreach ($grants as $g) {
      $grant_by_priority[intval($g['priority'])][] = $g;
    }
    krsort($grant_by_priority);
    $grants = array_shift($grant_by_priority);
  }

  node_access_write_grants($node, $grants);
}
?>