.. _upgrade-to-3.11.1:

######################
 release notes 3.11.1
######################

This release focuses on support for django 4 and dark mode.

********************
What's new in 3.11.1
********************

Features:
---------
* add Python 3.11 support for Django CMS (#7422) (3fe1449e6) -- Vinit Kumar
* Support for Django 4.1 (#7404) (777864af3) -- Fabian Braun
* Add support for tel: and mailto: URIs in Advanced Page Settings redirect field (#7370) (0fd058ed3) -- Mark Walker
* Improved dutch translations -- Stefan van den Eertwegh

Bug Fixes:
----------
* Prefer titles matching request language (#7144) (06c9a85df) -- Micah Denbraver
* Adds a deprecation warning for SEND_BROKEN_LINK_EMAILS (#7420) (d38f4a1cc) -- Fabian Braun
* Added deprecation warning to `get_current_language()` (#7410) (2788f75e6) -- Mark Walker
* CMS check management command fixed [#7412] (#7413) (dcf394bd5) -- ton77v
* Changing color scheme resets session settings to defaults (#7407) (fcfe77f63) -- Fabian Braun
* Clear page permission cache on page create (#6866) (e59c179dd) -- G3RB3N
* Unlocalize page and node ids when rendering the page tree in the admin (#7188) (9e3c57946) -- Marco Bonetti
* Allow partially overriding CMS_CACHE_DURATIONS (#7339) (162ff8dd8) -- Qijia Liu
* CMS check management command fixed [#7386] (cdcf260aa) -- Marco Bonetti
* default light mode (#7381) (abc6e6c5b) -- viliammihalik
* Added language to page cache key (#7354) (d5a9f49e6) -- Mark Walker

Refactoring and Cleanups:
-------------------------
* Move js API functions to CMS.Helpers to make them available also to the admin site (#7384) (a7f8cd44f) -- Fabian Braun

Statistics:
-----------

This release includes       40 pull requests, and was created with the help of the
following contributors (in alphabetical order):

* Cage Johnson (1 pull request)
* Christian Clauss (1 pull request)
* Dapo Adedire (1 pull request)
* Fabian Braun (11 pull requests)
* G3RB3N (1 pull request)
* Hussein Srour (1 pull request)
* Marco Bonetti (2 pull requests)
* Mark Walker (10 pull requests)
* Micah Denbraver (1 pull request)
* Qijia Liu (1 pull request)
* Shivan Sivakumaran (1 pull request)
* Vinit Kumar (1 pull request)
* code-review-doctor (1 pull request)
* dependabot[bot] (0 pull request)
* ton77v (1 pull request)
* viliammihalik (1 pull request)
* wesleysima (1 pull request)

With the review help of the following contributors:

* Christian Clauss
* Conrad
* Fabian Braun
* Florian Delizy
* Marco Bonetti
* Mark Walker
* Pankrat
* Patrick Mazulo
* Simon Krull
* Vinit Kumar
* dependabot[bot]
* jefe

Thanks to all contributors for their efforts!


************************
How to upgrade to
************************

We assume you are upgrading from django CMS 3.11.0.

Please make sure that your current database is consistent and in a healthy
state, and **make a copy of the database before proceeding further.**

Check your settings of `CMS_LANGUAGES` (if used), as it was ignored by default in preceding versions.
For more information, please see: https://github.com/django-cms/django-cms/pull/6795

Then run::

    python manage.py migrate  # to ensure that your database is up-to-date with migrations
    python manage.py cms fix-tree

Check custom code and third-party applications for use of deprecated or removed functionality or
APIs (see above). Some third-party components may need to be updated.

Install the new version of django CMS from GitHub or via pip.

Run::

    python manage.py migrate

to apply the new migrations.