feincms-bounds 0.1.0

=============================
feincms-bounds
=============================

.. image:: https://travis-ci.org/marcofucci/feincms-bounds.png?branch=master
:target: https://travis-ci.org/marcofucci/feincms-bounds


FeinCMS插件，增加了额外的管理页面验证

- 独特模板：只能使用一次的模板（例如主页）
- 仅一级模板：只能在导航的第一级中使用的模板（例如主页）
- 无子页模板：不能有子页的模板（例如主页）
- 导航级别：允许的最大导航级别


快速入门
----------

安装feincms-bounds：

pip install feincms-bounds


将feincms-bounds添加到您的`settings.INSTALLED_APPS`：

INSTALLED_APPS = (
...
'feincms_bounds',
...
)

在注册FeinCMS模板时，使用`feincms_bounds.models.Template`
并指定它是否是唯一的、仅一级或不能有子页。

在`models.py`中：

from feincms.module.page.models import Page

from feincms_bounds.models import Template


Page.register_templates(
Template(
key='internalpage',
title='内部页面',
path='pages/internal.html',
regions=(
('main', '主要内容'),
('sidebar', '侧边栏'),
)
), Template(
key='homepage',
title='主页',
path='pages/home_page.html',
regions=(
('main', '主要内容'),
),

# 由feincms-bounds引入的新参数
unique=True,
first_level_only=True,
no_children=True
)
)


最后，在注册页面时使用`feincms_bounds.admin.PageAdmin`
(您需要首先注销feinCMS默认的）。

在`admin.py`中：

from django.contrib import admin

from feincms.module.page.models import Page

from feincms_bounds.admin import PageAdmin


# 我们必须注销它，然后重新注册
admin.site.unregister(Page)
admin.site.register(Page, PageAdmin)


可选地，您可以使用`settings.FEINCMS_NAVIGATION_LEVEL`指定导航的最大级别。

完成！现在您可以利用feincms-bounds提供的额外admin Page验证功能了。
feincms-bounds。


示例
-------

* 样本项目：https://github.com/marcofucci/feincms_extended
* 原始博客：http://www.marcofucci.com/tumblelog/19/may/2010/customizing-feincms-part-1/




历史
-------

0.1.0 (2013-10-07)
++++++++++++++++++

* 版本 0.1.0