django cms 4.1.1 Documentation

语言	格式	评分
英语	.pdf	3
摘要
文档详细介绍了Django CMS 4.1.1版本的更新内容，包括多项功能改进、Bug修复、已移除的deprecated功能以及向后不兼容的变化。新版本移除了菜单模块命名为menus.py的功能，不再支持Django Reversion，并引入了对Django 4.1和Python 3.11的支持。文档还修复了多个影响用户体验的Bug，并改进了界面和文档结构。
AI总结
### Django CMS 4.1.1 文档总结 #### 1. 版本概述 - 发行版本：4.1.1 - 主要更新： - 修复了多个关键问题，包括页面模板设置权限、粘贴页面时翻译丢失、欢迎界面显示问题等。 - �移除了部分已弃用的功能，例如菜单模块文件名 `menus.py` 和 `cms.utils.django_load.py` 模块。 - 弃用了部分 API 和方法，例如 `CMSPlugin` 的 `render_plugin` 方法和 `cms_menus.py` 模块。 - 修复了与 Django 1.11 和 Python 3.10 兼容性相关的问题。 #### 2. 新功能与改进 - 新功能： - 支持 Django 4.1 和 Python 3.11。 - 支持暗黑模式。 - 支持 `tel:` 和 `mailto:` URI 在高级页面设置中的重定向字段。 - 改进页面树的性能和 UI，包括修复树状结构的排序和位置问题。 - 引入 `get_cache_expiration` 和 `get_vary_cache_on` 方法，用于插件缓存控制。 - 改进： - 提升了插件添加和移动的性能。 - 优化了占位符缓存和结构板的渲染逻辑。 - 改进了工具栏的用户体验，例如调整侧边栏的可调节性。 #### 3. 向后不兼容的变化 - 页面树的根页面不再自动设置为首页，需手动配置。 - 页面的排序方式从 `path` 更改为 `node__path`。 - 页面不再有 `site` 和 `parent` 字段，改为通过 `node` 树结构管理。 - 未发布的页面不再有“待发布”状态，数据迁移已处理相关问题。 - `CMSApp` 类的 `urls` 和 `menus` 属性不再支持，需使用 `get_urls()` 和 `get_menus()` 方法。 #### 4. 弃用的功能 - 移除了对 Django Reversion 的支持。 - 移除了 `CMS_TOOLBAR_SIMPLE_STRUCTURE_MODE` 设置。 - 移除了 `cms_plugin.get_parent_classes()` 方法，改为使用 `classmethod`。 #### 5. 已知问题与修复 - 修复了 slug 生成、页面树更新、占位符继承等回归问题。 - 解决了多数据库环境中迁移问题。 - 修复了 Firefox for Mac 用户的快捷键问题。 #### 6. 升级指南 - 备份数据库：确保数据库健康后再升级。 - 检查设置：确认 `CMS_LANGUAGES` 设置是否正确。 - 运行迁移：执行 `python manage.py migrate` 和 `python manage.py cms fix-tree`。 - 检查自定义代码：更新使用已弃用功能的部分。 - 安装新版本：通过 pip 或从 GitHub 安装。 #### 7. 兼容性说明 - 支持 Django 3.2、4.0 和 4.1，Python 3.6 至 3.11。 - 不再支持 Django 3.1 及以下版本。 #### 8. 总结 Django CMS 4.1.1 提供了更强的兼容性、性能优化和用户体验改进，同时移除了部分过时功能。升级时需注意向后不兼容的变化，并确保代码与新版本兼容。