[FEATURE] Add event for Readable class

to extend referrer with readable labels for defined domains

Classes/Domain/Service/Referrer/Readable.php

@@ -3,6 +3,10 @@
 declare(strict_types=1);
 namespace In2code\Lux\Domain\Service\Referrer;
 
+use In2code\Lux\Events\ReadableReferrersEvent;
+use Psr\EventDispatcher\EventDispatcherInterface;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
 /**
  * Class Readable
  * converts referrers like m.twitter.com to a readable referrer like "Twitter"
@@ -412,12 +416,16 @@ class Readable
             ],
         ],
     ];
-
     protected string $referrer = '';
+    private EventDispatcherInterface $eventDispatcher;
 
     public function __construct(string $referrer = '')
     {
-        $this->referrer = $referrer;
+        $this->eventDispatcher = GeneralUtility::makeInstance(EventDispatcherInterface::class);
+        /** @var ReadableReferrersEvent $event */
+        $event = $this->eventDispatcher->dispatch(new ReadableReferrersEvent($referrer, $this->sources));
+        $this->referrer = $event->getReferrer();
+        $this->sources = $event->getSources();
     }
 
     public function getReadableReferrer(): string

Classes/Events/ReadableReferrersEvent.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+namespace In2code\Lux\Events;
+
+final class ReadableReferrersEvent
+{
+    protected string $referrer;
+    protected array $sources;
+
+    public function __construct(string $referrer, array $sources)
+    {
+        $this->referrer = $referrer;
+        $this->sources = $sources;
+    }
+
+    public function getReferrer(): string
+    {
+        return $this->referrer;
+    }
+
+    public function setReferrer(string $referrer): self
+    {
+        $this->referrer = $referrer;
+        return $this;
+    }
+
+    public function getSources(): array
+    {
+        return $this->sources;
+    }
+
+    public function setSources(array $sources): self
+    {
+        $this->sources = $sources;
+        return $this;
+    }
+}

Tests/Unit/Domain/Service/Referrer/ReadableTest.php

@@ -2,7 +2,7 @@
 
 namespace In2code\Lux\Tests\Unit\Domain\Service;
 
-use In2code\Lux\Domain\Service\Referrer\Readable;
+use In2code\Lux\Tests\Unit\Fixtures\Domain\Service\Referrer\ReadableFixture;
 use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
 /**
@@ -46,7 +46,7 @@ public static function getReadableReferrerDataProvider(): array
      */
     public function testGetReadableReferrer(string $referrer, string $expectedResult): void
     {
-        $readable = new Readable($referrer);
+        $readable = new ReadableFixture($referrer);
         self::assertSame($expectedResult, $readable->getReadableReferrer());
     }
 
@@ -56,7 +56,7 @@ public function testGetReadableReferrer(string $referrer, string $expectedResult
      */
     public function testGetOriginalReferrer(): void
     {
-        $readable = new Readable('');
+        $readable = new ReadableFixture('');
         self::assertGreaterThan($readable->getOriginalReferrer(), 10);
     }
 }

Tests/Unit/Fixtures/Domain/Service/Referrer/ReadableFixture.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace In2code\Lux\Tests\Unit\Fixtures\Domain\Service\Referrer;
+
+use In2code\Lux\Domain\Service\Referrer\Readable;
+
+class ReadableFixture extends Readable
+{
+    public function __construct(string $referrer = '')
+    {
+        $this->referrer = $referrer;
+    }
+}