DjangoCMS手动安装

djangoCMS手动安装课程

前言
Django CMS是目前最活跃的django内容系统，在社区里有非常高的活跃度

Django有一个自动安装方法django CMS installer，但是一直碰到问题，所有的时候会采用手动的方式。

本文会一步一步按照手动方式，完成Django-CMS的安装。

安装django CMS包
首先检查django-CMS的匹配版本 http://docs.django-cms.org/en/release-3.4.x/index.html#requirements

本文最终安装信息

asn1crypto==0.24.0
certifi==2018.1.18
cffi==1.11.5
chardet==3.0.4
cryptography==2.1.4
dj-database-url==0.5.0
Django==1.9.13
django-classy-tags==0.8.0
django-cms==3.5.0
django-filer==1.3.0
django-formtools==2.1
django-mptt==0.8.7
django-polymorphic==1.3
django-sekizai==0.10.0
django-treebeard==4.2.0
djangocms-admin-style==1.2.7
djangocms-attributes-field==0.3.0
djangocms-column==1.7.0
djangocms-file==2.0.2
djangocms-googlemap==1.1.1
djangocms-installer==1.0.0
djangocms-link==2.1.2
djangocms-picture==2.0.6
djangocms-snippet==2.0.0
djangocms-style==2.0.2
djangocms-text-ckeditor==3.5.3
djangocms-video==2.0.4
easy-thumbnails==2.4.2
enum34==1.1.6
html5lib==0.9999999
idna==2.6
ipaddress==1.0.19
ndg-httpsclient==0.4.4
Pillow==5.0.0
pyasn1==0.4.2
pycparser==2.18
pyOpenSSL==17.5.0
pytz==2018.3
requests==2.18.4
six==1.11.0
tzlocal==1.5.1
Unidecode==0.4.21
我刚开始安装的是django 1.11版本，但是中间插件django-column安装时因为支持版本原因，自动退回到了django 1.9, 但基本不影响使用。 要注意的地方是MIDDLEWARE这个设置，django 10里改成了MIDDLEWARE_CLASS, 如果退回去了，也要做相应的修改。

Django-CMS还有其他的依赖库，这些都在它的setup.py文件里列出来了。
上面是我pip freeze出来的安装库，有些只是依赖库

执行下面命令安装django CMS

pip install django-cms 它会安装最新的稳定版本

同时会安装对应的基本依赖库

Django==1.11.10
django-classy-tags==0.8.0
django-cms==3.5.0
django-formtools==2.1
django-sekizai==0.10.0
django-treebeard==4.2.0
djangocms-admin-style==1.2.7
pytz==2018.3

创建新项目
django-admin.py startproject csblog

csblog是本文的演示项目名

最小需求应用和设置
打开setting.py，分别针对下面几部分进行设置

INSTALLED_APPS
将下面应用添加到INSTALLED_APPS

'django.contrib.sites',
'cms',
'menus',
'treebeard',

Django CMS需要用到django的django.contrib.sites框架，你需要在setting文件设置SITE_ID ，SITE_ID = 1 就行了。
cms 和menus 是django CMS的核心模块
django-treebeard用于管理django CMS页面和插件的树结构
django CMS默认安装 django CMS admin style。它的很多styling特性能够让admin模块更好的工作。这是一个可选模块，但是强烈推荐你去使用它。

如果选择admin style，将下面应用添加到INSTALLED_APPS，放在django.contrib.admin之前

'djangocms_admin_style',

语言设置
Django CMS需要设置 LANGUAGES ，列出所有你想支持的语言，并且必须把它放在LANGUAGE_CODE.

LANGUAGES = [
    ('en', 'English'),
    ('zh-hans', 'Chinese'),
]
为了简单起见，现在就可以将默认的en-us改到en

数据库
Django CMS要求关系数据库后端，每个安装的django CMS都必须有自己的数据库。

