Fix the ordering for future talks

Rather than the custom event sorting plugin being based on the `created`
value, this change adds a new `field_event_date` field to the talk node
type and uses this for the sorting instead.

This commit also adds a new `TalkDateUpdater` service that extracts
either the next event date if there is a future date, or the last past
event date if there is no future date, from `field_events` for each talk
and saves it into the event date field.

For consistency, and to ensure that the results are ordered correctly,
the talk date updater converts the date from a date string (e.g.
`2020-08-24`) into a UNIX timestamp, and the timestamp is saved in the
event date field. This can be changed at a later date if needed.

The talks view has been updated to use the updated sort plugin, and the
existing tests have been updated to use the new field.

References #204

web/modules/custom/opd_talks/opd_talks.module

@@ -11,12 +11,12 @@ declare(strict_types=1);
  * Implements hook_views_data_alter().
  */
 function opd_talks_views_data_alter(array &$data): void {
-  $data['node_field_data']['event_sort'] = [
+  $data['node__field_event_date']['event_sort'] = [
     'title' => t('Custom event sort'),
     'group' => t('Content'),
     'help' => t('Sort events by past/future, then distance from now.'),
     'sort' => [
-      'field' => 'created',
+      'field' => 'field_event_date_value',
       'id' => 'event_sort',
     ]
   ];

web/modules/custom/opd_talks/opd_talks.services.yml

@@ -1,3 +1,6 @@
 services:
   Drupal\opd_talks\Repository\TalkRepository:
     autowire: true
+
+  Drupal\opd_talks\Service\TalkDateUpdater:
+    autowire: true

web/modules/custom/opd_talks/src/Plugin/views/sort/Event.php

@@ -4,24 +4,55 @@ declare(strict_types=1);
 
 namespace Drupal\opd_talks\Plugin\views\sort;
 
-use Drupal\views\Plugin\views\sort\Date;
+use Carbon\Carbon;
+use Drupal\Component\Datetime\TimeInterface;
 use Drupal\views\Annotation\ViewsSort;
+use Drupal\views\Plugin\views\sort\Date;
+use Symfony\Component\DependencyInjection\ContainerInterface;
 
 /**
  * @ViewsSort("event_sort")
  */
 final class Event extends Date {
 
+  private TimeInterface $time;
+
+  public function __construct(
+    array $configuration,
+    $pluginId,
+    $pluginDefinition,
+    TimeInterface $time
+  ) {
+    parent::__construct($configuration, $pluginId, $pluginDefinition);
+
+    $this->time = $time;
+  }
+
+  public static function create(
+    ContainerInterface $container,
+    array $configuration,
+    $pluginId,
+    $pluginDefinition
+  ) {
+    return new static(
+      $configuration,
+      $pluginId,
+      $pluginDefinition,
+      $container->get('datetime.time')
+    );
+  }
+
   public function query() {
     $this->ensureMyTable();
 
-    $currentTime = time();
+    $currentDate = Carbon::parse('today')->getTimestamp();
+
     $dateAlias = "$this->tableAlias.$this->realField";
 
     // Is this event in the past?
     $this->query->addOrderBy(
       NULL,
-      sprintf("%d > %s", $currentTime, $dateAlias),
+      sprintf("%d > %s", $currentDate, $dateAlias),
       $this->options['order'],
       "in_past"
     );
@@ -29,10 +60,11 @@ final class Event extends Date {
     // How far in the past/future is this event?
     $this->query->addOrderBy(
       NULL,
-      sprintf('ABS(%s - %d)', $dateAlias, $currentTime),
-       $this->options['order'],
-       "distance_from_now"
-     );
+      sprintf('ABS(%s - %d)', $dateAlias, $currentDate),
+      $this->options['order'],
+      "distance_from_now"
+    );
   }
 
+
 }

web/modules/custom/opd_talks/src/Service/TalkDateUpdater.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\opd_talks\Service;
+
+use Carbon\Carbon;
+use Drupal\Component\Datetime\TimeInterface;
+use Drupal\custom\Entity\Node\Talk;
+use Drupal\datetime\Plugin\Field\FieldType\DateTimeItemInterface;
+use Drupal\opd_talks\Repository\TalkRepository;
+use Drupal\paragraphs\ParagraphInterface;
+
+final class TalkDateUpdater {
+
+  private TalkRepository $talkRepository;
+  private TimeInterface $time;
+
+  public function __construct(
+    TalkRepository $talkRepository,
+    TimeInterface $time
+  ) {
+    $this->talkRepository = $talkRepository;
+    $this->time = $time;
+  }
+
+  public function __invoke(): void {
+    foreach ($this->talkRepository->getAll() as $talk) {
+      $this->updateNextEventDate($talk);
+    }
+  }
+
+  private function updateNextEventDate(Talk $talk) {
+    if (!$nextDate = $this->findNextEventDate($talk)) {
+      return;
+    }
+
+    $nextDateTimestamp = Carbon::parse($nextDate)
+      ->getTimestamp();
+
+    if ($nextDateTimestamp == $talk->getNextDate()) {
+      return;
+    }
+
+    $talk->setNextDate($nextDateTimestamp);
+    $talk->save();
+  }
+
+  private function findNextEventDate(Talk $talk): ?string {
+    $currentTime = Carbon::today()
+      ->format(DateTimeItemInterface::DATE_STORAGE_FORMAT);
+
+    $dates = $talk->getEvents()
+      ->map(fn(ParagraphInterface $event) => $event->get('field_date')
+        ->getString())
+      ->sort();
+
+    if ($dates->isEmpty()) {
+      return NULL;
+    }
+
+    // If a future date is found, return it.
+    if ($futureDate = $dates->first(fn(string $eventDate) => $eventDate > $currentTime)) {
+      return $futureDate;
+    }
+
+    // If no future date is found, return the last past date.
+    return $dates->last();
+  }
+
+}

web/modules/custom/opd_talks/tests/src/Kernel/TalkEventDateTest.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace Drupal\Tests\opd_talks\Kernel;
+
+use Carbon\Carbon;
+use Drupal\custom\Entity\Node\Talk;
+use Drupal\datetime\Plugin\Field\FieldType\DateTimeItemInterface;
+use Drupal\node\Entity\Node;
+use Drupal\opd_talks\Service\TalkDateUpdater;
+use Drupal\Tests\custom\Kernel\TalksTestBase;
+
+final class TalkEventDateTest extends TalksTestBase {
+
+  /** @test */
+  public function talk_event_dates_are_set_to_the_next_future_date(): void {
+    $dateFormat = DateTimeItemInterface::DATE_STORAGE_FORMAT;
+
+    $talk = $this->createTalk([
+      'field_event_date' => NULL,
+      'field_events' => [
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->subWeeks(2)
+            ->format($dateFormat),
+        ]),
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->subDays(2)
+            ->format($dateFormat),
+        ]),
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->addDays(4)
+            ->format($dateFormat),
+        ]),
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->addDays(10)
+            ->format($dateFormat),
+        ]),
+      ],
+    ]);
+
+    $dateUpdater = $this->container->get(TalkDateUpdater::class);
+    $dateUpdater->__invoke();
+
+    $expected = Carbon::today()->addDays(4)->getTimestamp();
+
+    $talk = Node::load($talk->id());
+    $this->assertNextEventDateIs($talk, $expected);
+  }
+
+  /** @test */
+  public function talk_event_dates_are_set_to_the_last_past_date(): void {
+    $dateFormat = DateTimeItemInterface::DATE_STORAGE_FORMAT;
+
+    $talk = $this->createTalk([
+      'field_event_date' => NULL,
+      'field_events' => [
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->subDays(4)
+            ->format($dateFormat),
+        ]),
+        $this->createEvent([
+          'field_date' => Carbon::today()
+            ->subDays(2)
+            ->format($dateFormat),
+        ]),
+      ],
+    ]);
+
+    $dateUpdater = $this->container->get(TalkDateUpdater::class);
+    $dateUpdater->__invoke();
+
+    $expected = Carbon::today()->subDays(2)->getTimestamp();
+
+    $talk = Node::load($talk->id());
+    $this->assertNextEventDateIs($talk, $expected);
+  }
+
+  /** @test */
+  public function next_event_date_is_empty_if_there_are_no_events(): void {
+    $talk = $this->createTalk([
+      'field_event_date' => NULL,
+      'field_events' => [],
+    ]);
+
+    $dateUpdater = $this->container->get(TalkDateUpdater::class);
+    $dateUpdater->__invoke();
+
+    $talk = Node::load($talk->id());
+    $this->assertNoNextEventDate($talk);
+  }
+
+  private function assertNextEventDateIs(Talk $talk, $expected): void {
+    $this->assertSame($expected, $talk->getNextDate());
+  }
+
+  private function assertNoNextEventDate(Talk $talk): void {
+    $this->assertNull($talk->getNextDate());
+  }
+
+}

