django-fluent-pages 3.0.2

页面树定制

本模块提供了一个页面树，其中每个节点类型都可以是不同的模型。这使得像您这样的开发者可以按照自己的意愿来构建站点树。例如

• 通过定义RstPage类型来构建RST页面的树结构。

• 通过集成django-fluent-contents来构建基于小部件的页面树。

• 构建“产品页面”，将所有产品都作为子节点暴露。

• 构建一个主页、子部分和文章节点的树，每个节点都有像专业CMS那样的自定义字段。

每个节点类型都可以有自己的自定义字段、属性和渲染。

如果您正在构建一个自定义CMS，这个模块可能非常适合您，因为它为您提供了树，而不必担心其他任何事情。实际的页面内容是通过页面类型插件定义的。

配置

您还可以使用现成的模板

mkdir my-website.com
cd my-website.com
django-admin.py startproject mywebsite . -e py,rst,example,gitignore --template=https://github.com/edoburu/django-project-template/archive/django-fluent.zip

或创建一个新的项目

cd ..
django-admin.py startproject fluentdemo

要有一个标准设置，并集成django-fluent-contents，请使用

INSTALLED_APPS += (
    # The CMS apps
    'fluent_pages',

    # Required dependencies
    'mptt',
    'parler',
    'polymorphic',
    'polymorphic_tree',
    'slug_preview',

    # Optional widget pages via django-fluent-contents
    'fluent_pages.pagetypes.fluentpage',
    'fluent_contents',
    'fluent_contents.plugins.text',
    'django_wysiwyg',

    # Optional other CMS page types
    'fluent_pages.pagetypes.redirectnode',

    # enable the admin
    'django.contrib.admin',
)

DJANGO_WYSIWYG_FLAVOR = "yui_advanced"

请注意，每个CMS应用都是可选的。只需要fluent_pages和mptt。其余的应用为系统添加了额外的功能。

在urls.py中

urlpatterns += patterns('',
    url(r'', include('fluent_pages.urls'))
)

之后可以创建数据库

./manage.py migrate
./manage.py runserver

自定义页面类型

本模块的关键特性是对自定义节点类型的支持。查看现有的类型在fluent_pages.pagetypes中，了解它是如何实现的。

这归结为创建一个包含2个文件的包

models.py文件应定义自定义节点类型及其任何字段

from django.db import models
from django.utils.translation import ugettext_lazy as _
from fluent_pages.models import HtmlPage
from mysite.settings import RST_TEMPLATE_CHOICES


class RstPage(HtmlPage):
    """
    A page that renders RST code.
    """
    rst_content = models.TextField(_("RST contents"))
    template = models.CharField(_("Template"), max_length=200, choices=RST_TEMPLATE_CHOICES)

    class Meta:
        verbose_name = _("RST page")
        verbose_name_plural = _("RST pages")

一个page_type_plugins.py文件，定义元数据和渲染

from fluent_pages.extensions import PageTypePlugin, page_type_pool
from .models import RstPage


@page_type_pool.register
class RstPagePlugin(PageTypePlugin):
    model = RstPage
    sort_priority = 10

    def get_render_template(self, request, rstpage, **kwargs):
        return rstpage.template

一个模板可能看起来像这样

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

{% block headtitle %}{{ page.title }}{% endblock %}

{% block main %}
  <h1>{{ page.title }}</h1>

  <div id="content">
    {{ page.rst_content|restructuredtext }}
  </div>
{% endblock %}

Et, voila：用非常少的代码就创建了一个自定义CMS。

可选的，还可以定义一个model_admin，以在编辑或删除页面中实现自定义字段布局或额外功能。

将页面添加到网站地图

可选地，页面可以被包含在网站地图中。在 urls.py 中添加以下内容

from fluent_pages.sitemaps import PageSitemap

sitemaps = {
    'pages': PageSitemap,
}

urlpatterns += patterns('',
    url(r'^sitemap.xml$', 'django.contrib.sitemaps.views.sitemap', {'sitemaps': sitemaps}),
)

贡献

此模块旨在通用。如果您对它有任何不满意的地方，或者认为它不够灵活，请告诉我们。我们很高兴改进它！

如果您有任何其他有价值的贡献、建议或想法，也请告诉我们，因为我们会考虑这些。我们也欢迎拉取请求。:-)