django cms 3.1.x Documentation

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

摘要

文档是django CMS 3.1.x版本的官方文档，涵盖版本特性、更新说明和升级指南。3.1版本主要作为巩固版本，将树结构处理从MPTT（Modified Preorder Tree Traversal）切换为Django-treebeard的Materialized Path（MP）方法，以提升性能和可靠性。文档列出了3.1.1至3.1.5各子版本的bug修复，包括树损坏修复、工具栏问题修复等。同时指出3.1版本放弃了对Django 1.4和1.5的支持，要求Django 1.6或1.7。South变为可选依赖。文档还包含教程、操作指南、关键主题、参考等章节结构说明。

AI总结

django CMS 3.1.x 是一个重要的整合版本，旨在巩固3.0的进展，并为未来开发奠定稳定基础。该版本在保持最大向后兼容性的同时，修复了大量bug并引入了关键性能改进。

**核心变更与升级要求：**
* **树结构引擎更换**：从MPTT切换到django-treebeard（使用Materialized Path算法），以提升大型页面树（>1000页）的操作性能和事务可靠性。**注意**：这是一个不向后兼容的变更。自定义代码若使用底层树接口，需参考treebeard文档进行调整。**升级前必须运行 `manage.py cms fix-mptt` 命令**。
* **Django版本支持**：停止支持Django 1.4和1.5，现在需要Django 1.6或1.7。
* **South依赖可选**：South现在仅对Django 1.6是必需的，被标记为可选依赖。可通过 `pip install django-cms[south]` 安装。
* **重要警告**：从3.0升级到3.1需要执行特定步骤，请阅读《升级指南》。

**3.1.x系列主要新功能：**
* **前端编辑**：引入了全新的前端编辑界面，包括内容模式和结构模式，可直接在页面前端编辑内容、添加和重新排列插件。
* **新工具栏**：工具栏代码被简化，外观更新，成为一个更一致的管理工具。
* **页面类型**：可以将页面保存为“页面类型”，创建新页面时选择该类型，即可自动预填所有插件和内容。
* **实验性支持**：增加了对Python 3.3的实验性支持，停止支持Python 2.5。
* **多语言编辑优化**：改进了多语言站点管理，包括为未公开语言提供内置语言选择器，以及可配置的管理站点语言行为。
* **SEO字段调整**：移除了`CMS_SEO_FIELDS`设置和SEO字段集；`meta_description`字段最大长度改为155字符；移除了`meta_keywords`字段。
* **插件回退语言**：现在可以为占位符指定回退语言，当当前语言内容为空时使用。

**关键Bug修复（涵盖3.1.1至3.1.5版本）：**
* **树结构损坏修复**：3.1.4和3.1.5版本修复了因粘贴、移动或删除页面/插件导致的树结构损坏问题。升级后需运行 `manage.py cms fix-tree` 命令修复数据。
* **安全修复**：3.1.1版本修复了一个CSRF漏洞，该漏洞可能诱使特权用户在不知情的情况下执行操作。
* **兼容性问题**：3.1.5版本与 `djangocms-text-ckeditor` 版本不兼容，要求升级到2.7.1或更高版本（注意：2.8及以上版本仅兼容CMS 3.2.x）。
* **其他修复**：包括工具栏错误、占位符缓存、插件排序、语言回退、面包屑导航、页面菜单缺失、X-Frame-Options问题等。

**文档结构：**
文档分为教程（入门）、操作指南（进阶开发）、关键主题（系统解释）、参考（API参考）、开发与社区、发布说明与升级信息以及用户指南（使用CMS）等主要部分。