Home › API reference › taxonomy.api.php

hook_taxonomy_term_load

  1. drupal
    1. 7
Versions
7 hook_taxonomy_term_load($terms)

Act on taxonomy terms when loaded.

Modules implementing this hook can act on the term objects returned by taxonomy_term_load_multiple().

For performance reasons, information to be added to term objects should be loaded in a single query for all terms where possible.

Since terms are stored and retrieved from cache during a page request, avoid altering properties provided by the {taxonomy_term_data} table, since this may affect the way results are loaded from cache in subsequent calls.

Parameters

$terms An array of term objects, indexed by tid.

Related topics

Hooks
Allow modules to interact with the Drupal core.

Code

drupal/modules/taxonomy/taxonomy.api.php, line 104

<?php
function hook_taxonomy_term_load($terms) {
  $result = db_query('SELECT tid, foo FROM {mytable} WHERE tid IN (:tids)', array(':tids' => array_keys($terms)));
  foreach ($result as $record) {
    $terms[$record->tid]->foo = $record->foo;
  }
}
?>