django cms 2.2.x Documentation

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

摘要

The document provides comprehensive guidance on installing, configuring, and using Django CMS 2.2.x. It covers requirements, database setup, upgrading, and introductory tutorials for new users. Key features include the use of Django-sekizai for media handling, integration with Django 1.3 staticfiles, and deprecated features such as Django-dbgettext. The document also details configuration settings like CMS_Templates, CMS_TEMPLATE_INHERITANCE, and CMS_PLACEHOLDER_CONF. Additionally, it explains how to create custom plugins and integrate them into CMS pages.

AI总结

《Django CMS 2.2.x Documentation》提供了对Django CMS 2.2.x版本的全面指南，涵盖安装、配置、使用和扩展等内容。以下是文档的核心内容总结：

### 1. **版本概述**
- **Django CMS 2.2.x** 是Django内容管理系统的一个重要版本，支持Django 1.2.5和1.3，并引入了多项新功能和改进。

### 2. **安装与依赖**
- **Django-mptt** 现在作为外部依赖，版本要求为0.4.2或更高。安装前需手动删除旧版本。
- **Django-Sekizai** 替代了旧的`PluginMedia`框架，成为新的依赖。需在`TEMPLATE_CONTEXT_PROCESSORS`中添加`sekizai`上下文处理器。

### 3. **核心功能**
- **静态文件迁移**：静态资源从`/media/`迁移到`/static/`，以兼容Django 1.3的`staticfiles`应用。
- **模板要求**：所有CMS模板必须包含`js`和`css`的Sekizai命名空间。
- **视图权限**：支持为Django CMS页面分配视图权限，增强权限管理。

### 4. **配置与自定义**
- **基本设置**：包括`CMS_TEMPLATES`、`CMS_TEMPLATE_INHERITANCE`和`CMS_PLACEHOLDER_CONF`等关键配置。
- **媒体处理**：通过Sekizai框架处理静态资源，需在模板中使用`{% cms_toolbar %}`标签启用工具栏。

### 5. **导航与菜单**
- 提供多种导航显示方式，如菜单、子菜单和面包屑导航。
- 支持软根节点和菜单的扩展。

### 6. **插件系统**
- **内置插件**：包括文件上传、Flash播放器等插件。
- **第三方插件**：推荐使用Django-Filer和`cmsplugin-filer`等扩展插件。
- **自定义插件**：允许开发者创建自定义插件以集成其他Django应用的功能。

### 7. **sitemap.xml生成**
- 通过`CMSSitemap`生成网站地图，需在`INSTALLED_APPS`中添加`django.contrib.sitemaps`，并在URL配置中添加`sitemap.xml`路由。

### 8. **重要注意事项**
- **工具栏启用**：工具栏需通过模板标签`{% cms_toolbar %}`显式启用。
- **静态文件服务**：需确保服务器配置正确以同时服务静态文件和媒体文件。

### 9. **新功能与改进**
- **Django 1.3支持**：兼容性提升。
- **文件插件限制**：内置文件插件仅支持本地存储，建议使用Django-Filer扩展功能。

### 10. **文档结构**
- 包括入门教程、配置指南、插件参考、sitemap生成等模块，适合不同层次的开发者使用。

总结来看，Django CMS 2.2.x版本在功能、性能和扩展性上均有显著提升，特别在静态资源处理、插件系统和权限管理方面表现突出。