. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2 Getting started 7 2.1 Django at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . in general? Well, you came to the right place: read this material to quickly get up and running. 2.1 Django at a glance Because Django was developed in a fast-paced newsroom environment, it was designed 0) content = models.TextField() reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE) 2.1. Django at a glance 9 Django Documentation, Release 2.1.16.dev20191202082911 Listing 3: mysite/news/admin

Framework Third-party distributions of Django For distributors Glossary Release notes Final releases 2.1 release 2.0 release 1.11 release 1.10 release 1.9 release 1.8 release 1.7 release 1.6 release 1.5 release Release cadence Deprecation policy Supported versions Release process Django Deprecation Timeline 3.0 2.1 2.0 1.10 1.9 1.8 1.7 1.6 1.5 1.4 1.3 The Django source code repository High-level overview The master Then at the Python prompt, try to import Django: >>> import django >>> print(django.get_version()) 2.1 You may have another version of Django installed. That’s it! That’s it – you can now move onto the

version 2.1.5 Getting Started 1. Installation 1.1. Requirements 1.2. Databases 2. Introductory Tutorial 2.1. Configuration and setup 2.2. Creating templates 2.3. Creating your first CMS page! 2.4. Troubleshooting Middleware 1.2. Language Chooser 1.3. page_language_url 1.4. CMS_HIDE_UNTRANSLATED 2. Sitemap Guide 2.1. Sitemap 2.2. Configuration 2.3. Django.contrib.sitemaps 3. Templatetags 3.1. placeholder 3.2. show_placeholder CMS: Examples 1.1. My First Plugin 1.2. My First App (apphook) 1.3. My First Menu 2. Custom Plugins 2.1. Writing a custom plugin 2.2. Plugin Context Processors 2.3. Plugin Processors modules | index next

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 2 Advanced 25 2.1 Internationalization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . which can not be used in non-cms placehold- ers. 24 Chapter 1. Getting Started CHAPTER 2 Advanced 2.1 Internationalization 2.1.1 Multilingual URL Middleware The multilingual URL middleware adds a language

release notes 2.3.3 release notes 2.3.2 release notes 2.3 release notes 2.2 release notes Upgrading from 2.1.x and Django 1.2.x Getting Started 1. Introductory Tutorial 1.1. Getting help 1.2. Configuration and and setup 1.3. Creating templates 1.4. Creating your first CMS Page! 2. Using South with django CMS 2.1. Installation 2.2. Basic usage 2.3. More information about South 3. Configuration 3.1. Required Settings page_language_url 1.5. hide_unstranslated 1.6. Automated slug generation unicode characters 2. Sitemap Guide 2.1. Sitemap 2.2. Configuration 2.3. django.contrib.sitemaps 3. Template Tags 3.1. CMS templatetags 3

dropped in 2.2 in favor of the built-in mechanisms to achieve multi- linguality. 1.9 Upgrading from 2.1.x and Django 1.2.x 1.9.1 Upgrading dependencies Upgrade both your version of django CMS and Django Please make sure the static subfolder exists in your project and is writable. 1.9. Upgrading from 2.1.x and Django 1.2.x 9 django cms Documentation, Release 2.3.8 Note: PROJECT_PATH is the absolute path manage.py collectstatic 1.9. Upgrading from 2.1.x and Django 1.2.x 11 django cms Documentation, Release 2.3.8 12 Chapter 1. Install CHAPTER 2 Getting Started 2.1 Introductory Tutorial This guide assumes

dropped in 2.2 in favor of the built-in mechanisms to achieve multi- linguality. 1.11 Upgrading from 2.1.x and Django 1.2.x 1.11.1 Upgrading dependencies Upgrade both your version of django CMS and Django the front-end editing. See Backwards incompatible changes for more information 1.11. Upgrading from 2.1.x and Django 1.2.x 17 django cms Documentation, Release 2.4.3-support Here is a simple example for your STATIC_ROOT: python manage.py collectstatic 18 Chapter 1. Install CHAPTER 2 Getting Started 2.1 Introductory Tutorial This guide assumes your machine meets the requirements outlined in the Installation

Started 1. Installation 1.1. Requirements 1.2. Databases 2. Upgrading a django CMS installation 2.1. 2.2 Release 3. Introductory Tutorial 3.1. Getting help 3.2. Configuration and setup 3.3. Creating Middleware 1.2. Language Chooser 1.3. page_language_url 1.4. CMS_HIDE_UNTRANSLATED 2. Sitemap Guide 2.1. Sitemap 2.2. Configuration 2.3. django.contrib.sitemaps 3. Template Tags 3.1. placeholder 3.2. show_placeholder | next | 1.1. My First Plugin 1.2. My First App (apphook) 1.3. My First Menu 2. Custom Plugins 2.1. Why would you need to write a plugin? 2.2. Overview 2.3. The simplest plugin 2.4. Storing configuration

Third-party distributions of Django For distributors Glossary Release notes Final releases 2.2 release 2.1 release 2.0 release 1.11 release 1.10 release 1.9 release 1.8 release 1.7 release 1.6 release 1.5 release cadence Deprecation policy Supported versions Release process Django Deprecation Timeline 3.1 3.0 2.1 2.0 1.10 1.9 1.8 1.7 1.6 1.5 1.4 1.3 The Django source code repository High-level overview The master version Python versions 1.11 2.7, 3.4, 3.5, 3.6, 3.7 (added in 1.11.17) 2.0 3.4, 3.5, 3.6, 3.7 2.1 3.5, 3.6, 3.7 Django version Python versions 2.2 3.5, 3.6, 3.7, 3.8 (added in 2.2.8), 3.9 (added

distributions of Django For distributors Glossary Release notes Final releases 3.0 release 2.2 release 2.1 release 2.0 release 1.11 release 1.10 release 1.9 release 1.8 release 1.7 release 1.6 release 1.5 release cadence Deprecation policy Supported versions Release process Django Deprecation Timeline 4.0 3.1 3.0 2.1 2.0 1.10 1.9 1.8 1.7 1.6 1.5 1.4 1.3 The Django source code repository High-level overview The master release incrementally (2.0 to 2.1 to 2.2) rather than to make all the changes for each feature release at once. For each feature release, use the latest patch release (e.g. for 2.1, use 2.1.15). The same incremental