更改生成的链接字段上的链接名称

时间:2016-07-30 12:20:57

标签: drupal twig drupal-theming drupal-8

我在Drupal 8和node.html.twig模板上创建自定义主题我使用{{content.field_type}}显示当前页面允许的类别的链接用户链接回该类别中的页面列表。使用此页面,页面呈现:

<a href="/drupal/main-cat/sub-cat" hreflang="en">Sub Cat Name</a>

我需要做什么将其更改为:

<a href="/drupal/main-cat/sub-cat" hreflang="en">My Custom Link</a>

1 个答案:

答案 0 :(得分:2)

可以使用预处理功能更改渲染数组,但在您的情况下,它并不是一个好主意。您正在谈论的链接是字段格式化程序的渲染结果。所以,你需要另一个字段格式化器来支持你的&#39; Type&#39;字段,而不是当前的标签&#39;格式化。

创建新的格式化程序非常简单(特别是如果使用EntityReferenceLabelFormatter作为示例)。假设您有一个名为entity_reference_link_formatter的模块。然后在此模块的目录中创建src/Plugin/Field/FieldFormatter文件夹,并在其中放置以下EntityReferenceLinkFormatter.php文件:

<?php
/**
 * @file
 * Contains Drupal\entity_reference_link_formatter\Plugin\Field\FieldFormatter\EntityReferenceLinkFormatter
 */

namespace Drupal\entity_reference_link_formatter\Plugin\Field\FieldFormatter;


use Drupal\Core\Entity\Exception\UndefinedLinkTemplateException;
use Drupal\Core\Field\FieldItemListInterface;
use Drupal\Core\Field\Plugin\Field\FieldFormatter\EntityReferenceFormatterBase;
use Drupal\Core\Form\FormStateInterface;

/**
 * Plugin implementation of the 'entity reference link' formatter.
 *
 * @FieldFormatter(
 *   id = "entity_reference_link",
 *   label = @Translation("Link"),
 *   description = @Translation("Display the link to the referenced entity."),
 *   field_types = {
 *     "entity_reference"
 *   }
 * )
 */
class EntityReferenceLinkFormatter extends EntityReferenceFormatterBase {

  /**
   * {@inheritdoc}
   */
  public static function defaultSettings() {
    return [
      'text' => 'View',
    ] + parent::defaultSettings();
  }

  /**
   * {@inheritdoc}
   */
  public function settingsForm(array $form, FormStateInterface $form_state) {
    $elements['text'] = [
      '#title' => t('Text of the link to the referenced entity'),
      '#type' => 'textfield',
      '#required' => true,
      '#default_value' => $this->getSetting('text'),
    ];

    return $elements;
  }

  /**
   * {@inheritdoc}
   */
  public function settingsSummary() {
    $summary = [];
    $summary[] = t('Link text: @text', ['@text' => $this->getSetting('text')]);
    return $summary;
  }

  /**
   * {@inheritdoc}
   */
  public function viewElements(FieldItemListInterface $items, $langcode) {
    $elements = array();

    foreach ($this->getEntitiesToView($items, $langcode) as $delta => $entity) {
      if (!$entity->isNew()) {
        try {
          $uri = $entity->urlInfo();

          $elements[$delta] = [
            '#type' => 'link',
            '#title' => t('!text', ['!text' => $this->getSetting('text')]),
            '#url' => $uri,
            '#options' => $uri->getOptions(),
          ];

          if (!empty($items[$delta]->_attributes)) {
            $elements[$delta]['#options'] += array('attributes' => array());
            $elements[$delta]['#options']['attributes'] += $items[$delta]->_attributes;
            // Unset field item attributes since they have been included in the
            // formatter output and shouldn't be rendered in the field template.
            unset($items[$delta]->_attributes);
          }
        }
        catch (UndefinedLinkTemplateException $e) {
          // This exception is thrown by \Drupal\Core\Entity\Entity::urlInfo()
          // and it means that the entity type doesn't have a link template nor
          // a valid "uri_callback", so don't bother trying to output a link for
          // the rest of the referenced entities.
        }
      }

      $elements[$delta]['#cache']['tags'] = $entity->getCacheTags();
    }

    return $elements;
  }

}

启用此模块后(或者如果之前启用了此模块,则清除缓存后),您将拥有“&#39; Link&#39;您所有&#39;实体参考的格式化程序&#39;字段,允许您仅在格式化设置中自定义链接文本。