用途:指导在 TYPO3 中使用 Content Blocks 建模自定义内容类型,覆盖内容元素(tt_content)、记录类型、页面类型(pages)与文件类型(sys_file_reference),以单一 YAML 配置作为唯一数据源,自动生成 TCA、数据库结构、TypoScript 渲染、后端表单与预览、标签与翻译。
主要能力:提供四类内容类型的目录结构与 config.yaml 写法;支持 basics 引入核心字段组(如 TYPO3/Header、TYPO3/Appearance、TYPO3/Links、TYPO3/Categories);提供 Fluid 前端模板与后端预览模板示例;包含 shadcn/ui 风格模板的组织建议,如把重复视觉结构放入共享 Fluid 组件、用 Alpine 或原生控制器实现交互、用 f:asset.css / f:asset.script 仅加载块级资源;并说明迁移与跨技能交接。
使用方式:通过 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 等目录。
适用场景:需要为 TYPO3 站点包定义英雄区、手风琴、CTA 等前端内容,或新闻、产品、团队等结构化记录,以及博客、落地页等自定义页面类型和扩展文件引用字段时。
限制:技能面向 TYPO3 v14.3+ 与 Content Blocks 2.x;Content Blocks 1.x 用于 TYPO3 v13 时上游要求 TYPO3 ≥ 13.4,需以 Packagist 约束为准。示例使用 TYPO3 v14 API 与 CB 2.x,若上游约束不同需调整 composer.json。应优先使用 TYPO3 内置 API 与既有约定,并核对所用 API 在 v14 中是否存在且未废弃。具体收费、价格与效果暂未提供。