Introduction to Django CMS

Django CMS
Pim Van Heuven
Think Wize (@twPim_)

Why?
• New Think Wize website
• Request to build a website
• Another request to build a website
• And another one …
• Django experience

Building websites
• Realistic budget
• Increasing baseline demands:
• Responsive
• Components: text and images, carousel, contact
form, map, analytics, newsletter, blog…
• Ability to make small edits
• Build yourself not really effective for most

Contents
• Short introduction to Django CMS
• Making sense of the Django CMS installer
• Plugins

Stack
• Python + relational database + webserver
• Django
• Django admin
• Django CMS

• Content mode (front-end editing)
• Structure mode
• Admin
• Wizards

Django CMS installer
• https://github.com/nephila/djangocms-installer
• pip install djangocms-installer
• virtualenv projectenv
• source env/bin/activate
• mkdir project
• cd project
• djangocms -f -p . website

Versions
django CMS version (choices: 2.4, 3.0, 3.1, stable,develop)
[default stable]: stable
Django version (choices: 1.4, 1.5, 1.6, 1.7, 1.8, stable)
[default stable]: stable

Database conﬁguration 
URLs
Database configuration (in URL format) [default
sqlite://localhost/project.db]:
sqlite://localhost/project.db
postgres://user:password@host:port/name
mysql://user:passwordl@host:port/name

i18n / i10n
• i18n = internationalisation
• translations
• i10n = localisation
• date and number formats
Activate Django I18N / L10N setting (choices: yes, no) [default yes]: yes

Reversion
Install and configure reversion support (choices: yes, no)
default yes]: yes

Reversion
• undo / redo changes
• views history

Languages
Languages to enable. Option can be provided multiple times,
or as a comma separated list. Only language codes supported
by Django can be used
here: nl, en
Optional default time zone [default Europe/Brussels]:
Activate Django timezone support (choices: yes, no) [default
yes]: yes

• Usage: manage.py cms copy-lang <lang_from>
<lang_to>
• urlpatterns = i18n_patterns('', …

CMS permission
management
Activate CMS permission management (choices: yes, no)
[default yes]: no

Bootstrap theme
Use Twitter Bootstrap Theme (choices: yes, no) [default no]:
yes

templates & placeholders
• html pages:
• base.html
• feature.html
• menu.html
• page.html
CMS_TEMPLATES = (
## Customize this
('page.html', 'Page'),
('feature.html', 'Page with Feature')
)

Placeholders
• placeholder
• static placeholder

Placeholders
• cms_template
• placeholders
• plugins

page.html
{% extends "base.html" %}
{% load cms_tags %}
{% block title %}{% page_attribute "page_title" %}
{% endblock title %}
{% block content %}
{% placeholder "content" %}
{% endblock content %}

no bootstrap
• templates:
• base.html
• fullwidth.html
• sidebar_left.html
• sidebar_right.html
CMS_TEMPLATES = (
## Customize this
('fullwidth.html', 'Fullwidth'),
('sidebar_left.html', 'Sidebar Left'),
('sidebar_right.html', 'Sidebar Right')
)

sidebar_left.html
{% extends "base.html" %}
{% load cms_tags %}
{% block title %}{% page_attribute "page_title" %}{
% endblock title %}
{% block content %}
<div class="sidebar">
{% placeholder "sidebar" %}
</div>
<div class="content">
{% placeholder "content" %}
</div>
{% endblock content %}

Custom template
Use custom template set [default no]: no
(Use custom template set [default no]: ~/djangocms/
defaulttemplates/)
Load a starting page with examples after installation
(english language only). Choose "no" if you use a custom
template set. (choices: yes, no) [default no]: yes

Plugins
• Must have
• djangocms-admin-style
• djangocms-text-ckeditor
• easy_thumbnails
• django-ﬁler

Plugins
• Aldryn
• newsblog
• bootstrap3
• aldryn_people
• aldryn_events
• aldryn_mailchimp

Plugins
• taggit, taggit_autosuggest
• testimony
• cmsplugin_contact
• google_analytics
• image_gallery

apps.py
class CmspluginFilerImageConfig(AppConfig):
name = 'cmsplugin_filer_image'
verbose_name = "Image sizes"
class FilerConfig(AppConfig):
name = 'filer'
verbose_name = "Files and images"

aldryn_search
• solr
• haystack
• manage.py build_solr_schema
• manage.py rebuild_index
• django cms apphook

cms_wizards.py
newsblog_article_wizard = NewsBlogArticleWizard(
title=_(u"New news/blog article"),
weight=200,
form=CreateNewsBlogArticleForm,
description=_(u"Create a new news/blog article.")
)
wizard_pool.register(newsblog_article_wizard)

templatetag
from django import template
register = template.Library()
@register.filter
def specialplugin(field):
if field in ['TextPlugin', 'FilerImagePlugin',
'LinkPlugin']:
return True
else:
return False

templatetag
templates/cms/toolbar/dragitem_menu.html
{% for module in module_list %}
{% for p in module.list %}
{% if p.value|specialplugin %}
<div class="cms-submenu-item">
<a style="background:#dff0d8" data-rel="add"
href="{{ p.value }}">{{ p.name }}</a>
</div>
{% endif %}
{% endfor %}
{% endfor %}

Conclusion
• Django CMS: The open-source CMS used by
thousands of websites since 2007
• Effective way to build websites whether you
need the "content management" part or not
• Values technical quality and usability
• Recommended

Introduction to Django CMS

More Related Content

What's hot (20)

Similar to Introduction to Django CMS (20)

Recently uploaded (20)

Introduction to Django CMS