function NodeTokensHooks::tokens
Implements hook_tokens().
File
-
core/
modules/ node/ src/ Hook/ NodeTokensHooks.php, line 74
Class
- NodeTokensHooks
- Hook implementations for node.
Namespace
Drupal\node\HookCode
public function tokens($type, $tokens, array $data, array $options, BubbleableMetadata $bubbleable_metadata) {
$token_service = \Drupal::token();
$url_options = [
'absolute' => TRUE,
];
if (isset($options['langcode'])) {
$url_options['language'] = \Drupal::languageManager()->getLanguage($options['langcode']);
$langcode = $options['langcode'];
}
else {
$langcode = LanguageInterface::LANGCODE_DEFAULT;
}
$replacements = [];
if ($type == 'node' && !empty($data['node'])) {
/** @var \Drupal\node\NodeInterface $node */
$node = $data['node'];
foreach ($tokens as $name => $original) {
switch ($name) {
// Simple key values on the node.
case 'nid':
$replacements[$original] = $node->id();
break;
case 'uuid':
$replacements[$original] = $node->uuid();
break;
case 'vid':
$replacements[$original] = $node->getRevisionId();
break;
case 'type':
$replacements[$original] = $node->getType();
break;
case 'type-name':
$type_name = node_get_type_label($node);
$replacements[$original] = $type_name;
break;
case 'title':
$replacements[$original] = $node->getTitle();
break;
case 'body':
case 'summary':
$translation = \Drupal::service('entity.repository')->getTranslationFromContext($node, $langcode, [
'operation' => 'node_tokens',
]);
if ($translation->hasField('body') && ($items = $translation->get('body')) && !$items->isEmpty()) {
$item = $items[0];
// If the summary was requested and is not empty, use it.
if ($name == 'summary' && !empty($item->summary)) {
$output = $item->summary_processed;
}
else {
$output = $item->processed;
// A summary was requested.
if ($name == 'summary') {
// Generate an optionally trimmed summary of the body field.
// Get the 'trim_length' size used for the 'teaser' mode, if
// present, or use the default trim_length size.
$display_options = \Drupal::service('entity_display.repository')->getViewDisplay('node', $node->getType(), 'teaser')
->getComponent('body');
if (isset($display_options['settings']['trim_length'])) {
$length = $display_options['settings']['trim_length'];
}
else {
$settings = \Drupal::service('plugin.manager.field.formatter')->getDefaultSettings('text_summary_or_trimmed');
$length = $settings['trim_length'];
}
$output = text_summary($output, $item->format, $length);
}
}
// "processed" returns a \Drupal\Component\Render\MarkupInterface
// via check_markup().
$replacements[$original] = $output;
}
break;
case 'langcode':
$replacements[$original] = $node->language()
->getId();
break;
case 'published_status':
$replacements[$original] = $node->isPublished() ? t('Published') : t('Unpublished');
break;
case 'url':
$replacements[$original] = $node->toUrl('canonical', $url_options)
->toString();
break;
case 'edit-url':
$replacements[$original] = $node->toUrl('edit-form', $url_options)
->toString();
break;
// Default values for the chained tokens handled below.
case 'author':
$account = $node->getOwner() ? $node->getOwner() : User::load(0);
$bubbleable_metadata->addCacheableDependency($account);
$replacements[$original] = $account->label();
break;
case 'created':
$date_format = DateFormat::load('medium');
$bubbleable_metadata->addCacheableDependency($date_format);
$replacements[$original] = \Drupal::service('date.formatter')->format($node->getCreatedTime(), 'medium', '', NULL, $langcode);
break;
case 'changed':
$date_format = DateFormat::load('medium');
$bubbleable_metadata->addCacheableDependency($date_format);
$replacements[$original] = \Drupal::service('date.formatter')->format($node->getChangedTime(), 'medium', '', NULL, $langcode);
break;
}
}
if ($author_tokens = $token_service->findWithPrefix($tokens, 'author')) {
$replacements += $token_service->generate('user', $author_tokens, [
'user' => $node->getOwner(),
], $options, $bubbleable_metadata);
}
if ($created_tokens = $token_service->findWithPrefix($tokens, 'created')) {
$replacements += $token_service->generate('date', $created_tokens, [
'date' => $node->getCreatedTime(),
], $options, $bubbleable_metadata);
}
if ($changed_tokens = $token_service->findWithPrefix($tokens, 'changed')) {
$replacements += $token_service->generate('date', $changed_tokens, [
'date' => $node->getChangedTime(),
], $options, $bubbleable_metadata);
}
}
return $replacements;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.