sigmacms-fluent-pages 1.0.1

页面树定制

本模块提供了一个页面树，每个节点类型都可以是不同的模型。这使得您等开发者可以根据自己的需求来结构化您的站点树。例如：

• 通过定义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中现有的类型，了解它是如何实现的。

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

在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 %}

就这样：用很少的代码就创建了一个自定义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}),
)

贡献

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

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