如何在TYPO3后端为默认Text/Media内容元素分配预览模板？

你的PageTS配置未生效可能由多个原因导致，以下是逐一排查和解决的方法：

1. 修正PageTS配置的格式错误 #

你的配置中textmedia = EXT:存在多余空格，会导致路径解析失败，修正后的配置如下：

mod.web_layout {
  tt_content {
    preview {
      # My CType
      textmedia = EXT:my_extension/Resources/Private/Templates/Preview/TextMedia.html
    }
  }
}

2. 确认PageTS配置已加载 #

• 进入TYPO3后端的「Template」模块，选择根模板，点击「Info/Modify」→「View PageTSconfig」，检查你的配置是否出现在列表中。
• 如果未加载，需要确保你的扩展已在根模板中被包含，或者通过扩展的ext_localconf.php注册PageTS：

  \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPageTSConfig(
      '@import "EXT:my_extension/Configuration/TsConfig/Page/ContentPreview.tsconfig"'
  );
  

3. 验证模板文件的有效性 #

• 检查模板路径EXT:my_extension/Resources/Private/Templates/Preview/TextMedia.html是否存在，文件名和路径的大小写是否正确（Linux服务器对大小写敏感）。
• 确保Web服务器进程拥有该文件的读取权限。

4. 清除TYPO3缓存 #

修改配置或模板后，必须清除所有缓存（包括配置缓存），点击后端顶部的「Flush all caches」按钮完成操作。

5. 优先级更高的钩子替代方案 #

如果PageTS方式仍不生效，可以使用后端钩子直接接管预览渲染：

1. 在扩展的ext_localconf.php中注册钩子：

   $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']['tt_content_drawItem']['textmedia'] = \Vendor\MyExtension\Hooks\ContentElementPreviewRenderer::class;
   

2. 创建对应的钩子类Classes/Hooks/ContentElementPreviewRenderer.php：

   <?php
   namespace Vendor\MyExtension\Hooks;
   
   use TYPO3\CMS\Backend\View\PageLayoutViewDrawItemHookInterface;
   use TYPO3\CMS\Core\Utility\GeneralUtility;
   use TYPO3\CMS\Fluid\View\StandaloneView;
   
   class ContentElementPreviewRenderer implements PageLayoutViewDrawItemHookInterface
   {
       public function preProcess(
           \TYPO3\CMS\Backend\View\PageLayoutView $parentObject,
           &$drawItem,
           &$headerContent,
           &$itemContent,
           array $row
       ) {
           if ($row['CType'] === 'textmedia') {
               $drawItem = false;
               $view = GeneralUtility::makeInstance(StandaloneView::class);
               $view->setTemplatePathAndFilename(
                   GeneralUtility::getFileAbsFileName('EXT:my_extension/Resources/Private/Templates/Preview/TextMedia.html')
               );
               $view->assign('row', $row);
               $itemContent = $view->render();
           }
       }
   }
   

3. 清除缓存后，后端预览会优先使用该钩子渲染的内容。

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