function node_access_grants

Same name and namespace in other branches
  1. 9 core/modules/node/node.module \node_access_grants()
  2. 8.9.x core/modules/node/node.module \node_access_grants()
  3. 10 core/modules/node/node.module \node_access_grants()
  4. 11.x core/modules/node/node.module \node_access_grants()

Fetches an array of permission IDs granted to the given user ID.

The implementation here provides only the universal "all" grant. A node access module should implement hook_node_grants() to provide a grant list for the user.

After the default grants have been loaded, we allow modules to alter the grants array by reference. This hook allows for complex business logic to be applied when integrating multiple node access modules.


$op: The operation that the user is trying to perform.

$account: The user object for the user performing the operation. If omitted, the current user is used.

Return value

An associative array in which the keys are realms, and the values are arrays of grants for those realms.

Related topics

4 calls to node_access_grants()
hook_query_TAG_alter in modules/system/system.api.php
Perform alterations to a structured query for a given tag.
node_access in modules/node/node.module
Determines whether the current user may perform the operation on the node.
node_access_view_all_nodes in modules/node/node.module
Determines whether the user has a global viewing grant for all nodes.
_node_query_node_access_alter in modules/node/node.module
Helper for node access functions.


modules/node/node.module, line 3215


function node_access_grants($op, $account = NULL) {
    if (!isset($account)) {
        $account = $GLOBALS['user'];
    // Fetch node access grants from other modules.
    $grants = module_invoke_all('node_grants', $account, $op);
    // Allow modules to alter the assigned grants.
    drupal_alter('node_grants', $grants, $account, $op);
    return array_merge(array(
        'all' => array(
    ), $grants);

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.