[FEATURE] Support for TypolinkParameter objects in TYPO3 v13

Author: s2b

Classes/Domain/Model/Typolink.php

@@ -6,16 +6,18 @@
 use SMS\FluidComponents\Exception\InvalidArgumentException;
 use SMS\FluidComponents\Interfaces\ConstructibleFromArray;
 use SMS\FluidComponents\Interfaces\ConstructibleFromInteger;
+use SMS\FluidComponents\Interfaces\ConstructibleFromTypolinkParameter;
 use TYPO3\CMS\Core\LinkHandling\LinkService;
 use TYPO3\CMS\Core\LinkHandling\TypoLinkCodecService;
+use TYPO3\CMS\Core\LinkHandling\TypolinkParameter;
 use TYPO3\CMS\Core\Utility\GeneralUtility;
 use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
 
 /**
  * Data Structure to provide information extracted from a Typolink string
  * in a structured matter.
  */
-class Typolink extends Link implements ConstructibleFromInteger, ConstructibleFromArray
+class Typolink extends Link implements ConstructibleFromInteger, ConstructibleFromArray, ConstructibleFromTypolinkParameter
 {
     /**
      * Data interpretation of the provided TYPO3 uri.
@@ -116,6 +118,31 @@ public static function fromArray(array $typolinkData): self
         return $instance;
     }
 
+    public static function fromTypolinkParameter(TypolinkParameter $parameter): self
+    {
+        // Analyze structure of provided TYPO3 uri
+        $linkService = GeneralUtility::makeInstance(LinkService::class);
+        $uriStructure = $linkService->resolve($parameter->url);
+
+        // Generate general purpose uri (https://) from TYPO3 uri (t3://)
+        // Could also be a mailto or tel uri
+        $cObj = GeneralUtility::makeInstance(ContentObjectRenderer::class);
+        $uri = $cObj->typoLink_URL([
+            'parameter' => $parameter->url,
+            'additionalParams' => $parameter->additionalParams,
+        ]);
+
+        // TODO constructor code should be avoided in the future, but this would require changes
+        //      to the current constructure method signature (such as making the string nullable),
+        //      which would be a breaking change.
+        return (new static(''))
+            ->setUri($uri)
+            ->setOriginalLink($uriStructure)
+            ->setTarget($parameter->target)
+            ->setClass($parameter->class)
+            ->setTitle($parameter->title);
+    }
+
     public function setOriginalLink(array $originalLink): self
     {
         $this->originalLink = $originalLink;

Classes/Interfaces/ConstructibleFromTypolinkParameter.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+namespace SMS\FluidComponents\Interfaces;
+
+use TYPO3\CMS\Core\LinkHandling\TypolinkParameter;
+
+/**
+ * ConstructibleFromTypolinkParameter defines an alternative constructor
+ * which "converts" the provided ConstructibleFromTypolinkParameter instance
+ * to the class implementing the interface.
+ */
+interface ConstructibleFromTypolinkParameter
+{
+    /**
+     * Creates an instance of the class based on the provided object.
+     */
+    public static function fromTypolinkParameter(TypolinkParameter $value): object;
+}

Classes/Utility/ComponentArgumentConverter.php

@@ -13,7 +13,9 @@
 use SMS\FluidComponents\Interfaces\ConstructibleFromInteger;
 use SMS\FluidComponents\Interfaces\ConstructibleFromNull;
 use SMS\FluidComponents\Interfaces\ConstructibleFromString;
+use SMS\FluidComponents\Interfaces\ConstructibleFromTypolinkParameter;
 use Traversable;
+use TYPO3\CMS\Core\LinkHandling\TypolinkParameter;
 use TYPO3\CMS\Core\Resource\AbstractFile;
 use TYPO3\CMS\Core\Resource\FileInterface;
 use TYPO3\CMS\Extbase\Domain\Model\FileReference;
@@ -66,6 +68,10 @@ class ComponentArgumentConverter implements \TYPO3\CMS\Core\SingletonInterface
             ConstructibleFromFileInterface::class,
             'fromFileInterface',
         ],
+        TypolinkParameter::class => [
+            ConstructibleFromTypolinkParameter::class,
+            'fromTypolinkParameter',
+        ],
     ];
 
     /**