Installing packages

We’ll assume you have a django CMS (version 3.x) project up and running.

If you need to set up a new django CMS project, follow the instructions in the django CMS tutorial.

Then run either:

pip install aldryn-events

or to install from the latest source tree:

pip install -e git+


In your project’s make sure you have all of:


listed in INSTALLED_APPS, after 'cms'.

Aldryn Boilerplates

This application uses (and will install) Aldryn Boilerplates, which requires some basic configuration to get you started.


If you are using Django 1.8 please note the configuration instructions for Aldryn Boilerplates.

Edit your settings so that they conform to:


    # important - place immediately before AppDirectoriesFinder

    # important! place right before django.template.loaders.app_directories.Loader

Now set the name of the boilerplate you’ll use in your project:



Note that Aldryn Events doesn’t use the the traditional Django /templates and /static directories. Instead, it employs Aldryn Boilerplates, which makes it possible to to support multiple different frontend schemes (‘Boilerplates’)and switch between them without the need for project-by-project file overwriting.

Aldryn Events’s templates and static files will be found in named directories in the /boilerplates directory.


Aldryn Events also depends on Filer, be sure to follow Filer’s installation instructions. To get up and running quickly, make sure you adapt your settings to include the filer.thumbnail_processors.scale_and_crop_with_subject_location thumbnail processor:

    # 'easy_thumbnails.processors.scale_and_crop',

Prepare the database and run

Now run python migrate to prepare the database for the new application, then python runserver.

For Aldryn users

On the Aldryn platform, the Addon is available from the Marketplace.

You can also install Aldryn Events into any existing Aldryn project.