TYPO3中实现带返回URL与关闭按钮的后台页面布局模块跳转

问题背景 #

从列表（如链接验证器断链列表）通过<be:moduleLink>跳转至/web/layout模块时，已传递returnUrl参数，但页面未显示返回/关闭按钮，而编辑表单跳转后正常显示。

核心原因 #

页面布局模块（web_layout）的默认控制器未内置returnUrl参数的返回按钮渲染逻辑，与编辑表单模块（editRecord）的处理机制不同。

解决方案 #

方案1：临时快速测试（优先尝试）

尝试在跳转参数中添加close: 1，部分TYPO3版本的后台模块会识别该参数配合returnUrl显示关闭按钮：

<f:variable name="link">
    <be:moduleLink route="web_layout" arguments="{id: element.pid, returnUrl: returnUrl, close: 1}">layout</be:moduleLink>
</f:variable>
<a href="{link}" class="btn btn-default" title="page layout">
  <core:icon identifier="actions-document" size="small"/>
</a>

方案2：自定义控制器添加按钮逻辑

若方案1无效，可通过扩展控制器实现按钮渲染：

1. 创建自定义控制器类（继承核心PageLayoutController）：

<?php
namespace YourVendor\YourExtension\Controller;

use TYPO3\CMS\Backend\Controller\PageLayoutController as CorePageLayoutController;
use TYPO3\CMS\Core\Imaging\IconFactory;
use TYPO3\CMS\Core\Localization\LanguageService;
use TYPO3\CMS\Backend\Template\Components\ButtonBar;

class CustomPageLayoutController extends CorePageLayoutController
{
    protected IconFactory $iconFactory;
    protected LanguageService $languageService;

    public function injectIconFactory(IconFactory $iconFactory): void
    {
        $this->iconFactory = $iconFactory;
    }

    protected function getLanguageService(): LanguageService
    {
        return $GLOBALS['LANG'];
    }

    public function initializeAction()
    {
        parent::initializeAction();
        $returnUrl = $this->request->getArgument('returnUrl') ?? '';
        if (!empty($returnUrl)) {
            $this->pageTitleView->addButton(
                ButtonBar::BUTTON_POSITION_LEFT,
                $this->buttonBar->makeLinkButton()
                    ->setHref($returnUrl)
                    ->setIcon($this->iconFactory->getIcon('actions-close', \TYPO3\CMS\Core\Imaging\Icon::SIZE_SMALL))
                    ->setTitle($this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:labels.close'))
            );
        }
    }
}

2. 在ext_localconf.php中替换默认控制器：

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'][\TYPO3\CMS\Backend\Controller\PageLayoutController::class] = [
    'className' => \YourVendor\YourExtension\Controller\CustomPageLayoutController::class
];

方案3：模板覆盖添加按钮

无需修改控制器，通过模板覆盖实现：

1. 在你的扩展中创建模板文件：Resources/Private/Backend/Templates/PageLayout/Index.html
2. 复制核心模板内容，在页面标题栏区域添加以下判断：

<f:if condition="{returnUrl}">
    <be:button.link 
        href="{returnUrl}" 
        icon="actions-close" 
        title="LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:labels.close"
    />
</f:if>

3. 在ext_tables.php中配置模板路径：

\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPageTSConfig(
    '<INCLUDE_TYPOSCRIPT: source="FILE:EXT:your_extension/Configuration/TsConfig/Backend/PageLayout.tsconfig">'
);

4. 创建PageLayout.tsconfig文件：

mod.web_layout {
    templateRootPaths.10 = EXT:your_extension/Resources/Private/Backend/Templates/
}

验证要点 #

• 确保returnUrl已正确编码（可通过<f:uri.encode value="{returnUrl}" />处理）
• 跳转后检查页面顶部标题栏是否出现返回/关闭按钮
• 测试按钮点击是否能正常返回原列表页面

内容的提问来源于stack exchange，提问作者Sybille Peters