django-cms 5.1.0

Lean enterprise content management powered by Django.

Lean, open-source enterprise content management powered by Django. Backed by the non-profit django CMS Association (Sponsor us).

This repository contains the core package published as django-cms on PyPI.

Start here

• Read the docs: Documentation (stable)

• Installing / learning: Installation · Docker quickstart · Tutorials

• Upgrading: Release notes / Upgrade guide

• Get help: Discord or Stackoverflow

• Contribute safely: Contributing · Code of Conduct · Security

• Project info: Website · Changelog

Features

Build complex publishing workflows with simple, composable parts:

• robust internationalisation (i18n) and multi-site support

• front-end (inline) editing so editors can work directly on rendered pages

• a flexible placeholder and plugin system for reusable content components

• integration with multiple rich-text editors

• content versioning, editorial workflows, and headless setups via official add-on packages

• a hierarchical page tree with SEO-friendly URLs

• extensible navigation and application integration (apphooks)

Developing applications that integrate with and take advantage of django CMS features is easy and well-documented. More information on our website.

Test django CMS in our demo

The demo platform is kindly provided by Divio, platinum member of the django CMS Association.

Want to get a feel for the editing experience before you install anything? Start with the demo link above.

Installation & Quickstart

Create a fully configured django CMS project with a single command:

python -m pip install django-cms
djangocms mysite --interactive
cd mysite
python -m manage runserver

The djangocms command clones the official project template, installs the requirements, runs the migrations and creates a superuser for you. Run it without arguments to be guided through the available options (such as the headless mode) interactively.

Already have a Django project? Run djangocms . in its root directory to add django CMS to it.

Next, follow the official installation guide and tutorials: Installation

Using Docker? Check out our django-cms-quickstart project.

Documentation

Find tutorials, how-to guides, explanation, and reference material here:

• Current stable version (current release)

• Latest development version (main branch)

• Sources in this repo: docs/

Branch policy details: Development policies.

Development

If you want to contribute code, start here (you’ll be productive quickly):

• CONTRIBUTING.rst (workflow, PR process)

• Contributing docs

Getting Help

Need help choosing an approach, debugging an issue, or reviewing an implementation idea? Head over to our Discord Server or Stackoverflow.

Professional support

Choose from a list of trusted tech partner of the django CMS Association to get your website project delivered successfully.

Choose a trusted web host for your django CMS project and get your website online today.

The django CMS Association

The django CMS Association is a non-profit founded in 2020 to drive the success of django CMS by providing guidance, infrastructure and funding for core development and community projects.

If your business depends on django CMS, consider supporting its long-term health: Join forces with the django CMS Association or become a paying member.

Credits

• Includes icons and adapted icons from Bootstrap.

• Includes icons from FamFamFam.

• Python tree engine powered by django-treebeard.

• JavaScript tree in admin uses jsTree.

• Many thanks to all the contributors to django CMS!