用途:让 TYPO3 项目适配 friendsoftypo3/visual-editor,使编辑者可在后端就近于渲染页面进行内联文本编辑、拖放排序、增删内容元素,支持实时预览、工作区、可选自动保存、容器与 Context Panel。
核心能力:该扩展依赖 Fluid 钩子。f:render.text 将 TCA 文本字段标记为可编辑并按字段配置渲染;f:render.contentArea 渲染 TYPO3 v14.2+ 页面内容区域;f:mark.contentArea 是 v13 或旧渲染器的回退方案。安装不仅需要装上扩展,还需前端输出可追溯到记录、字段与内容区域。
安装方式:Composer 使用 ddev composer require friendsoftypo3/visual-editor 后执行 ddev typo3 cache:flush;无 DDEV 时用 composer require friendsoftypo3/visual-editor 与 vendor/bin/typo3 cache:flush;非 Composer 则在扩展管理器中安装并激活 visual_editor,清理缓存并按安装工具提示运行数据库更新。
模板迁移:把直接的 {record.header}、f:format.html 等文本输出改为 f:render.text(field: 'header'),field 使用数据库/TCA 字段名;若模板为数组,先加 lib.contentElement.dataProcessing.<id> = record-transformation。v14.2+ 优先用 <f:render.contentArea contentArea="{content.main}" />,并把旧 colPos 映射到后端布局列标识。v13 或旧渲染器用 f:mark.contentArea 包裹现有渲染,如 f:cObject、VHS、Flux、EXT:container 子列。
限制与注意:当前上游 1.7.1 需 PHP 8.2+,支持 TYPO3 13.4.22+ 或 14.3+;f:render.text 不应用于计算值、FAL、链接、布尔、日期或已渲染 HTML;需验证编辑器权限、多域名、工作区与语言。移除:composer remove friendsoftypo3/visual-editor 后清理缓存,非 Composer 则卸载扩展;v14.2+ 可保留 Core 的 f:render.contentArea 与 f:render.text。版本、收费、平台等未在资料中提供的细节暂未提供。