django cms 4.1.x Documentation

• 语言: 英语
• 格式: .pdf
• 来源: docs.django-cms.org

摘要

文档详细介绍了 django CMS 4.1.x 的新功能、改进和兼容性。主要内容包括：引入了状态指示器到页面树，改进了插件管理功能，修复了多个已知 bug，提升了性能和用户体验。文档还强调了与 Django 和 Python 的兼容性要求，并提供了从旧版本升级的注意事项。此外，还介绍了多个第三方插件及其兼容性状态。

AI总结

### Django CMS 4.1.x 文档总结

#### 1. 版本兼容性
- **Django 版本**：支持 Django 3.2 到 5.0，推荐使用最新版本。
- **Python 版本**：支持 Python 3.8、3.9、3.10 和 3.11。
- **djangocms-versioning**：要求使用版本 2.0 及以上。

#### 2. 新功能
- **状态指示器**：页面树中新增状态指示器，显示“公开”和“空”状态，并允许其他包扩展功能。
- **.djangocms-versioning**：新增版本控制功能，如从页面树发布内容。

#### 3. Bug 修复
- **插件移动**：修复了插件从一个占位符移动到另一个占位符可能导致的服务器错误。
- **空页面内容**：修复了空页面内容在页面树中渲染不正确的问题。
- **语言视图**：新增页面时触发语言视图中的表单，而非浏览器语言。
- **“清空”菜单**：修复了占位符“清空”菜单功能。

#### 4. 向后不兼容的变化
- **TitleExtension 重命名**：`cms.extensions.models.TitleExtension` 重命名为 `PageContentExtension`，第三方包需更新代码。
- **方法弃用**：`ExtensionToolbar.get_title_extension_admin` 方法已弃用，推荐使用 `get_page_content_extension_admin`。
- **Monkey Patching**：Django CMS 4.1 不支持 `djangocms-versioning` 的 Monkey Patching。

#### 5. 升级注意事项
- **从旧版本升级**：建议使用第三方工具 `djangocms-4-migration` 进行迁移。
- **核心简化**：4.0 版本对核心进行了大幅简化，移除了限制，如版本发布限制和过多的“意见”。
- **发布功能移出**：发布功能移交给 `djangocms-versioning`，允许第三方自定义发布逻辑。

#### 6. 第三方插件兼容性
- **推荐插件**：包括 `djangocms-text-ckeditor`、`djangocms-frontend` 等，均支持 4.1 版本。
- **其他插件**：如 `djangocms-version-locking`、`djangocms-page-admin` 等，兼容性需注意。

#### 7. 性能改进与优化
- **插件渲染**：优化了插件移动逻辑，减少保存次数。
- **页面树**：改进了页面树的拖放功能和排序逻辑。
- **缓存与性能**：新增 `get_cache_expiration` 和 `get_vary_cache_on` 方法，优化了缓存控制。

#### 8. 其他改进
- **UI 改进**：页面树和侧边栏的用户体验优化。
- **设置调整**：新增 `CMS_INTERNAL_IPS` 设置，控制工具栏显示的 IP 地址。
- **JavaScript 改进**：从 JSHint 和 JSCS 切换为 ESLint，提升了代码质量。

#### 9. 升级指南
- **备份数据**：升级前请备份数据库。
- **详细步骤**：参考文档中的升级指南和 `djangocms-4-migration` 工具。

总结：Django CMS 4.1 版本在兼容性、功能和性能方面均有较大提升，建议开发者仔细阅读升级指南，确保平滑过渡。