Django CMS 以编程方式创建页面

Django CMS 是一个基于 Django 框架的内容管理系统，它提供了许多功能强大且易于使用的工具来创建和管理网站内容，包括页面、文章、图像等。

在本篇文章中，我们将介绍如何以编程方式创建页面，这种方法非常适用于开发人员，因为它允许我们利用 Python 代码自动化页面创建和管理过程。

创建页面

要创建一个页面，首先需要导入必要的模块和类：

from cms.api import create_page
from cms.models import Title
from django.contrib.auth.models import User

然后，我们需要定义页面的基本信息，包括标题、父页面、URL、模板和语言：

user = User.objects.filter(is_staff=True, is_superuser=True).order_by('pk').first()
title = 'New Page'
parent_page = None
url = 'new-page'
template = 'default.html'
language = 'en'

在这个例子中，我们将新页面创建在根目录下，并使用默认模板。

接下来，我们可以使用 create_page() 方法来创建页面：

page = create_page(
    title=title,
    template=template,
    url=url,
    language=language,
    parent=parent_page,
    created_by=user,
    published=True,
)

create_page() 方法接受许多参数，但最基本的参数是标题、模板、URL、语言和父页面。我们还可以指定页面的创建者、发布状态和其他选项。

现在，我们已经成功地创建了一个新页面，接下来，我们可以添加一些内容。

添加内容

要向页面添加内容，请首先导入必要的类：

from cms.api import add_plugin
from cms.models import Placeholder, CMSPlugin

然后，我们需要获得新页面的占位符。在 Django CMS 中，占位符是用来存放内容的区域：

placeholder = Placeholder.objects.create(slot='content', default_width='full')
page.placeholders.add(placeholder)

在这个例子中，我们创建了一个名为 content 的占位符，并将其添加到新页面中。现在，我们可以使用 add_plugin() 方法来向占位符添加内容：

plugin = add_plugin(placeholder, 'TextPlugin', language=language)
plugin.body = 'Hello, World!'
plugin.save()

在这个例子中，我们向占位符添加了一个文本插件，并将其内容设置为 "Hello, World!"。

现在，我们已经成功地创建了一个新页面，并向其添加了一些内容。接下来，让我们来看一下如何在前端页面上访问这些内容。

渲染页面

要在前端页面上呈现我们创建的页面和内容，我们需要使用模板。在 Django CMS 中，我们可以使用 {% cms_toolbar %} 标签和 djangocms_page_placeholder 模板标签来轻松集成 CMS 功能。

{% extends "base.html" %}

{% block content %}
<div class="container">
    {% cms_toolbar %}
    {% for title in page.get_title_obj %}
        <h1>{{ title.title }}</h1>
    {% endfor %}
    {% for plugin in instance.placeholder.get_plugins %}
        {% render_plugin plugin %}
    {% endfor %}
</div>
{% endblock %}

在这个例子中，我们首先渲染了 CMS 工具栏，然后渲染了页面的标题和内容插件。

结论

在本文中，我们探讨了如何以编程方式创建页面、添加内容以及在前端页面上呈现这些内容。这是一种非常强大的方法，可以使开发人员更轻松地管理网站内容，特别是对于拥有大量页面和内容的网站来说。如果您使用 Django CMS，我强烈建议您尝试一下这种方法。