{% extends "base/class.php.twig" %} {% block file_path %} \Drupal\{{ module }}\Plugin\Field\FieldFormatter\{{ class_name }}. {% endblock %} {% block namespace_class %} namespace Drupal\{{ module }}\Plugin\Field\FieldFormatter; {% endblock %} {% block use_class %} use Drupal\image\Plugin\Field\FieldFormatter\ImageFormatterBase; use Drupal\Core\Entity\EntityStorageInterface; use Drupal\Core\Field\FieldItemListInterface; use Drupal\Core\Field\FieldDefinitionInterface; use Drupal\Core\Plugin\ContainerFactoryPluginInterface; use Drupal\Core\Session\AccountInterface; use Drupal\Core\Url; use Drupal\Core\Utility\LinkGeneratorInterface; use Symfony\Component\DependencyInjection\ContainerInterface; use Drupal\Core\Form\FormStateInterface; use Drupal\Core\Cache\Cache; {% endblock %} {% block class_declaration %} /** * Plugin implementation of the '{{ plugin_id }}' formatter. * * @FieldFormatter( * id = "{{ plugin_id }}", * label = @Translation("{{ label }}"), * field_types = { * "image" * } * ) */ class {{ class_name }} extends ImageFormatterBase implements ContainerFactoryPluginInterface {% endblock %} {% block class_methods %} /** * The current user. * * @var \Drupal\Core\Session\AccountInterface */ protected $currentUser; /** * The link generator. * * @var \Drupal\Core\Utility\LinkGeneratorInterface */ protected $linkGenerator; /** * The image style entity storage. * * @var \Drupal\Core\Entity\EntityStorageInterface */ protected $imageStyleStorage; /** * Constructs a new {{ class_name }} object. * * @param string $plugin_id * The plugin_id for the formatter. * @param mixed $plugin_definition * The plugin implementation definition. * @param \Drupal\Core\Field\FieldDefinitionInterface $field_definition * The definition of the field to which the formatter is associated. * @param array $settings * The formatter settings. * @param string $label * The formatter label display setting. * @param string $view_mode * The view mode. * @param array $third_party_settings * Any third party settings settings. * @param \Drupal\Core\Session\AccountInterface $current_user * The current user. * @param \Drupal\Core\Utility\LinkGeneratorInterface $link_generator * The link generator service. * @param \Drupal\Core\Entity\EntityStorageInterface $image_style_storage * The entity storage for the image. */ public function __construct($plugin_id, $plugin_definition, FieldDefinitionInterface $field_definition, array $settings, $label, $view_mode, array $third_party_settings, AccountInterface $current_user, LinkGeneratorInterface $link_generator, EntityStorageInterface $image_style_storage) { parent::__construct($plugin_id, $plugin_definition, $field_definition, $settings, $label, $view_mode, $third_party_settings); $this->currentUser = $current_user; $this->linkGenerator = $link_generator; $this->imageStyleStorage = $image_style_storage; } /** * {@inheritdoc} */ public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) { return new static( $plugin_id, $plugin_definition, $configuration['field_definition'], $configuration['settings'], $configuration['label'], $configuration['view_mode'], $configuration['third_party_settings'], $container->get('current_user'), $container->get('link_generator'), $container->get('entity_type.manager')->getStorage('image_style') ); } /** * {@inheritdoc} */ public static function defaultSettings() { return [ 'image_style' => '', 'image_link' => '', ] + parent::defaultSettings(); } /** * {@inheritdoc} */ public function settingsForm(array $form, FormStateInterface $form_state) { $image_styles = image_style_options(FALSE); $element['image_style'] = [ '#title' => t('Image style'), '#type' => 'select', '#default_value' => $this->getSetting('image_style'), '#empty_option' => t('None (original image)'), '#options' => $image_styles, '#description' => [ '#markup' => $this->linkGenerator->generate($this->t('Configure Image Styles'), new Url('entity.image_style.collection')), '#access' => $this->currentUser->hasPermission('administer image styles'), ], ]; return $element; } /** * {@inheritdoc} */ public function settingsSummary() { $summary = []; $image_styles = image_style_options(FALSE); // Unset possible 'No defined styles' option. unset($image_styles['']); // Styles could be lost because of enabled/disabled modules that defines // their styles in code. $image_style_setting = $this->getSetting('image_style'); if (isset($image_styles[$image_style_setting])) { $summary[] = t('Image style: @style', ['@style' => $image_styles[$image_style_setting]]); } else { $summary[] = t('Original image'); } return $summary; } /** * {@inheritdoc} */ public function viewElements(FieldItemListInterface $items, $langcode) { $elements = []; $files = $this->getEntitiesToView($items, $langcode); // Early opt-out if the field is empty. if (empty($files)) { return $elements; } $url = NULL; $image_link_setting = $this->getSetting('image_link'); // Check if the formatter involves a link. if ($image_link_setting == 'content') { $entity = $items->getEntity(); if (!$entity->isNew()) { $url = $entity->toUrl(); } } elseif ($image_link_setting == 'file') { $link_file = TRUE; } $image_style_setting = $this->getSetting('image_style'); // Collect cache tags to be added for each item in the field. $cache_tags = []; if (!empty($image_style_setting)) { $image_style = $this->imageStyleStorage->load($image_style_setting); $cache_tags = $image_style->getCacheTags(); } foreach ($files as $delta => $file) { if (isset($link_file)) { $image_uri = $file->getFileUri(); $url = Url::fromUri(file_create_url($image_uri)); } $cache_tags = Cache::mergeTags($cache_tags, $file->getCacheTags()); // Extract field item attributes for the theme function, and unset them // from the $item so that the field template does not re-render them. $item = $file->_referringItem; $item_attributes = $item->_attributes; unset($item->_attributes); $elements[$delta] = [ '#theme' => 'image_formatter', '#item' => $item, '#item_attributes' => $item_attributes, '#image_style' => $image_style_setting, '#url' => $url, '#cache' => [ 'tags' => $cache_tags, ], ]; } return $elements; } {% endblock %}