你可以使用SQLite，它包含在python里，并不需要单独安装或特别配置。它不大可能会用于产品，但是开发的理想选择，而且它还是django的默认DATABASES配置。

真正部署时，推荐使用 PostgreSQL 或 MySQL，不在本文介绍。

不管使用哪种技术，它都需要安装对应的python适配模块

pip install psycopg2 # for Postgres
pip install mysqlclient # for MySQL

mysql实际安装时往往都会报错，具体安装方法参考我的mysql安装文章。

数据表
运行migrate为新项目创建数据表

python manage.py migrate

Admin用户
创建一个admin超级用户

python manage.py createsuperuser

使用cms check进行配置
一旦你完成以上描述的最小需求的安装，接下来你可以用django-CMS自带的cms check 命令去帮助你识别和安装其他的模块。

python manage.py cms check 它会检查你的配置、应用和数据库，然后报告问题。

注意：如果关键模块缺失，django CMS就不能执行该命令，只是简单抛出错误。

接下来，首先完成以下步骤，然后用cms check 去验证它的检查列表里的各项是否已完成。

Sekizai
Django Sekizai用于django CMS的静态文件管理，你需要在INSTALLED_APPS添加

'sekizai'
并且，在TEMPLATES['OPTIONS']['context_processors']:添加

TEMPLATES = [
    {
        ...
        'OPTIONS': {
            'context_processors': [
                ...
                'sekizai.context_processors.sekizai',
            ],
        },
    },
]
中间件Middleware
在 MIDDLEWARE_CLASSES 添加 django.middleware.locale.LocaleMiddleware ，默认不是安装的。

同时，添加

'cms.middleware.user.CurrentUserMiddleware',
'cms.middleware.page.CurrentPageMiddleware',
'cms.middleware.toolbar.ToolbarMiddleware',
'cms.middleware.language.LanguageCookieMiddleware',
你也可以安装'cms.middleware.utils.ApphookReloadMiddleware'。它不是必须的，但是很有用，如果要添加的话，放在列表最前面。

上下文处理器 context processors
将 'cms.context_processors.cms_settings' 添加到TEMPLATES['OPTIONS']['context_processors']，

虽然还需要进一步安装一些配置，但是这个时候cms check已经能够帮助你进行相应的检查工作了。

进一步配置
URLS
在项目的urls.py，添加cms.url到urlpatterns列表。他需要放在其他的pattern之后，这样其他应用的URL能够首先被检测到。

同时，你需要导入django.conf.urls.include，例如

from django.conf.urls import url, include

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^', include('cms.urls')),
]
至此，django项目已经可以运行了。可以执行python manage.py runserver启动项目。通过 http://localhost:8000/访问项目，或者http://localhost:8000/admin/访问admin。

模板 Templates
Django CMS需要至少一个模板用于页面显示，CMS_TEMPLATES的第一个模板将被用于项目的默认模板

CMS_TEMPLATES = [
    ('home.html', 'Home page template'),
]
在项目根目录，创建templates目录及home.html，编写一个最小的django CMS模板。

{% load cms_tags sekizai_tags %}
<html>
    <head>
        <title>{% page_attribute "page_title" %}</title>
        {% render_block "css" %}
    </head>
    <body>
        {% cms_toolbar %}
        {% placeholder "content" %}
        {% render_block "js" %}
    </body>
</html>
这儿有必要将这个模板介绍一下：

{% load cms_tags sekizai_tags %}加载模板库。
{% page_attribute "page_title" %} 提取页面的 page_title 属性。
{% render_block "css" %}和{% render_block "js" %} 是Sekizai的template tags，用于加载block。Django CMS为css和js定义了block，需要包含他们两个。建议把{% render_block "css" %}放在</head>前面，{% render_block "js" %}放在</body>前面。
{% cms_toolbar %} 渲染cms工具栏
{% placeholder "content" %} 定义了一个placehoder用于安置plugin插件。一个模板只是需要一个placeholder。这个例子的名字只是为了一个简化的显示。
Django需要知道从哪儿去找到它的模板，所以需要将templates添加到setting的模板目录TEMPLATES['DIRS']

