Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP


[docs] upgrade guide from 2.4 to 3.0 #2814

merged 1 commit into from

3 participants


No description provided.

@Chive Chive self-assigned this
@Chive Chive removed their assignment
@digi604 digi604 was assigned by Chive

Coverage Status

Coverage remained the same when pulling cb99a64 on Chive:docs/upgrade into 536c6ae on divio:develop.

@digi604 digi604 merged commit 8e86151 into from
@Chive Chive deleted the branch
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on Mar 6, 2014
  1. @Chive
This page is out of date. Refresh to see the latest.
Showing with 53 additions and 0 deletions.
  1. +53 −0 docs/upgrade/3.0.rst
53 docs/upgrade/3.0.rst
@@ -13,6 +13,8 @@ What's new in 3.0
3.0 introduces some changes that **require** action if you are upgrading
from a previous version.
+.. note:: :ref:`Click here to see the quick upgrade guide <upgrading-from-2.4>`
New Frontend Editing
@@ -97,6 +99,8 @@ If you have ``django-reversion`` installed you now have **undo** and **redo**
options available directly in the toolbar. These can now revert *plugin*
content as well as *page* content.
+.. _ex-core-plugins:
Plugins removed
@@ -206,6 +210,7 @@ to keep your existing files from the old ``cms.plugins.snippet``!)
+.. _cmsplugin-twitter-removed:
Twitter Plugin
@@ -400,6 +405,54 @@ A new ``CMS_TEMPLATE`` variable is now available in the context: it contains the
current page template.
See :ref:`CMS_TEMPLATE reference <page_template>` for details.
+.. _upgrading-from-2.4:
+Upgrading from 2.4
+If you want to upgrade from version 2.4 to 3.0, there's a few things you need to do.
+Start of by updating the cms' package::
+ pip install django-cms==3.0
+Next, you need to make the following changes in your ````
+* settings.INSTALLED_APPS
+ * Remove ``cms.plugin.twitter``. This package has been deprecated, see :ref:`cmsplugin-twitter-removed`.
+ * Rename all the other ``cms.plugins.X`` to ``djangocms_X``, see :ref:`ex-core-plugins`.
+ * Replace ```` with ``cms.context_processors.cms_settings``
+Afterwards, install all your previously renamed ex-core plugins (djangocms-X). Here's a full list, but you probably
+don't need all of them::
+ pip install djangocms-file
+ pip install djangocms-flash
+ pip install djangocms-googlemap
+ pip install djangocms-inherit
+ pip install djangocms-picture
+ pip install djangocms-teaser
+ pip install djangocms-video
+ pip install djangocms-link
+ pip install djangocms-snippet
+Also, please check your templates to make sure that you haven't put the ``{% cms_toolbar %}`` tag into a ``{% block %}``
+tag. This is not allowed in 3.0 anymore.
+To finish up, please update your database::
+ python syncdb
+ python migrate (answer yes if your prompted to delete stale content types)
+That's it!
Pending deprecations
Something went wrong with that request. Please try again.