Django CMS 2.4.x Documentation

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

摘要

文档详细介绍了Django CMS 2.4.3-support版本的安装、升级和配置。版本2.4引入了对Django 1.5的支持，并放弃了对Django 1.3和Python 2.5的支持，要求Python 2.6+和Django 1.4+。文档强调了迁移的重要性，特别是从旧版本升级时需要注意的迁移过程和数据迁移问题。此外，还详细说明了相关依赖项如South、django-mptt等的版本要求和更新方式。安装步骤包括数据库设置、迁移命令以及验证安装的正确性。文档还提到了新的功能和改进，如页面树的延迟加载、提高管理性能、修复了WymEditor和MPTT树数据的管理命令等。

AI总结

以下是对《Django CMS 2.4.3-support Documentation》的中文总结，重点突出核心观点和关键信息，语言简洁明了，逻辑连贯：

---

## **Django CMS 2.4.3 支持文档总结**

### **1. 安装与升级**
1. **安装要求**
- Python 2.5 或更高版本（2.x 系列）。
- Django 1.4.5、1.5 或更高版本。
- South 0.7.2 或更高版本。
- 其他依赖如 `django-classy-tags`、`django-mptt`、`django-sekizai` 等，需满足最低版本要求。

**注意**：使用 pip安装时，上述依赖会自动安装。

2. **新建安装**
- 运行 `python manage.py syncdb --all` 和 `python manage.py migrate --fake` 初始化数据库。
- 完成后访问 `http://127.0.0.1:8000/admin/` 即可使用。

3. **升级说明**
- 升级前请仔细阅读升级指南，尤其是从旧版本升级的情况。
- 2.4 版本移除了对 Django 1.3 和 Python 2.5 的支持，Django 1.4 和 Python 2.6 是最低要求。

---

### **2. 2.4.3 版本更新说明**
1. **修复与改进**
- 修复了 cookies 处理问题、Unicode 较小问题、WymEditor 错误、迁移工具 bug 等。
- 优化了测试框架，支持通过 `setup.py test` 或 `runtests.py` 运行测试。
- 修复了页面树在管理员界面中的懒加载性能问题。

2. **迁移工具改造**
- 2.4 版本完全重写了迁移文件，所有 CMS 应用的迁移文件合并为 `0001_initial.py`。
- 从 2.3.1 或更早版本升级需先升级到 2.3.3，再完成 2.4 升级。

---

### **3. 2.4 版本主要变更**
1. **新增功能**
- 支持 Django 1.5，移除 Django 1.3 和 Python 2.5 支持。
- CMS 的迁移工具完全重写，合并迁移文件，简化升级流程。

2. **不兼容性更改**
- **CMS_FLAT_URLS** 设置已弃用，将在 2.4 移除。
- **CMS_MODERATOR** 功能将被简化，取代未发布内容的复杂处理方式。

---

### **4. 其他版本更新说明**
1. **2.3.8 版本**
- 修复了 Postgres 数据库中占位符复制的问题。

2. **2.3.7 版本**
- 提高了缓存性能，修复了插件模板缓存问题。
- 增加了 `cms fix-mptt` 命令，用于修复 MPTT 树数据。

3. **2.3.4 版本**
- 修复了 WymEditor 的 JavaScript 资源加载问题。

---

### **5. 配置与扩展**
1. **SEO 字段**
- 通过 `CMS_SEO_FIELDS` 设置启用“SEO 字段”，支持设置页面标题、关键词和描述。

2. **缓存设置**
- `CMS_CACHE_DURATIONS`：设置内容、菜单和权限的缓存有效期，默认为 60秒、3600秒和 3600秒。
- `CMS_CACHE_PREFIX`：为缓存键添加前缀，避免多站点间缓存冲突。

---

## **总结**
Django CMS 2.4.3 支持文档详细说明了安装、升级、版本更新和配置选项。2.4 版本主要升级了 Django 1.5 支持，优化了迁移工具，并修复了多项 bug，适合新安装和升级使用。