README

添加迁移命令，将内容块从内容块注册API迁移到TYPO3 CMS内容块。

它做什么？

复制旧内容块到新位置（文件夹ContentBlocks/ContentElements/）
构建新的文件夹结构
- 删除不必要的文件（例如 composer.json）
- 重命名文件（例如语言文件、图标文件）
- 重命名文件夹（例如src到Source和dist到Assets）
- 调整语言文件
转换EditorInterface.yaml
调整模板文件（仅Frontend.html和EditorPreview.html）
- （将所有未声明为"useExistingFields"的变量的"data-"前缀添加到所有变量中）
- 转换EXT:content_blocks特定的ViewHelpers
转换数据库结构

它不做什么？

考虑第一级集合（在集合中的集合...在集合...中的集合...未测试/不支持）
模板调整必须手动完成（迁移仅调整上述部分）

安装

通过composer添加

composer require passionweb/contentblocks-reg-api-migration --dev

通过composer安装扩展
刷新TYPO3和PHP缓存

要求

TYPO3 12.4
EXT:content_blocks

重要注意事项/开始前

请确保您的数据库和文件有备份（如果没有，请在开始前进行备份）！此迁移不应在没有备份的实时系统上执行！迁移开始之前将询问额外的问题，以便您可以在更改之前取消迁移。

命令详细信息

ddev typo3 content-blocks:migrate --target-extension=EXTENSION --vendor-name=VENDOR_NAME --package-path=PACKAGE_PATH --source-content-block=CONTENT_BLOCK_PACKAGE

--target-extension（必需）：目标扩展的扩展密钥，内容块应迁移到。
--vendor-name（必需）：迁移内容块的供应商名称。
--package-path（必需）：应迁移的“旧”内容块包的路径（从文档根目录相对路径）。
--source-content-block（可选）：应迁移的“旧”内容块的包密钥。

需要注意的缺点

如果您迁移数据库结构，在运行database updateschema时可能会得到“行大小太大”的错误。

有时再次运行带有附加参数如"table.add"的database updateschema命令就足够了。如果这不起作用，您必须根据“行大小太大”错误的信息手动分析数据库结构，并执行一些必要的SQL查询。

故障排除和日志记录

如果某些事情没有按预期工作，请首先查看日志文件。每个问题都记录在TYPO3日志中（通常位于var/log/typo3_*.log）

一起取得更大成果或反馈，反馈，反馈

感谢任何反馈！无论是改进建议、扩展请求还是对扩展的好或坏的（建设性）反馈。

请随时通过service@passionweb.de或在Slack上联系我发送您的反馈。

passionweb / contentblocks-reg-api-migration

维护者

详细信息