function hook_tokens_alter

Alter replacement values for placeholder tokens.


$replacements: An associative array of replacements returned by hook_tokens().

$context: The context in which hook_tokens() was called. An associative array with the following keys, which have the same meaning as the corresponding parameters of hook_tokens():

  • 'type'
  • 'tokens'
  • 'data'
  • 'options'

See also


Related topics

1 invocation of hook_tokens_alter()
token_generate in drupal/includes/
Generates replacement values for a list of tokens.


drupal/modules/system/system.api.php, line 4497
Hooks provided by Drupal core and the System module.


function hook_tokens_alter(array &$replacements, array $context) {
  $options = $context['options'];
  if (isset($options['language'])) {
    $url_options['language'] = $options['language'];
    $language_code = $options['language']->language;
  else {
    $language_code = NULL;
  $sanitize = !empty($options['sanitize']);
  if ($context['type'] == 'node' && !empty($context['data']['node'])) {
    $node = $context['data']['node'];

    // Alter the [node:title] token, and replace it with the rendered content
    // of a field (field_title).
    if (isset($context['tokens']['title'])) {
      $title = field_view_field('node', $node, 'field_title', 'default', $language_code);
      $replacements[$context['tokens']['title']] = drupal_render($title);