history_read_multiple

history_read_multiple($nids)

Retrieves the last viewed timestamp for each of the passed node IDs.

Parameters

array $nids: An array of node IDs.

Return value

array Array of timestamps keyed by node ID. If a node has been previously viewed by the user, the timestamp in seconds of when the last view occurred; otherwise, zero.

File

core/modules/history/history.module, line 62: Records which users have read which content.

Code

function history_read_multiple($nids) {
  $history = &drupal_static(__FUNCTION__, array());
 
  $return = array();
 
  $nodes_to_read = array();
  foreach ($nids as $nid) {
    if (isset($history[$nid])) {
      $return[$nid] = $history[$nid];
    }
    else {
      // Initialize value if current user has not viewed the node.
      $nodes_to_read[$nid] = 0;
    }
  }
 
  if (empty($nodes_to_read)) {
    return $return;
  }
 
  $result = db_query('SELECT nid, timestamp FROM {history} WHERE uid = :uid AND nid IN ( :nids[] )', array(
    ':uid' => \Drupal::currentUser()->id(),
    ':nids[]' => array_keys($nodes_to_read),
  ));
  foreach ($result as $row) {
    $nodes_to_read[$row->nid] = (int) $row->timestamp;
  }
  $history += $nodes_to_read;
 
  return $return + $nodes_to_read;
}

Links:

https://api.drupal.org/api/drupal/core%21modules%21history%21history.module/function/history_read_multiple/8.2.x

doc_Drupal

2025-01-10 15:47:30

Comments