django CMS Installer

Join the Gitter chat Latest PyPI version Python versions Latest Travis CI build status Test coverage Code Climate License

Command to easily bootstrap django CMS projects

  • Free software: BSD license

Features

djangocms-installer is a console wizard to help bootstrapping a django CMS project.

Refer to django CMS Tutorial on how to properly setup your first django CMS project.

Warning

For all 1.2 RC django CMS 3.7 rc will be installed by default, not latest stable, to ensure a smoother transition. Likewise “3.7”, “stable” and “lts” selector will install django CMS 3.7rc1

Warning

Version 1.2 dropped support for Python 3.4, django CMS < 3.6 and Django < 1.11. More 1.1.x versions may be released after 1.2 is out in case important bugfixes will be needed.

Warning

Due to some incompatibilities between psycopg2 2.8 and Django 2.1+ we ship with psycopg2 2.7 when PostgreSQL database is selected, this in turn trigger an outdated psycopg2 warning. To silence it, add the following to your manage.py:

import os
import sys
import warnings

if __name__ == '__main__':
    warnings.filterwarnings(
        'ignore', r'The psycopg2.*release 2\.8', UserWarning, 'psycopg2')
    # ... rest of code ...

Usage

To create your first django CMS project run:

djangocms my_project

That’s all!

This command will:

  • Create a Django project
  • Install django CMS and its core plugins
  • Create and populate the database
  • Install default templates

Just run manage.py runserver, go to http://localhost:8000 , login with user admin (same password) and enjoy your first django CMS project.

More at django CMS Tutorial and installer usage page

Documentation

For detailed information see https://djangocms-installer.readthedocs.io

Preliminary checks and system libraries

While this wizard try to handle most of the things for you, it doesn’t check for all the proper native (non python) libraries to be installed. Before running this, please check you have the proper header and libraries installed and available for packages to be installed.

Libraries you would want to check:

  • libjpeg (for JPEG support in Pillow)
  • zlib (for PNG support in Pillow)
  • postgresql (for psycopg2)
  • libmysqlclient (for Mysql)
  • python-dev (for compilation and linking)

For additional information, check https://djangocms-installer.readthedocs.io/en/latest/libraries.html

Supported versions

The current supported version matrix is the following:

  Django 1.11 Django 2.0 Django 2.1 Django 2.2 Django 3.0
django CMS 3.6 Supported Supported Supported Supported Supported
django CMS 3.7 Supported Supported Supported Supported Supported

See version 1.1 for older Django / django CMS versions support

Any beta and develop version of Django and django CMS, by its very nature, it’s not supported, while it still may work.

djangocms-installer tries to support beta versions of django CMS when they are be considered sufficiently stable by the upstream project.

Warning

djangocms-installer assumes that django-admin.py is installed in the same directory as python executable, which is the standard virtualenv layout. Other installation layouts might work, but are not officially supported.

Windows support

The installer is tested on Windows 7 with Python versions 3.4.2 and 2.7.8 installed using official MSI packages available at http://python.org.

Please check that the .py extension is associated correctly with Python interpreter:

c:\> assoc .py
.py=Python.File

c:\>ftype Python.File
Python.File="C:\Windows\py.exe" "%1" %*