TypoLinkGeneratorTest.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Frontend\Tests\Functional\SiteHandling;
 
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\Test;
use Psr\Http\Message\ResponseInterface;
use ‪TYPO3\CMS\Core\Database\ConnectionPool;
use ‪TYPO3\CMS\Core\Localization\LanguageServiceFactory;
use ‪TYPO3\CMS\Core\Resource\Index\Indexer;
use ‪TYPO3\CMS\Core\Resource\StorageRepository;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Frontend\Tests\Functional\SiteHandling\Fixtures\LinkHandlingController;
use ‪TYPO3\CMS\Frontend\Tests\Functional\SiteHandling\Fixtures\TestSanitizerBuilder;
use TYPO3\TestingFramework\Core\Functional\Framework\DataHandling\Scenario\DataHandlerFactory;
use TYPO3\TestingFramework\Core\Functional\Framework\DataHandling\Scenario\DataHandlerWriter;
use TYPO3\TestingFramework\Core\Functional\Framework\Frontend\Internal\AbstractInstruction;
use TYPO3\TestingFramework\Core\Functional\Framework\Frontend\Internal\ArrayValueInstruction;
use TYPO3\TestingFramework\Core\Functional\Framework\Frontend\Internal\TypoScriptInstruction;
use TYPO3\TestingFramework\Core\Functional\Framework\Frontend\InternalRequest;
 
final class ‪TypoLinkGeneratorTest extends ‪AbstractTestCase
{
    protected array ‪$pathsToProvideInTestInstance = [
        'typo3/sysext/frontend/Tests/Functional/Fixtures/Images/typo3-logo.png' => 'fileadmin/logo.png',
    ];
 
    protected function ‪setUp(): void
    {
        parent::setUp();
 
        $this->‪writeSiteConfiguration(
            'acme-com',
            $this->‪buildSiteConfiguration(1000, 'https://acme.com/'),
            [
                $this->‪buildDefaultLanguageConfiguration('EN', 'https://acme.us/'),
                $this->‪buildLanguageConfiguration('FR', 'https://acme.fr/', ['EN']),
                $this->‪buildLanguageConfiguration('FR-CA', 'https://acme.ca/', ['FR', 'EN']),
            ]
        );
 
        $this->withDatabaseSnapshot(function () {
            $this->importCSVDataSet(__DIR__ . '/../Fixtures/be_users.csv');
            $backendUser = $this->setUpBackendUser(1);
            ‪$GLOBALS['LANG'] = $this->get(LanguageServiceFactory::class)->createFromUserPreferences($backendUser);
            $scenarioFile = __DIR__ . '/Fixtures/TypoLinkScenario.yaml';
            $factory = DataHandlerFactory::fromYamlFile($scenarioFile);
            $writer = DataHandlerWriter::withBackendUser($backendUser);
            $writer->invokeFactory($factory);
            static::failIfArrayIsNotEmpty($writer->getErrors());
            $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('pages');
            $connection->update(
                'pages',
                ['TSconfig' => implode(chr(10), [
                    'TCEMAIN.linkHandler.content {',
                    '   configuration.table = tt_content',
                    '}',
                ])],
                ['uid' => 1000]
            );
            $this->‪setUpFileStorage();
            $this->setUpFrontendRootPage(1000, ['EXT:frontend/Tests/Functional/SiteHandling/Fixtures/LinkGenerator.typoscript'], ['title' => 'ACME Root']);
        });
    }
 
    private function ‪setUpFileStorage(): void
    {
        $storageRepository = GeneralUtility::makeInstance(StorageRepository::class);
        $storageId = $storageRepository->createLocalStorage(
            'fileadmin',
            'fileadmin/',
            'relative',
            'Default storage created in TypoLinkTest',
            true
        );
        $storage = $storageRepository->findByUid($storageId);
        (new ‪Indexer($storage))->processChangesInStorages();
    }
 
