django CMS 入门教程

这份手册假设你的机器已经达到本文档的要求。

1.1 获取帮助

当你遇到问题而且不能独自解决的时候，你能够从邮件列表中得到帮助或者在irc.freenode.net网络的IRC频道#django-cms得到帮助。

1.2 配置和安装

1.2.1 准备环境

收集须要的配置是一个好的开始，可是咱们如今用一个实际的Django CMS项目而且配置它。

1.2.1.1 启动你的Django项目

下面假设你的项目在~/workspace/myproject/。

用下面的代码启动你的Django项目：

1	cd~/workspace

2	django-admin.py startproject myproject

3	cdmyproject

4	python manage.py runserver

在你的浏览器中打开127.0.0.1:8000，你能够看到一个来自Django的“It Worked”的消息。

1.2.1.2 在你的Django项目中安装和配置Django CMS

打开文件：~/workspace/myproject/settings.py。为了让生活更容易，把下面几行增长到文件的顶部：

1	# -*- coding: utf-8 -*-

2

importos

3	gettext = lambda s: s

4	PROJECT_PATH = os.path.abspath(os.path.dirname(__file__))

把下面的应用程序增长到你的INSTALLED_APPS，它包含了Django CMS自己，同时也包含了它的依赖和其它建议的应用程序/库：

    'cms'，Django CMS自己；

    'mptt'，实现修正预排序遍历树的实用工具；

    'menus'，模型独立层次的网站导航助手；

    'south'，智能架构和数据迁移；

    'sekizai'，管理javascript和css。

同时，根据你的须要增长下面的插件：

• 'cms.plugins.file'
• 'cms.plugins.flash'
• 'cms.plugins.googlemap'
• 'cms.plugins.link'
• 'cms.plugins.picture'
• 'cms.plugins.snippet'
• 'cms.plugins.teaser'
• 'cms.plugins.text'
• 'cms.plugins.video'
• 'cms.plugins.twitter'

（警告：增长'cms.plugins.snippet'插件有潜在的安全隐患，更多信息请参考Snippet文档。）

这个在插件参考中有详细的描述。在Django CMS的扩展页面有许多可用的插件。除此以外，肯定你取消'django.contrib.admin'的注释。

你可能但愿用django-filter和它带有django CMS插件的部分而不是cms.plugins.file,cms.plugins.picture, cms.plugins.teaser和cms.plugins.video核心插件。在这种状况下，你不须要把他们增长到 INSTALLED_APPS，而是增长下面的：

• 'filer'
• 'cmsplugin_filer_file'
• 'cmsplugin_filer_folder'
• 'cmsplugin_filer_image'
• 'cmsplugin_filer_teaser'
• 'cmsplugin_filer_video'

若是你选择核心插件，你应该关注CMS_PAGE_MEDIA_PATH设置点指向的目录（默认状况下MEDIA_ROOT和 cms_page_media/相关），在Django运行时用户对它能够写入的。若是你选择django-filter，它的配置有一个类似的要求。

若是你想版本化你的内容，你也须要安装django-reversion并把它增长到INSTALLED_APPS：

'reversion'

你须要在合适的地方把django CMS中间层增长到你的MIDDLEWARE_CLASSES：

01	MIDDLEWARE_CLASSES=(

02	'django.middleware.common.CommonMiddleware',

03	'django.contrib.sessions.middleware.SessionMiddleware',

04	'django.middleware.csrf.CsrfViewMiddleware',

05	'django.contrib.auth.middleware.AuthenticationMiddleware',

06	'django.contrib.messages.middleware.MessageMiddleware',

07	'cms.middleware.multilingual.MultilingualURLMiddleware',

08	'cms.middleware.page.CurrentPageMiddleware',

09	'cms.middleware.user.CurrentUserMiddleware',

10	'cms.middleware.toolbar.ToolbarMiddleware',

11

)

在TEMPLATE_CONTEXT_PROCESSORS中你至少要增长下面的东西：

1	TEMPLATE_CONTEXT_PROCESSORS=(

2	'django.contrib.auth.context_processors.auth',

3	'django.core.context_processors.i18n',

4	'django.core.context_processors.request',

5	'django.core.context_processors.media',

6	'django.core.context_processors.static',

7	'cms.context_processors.media',

8	'sekizai.context_processors.sekizai',

9

)

