TYPO3 v15 dev-main snapshot ()
This commit is contained in:
@@ -0,0 +1,177 @@
|
||||
<?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\Fluid\ViewHelpers\Link;
|
||||
|
||||
use Psr\Http\Message\ServerRequestInterface;
|
||||
use TYPO3\CMS\Core\LinkHandling\TypoLinkCodecService;
|
||||
use TYPO3\CMS\Core\LinkHandling\TypolinkParameter;
|
||||
use TYPO3\CMS\Core\Utility\GeneralUtility;
|
||||
use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
|
||||
use TYPO3Fluid\Fluid\Core\Variables\ScopedVariableProvider;
|
||||
use TYPO3Fluid\Fluid\Core\Variables\StandardVariableProvider;
|
||||
use TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper;
|
||||
|
||||
/**
|
||||
* ViewHelper to create links from fields supported by the link wizard
|
||||
*
|
||||
* ```
|
||||
* <f:link.typolink parameter="123" additionalParams="&u=b" language="2" />
|
||||
* ```
|
||||
*
|
||||
* @see https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-link-typolink
|
||||
*/
|
||||
final class TypolinkViewHelper extends AbstractViewHelper
|
||||
{
|
||||
/**
|
||||
* @var bool
|
||||
*/
|
||||
protected $escapeOutput = false;
|
||||
|
||||
public function __construct(
|
||||
private readonly TypoLinkCodecService $typoLinkCodecService
|
||||
) {}
|
||||
|
||||
public function initializeArguments(): void
|
||||
{
|
||||
$this->registerArgument('parameter', 'mixed', 'stdWrap.typolink style parameter string', true);
|
||||
$this->registerArgument('target', 'string', 'Define where to display the linked URL', false, '');
|
||||
$this->registerArgument('class', 'string', 'Define classes for the link element', false, '');
|
||||
$this->registerArgument('title', 'string', 'Define the title for the link element', false, '');
|
||||
$this->registerArgument('language', 'string', 'link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language');
|
||||
$this->registerArgument('additionalParams', 'string', 'Additional query parameters to be attached to the resulting URL', false, '');
|
||||
$this->registerArgument('additionalAttributes', 'array', 'Additional tag attributes to be added directly to the resulting HTML tag', false, []);
|
||||
$this->registerArgument('addQueryString', 'string', 'If set, the current query parameters will be kept in the URL. If set to "untrusted", then ALL query parameters will be added. Be aware, that this might lead to problems when the generated link is cached.', false, false);
|
||||
$this->registerArgument('addQueryStringExclude', 'string', 'Define parameters to be excluded from the query string (only active if addQueryString is set)', false, '');
|
||||
$this->registerArgument('absolute', 'bool', 'Ensure the resulting URL is an absolute URL', false, false);
|
||||
$this->registerArgument('partsAs', 'string', 'Variable name containing typoLink parts (if any), defaults to "typoLinkParts"');
|
||||
$this->registerArgument('parts-as', 'string', 'Only kept for backwards compatibility, use "partsAs" instead');
|
||||
$this->registerArgument('textWrap', 'string', 'Wrap the link using the typoscript "wrap" data type', false, '');
|
||||
}
|
||||
|
||||
/**
|
||||
* @throws \InvalidArgumentException
|
||||
* @throws \UnexpectedValueException
|
||||
*/
|
||||
public function render(): string
|
||||
{
|
||||
$parameter = $this->arguments['parameter'] ?? '';
|
||||
$partsAs = $this->arguments['partsAs'] ?? $this->arguments['parts-as'] ?? 'typoLinkParts';
|
||||
if (!$parameter instanceof TypolinkParameter) {
|
||||
$parameter = TypolinkParameter::createFromTypolinkParts(
|
||||
is_scalar($parameter) ? $this->typoLinkCodecService->decode((string)$parameter) : []
|
||||
);
|
||||
}
|
||||
// Merge the $parameter with other arguments
|
||||
$typolinkParameter = TypolinkParameter::createFromTypolinkParts(self::mergeTypoLinkConfiguration($parameter->toArray(), $this->arguments))->toArray();
|
||||
// expose internal typoLink configuration to Fluid child context
|
||||
$variableProvider = new ScopedVariableProvider($this->renderingContext->getVariableProvider(), new StandardVariableProvider([$partsAs => $typolinkParameter]));
|
||||
$this->renderingContext->setVariableProvider($variableProvider);
|
||||
// If no link has to be rendered, the inner content will be returned as such
|
||||
$content = (string)$this->renderChildren();
|
||||
// clean up exposed variables
|
||||
$this->renderingContext->setVariableProvider($variableProvider->getGlobalVariableProvider());
|
||||
$typolink = $this->typoLinkCodecService->encode($typolinkParameter);
|
||||
if ($typolink !== '') {
|
||||
$request = null;
|
||||
if ($this->renderingContext->hasAttribute(ServerRequestInterface::class)) {
|
||||
$request = $this->renderingContext->getAttribute(ServerRequestInterface::class);
|
||||
}
|
||||
$content = self::invokeContentObjectRenderer($this->arguments, $typolink, $content, $request);
|
||||
}
|
||||
return $content;
|
||||
}
|
||||
|
||||
private static function invokeContentObjectRenderer(array $arguments, string $typoLinkParameter, string $content, ?ServerRequestInterface $request): string
|
||||
{
|
||||
$addQueryString = $arguments['addQueryString'] ?? false;
|
||||
$addQueryStringExclude = $arguments['addQueryStringExclude'] ?? '';
|
||||
$absolute = $arguments['absolute'] ?? false;
|
||||
$aTagParams = self::serializeTagParameters($arguments);
|
||||
|
||||
$instructions = [
|
||||
'parameter' => $typoLinkParameter,
|
||||
'ATagParams' => $aTagParams,
|
||||
'forceAbsoluteUrl' => $absolute,
|
||||
];
|
||||
if (array_key_exists('language', $arguments) && $arguments['language'] !== null) {
|
||||
$instructions['language'] = (string)$arguments['language'];
|
||||
}
|
||||
if ($addQueryString && $addQueryString !== 'false') {
|
||||
$instructions['addQueryString'] = $addQueryString;
|
||||
$instructions['addQueryString.'] = [
|
||||
'exclude' => $addQueryStringExclude,
|
||||
];
|
||||
}
|
||||
if ((string)($arguments['textWrap'] ?? '') !== '') {
|
||||
$instructions['ATagBeforeWrap'] = true;
|
||||
$instructions['wrap'] = $arguments['textWrap'];
|
||||
}
|
||||
|
||||
$contentObject = GeneralUtility::makeInstance(ContentObjectRenderer::class);
|
||||
if ($request) {
|
||||
$contentObject->setRequest($request);
|
||||
}
|
||||
return $contentObject->typoLink($content, $instructions);
|
||||
}
|
||||
|
||||
private static function serializeTagParameters(array $arguments): string
|
||||
{
|
||||
// array(param1 -> value1, param2 -> value2) --> param1="value1" param2="value2" for typolink.ATagParams
|
||||
$extraAttributes = [];
|
||||
$additionalAttributes = $arguments['additionalAttributes'] ?? [];
|
||||
foreach ($additionalAttributes as $attributeName => $attributeValue) {
|
||||
$extraAttributes[] = $attributeName . '="' . htmlspecialchars((string)$attributeValue) . '"';
|
||||
}
|
||||
return implode(' ', $extraAttributes);
|
||||
}
|
||||
|
||||
/**
|
||||
* Merges view helper arguments with typolink parts.
|
||||
*/
|
||||
private static function mergeTypoLinkConfiguration(array $typoLinkConfiguration, array $arguments): array
|
||||
{
|
||||
if ($typoLinkConfiguration === []) {
|
||||
return $typoLinkConfiguration;
|
||||
}
|
||||
|
||||
$target = $arguments['target'] ?? '';
|
||||
$class = $arguments['class'] ?? '';
|
||||
$title = $arguments['title'] ?? '';
|
||||
$additionalParams = $arguments['additionalParams'] ?? '';
|
||||
|
||||
// Override target if given in target argument
|
||||
if ($target) {
|
||||
$typoLinkConfiguration['target'] = $target;
|
||||
}
|
||||
// Combine classes if given in both "parameter" string and "class" argument
|
||||
if ($class) {
|
||||
$classes = explode(' ', trim($typoLinkConfiguration['class']) . ' ' . trim($class));
|
||||
$typoLinkConfiguration['class'] = implode(' ', array_unique(array_filter($classes)));
|
||||
}
|
||||
// Override title if given in title argument
|
||||
if ($title) {
|
||||
$typoLinkConfiguration['title'] = $title;
|
||||
}
|
||||
// Combine additionalParams
|
||||
if ($additionalParams) {
|
||||
$typoLinkConfiguration['additionalParams'] .= $additionalParams;
|
||||
}
|
||||
|
||||
return $typoLinkConfiguration;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user