Integrating a third-party applicationΒΆ

We’ve already written our own django CMS plugins and apps, but now we want to extend our CMS with a third party app, Aldryn blog.

First, we need to install the app into our virtual environment from PyPI:

pip install aldryn-blog

Add the app and any of its requirements that are not there already to INSTALLED_APPS in settings.py. Some will be already present; it’s up to you to check them:

'aldryn_blog',
'aldryn_common',
'django_select2',
'djangocms_text_ckeditor',
'easy_thumbnails',
'filer',
'taggit',
'hvad',

One of the dependencies is easy_thumbnails. It has already switched to Django-1.7-style migrations and needs some extra configuration to work with South. In settings.py:

SOUTH_MIGRATION_MODULES = {
    'easy_thumbnails': 'easy_thumbnails.south_migrations',
}

Configure the image thumbnail processors in settings.py:

THUMBNAIL_PROCESSORS = (
    'easy_thumbnails.processors.colorspace',
    'easy_thumbnails.processors.autocrop',
    #'easy_thumbnails.processors.scale_and_crop',
    'filer.thumbnail_processors.scale_and_crop_with_subject_location',
    'easy_thumbnails.processors.filters',
)

Since we added a new app, we need to update our database:

python manage.py migrate

Start the server again.

The weblog application comes with a django CMS apphook, so add a new django CMS page, and add the weblog application to it as you did for Polls in the previous tutorial. You may need to restart your server at this point.

Publish the new page, and you should find the weblog application at work there.

You can add new weblog posts using the admin, but also have a look at the toolbar. You can now select “Blog” > “Add Blog Post...” from it and add a new blog post directly from there.

Try also inserting a “Latest blog entries” plugin into another page - as a good django CMS application, Aldryn Blog comes with plugins.

In the next tutorial, we’re going to integrate our Polls app into the toolbar in, just like the weblog application has been.

Previous topic

Apphooks

Next topic

Extending the Toolbar

This Page