    public static function ‪linkIsGeneratedDataProvider(): array
    {
        $instructions = [
            [
                't3://email?email=mailto:user@example.org&other=other#other',
                '<a href="mailto:user@example.org">user@example.org</a>',
            ],
            [
                't3://email?email=user@example.org&other=other#other',
                '<a href="mailto:user@example.org">user@example.org</a>',
            ],
            [
                't3://email?email=user@example.org?subject=Hello%20World#other',
                '<a href="mailto:user@example.org?subject=Hello%20World">user@example.org</a>',
            ],
            [
                't3://file?uid=1&type=1&other=other#other',
                '<a href="/fileadmin/logo.png#other">/fileadmin/logo.png</a>',
            ],
            [
                't3://file?identifier=1:/logo.png&other=other#other',
                '<a href="/fileadmin/logo.png#other">/fileadmin/logo.png</a>',
            ],
            [
                't3://file?identifier=fileadmin/logo.png&other=other#other',
                '<a href="/fileadmin/logo.png#other">/fileadmin/logo.png</a>',
            ],
            [
                't3://folder?identifier=fileadmin&other=other#other',
                '<a href="/fileadmin/#other">/fileadmin/</a>',
            ],
            [
                't3://page?uid=1200&type=1&param-a=a&param-b=b#fragment',
                '<a href="/features?param-a=a&amp;param-b=b&amp;type=1&amp;cHash=92aa5284d0ad18f7934fe94b52f6c1a5#fragment">EN: Features</a>',
            ],
            [
                't3://page?uid=1300&additional=1&param-a=a#fragment',
                '<a href="http://typo3.org">Go to TYPO3.org</a>',
            ],
            [
                't3://record?identifier=content&uid=400&other=other#fragment',
                '<a href="/features#c400">EN: Features</a>',
            ],
            'Non-existent record' => [
                't3://record?identifier=content&uid=400000',
                '',
            ],
            'Translated record on default language page' => [
                't3://record?identifier=content&uid=402',
                '<a href="/features#c402">EN: Features</a>',
            ],
            'Record with language ALL on default language page' => [
                't3://record?identifier=content&uid=410',
                '<a href="/features#c410">EN: Features</a>',
            ],
            [
                't3://url?url=https://typo3.org%3f%26param-a=a%26param-b=b&other=other#other',
                '<a href="https://typo3.org?&amp;param-a=a&amp;param-b=b">https://typo3.org?&amp;param-a=a&amp;param-b=b</a>',
            ],
            [
                '1200,1 target class title &param-a=a',
                '<a href="/features?param-a=a&amp;type=1&amp;cHash=62ac35c73f425af5e13cfff14c04424e" target="target" title="title" class="class">EN: Features</a>',
            ],
            [
                'user@example.org target class title &other=other',
                '<a href="mailto:user@example.org" target="target" title="title" class="class">user@example.org</a>',
            ],
            // check link with language parameters
            [
                't3://page?uid=1200&L=0',
                '<a href="/features">EN: Features</a>',
            ],
            [
                't3://page?uid=1200&_language=0',
                '<a href="/features">EN: Features</a>',
            ],
            [
                't3://page?uid=1200&L=1',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            [
                't3://page?uid=1200&_language=1',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            [
                't3://page?uid=1201&L=1',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            [
                't3://page?uid=1201&_language=1',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            // localized page language overrule language arguments (new and old).
            // This has also test coverage through SlugGeneratorTests.
            [
                't3://page?uid=1202&L=1',
                '<a href="https://acme.ca/features-ca">FR-CA: Features</a>',
            ],
            [
                't3://page?uid=1202&_language=1',
                '<a href="https://acme.ca/features-ca">FR-CA: Features</a>',
            ],
            // check precedence order correctness if old and modern are provided
            [
                't3://page?uid=1200&L=2&_language=1',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            [
                't3://page?uid=1200&_language=1&L=2',
                '<a href="https://acme.fr/features-fr">FR: Features</a>',
            ],
            [
                't3://page?uid=1200&L=1&_language=2',
                '<a href="https://acme.ca/features-ca">FR-CA: Features</a>',
            ],
            [
                't3://page?uid=1200&_language=2&L=1',
                '<a href="https://acme.ca/features-ca">FR-CA: Features</a>',
            ],
        ];
        return self::keysFromTemplate($instructions, '%1$s;');
    }
 
    #[DataProvider('linkIsGeneratedDataProvider')]
    #[Test]
    public function ‪linkIsGenerated(string $parameter, string $expectation): void
    {
        $response = $this->‪invokeTypoLink($parameter);
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    public static function ‪ATagParamsAreAddedInOrderDataProvider(): array
    {
        return [
            'No ATag Params' => [
                [
                    'ATagParams' => '',
                ],
                '',
                'text',
                '<a href="/welcome">text</a>',
            ],
            'specific ATagParams' => [
                [
                    'ATagParams' => 'data-any="where"',
                ],
                '',
                'text',
                '<a href="/welcome" data-any="where">text</a>',
            ],
            'specific ATagParams with a target' => [
                [
                    'ATagParams' => 'data-any="where" target="from-a-tags"',
                ],
                '',
                'text',
                '<a href="/welcome" target="from-a-tags" data-any="where">text</a>',
            ],
            'specific ATagParams with target in parameter' => [
                [
                    'parameter' => '1100 from-parameter',
                    'ATagParams' => 'data-any="where"',
                ],
                '',
                'text',
                '<a href="/welcome" target="from-parameter" data-any="where">text</a>',
            ],
            'specific ATagParams with a target and target in parameter' => [
                [
                    'parameter' => '1100 from-parameter',
                    'ATagParams' => 'data-any="where" target="from-a-tags"',
                ],
                '',
                'text',
                '<a href="/welcome" target="from-a-tags" data-any="where">text</a>',
            ],
            'specific ATagParams with a target and target as option' => [
                [
                    'parameter' => '1100 from-parameter',
                    'ATagParams' => 'data-any="where" target="from-a-tags"',
                    'target' => 'from-option',
                ],
                '',
                'text',
                '<a href="/welcome" target="from-a-tags" data-any="where">text</a>',
            ],
            'specific ATagParams with a target and target in parameter and global attributes' => [
                [
                    'parameter' => '1100 from-parameter',
                    'ATagParams' => 'data-any="where" target="from-a-tags"',
                ],
                'tabindex="from-global"',
                'text',
                '<a href="/welcome" target="from-a-tags" tabindex="from-global" data-any="where">text</a>',
            ],
            'specific ATagParams with global attributes and local ATagParams overridden mixed, and href removed' => [
                [
                    'ATagParams' => 'data-any="where" target="from-a-tags"',
                ],
                'tabindex="from-global" target="_blank" data-any="global" data-global="1" href="#"',
                'text',
                '<a href="/welcome" target="from-a-tags" tabindex="from-global" data-any="where" data-global="1">text</a>',
            ],
        ];
    }
 
    #[DataProvider('ATagParamsAreAddedInOrderDataProvider')]
    #[Test]
    public function ‪ATagParamsAreAddedInOrder(array $instructions, string $globalATagParams, string $linkText, string $expectation): void
    {
        $sourcePageId = 1100;
        $instructions['parameter'] = $instructions['parameter'] ?? $sourcePageId;
        $request = (new InternalRequest('https://acme.us/'))
            ->withPageId($sourcePageId)
            ->withInstructions(
                [
                    $this->‪createTypoLinkInstruction($instructions, $linkText),
                    (new TypoScriptInstruction())
                        ->withTypoScript([
                            'config.' => [
                                'ATagParams' => $globalATagParams,
                            ],
                        ]),
                ],
            );
        $response = $this->executeFrontendSubRequest($request);
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    public static function ‪linkIsEncodedDataProvider(): array
    {
        $instructions = [
            [
                't3://email?email=mailto:<bad>thing(1)</bad>',
                '<a href="mailto:&lt;bad&gt;thing(1)&lt;/bad&gt;">&lt;bad&gt;thing(1)&lt;/bad&gt;</a>',
            ],
            [
                't3://email?email=mailto:<good%20a="a/"%20b="thing(1)">',
                '<a href="mailto:&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;">&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;</a>',
            ],
            [
                't3://email?email=<bad>thing(1)</bad>',
                '<a href="mailto:&lt;bad&gt;thing(1)&lt;/bad&gt;">&lt;bad&gt;thing(1)&lt;/bad&gt;</a>',
            ],
            [
                't3://email?email=<good%20a="a/"%20b="thing(1)">',
                '<a href="mailto:&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;">&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;</a>',
            ],
            [
                't3://folder?identifier=<any>',
                '',
            ],
            [
                't3://page?uid=<any>',
                '',
            ],
            [
                't3://record?identifier=content&uid=<any>',
                '',
            ],
            [
                't3://url?url=<bad>thing(1)</bad>',
                '<a href="http://&lt;bad&gt;thing(1)&lt;/bad&gt;">http://&lt;bad&gt;thing(1)&lt;/bad&gt;</a>',
            ],
            [
                't3://url?url=<good%20a="a/"%20b="thing(1)">',
                '<a href="http://&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;">http://&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;</a>',
            ],
            [
                't3://url?url=javascript:good()',
                '<a ></a>',
            ],
            [
                "t3://url?url=java\tscript:good()",
                '<a href="http://java_script:good()">http://java_script:good()</a>',
            ],
            [
                't3://url?url=java&#09;script:good()',
                '<a href="http://java">http://java</a>',
            ],
            [
                't3://url?url=javascript&colon;good()',
                '<a href="http://javascript">http://javascript</a>',
            ],
            [
                't3://url?url=data:text/html,<good>',
                '<a ></a>',
            ],
            [
                "t3://url?url=da\tsta:text/html,<good>",
                '<a href="http://da_sta:text/html,&lt;good&gt;">http://da_sta:text/html,&lt;good&gt;</a>',
            ],
            [
                't3://url?url=da&#09;ta:text/html,<good>',
                '<a href="http://da">http://da</a>',
            ],
            [
                't3://url?url=data&colon;text/html,<good>',
                '<a href="http://data">http://data</a>',
            ],
            [
                't3://url?url=%26%23106%3B%26%2397%3B%26%23118%3B%26%2397%3B%26%23115%3B%26%2399%3B%26%23114%3B%26%23105%3B%26%23112%3B%26%23116%3B%26%2358%3B%26%23103%3B%26%23111%3B%26%23111%3B%26%23100%3B%26%2340%3B%26%2341%3B',
                '<a href="http://&amp;#106;&amp;#97;&amp;#118;&amp;#97;&amp;#115;&amp;#99;&amp;#114;&amp;#105;&amp;#112;&amp;#116;&amp;#58;&amp;#103;&amp;#111;&amp;#111;&amp;#100;&amp;#40;&amp;#41;">http://&amp;#106;&amp;#97;&amp;#118;&amp;#97;&amp;#115;&amp;#99;&amp;#114;&amp;#105;&amp;#112;&amp;#116;&amp;#58;&amp;#103;&amp;#111;&amp;#111;&amp;#100;&amp;#40;&amp;#41;</a>',
            ],
            [
                '<bad>thing(1)</bad>',
                '<a href="/&lt;bad&gt;thing(1)&lt;/bad&gt;">&lt;bad&gt;thing(1)&lt;/bad&gt;</a>',
            ],
            [
                '<good%20a="a/"%20b="thing(1)">',
                '<a href="/&lt;good%20a=&quot;a/&quot;%20b=&quot;thing(1)&quot;&gt;">&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;</a>',
            ],
            [
                '<good/a="a/"/b="thing(1)"> target class title &other=other',
                '<a href="/&lt;good/a=&quot;a/&quot;/b=&quot;thing(1)&quot;&gt;" target="target" title="title" class="class">&lt;good/a=&quot;a/&quot;/b=&quot;thing(1)&quot;&gt;</a>',
            ],
            [
                'javascript:good()',
                '',
            ],
            [
                "java\tscript:good()",
                '',
            ],
            [
                'java&#09;script:good()',
                '<a href="java&amp;#09;script:good()"></a>',
            ],
            [
                'javascript&colon;good()',
                '',
            ],
            [
                'data:text/html,<good>',
                '',
            ],
            [
                "da\tta:text/html,<good>",
                '',
            ],
            [
                'da&#09;ta:text/html,<good>',
                '<a href="da&amp;#09;ta:text/html,&lt;good&gt;"></a>',
            ],
            [
                'data&colon;text/html,<good>',
                '<a href="/data&amp;colon;text/html,&lt;good&gt;">data&amp;colon;text/html,&lt;good&gt;</a>',
            ],
            [
                '%26%23106%3B%26%2397%3B%26%23118%3B%26%2397%3B%26%23115%3B%26%2399%3B%26%23114%3B%26%23105%3B%26%23112%3B%26%23116%3B%26%2358%3B%26%23103%3B%26%23111%3B%26%23111%3B%26%23100%3B%26%2340%3B%26%2341%3B',
                '',
            ],
            [
                '</> <"> <"> <">',
                '<a href="/&lt;/&gt;" target="&lt;&quot;&gt;" title="&lt;&quot;&gt;" class="&lt;&quot;&gt;">&lt;/&gt;</a>',
            ],
        ];
        return self::keysFromTemplate($instructions, '%1$s;');
    }
 
    #[DataProvider('linkIsEncodedDataProvider')]
    #[Test]
    public function ‪linkIsEncodedPerDefault(string $parameter, string $expectation): void
    {
        $response = $this->‪invokeTypoLink($parameter);
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    #[DataProvider('linkIsEncodedDataProvider')]
    #[Test]
    public function ‪linkIsEncodedHavingParseFunc(string $parameter, string $expectation): void
    {
        $response = $this->‪invokeTypoLink($parameter, $this->‪createParseFuncInstruction([
            'allowTags' => 'good',
            'denyTags' => '*',
            'nonTypoTagStdWrap.' => [
                'HTMLparser.' => [
                    'tags.' => [
                        'good.' => [
                            'allowedAttribs' => 0,
                        ],
                    ],
                ],
            ],
        ]));
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    public static function ‪linkToPageIsProcessedDataProvider(): array
    {
        return [
            [
                't3://page?uid=9911',
                '<a href="/test/good">&lt;good&gt;</a>',
                false,
            ],
            [
                't3://page?uid=9911',
                '<a href="/test/good"><good></good></a>', // expanded from `<good>` to `<good></good>`
                true,
            ],
            [
                't3://page?uid=9912',
                '<a href="/test/good-a-b-spaced">&lt;good a=&quot;a/&quot; b=&quot;thing(1)&quot;&gt;</a>',
                false,
            ],
            [
                't3://page?uid=9912',
                '<a href="/test/good-a-b-spaced"><good></good></a>', // expanded from `<good>` to `<good></good>`
                true,
            ],
            [
                't3://page?uid=9913',
                '<a href="/test/good-a-b-enc-a">&lt;good%20a=&quot;a/&quot;%20b=&quot;thing(1)&quot;&gt;</a>',
                false,
            ],
            [
                't3://page?uid=9913',
                '<a href="/test/good-a-b-enc-a">&lt;good%20a="a/"%20b="thing(1)"&gt;</a>',
                true,
            ],
            [
                't3://page?uid=9914',
                '<a href="/test/good-a-b-enc-b">&lt;good/a=&quot;a/&quot;/b=&quot;thing(1)&quot;&gt;</a>',
                false,
            ],
            [
                't3://page?uid=9914',
                '<a href="/test/good-a-b-enc-b">&lt;good/a="a/"/b="thing(1)"&gt;</a>',
                true,
            ],
            [
                't3://page?uid=9921',
                '<a href="/test/bad">&lt;bad&gt;</a>',
                false,
            ],
            [
                't3://page?uid=9921',
                '<a href="/test/bad">&lt;bad&gt;</a>',
                true,
            ],
        ];
    }
 
    #[DataProvider('linkToPageIsProcessedDataProvider')]
    #[Test]
    public function ‪linkToPageIsProcessed(string $parameter, string $expectation, bool $parseFuncEnabled): void
    {
        $instructions = [];
        if ($parseFuncEnabled) {
            $instructions[] = $this->‪createParseFuncInstruction([
                'allowTags' => 'good',
                'denyTags' => '*',
                'nonTypoTagStdWrap.' => [
                    'HTMLparser.' => [
                        'tags.' => [
                            'good.' => [
                                'allowedAttribs' => 0,
                            ],
                        ],
                    ],
                ],
                'htmlSanitize' => true,
                'htmlSanitize.' => [
                    'build' => TestSanitizerBuilder::class,
                ],
            ]);
        }
        $response = $this->‪invokeTypoLink($parameter, ...$instructions);
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    public static function ‪linkWithoutAnchorIsGeneratedDataProvider(): array
    {
        return [
            'empty parameter does not create a link' => [
                [
                    'parameter' => '',
                ],
                'no link',
                'no link',
            ],
            'empty parameter with additional ATagParams does not create a link' => [
                [
                    'parameter' => '',
                    'ATagParams' => 'data-any="where"',
                ],
                'no link',
                'no link',
            ],
            'empty parameter with additional ATagParams with id creates a link' => [
                [
                    'parameter' => '',
                    'ATagParams' => 'id="c13" data-any="where"',
                ],
                'a link',
                '<a id="c13" data-any="where">a link</a>',
            ],
            'empty parameter with additional ATagParams with id creates a link and adds title' => [
                [
                    'parameter' => '',
                    'ATagParams' => 'id="c13" data-any="where"',
                    'title' => 'custom title',
                ],
                'a link',
                '<a id="c13" data-any="where" title="custom title">a link</a>',
            ],
        ];
    }
 
    #[DataProvider('linkWithoutAnchorIsGeneratedDataProvider')]
    #[Test]
    public function ‪linkWithoutAnchorIsGenerated(array $instructions, string $linkText, string $expectation): void
    {
        $sourcePageId = 1100;
        $request = (new InternalRequest('https://acme.us/'))
            ->withPageId($sourcePageId)
            ->withInstructions(
                [
                    $this->‪createTypoLinkInstruction($instructions, $linkText),
                ]
            );
        $response = $this->executeFrontendSubRequest($request);
        self::assertSame($expectation, (string)$response->getBody());
    }
 
    private function ‪invokeTypoLink(string $parameter, AbstractInstruction ...$instructions): ResponseInterface
    {
        $sourcePageId = 1100;
 
        $request = (new InternalRequest('https://acme.us/'))
            ->withPageId($sourcePageId)
            ->withInstructions(
                [
                    $this->‪createRecordLinksInstruction([
                        'parameter.' => [
                            'data' => 'field:pid',
                        ],
                        'section.' => [
                            'data' => 'field:uid',
                            'wrap' => 'c|',
                        ],
                    ]),
                    $this->‪createTypoLinkInstruction([
                        'parameter' => $parameter,
                    ]),
                ]
            );
 
        if (count($instructions) > 0) {
            $request = $this->‪applyInstructions($request, ...$instructions);
        }
 
        return $this->executeFrontendSubRequest($request);
    }
 
    private function ‪createTypoLinkInstruction(array $typoLink, ?string $linkText = null): ArrayValueInstruction
    {
        return (new ArrayValueInstruction(LinkHandlingController::class))
            ->withArray([
                '10' => 'TEXT',
                '10.' => array_merge([
                    'typolink.' => $typoLink,
                ], ($linkText ? ['value' => $linkText] : [])),
            ]);
    }
 
    private function ‪createRecordLinksInstruction(array $typoLink): TypoScriptInstruction
    {
        return (new TypoScriptInstruction())
            ->withTypoScript([
                'config.' => [
                    'recordLinks.' => [
                        'content.' => [
                            'typolink.' => $typoLink,
                        ],
                    ],
                ],
            ]);
    }
 
    private function ‪createParseFuncInstruction(array $parseFunc): TypoScriptInstruction
    {
        return (new TypoScriptInstruction())
            ->withTypoScript([
                'lib.' => [
                    'parseFunc.' => array_replace_recursive(
                        [
                            'makelinks' => 1,
                            'makelinks.' => [
                                'http.' => [
                                    'keep' => 'path',
                                    'extTarget' => '_blank',
                                ],
                                'mailto.' => [
                                    'keep' => 'path',
                                ],
                            ],
                            'allowTags' => '',
                            'denyTags' => '',
                            'constants' => 1,
                            'nonTypoTagStdWrap.' => [
                                'HTMLparser' => 1,
                                'HTMLparser.' => [
                                    'keepNonMatchedTags' => 1,
                                    'htmlSpecialChars' => 2,
                                ],
                            ],
                        ],
                        $parseFunc
                    ),
                ],
            ]);
    }
}