Django CMS 2.4.x Documentation

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

摘要

文档主要介绍了Django CMS 2.4.x版本的更新内容和改进措施。包括修复了WymEditor的JavaScript加载问题，将挪威语言代码从`no`更新为`nb`，新增了时区支持功能，解决了slug冲突问题，禁止 unnamed related names for PlaceholderField，修复了页面修改表单的错误，并介绍了如何从旧版本升级到新版本。文档还提到了新增的管理命令，如删除 orphaned plugins 和检查配置环境的命令。此外，文档还更新了对依赖项的最低版本要求，并介绍了如何使用South进行数据库迁移。

AI总结

### Django CMS 2.4.x 版本更新总结

#### 1. 重要修复
- **WymEditor修复**：解决了WymEditor无法正确加载JavaScript资产的问题。
- **Norwegian翻译更新**：将旧的语言代码`no`替换为新的`nb`，用户需更新`LANGUAGES`设置。
- **slug冲突问题**：新增检查机制，避免相同`slug`导致的错误，提示用户修改`slug`。
- **PlaceholderField改进**：禁止匿名相关名称，增强权限检查。
- **页面变更表单修复**：解决了权限不足或`DEBUG=False`时的错误，修复了`slug`字段预填充问题。

#### 2. 新增功能
- **时区支持**：在Django 1.4及以上版本中新增时区感知功能，需启用`USE_TZ=True`。
- **Google地图插件**：新增宽度和高度字段，支持自定义插件大小。
- **管理命令**：
- `delete_orphaned_plugins`：用于删除无关联的插件。
- `cms check`：用于检查配置和环境。
- `fix-mptt`：修复MPTT树数据。
- **页面可见性和菜单选项**：新增页面可见性和菜单显示的控制功能。

#### 3. 其他改进
- **依赖项更新**：
- 支持Django 1.5，移除对Django 1.3和Python 2.5的支持。
- 更新`django-mptt`至0.5.1或0.5.2版本。
- **文档改进**：修复了部分文档问题，新增了对新功能的说明。
- **代码规范**：遵循PEP8，使用4个空格缩进，保持代码风格一致。

#### 4. 弃用与注意事项
- **Pending deprecations**：
- `CMS_FLAT_URLS`设置将被移除。
- `CMS_MODERATOR`功能将被替换为更简单的 unpublished 变更处理方式。
- **Python 2.5支持**：将在2.4版本中移除。

#### 5. 安装与配置
- **最低要求**：
- Python 2.6及以上。
- Django 1.4.5或更高版本。
- South 0.7.2或更高版本。
- **推荐扩展**：
- Django Filer：用于文件和图片管理。
- Django-filter：增强插件功能。

#### 6. 迁移与升级
- **迁移方案**：2.4版本对迁移方案进行了重大调整，需通过两步升级过程完成。
- **管理命令**：新增了`cms moderator`和`cms check`命令，用于检查和处理迁移问题。

#### 7. 贡献指南
- **代码贡献**：需经过严格的代码审查和测试，确保代码质量。
- **文档贡献**：使用Sphinx和restructuredText编写文档，保持文档的准确性和完整性。

总结：Django CMS 2.4版本在功能、性能和用户体验上均有显著提升，新增了多项实用功能，并修复了多个关键问题，同时对未来的版本进行了规划，建议用户及时升级以获取更好的体验。