www.aleph1.co.uk Git - yaffs-website/blob - web/core/modules/datetime_range/src/Plugin/Field/FieldFormatter/DateRangeCustomFormatter.php

   1 <?php
   2
   3 namespace Drupal\datetime_range\Plugin\Field\FieldFormatter;
   4
   5 use Drupal\Core\Field\FieldItemListInterface;
   6 use Drupal\Core\Form\FormStateInterface;
   7 use Drupal\datetime\Plugin\Field\FieldFormatter\DateTimeCustomFormatter;
   8 use Drupal\datetime_range\DateTimeRangeTrait;
   9
  10 /**
  11  * Plugin implementation of the 'Custom' formatter for 'daterange' fields.
  12  *
  13  * This formatter renders the data range as plain text, with a fully
  14  * configurable date format using the PHP date syntax and separator.
  15  *
  16  * @FieldFormatter(
  17  *   id = "daterange_custom",
  18  *   label = @Translation("Custom"),
  19  *   field_types = {
  20  *     "daterange"
  21  *   }
  22  * )
  23  */
  24 class DateRangeCustomFormatter extends DateTimeCustomFormatter {
  25
  26   use DateTimeRangeTrait;
  27
  28   /**
  29    * {@inheritdoc}
  30    */
  31   public static function defaultSettings() {
  32     return [
  33       'separator' => '-',
  34     ] + parent::defaultSettings();
  35   }
  36
  37   /**
  38    * {@inheritdoc}
  39    */
  40   public function viewElements(FieldItemListInterface $items, $langcode) {
  41     $elements = [];
  42     $separator = $this->getSetting('separator');
  43
  44     foreach ($items as $delta => $item) {
  45       if (!empty($item->start_date) && !empty($item->end_date)) {
  46         /** @var \Drupal\Core\Datetime\DrupalDateTime $start_date */
  47         $start_date = $item->start_date;
  48         /** @var \Drupal\Core\Datetime\DrupalDateTime $end_date */
  49         $end_date = $item->end_date;
  50
  51         if ($start_date->getTimestamp() !== $end_date->getTimestamp()) {
  52           $elements[$delta] = [
  53             'start_date' => $this->buildDate($start_date),
  54             'separator' => ['#plain_text' => ' ' . $separator . ' '],
  55             'end_date' => $this->buildDate($end_date),
  56           ];
  57         }
  58         else {
  59           $elements[$delta] = $this->buildDate($start_date);
  60         }
  61       }
  62     }
  63
  64     return $elements;
  65   }
  66
  67   /**
  68    * {@inheritdoc}
  69    */
  70   public function settingsForm(array $form, FormStateInterface $form_state) {
  71     $form = parent::settingsForm($form, $form_state);
  72
  73     $form['separator'] = [
  74       '#type' => 'textfield',
  75       '#title' => $this->t('Date separator'),
  76       '#description' => $this->t('The string to separate the start and end dates'),
  77       '#default_value' => $this->getSetting('separator'),
  78     ];
  79
  80     return $form;
  81   }
  82
  83   /**
  84    * {@inheritdoc}
  85    */
  86   public function settingsSummary() {
  87     $summary = parent::settingsSummary();
  88
  89     if ($separator = $this->getSetting('separator')) {
  90       $summary[] = $this->t('Separator: %separator', ['%separator' => $separator]);
  91     }
  92
  93     return $summary;
  94   }
  95
  96 }