【实战指南】轻松上手：Mezzanine CMS模板定制全攻略

Mezzanine CMS模板使用教程

引言

Mezzanine 是一个基于 Django 的内容管理系统（CMS），它为开发者提供了一个强大而灵活的平台来构建功能丰富的网站。除了继承了 Django 的所有优点之外，Mezzanine 还引入了许多额外的功能，如内置的博客、页面管理、评论系统等。本文将详细介绍如何在 Mezzanine 中创建和使用自定义模板，以帮助你快速掌握这一强大的工具。

环境搭建

在开始之前，请确保你的开发环境中已经安装了 Python 和 pip。接着，通过 pip 安装 Mezzanine：

pip install mezzanine

创建一个新的 Mezzanine 项目，并初始化数据库：

mezzanine-project myproject
cd myproject
python manage.py migrate

启动开发服务器以验证安装是否成功：

python manage.py runserver

访问 http://127.0.0.1:8000/ 应该能看到 Mezzanine 的默认主页。

步骤一：创建自定义应用

为了更好地组织代码，我们通常会在 Mezzanine 项目中创建一个新的应用。这可以通过以下命令完成：

python manage.py startapp custom_pages

然后，在 myproject/settings.py 文件中添加新应用到 INSTALLED_APPS 列表里：

INSTALLED_APPS = (
    ...
    'custom_pages',
)

步骤二：定义模型

虽然 Mezzanine 提供了丰富的内容类型，但有时我们需要扩展或自定义这些类型。这里我们创建一个简单的模型来存储一些额外信息：

# custom_pages/models.py
from django.db import models
from mezzanine.pages.models import Page

class CustomPage(Page):
    extra_info = models.TextField(blank=True, null=True)

    class Meta:
        verbose_name = "Custom Page"
        verbose_name_plural = "Custom Pages"

别忘了进行迁移以更新数据库结构：

python manage.py makemigrations
python manage.py migrate

步骤三：创建模板

接下来，我们将创建一个自定义模板来展示我们的 CustomPage 模型中的数据。在 custom_pages 目录下创建一个名为 templates 的文件夹，并在其中创建 custompage.html 文件：

<!-- custom_pages/templates/custompage.html -->
{% extends "base.html" %}
{% load mezzanine_tags %}

{% block main %}
<div class="container">
    <h1>{{ page.title }}</h1>
    <p>{{ page.content|richtext_filters|safe }}</p>
    {% if page.extra_info %}
    <div class="extra-info">
        <strong>Extra Information:</strong>
        <p>{{ page.extra_info|linebreaksbr }}</p>
    </div>
    {% endif %}
</div>
{% endblock %}

这个模板继承了 Mezzanine 默认的基础模板，并添加了一个用于显示 extra_info 字段的部分。

步骤四：配置URL

为了让 Django 能够找到并渲染我们的自定义页面，需要修改项目的 URL 配置。打开 myproject/urls.py 并调整如下：

# myproject/urls.py
from django.urls import path, include
from mezzanine.conf import settings
from mezzanine.pages.views import page as page_view

urlpatterns = [
    # Mezzanine's URLs
    path('', include('mezzanine.urls')),

    # Custom pages
    path('<slug>/', page_view, name='page'),
]

if settings.DEBUG:
    from django.contrib.staticfiles.urls import staticfiles_urlpatterns
    urlpatterns += staticfiles_urlpatterns()

这样就确保了任何请求都能被正确地路由到页面视图函数，从而加载相应的模板。

步骤五：注册管理界面

为了让管理员能够通过后台管理界面编辑 CustomPage，我们需要将其注册到 Django 管理站点中。编辑 custom_pages/admin.py 文件：

# custom_pages/admin.py
from django.contrib import admin
from .models import CustomPage

admin.site.register(CustomPage)

现在你可以通过 http://127.0.0.1:8000/admin/ 登录管理后台，看到新增加的 Custom Pages 选项。

步骤六：测试自定义页面

最后一步是创建一个实际的 CustomPage 实例，并查看其效果。登录管理后台后，选择 Pages > Add New Page，填写标题和其他必要信息，选择 Custom Page 作为页面类型，然后输入一些示例文本到 Extra Information 字段中保存。

刷新浏览器，你应该能够在前端看到新创建的页面及其额外信息。

完整代码示例

以下是整个过程中涉及的主要文件内容汇总：

settings.py

INSTALLED_APPS = (
    ...
    'custom_pages',
)

models.py (位于 custom_pages 目录)

from django.db import models
from mezzanine.pages.models import Page

class CustomPage(Page):
    extra_info = models.TextField(blank=True, null=True)

    class Meta:
        verbose_name = "Custom Page"
        verbose_name_plural = "Custom Pages"

custompage.html (位于 custom_pages/templates 目录)

{% extends "base.html" %}
{% load mezzanine_tags %}

{% block main %}
<div class="container">
    <h1>{{ page.title }}</h1>
    <p>{{ page.content|richtext_filters|safe }}</p>
    {% if page.extra_info %}
    <div class="extra-info">
        <strong>Extra Information:</strong>
        <p>{{ page.extra_info|linebreaksbr }}</p>
    </div>
    {% endif %}
</div>
{% endblock %}

urls.py (位于 myproject 目录)

from django.urls import path, include
from mezzanine.conf import settings
from mezzanine.pages.views import page as page_view

urlpatterns = [
    path('', include('mezzanine.urls')),
    path('<slug>/', page_view, name='page'),
]

if settings.DEBUG:
    from django.contrib.staticfiles.urls import staticfiles_urlpatterns
    urlpatterns += staticfiles_urlpatterns()

admin.py (位于 custom_pages 目录)

from django.contrib import admin
from .models import CustomPage

admin.site.register(CustomPage)

结论

通过本教程的学习，你已经掌握了如何在 Mezzanine 中创建和使用自定义模板的基本方法。从创建新的应用、定义模型、编写模板，再到配置 URL 和管理界面，每一步都详细介绍了具体操作步骤及相关代码。希望这篇教程能为你提供足够的指导，让你能够在自己的项目中顺利实施这些技术。