Upgrading django CMS blog

djangocms-blog uses the ThumbnailOption model from cmsplugin-filer / django-filer.

ThumbnailOption model used to be in cmsplugin-filer up to version 1.0 included.

Since cmsplugin-filer 1.1 has been moved to django-filer (since version 1.2).

djangocms-blog introduced compatibility shims to support both combinations.

Since djangocms-blog 1.0 the compatibility has been dropped and django-filer 1.3 is required for djangocms-blog to work.

See below the migration path if you still use older versions of cmsplugin-filer / django-filer.

Upgrading djangocms-blog from 0.9.x to 1.0

No specific migration path is needed:

  • upgrade djangocms-blog to 1.0: pip install djangocms-blog>=1.0

  • remove cmsplugin_filer from INSTALLED_APPS

  • run migrations: python manage.py migrate

Upgrading djangocms-blog from 0.8.x to 1.0

  • migrate to djangocms-blog 0.8.12 following instructions below

  • upgrade djangocms-blog to 1.0: pip install djangocms-blog>=1.0

  • remove cmsplugin_filer from INSTALLED_APPS

  • run migrations: python manage.py migrate

Upgrading cmsplugin-filer from 1.0 to 1.1

Due to changes in cmsplugin-filer / django-filer which moved ThumbnailOption model from the former to the latter, djangocms-blog must be migrated as well.

Migrating cmsplugin-filer to 1.1 and djangocms-blog up to 0.8.4

If you have djangocms-blog up to 0.8.4 (included) installed or you are upgrading from a previous djangocms-blog version together with cmsplugin-filer upgrade, you can apply the migrations:

pip install cmsplugin-filer==1.1.3 django-filer==1.2.7 djangocms-blog==0.8.4
python manage.py migrate

Migrating cmsplugin-filer to 1.1 and djangocms-blog 0.8.5+

If you already a djangocms-blog 0.8.5+ up to 0.8.11, upgrade to 0.8.11, then you have to de-apply some blog migrations when doing the upgrade:

pip install djangocms-blog==0.8.11
python manage.py migrate djangocms_blog 0017 ## reverse for these migration is a noop
pip install cmsplugin-filer==1.1.3 django-filer==1.2.7
python manage.py migrate

After this step you can upgrade to 0.8.12:

pip install djangocms-blog==0.8.12

Note

de-apply migration before upgrading cmsplugin-filer. If running before upgrade, the backward migration won’t alter anything on the database, and it will allow the code to migrate ThumbnailOption from cmsplugin-filer to filer

Note

If you upgrade in a Django 1.10 environment, be sure to upgrade both packages at the same time to allow correct migration dependencies to be evaluated.