TYPO3后端渲染Fluid模板：如何配置Partial与Layout路径？

问题原因 #

后台内容预览的Fluid渲染上下文独立于前端Extbase的视图配置，默认不会自动读取扩展的Partial/Layout路径，导致调用Partial时找不到文件。

解决方案 #

1. 在自定义PreviewRenderer中手动配置Fluid视图路径 #

修改你的\Vendor\Name\Backend\Preview\PreviewRenderer类，继承默认的FluidTemplatePreviewRenderer并重写initializeView方法，手动添加扩展的模板、Partial、Layout根路径：

<?php
declare(strict_types=1);

namespace Vendor\Name\Backend\Preview;

use TYPO3\CMS\Backend\Preview\FluidTemplatePreviewRenderer;
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;

class PreviewRenderer extends FluidTemplatePreviewRenderer
{
    protected function initializeView(): void
    {
        parent::initializeView();
        
        // 替换为你的扩展键（小写）
        $extensionKey = 'name';
        $extensionResourcePath = ExtensionManagementUtility::extPath($extensionKey) . 'Resources/Private/';
        
        // 追加扩展的路径到视图配置，保留原有路径优先级
        $this->view->setTemplateRootPaths([
            $extensionResourcePath . 'Templates/',
            ...$this->view->getTemplateRootPaths()
        ]);
        $this->view->setPartialRootPaths([
            $extensionResourcePath . 'Partials/',
            ...$this->view->getPartialRootPaths()
        ]);
        $this->view->setLayoutRootPaths([
            $extensionResourcePath . 'Layouts/',
            ...$this->view->getLayoutRootPaths()
        ]);
    }
}

2. 验证Partial文件路径 #

确保你的Partial文件路径与调用路径匹配：

• 调用代码：<f:render arguments="{_all}" partial="Preview/List"/>
• 对应文件位置：EXT:name/Resources/Private/Partials/Preview/List.html

3. 注意事项 #

• 前端Extbase的TypoScript视图配置（如plugin.tx_yourplugin.view.partialRootPaths）对后台预览渲染无效，必须在PreviewRenderer中单独配置。
• 清理TYPO3缓存后测试效果。

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