SuperAPI AI 工具集

typo3-content-blocks

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:该技能定义 TYPO3 中 Content Block 的构成方式,即在 config.yaml 中声明字段定义,以及字段如何嵌套为集合或可重复子项,用于创建自定义内容类型。

主要能力:Content Blocks 以单一 YAML 配置作为唯一事实来源,自动生成 TCA、数据库 schema(SQL)、TypoScript 渲染、后端表单与预览、标签与翻译。支持四类内容类型:ContentElements(tt_content,前台内容如 hero、accordion、CTA)、RecordTypes(结构化记录如新闻、产品、团队)、PageTypes(自定义页面类型如博客、落地页)、FileTypes(扩展文件引用如摄影师、版权)。字段可复用已有字段(useExistingField),可通过 basics 引入 TYPO3/Header、TYPO3/Appearance、TYPO3/Links、TYPO3/Categories 等核心字段组。

使用方式:通过 Composer 安装,命令为 ddev composer require friendsoftypo3/content-blocks,安装后执行 ddev typo3 cache:flush。可用交互式命令 ddev typo3 make:content-block 或带参数的一行命令创建内容块,创建后执行 ddev typo3 cache:flush -g system 与 ddev typo3 extension:setup --extension=my_sitepackage 更新数据库。非 Composer 安装需在 .htaccess 中禁止访问 ContentBlocks 等目录。前端模板使用 Fluid,可配合 cb:assetPath() 与 f:asset.css 加载块级资源;后端预览使用 backend-preview.fluid.html。

适用场景:TYPO3 v14 项目中构建自定义内容元素、记录、页面与文件类型,以及从旧方式迁移到 Content Blocks。

限制:该技能面向 TYPO3 v14.3+ 与 Content Blocks 2.x,1.x 仅适用于 v13,不应在 v14 项目中固定 1.x。需始终核对 Packagist 上 friendsoftypo3/content-blocks 与核心版本的约束。应优先使用 TYPO3 内置 API 与约定,并确认所用 API 在 v14 中未被弃用。仅复用 bodytext 不会为新 CType 启用富文本。迁移预览可能输出原始字段,集合在特定 partial 下可能显示空卡片。其余细节暂未提供。