Version 1
[yaffs-website] / vendor / drupal / console / templates / module / src / Plugin / Field / FieldFormatter / imageformatter.php.twig
diff --git a/vendor/drupal/console/templates/module/src/Plugin/Field/FieldFormatter/imageformatter.php.twig b/vendor/drupal/console/templates/module/src/Plugin/Field/FieldFormatter/imageformatter.php.twig
new file mode 100644 (file)
index 0000000..83e6b7f
--- /dev/null
@@ -0,0 +1,224 @@
+{% 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 an ImageFormatter 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 %}