（注意：这个文件在Django设置文件自动生成时会丢失，所以你须要增长它。）

把STATIC_ROOT指向静态文件存在的地方（也就是说，你的图像，CSS文件，Javascript文件，等等）：

1	STATIC_ROOT=os.path.join(PROJECT_PATH,"static")

2	STATIC_URL="/static/"

对于上传的文件，你须要设置MEDIA_ROOT设置：

1	MEDIA_ROOT=os.path.join(PROJECT_PATH,"media")

2	MEDIA_URL="/media/"

（注意：请确保static和media子文件夹存在而且是可写的。）

如今在文件的TEMPLATE_DIRS部分增长一点东西：

1	TEMPLATE_DIRS=(

2	# The docs say it should be absolute path: PROJECT_PATH is precisely one.

3	# Life is wonderful!

4	os.path.join(PROJECT_PATH,"templates"),

5

)

在CMS_TEMPLATES中至少增长一个模板，好比说：

1	CMS_TEMPLATES=(

2	('template_1.html','Template One'),

3	('template_2.html','Template Two'),

4

)

咱们在以后的步骤中会建立一个实际的模板，所以如今不用担忧它。只要把它黏贴到你的设置文件。

（注意：你定义的CMS_TEMPLATES模板在运行时必须存在，而且至少有一个在django CMS有用的{% placeholder <name> %} 模板标签。）

django CMS容许你用Django内建的翻译编辑全部的语言。因为这些是可数的，咱们目前限制为英语：

1	LANGUAGES=[

2	('en','English'),

3

]

最后，设置文件的DATABASES部分，让它反应你的数据库布置。若是你只想在本地尝试一下，sqlite3是最容易创建的数据库，可是在实际项目中不该该使用。若是你如今但愿用sqlite3，下面是你的DATABASES设置应该看起来的样子：

1	DATABASES={

2	'default': {

3	'ENGINE':'django.db.backends.sqlite3',

4	'NAME': os.path.join(PROJECT_PATH,'database.sqlite'),

5

}

6

}

1.2.2 URL配置

你须要在你的urlpatterns的结束的地方包含'cms.urls'的urlpatterns。咱们建议用下面的urls.py：

01	fromdjango.conf.urls.defaultsimport*

02	fromdjango.contribimportadmin

03	fromdjango.confimportsettings

04

05	admin.autodiscover()

06

07	urlpatterns=patterns('',

08	(r'^admin/', include(admin.site.urls)),

09	url(r'^', include('cms.urls')),

10

)

11

12	ifsettings.DEBUG:

13	urlpatterns=patterns('',

14	url(r'^media/(?P<path>.*)$','django.views.static.serve',

15	{'document_root': settings.MEDIA_ROOT,'show_indexes':True}),

16	url(r'', include('django.contrib.staticfiles.urls')),

17	)+urlpatterns

1.3 建立模板

django CMS用模板来定义页面的外观和哪一部分是可编辑的。可编辑的地方被称为placeholders。这些模板是标准的Django模板，你能够像官方文档中描述的那样使用它们。

你但愿在你的页面使用的模板必定要在CMS_TEMPLATES设置中声明：

1	CMS_TEMPLATES=(

2	('template_1.html','Template One'),

3	('template_2.html','Template Two'),

4

)

若是你从开头遵循这个教程，这个代码已经在你的设置文件中。

如今，来个实际带有实际模板的文件。

打开你最喜欢的编辑器而后在你项目目录templates下建立一个叫base.html的文件。

下面是最简单的一个基本模板叫作base.html的例子：

01	{%load cms_tags sekizai_tags%}

02

<html>

03

<head>

04	{%render_block"css"%}

05

</head>

06

<body>

07	{%cms_toolbar%}

08	{%placeholder base_content%}

09	{%block base_content%}{%endblock%}

10	{%render_block"js"%}

11

</body>

12

</html>

如今，在一样目录下建立一个叫template_1.html的文件。它调用基本模板，并往里面增长额外的内容：

1	{%extends"base.html"%}

2	{%load cms_tags%}

3

4	{%block base_content%}

