function _devel_node_access_nar_alter

Mimics hook_node_access_records_alter() and traces what each module does with it.

Parameters

object $grants: An indexed array of grant records, augmented by the '#module' key, as created by _devel_node_access_module_invoke_all('node_access_records'). This array is updated by the hook_node_access_records_alter() implementations.

$node: The node that the grant records belong to.

Return value

A tree representation of the grant records in $grants including their history: $data[$realm][$gid] ['original'] - grant record before processing ['current'] - grant record after processing (if still present) ['changes'][]['op'] - change message (add/change/delete by $module) ['grant'] - grant record after change (unless deleted)

File

./devel_node_access.module, line 384

Functions for debugging node access permissions.

Code

function _devel_node_access_nar_alter(&$grants, $node) {

  //dpm($grants, '_devel_node_access_nar_alter(): grants IN');
  $dummy = array();
  drupal_alter('node_access_records', $dummy, $node);
  static $drupal_static = array();
  isset($drupal_static['drupal_alter']) || ($drupal_static['drupal_alter'] =& drupal_static('drupal_alter'));
  $functions = $drupal_static['drupal_alter'];

  // Build the initial tree (and check for duplicates).
  $data = _devel_node_access_build_nar_data($grants, $node, 'hook_node_access_records()');

  // Simulate drupal_alter('node_access_records', $grants, $node);
  foreach ($functions['node_access_records'] as $function) {

    // Call hook_node_access_records_alter() for one module at a time and
    // analyze.
    $function($grants, $node);

    // <==
    $module = substr($function, 0, strlen($function) - 26);
    foreach ($grants as $i => $grant) {
      if (empty($data[$grant['realm']][$grant['gid']]['current'])) {

        // It's an added grant.
        $data[$grant['realm']][$grant['gid']]['current'] = $grant;
        $data[$grant['realm']][$grant['gid']]['current']['#module'] = $module;
        $data[$grant['realm']][$grant['gid']]['changes'][] = array(
          'op' => 'added by ' . $module,
          'grant' => $grant,
        );
        $grants[$i]['#module'] = $module;
      }
      else {

        // It's an existing grant, check for changes.
        $view = $update = $delete = FALSE;
        foreach (array(
          'view',
          'update',
          'delete',
        ) as $op) {
          ${$op} = $grant["grant_{$op}"] - $data[$grant['realm']][$grant['gid']]['current']["grant_{$op}"];
        }
        $priority = $grant['priority'] - $data[$grant['realm']][$grant['gid']]['current']['priority'];
        if ($view || $update || $delete || $priority) {

          // It was changed.
          $data[$grant['realm']][$grant['gid']]['current'] = $grant;
          $data[$grant['realm']][$grant['gid']]['current']['#module'] = $module;
          $data[$grant['realm']][$grant['gid']]['changes'][] = array(
            'op' => 'altered by ' . $module,
            'grant' => $grant,
          );
          $grants[$i]['#module'] = $module;
        }
      }
      $data[$grant['realm']][$grant['gid']]['found'] = TRUE;
    }

    // Check for newly introduced duplicates.
    _devel_node_access_build_nar_data($grants, $node, 'hook_node_access_records_alter()');

    // Look for grant records that have disappeared.
    foreach ($data as $realm => $data2) {
      foreach ($data2 as $gid => $data3) {
        if (empty($data[$realm][$gid]['found']) && isset($data[$realm][$gid]['current'])) {
          unset($data[$realm][$gid]['current']);
          $data[$realm][$gid]['changes'][] = array(
            'op' => 'removed by ' . $module,
          );
        }
        else {
          unset($data[$realm][$gid]['found']);
        }
      }
    }
  }

  //dpm($data, '_devel_node_access_nar_alter() returns');

  //dpm($grants, '_devel_node_access_nar_alter(): grants OUT');
  return $data;
}