web/modules/custom/opd_talks/tests/src/Kernel/TalksPageSortTest.php

@@ -20,10 +20,18 @@ final class TalksPageSortTest extends TalksTestBase {
    * @test
    */
   public function upcoming_talks_are_shown_first_followed_by_past_talks_and_ordered_by_distance() {
-    $this->createTalk(['created' => Carbon::parse('+4 days')->getTimestamp()]);
-    $this->createTalk(['created' => Carbon::parse('-2 days')->getTimestamp()]);
-    $this->createTalk(['created' => Carbon::parse('+1 days')->getTimestamp()]);
-    $this->createTalk(['created' => Carbon::parse('-10 days')->getTimestamp()]);
+    $this->createTalk([
+      'field_event_date' => Carbon::today()->addDays(4)->getTimestamp(),
+    ]);
+    $this->createTalk([
+      'field_event_date' => Carbon::today()->subDays(2)->getTimestamp(),
+    ]);
+    $this->createTalk([
+      'field_event_date' => Carbon::today()->addDay()->getTimestamp(),
+    ]);
+    $this->createTalk([
+      'field_event_date' => Carbon::today()->subDays(10)->getTimestamp(),
+    ]);
 
     $talkIds = (new Collection(views_get_view_result('talks')))
       ->map(fn(ResultRow $row) => (int) $row->_entity->id());