django CMS 4迁移

警告： 如果迁移过程未完成，您将无法在没有重新加载数据库备份的情况下撤销更改。我们不对运行此项目提供的命令时产生的任何数据丢失负责。请在运行此包提供的任何命令之前保留数据库备份。

何时需要此包？

此包旨在将django CMS 3.5+项目迁移到django CMS 4.0。

此包做什么？

• 保留任何草稿和发布的内容，确保任何新的草稿更改都作为djangocms_versioning中的新草稿版本保留。

局限性

由于django CMS 3.5+和4.0之间更改的性质，如果安装了不兼容的包，则该包将无法正常工作。

这可能需要您

• 分叉或复制并修改此包以符合您项目中的定制要求（我们可能将接受对流行包的这些更改作为可配置选项）
• 确保您的项目中安装的所有包

先决条件

需要了解4.0中的更改和新功能

• 新的cms应用程序配置
• 修订的页面、标题（现称为PageContent）和占位符关系

需要了解django CMS版本控制

• 分组和内容模型术语
• 理解版本控制如何选择发布内容

安装以下包

以下包尚未正式发布，需要直接从存储库安装。我们需要您的帮助来使包v4.0兼容，并为更广泛的社区提供文档！

django CMS 4.0

pip install http://github.com/divio/django-cms/tarball/release/4.0.x#egg=django-cms

djangocms-text-ckeditor

pip install https://github.com/divio/djangocms-text-ckeditor/tarball/support/4.0.x#egg=djangocms-text-ckeditor

djangocms-versioning

pip install https://github.com/divio/djangocms-versioning/tarball/master#egg=djangocms-versioning

djangocms-alias

pip install https://github.com/divio/djangocms-alias/tarball/master#egg=djangocms-alias

安装

警告：如果使用不当，此包可能导致您的数据库处于损坏状态，请在运行以下任何命令之前备份所有数据库！

首先将此包安装到您的项目中

pip install djangocms-4-migration

运行

只需运行以下命令即可运行数据迁移。注意：此命令调用django migrate命令，因为这需要运行保存信息的命令，这些信息会在直接运行cms迁移时丢失。

python manage.py cms4_migration

django CMS 4.0 兼容性的常见解决方案

以向后兼容的方式导入PageContent（标题）。

# django CMS v4
try:
    from cms.models import PageContent
# django CMS 3.x
except ImportError:
    from cms.models import Title as PageContent