编辑“︁Django CMS”︁

{{DISPLAYTITLE:Django CMS}}

'''Django CMS''' 是一个基于 [[Django]] 框架的开源内容管理系统（CMS），专为开发者设计，提供直观的内容编辑界面和灵活的扩展能力。它允许非技术人员管理网站内容，同时为开发者提供完整的 Python/Django 开发环境。

== 核心特性 ==
Django CMS 的主要特点包括：
* '''可视化编辑'''：拖放式页面构建和实时预览。
* '''多语言支持'''：内置国际化（i18n）功能。
* '''插件系统'''：可扩展的内容模块架构。
* '''版本控制'''：内容修订历史记录。
* '''SEO友好'''：自动生成元标签和URL管理。

== 架构概述 ==
Django CMS 采用分层架构：
<mermaid>
graph TD
    A[用户界面] --> B[Django CMS Core]
    B --> C[Placeholder/Plugin系统]
    C --> D[Django ORM]
    D --> E[数据库]
</mermaid>

=== 核心组件 ===
1. '''Placeholders'''：定义页面内容区域
2. '''Plugins'''：可插入内容单元（文本/图片/表单等）
3. '''Toolbar'''：管理界面控制中心

== 安装与配置 ==
基本安装步骤：
<syntaxhighlight lang="bash">
# 创建虚拟环境
python -m venv cmsenv
source cmsenv/bin/activate

# 安装依赖
pip install django-cms
</syntaxhighlight>

基础配置示例（settings.py）：
<syntaxhighlight lang="python">
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...,
    'cms',
    'menus',
    'treebeard',
    'sekizai',
]

CMS_TEMPLATES = [
    ('home.html', 'Home Page Template'),
]
</syntaxhighlight>

== 创建第一个CMS页面 ==
=== 1. 初始化项目 ===
<syntaxhighlight lang="bash">
django-admin startproject mycmsproject
cd mycmsproject
python manage.py migrate
python manage.py createsuperuser
</syntaxhighlight>

=== 2. 添加页面模板 ===
创建<code>templates/home.html</code>：
<syntaxhighlight lang="html+django">
{% load cms_tags %}
<html>
<head>
    <title>{% page_attribute "page_title" %}</title>
</head>
<body>
    {% placeholder "content" %}
</body>
</html>
</syntaxhighlight>

=== 3. 启动开发服务器 ===
<syntaxhighlight lang="bash">
python manage.py runserver
</syntaxhighlight>

== 插件开发示例 ==
创建简单的文本插件：
<syntaxhighlight lang="python">
# cms_plugins.py
from cms.plugin_base import CMSPluginBase
from cms.plugin_pool import plugin_pool

class TextPlugin(CMSPluginBase):
    name = "Text Block"
    render_template = "text_plugin.html"
    
    def render(self, context, instance, placeholder):
        context['text'] = instance.body
        return context

plugin_pool.register_plugin(TextPlugin)
</syntaxhighlight>

配套模板<code>text_plugin.html</code>：
<syntaxhighlight lang="html+django">
<div class="text-block">
    {{ text|safe }}
</div>
</syntaxhighlight>

== 实际应用案例 ==
'''新闻发布系统'''实现流程：
1. 创建新闻模型
2. 开发新闻列表插件
3. 添加新闻详情占位符
4. 配置多语言支持

性能优化公式（缓存命中率）：
<math>
H = \frac{N_{hit}}{N_{hit} + N_{miss}} \times 100\%
</math>

== 进阶主题 ==
=== 自定义菜单系统 ===
通过<code>menus.base.Menu</code>类扩展：
<syntaxhighlight lang="python">
from menus.base import Menu, NavigationNode

class CustomMenu(Menu):
    def get_nodes(self, request):
        return [
            NavigationNode("Home", "/", 1),
            NavigationNode("About", "/about/", 2)
        ]
</syntaxhighlight>

=== 多站点管理 ===
配置示例：
<syntaxhighlight lang="python">
CMS_SITE_LANGUAGES = {
    1: ['en','de'],
    2: ['fr','es']
}
</syntaxhighlight>

== 最佳实践 ==
* 始终使用Django CMS的'''信号系统'''处理内容变更
* 对静态内容使用'''片段缓存'''
* 遵循'''插件最小化'''原则
* 定期执行'''数据库优化'''

== 常见问题 ==
{| class="wikitable"
|-
! 问题 !! 解决方案
|-
| 插件不显示 || 检查<code>INSTALLED_APPS</code>注册
|-
| 模板加载失败 || 确认<code>TEMPLATES</code>设置正确
|-
| 多语言失效 || 验证<code>LANGUAGES</code>配置
|}

== 性能比较 ==
{| class="wikitable"
|-
! 操作 !! 标准Django !! Django CMS
|-
| 页面渲染 || 15ms || 25ms
|-
| 内容编辑 || 需开发 || 内置
|-
| 扩展性 || 高 || 极高
|}

== 学习资源 ==
* 官方文档：https://docs.django-cms.org/
* GitHub仓库：https://github.com/django-cms/django-cms
* 社区论坛：https://discourse.django-cms.org/

{{Django扩展应用导航}}

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django扩展应用]]