README

此仓库包含 Webforge/CmsBundle 和一个 symfony bundle (AppBundle)，允许进行自测试

cms 的 "核心" 在 Webforge\CmsBundle 中（位于 src\php\Webforge\CmsBundle）。cms 由此 bundle 和一些组件组成（见 src\php）。

版本控制

npm 包 webforge-cms 和 composer 包 webforge/cms 在版本控制上始终同步。因此，一些小的更改可能仅适用于 js 包、php 包或两者。

测试

phpunit

以及几个 JavaScript 测试

npm test

赞助

非常感谢 BrowserStack.com 赞助了一个免费的 Live 账户，这使得我们能够在 Iphone 和其他设备上进行测试。

变更日志

BC Breaks 3.1.x

• 添加了 resetMediaMetadata 到 MediaFileEntityInterface。如果你正在使用 MediaFileEntityMetadata-Trait，你一切都很好

BC Breaks for 3.0.x

• symfony/symfony 现在不再是依赖项。你必须使用 symfony/flex 并自己配置一切。（prepend config 不再使用）
• 公共文件夹现在是 www（而不是 public）
• 使用 em 和 dc 构造 CommonController
• 移除了 Symfony\Kernel
• CommonController 现在是 Symfony-AbstractController，因此具有更窄的依赖注入：你需要重构你的控制器代码
• 阅读升级到 3.0

BC Breaks for 2.3.x

• 序列化后，将不再像以前那样自动刷新（在每个二进制序列化后） - 这非常慢。你需要自己调用 em->flush
• exif 现在由 lsolesen/pel 读取，而不是使用 php 原生。这可能会给你带来更多或更少的失败案例
• 原始图像元数据（尽管带有旋转 exif 数据）将不会自动旋转，因为物理文件也没有旋转，但缩略图元数据将旋转，并且图像将物理旋转

BC Breaks for 2.2.x

• 你需要 php 7.2 来安装
• 依赖项 symfony/symfony 更新到 4.1
• 使用 phpunit 6.5.x
• TestCaseTrait 现在使用 mockery trait，因此你现在必须安装 mockery 1.1.0

BC Breaks for 2.1.x

• 上传到媒体控制器的文件将覆盖现有文件（但仍然会生成警告）

升级到 2.0.x

• 阅读升级到 2.0
• 更新到 Symfony 4.0

BC Breaks for 1.15.x

• 使用 PHPUnit 5.x.x
• BlockExtender 接口已更改，以通过引用传递 blocks-array 的值

BC Breaks for 1.14.x

• MediaFileEntityInterface 有两个新方法： setMediaMetadata 和 getMediaMetadata
• 将此添加到你的 model.json 以用于二进制 "mediaMeta": { "type": "Object", "nullable": true }
• 使用 trait： Webforge\CmsBundle\Media\MediaFileEntityMetadata 来实现这些方法
• 使用 imagine 生成缩略图的生成已弃用
• 缩略图将使用 thumbor 创建，因此默认情况下没有 width 和 height（将 metadata_only: true 传递到转换的配置中以启用获取元数据）
• 将 cms.version 添加到你的全局 twig 变量中

BC Breaks for 1.13.x

• 不要向 appkernel 添加 \Knp\Bundle\MarkdownBundle\KnpMarkdownBundle()。它将被自动添加
• 创建一个 etc/cms/blocktypes.json 文件（包含一个空数组即可）
• 将 admin/config.js 分割成 etc/cms/blocktypes.json 并使用 requirejs-json 包含它
• 重构 当我在上下文中点击 "" 为 当我在点击 ""

1.12.x 版本的 BC 断开

• 在全局 twig 变量中将 site.url 改为 cms.site.url
• 在全局 twig 变量中将 site.title 改为 cms.site.title

1.11.x 版本的 BC 断开

• 将 Webforge\Common\String 重命名为 Webforge\Common\StringUtil（因为 PHP 7.x 的原因）

1.7.x 版本的 BC 断开

• CMS 中的链接通过单击一次即可添加并激活标签页（而不是两次）。因此，tabs.open() 的调用已更改。add 和 select 仍然有效。

1.6.x 版本的 BC 断开

• 您需要再次提供数据库参数（database_host, database_port, database_name, database_user, database_password）
• 您需要在 base.html.twig 模板中设置 sidebar.activeGroup
• 您需要在 base.html.twig 模板中设置 site.url 和 site.title
• 您需要在 base.html.twig 模板中设置 cms.title 和（可选）site.xsTitle（使用全局 twig 扩展：Twig_Extension_GlobalsInterface 来完成此操作）