Django CMS basics, installation and some advanced topics

1. Django CMS
Pim Van Heuven
Think Wize (@twPim_)

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

3. 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

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

5. Django CMS

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

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

8. Website

9. CMS toolbar

10. Content mode
double click!

11. Content mode

12. Structure mode

13. Structure mode

14. Admin

15. Wizards

17. Django CMS
installer

18. installer

19. 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

20. 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

21. Database configuration
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

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

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

24. Reversion
• undo / redo changes
• views history

25. View history…

26. 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

28. Pages

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

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

31. CMS permissions

32. page global
permissions

33. Page permissions

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

35. Bootstrap

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

37. template

38. Structure mode

39. Placeholders
• placeholder
• static placeholder

40. Placeholders
• cms_template
• placeholders
• plugins

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

42. no bootstrap

43. 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')
)

44. 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 %}

45. 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

46. Plugins

47. Plugins
• Must have
• djangocms-admin-style
• djangocms-text-ckeditor
• easy_thumbnails
• django-filer

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

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

51. Advanced
topics

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

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

54. 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)

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

56. 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 %}

58. 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