5	{%placeholder template_1_content%}

6	{%endblock%}

当你在页面上把template_1.html设置为一个模板时，你须要插入两个占位符。一个是在template_1.html页面的template_1_content，另外一个是在增长的base.html的base_content。

当实际中有许多占位符时，确保给占位符一个能够识别的名字，这样你就能够在管理页面更容易使他们。

如今，探索并增长一个template_2.html文件！若是你以为没有创造性，只要template_1，而后重命名第二个占位符就像“template_2_content”。

1.3.1 用sekizai处理静态文件

django CMS用django-sekizai处理CMS插件须要的媒体文件（css和javas文件）。这要求在你的模板中至少定义两个sekezai命名空 间：js和css。你能够在sekizai_tags模板标签中用render_block模板标签来这样作。咱们强烈建议 在</head>HTML标签结束以前放置{% render_block "css" %}标签，在</body>HTML标签结束以前放置{% render_block "js" %}标签。

1.3.2 初始化数据库

这个命令取决于你是升级你的安装仍是从新安装。咱们建议你熟悉South是如何工做的，由于它是一个颇有用，容易而且方便的工具。django CMS普遍的只用到它。

1.3.2.1 从新安装

运行：

1	python manage.py syncdb--all

2	python manage.py migrate--fake

第一个命令会提示你建立一个超级用户，选择‘yes’而后输入合适的值。

1.3.2.2 升级

运行：

1	python manage.py syncdb

2	python manage.py migrate

1.3.3 启动并运行！

就是它了。用python manage.py runserver重启你的开发服务器，在浏览器中输入127.0.0.1:8000，你应该能获得一个django CMS“It Worked”的页面。

进入管理面板<http://127.0.0.1:8000/admin/>，拥你在创建数据库的时候建立的用户登陆。

关于在实际网络服务器中布置你的django CMS项目，请参照Django文档。

1.4 建立你的第一个CMS页面！

就是他了。如今是最好的一部分：你能够用CMS开始了！用python manage.py runserver运行你的服务器，而后把浏览器指向127.0.0.1:8000/admin/，用你在syncdb以前定义的超级用户登陆。

当你在你页面的管理部分时，你应该看到像下面同样的东西：

1.4.1 增长一个页面

增长一个页面就像在管理视图中点击“Pages”同样简单，而后点击屏幕右上角“add page”按钮。

这里你选择你用哪一个模板（记住，咱们建立了2个），至关明显的东西也是同样的，就像页面使用什么语言的（用于国际化），页面的标题，它偷懒用的url。

点击“Save”按钮，不要惊讶，就会保存页面，如今显示一列页面。

恭喜你！你如今已经彻底安装了一个django CMS！

1.4.2 发布一个页面

下面是一系列能够为你的每一个页面更改的参数。

1.4.2.1 可视化

默认状况下，页面时“不可视的”，为了让你们可以看到他们，你应该把它标记为“发布的”。

1.4.2.2 菜单

另外一个选项就是让你调整一个页面是否该出如今你的站点的导航上（也就是说，是否应该有一个能够连接到这个页面的菜单）。

1.4.3 向一个页面增长内容

到目前为止，咱们的页面并无作太多的事。肯定它被标记为“发布的”，而后点击页面的“edit”按钮。

忽视到目前位置的大多数接口，点击屏幕右上角的“view on site”按钮。就像期待的同样，眼下你的页面是空的，由于咱们的模板是真正是最小的一个。

让咱们进入它吧！

点击你浏览器的后退按钮来看看页面的管理接口。若是到目前为止你是遵循教程的话，你的模板（template_1.html）定义了两个占位符。管理接口把这些占位符当成子菜单：

向下滚动“可用插件”的下拉列表。他显示你增长到INSTALLED_APPS设置的插件。选择在下拉列表中总选择“text”插件，而后点击增长。

插件合适的地方显示一个丰富的文本编辑器。

在编辑器中，输入一些文本而后点击“Save”按钮。

用右上角的“View on site”按钮回到你的页面，就是它了！

1.4.4 从这该去哪

恭喜你，你如今有一个彻底功能的CMS！请熟悉插件列表中提供的不一样插件而后创建一个好的网站！