TEMPLATES = [
    {
        ...
        'DIRS': ['templates'],
        ...
    },
]
Media媒体和static静态文件处理
Djang CMS站点需要处理

static file 静态文件，这些是一个项目的核心部分，包括css，js和image
media fiels 媒体文件，是用户或者应用的上传文件
这两个配置文件都需要配置一下，跟普通项目一样，所以这儿不做过多描述。

MEDIA_URL = "/media/"
MEDIA_ROOT = os.path.join(BASE_DIR, "media")
如果对项目进行部署，需要配置合适的media文件处理。在urls.py添加下面内容（仅用于产品部署目的）

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
添加内容处理功能
到目前为止，已经完成了django CMS站点的基本设置，可以正常的管理和服务网页。但是，到目前为止还没有安装任何的插件，这就意味着你什么内容也不能添加，因为django的所有内容都是通过插件操作的。所以，现在我们需要安装一些额外的应用插件来提供相应的功能。

Django filer
Django Filer 提供文件和图片处理功能，许多其他的应用都是依赖它的。

安装：

pip install django-filer

一些其他的app会作为依赖被安装。

Easy Thumbnails用于创建不同大小的新版本图片；
Django MPTT用于管理filer文件夹的树形结构。
Pillow这个python图形库也会被安装，它需要一些系统级的库，Pillow documentation描述了在各种操作系统下怎样安装运行。
django-filer==1.3.0
django-mptt==0.8.7
django-polymorphic==1.3
easy-thumbnails==2.4.2
Pillow==5.0.0
Unidecode==0.4.21

在INSTALLED_APPS添加

'filer',
'easy_thumbnails',
'mptt',
同时，你也要添加

THUMBNAIL_HIGH_RESOLUTION = True

THUMBNAIL_PROCESSORS = (
    'easy_thumbnails.processors.colorspace',
    'easy_thumbnails.processors.autocrop',
    'filer.thumbnail_processors.scale_and_crop_with_subject_location',
    'easy_thumbnails.processors.filters'
)
需要给Filer和Easy Thumbnail创建新的数据表，运行migrate

python manage.py migrate filer

python manage.py migrate easy_thumbnails

Django CMS CKEditor
Django CMS CKEditor 是django CMS默认的编辑器

安装：

pip install djangocms-text-ckeditor

djangocms-text-ckeditor==3.5.3
html5lib==0.9999999
six==1.11.0
将djangocms_text_ckeditor 添加到INSTALLED_APPS

各种插件
Django CMS有很多功能强大的插件，他们对django CMS处理内容管理非常有帮助。

djangocms-link
djangocms-file
djangocms-picture
djangocms-video
djangocms-googlemap
djangocms-snippet
djangocms-style
djangocms-column
安装：

pip install djangocms-link djangocms-file djangocms-picture djangocms-video djangocms-googlemap djangocms-snippet djangocms-style djangocms-column

pip结果

djangocms-link==2.1.2
djangocms-attributes-field==0.3.0
djangocms-link==2.1.2
djangocms-file==2.0.2
djangocms-picture==2.0.6
djangocms-video==2.0.4
djangocms-snippet==2.0.0
djangocms-column==1.7.0
djangocms-style==2.0.2
djangocms-googlemap==1.1.1
djangocms-column版本需求是>= 1.8 & < 1.10，所以它会卸载默认的django 1.11.10，安装djagno 1.9将以上应用添加到 INSTALLED_APPS：

'djangocms_link',
'djangocms_file',
'djangocms_picture',
'djangocms_video',
'djangocms_googlemap',
'djangocms_snippet',
'djangocms_style',
'djangocms_column',
运行migrate

启动项目
python manage.py runserver

参考文档
http://docs.django-cms.org/en/release-3.4.x/how_to/install.html