|
| 1 | +.. _upgrade-to-5.0.3: |
| 2 | + |
| 3 | +################### |
| 4 | +5.0.3 release notes |
| 5 | +################### |
| 6 | + |
| 7 | +*July 27, 2025* |
| 8 | + |
| 9 | +Welcome to django CMS 5.0.2! |
| 10 | + |
| 11 | +These release notes cover the new features, as well as some backwards |
| 12 | +incompatible changes you'll want to be aware of when upgrading from |
| 13 | +django CMS 4.1 or earlier. We've begun the deprecation process for some |
| 14 | +features. |
| 15 | + |
| 16 | +******************************* |
| 17 | +Django and Python compatibility |
| 18 | +******************************* |
| 19 | + |
| 20 | +django CMS supports **Django 4.2, 5.0, 5.1, and 5.2**. We highly recommend and only |
| 21 | +support the latest release of each series. |
| 22 | + |
| 23 | +It supports **Python 3.10, 3.11, 3.12, and 3.13**. As for Django we highly recommend and only |
| 24 | +support the latest release of each series. |
| 25 | + |
| 26 | +*********************** |
| 27 | +How to upgrade to 5.0.3 |
| 28 | +*********************** |
| 29 | + |
| 30 | +Update your project’s ``requirements.txt`` file to require (at least) django CMS 5.0.1 and |
| 31 | +run ``pip install -r requirements.txt``. |
| 32 | + |
| 33 | +If you are upgrading from an earlier version of django CMS, read the release |
| 34 | +notes for all the versions between your current version and this one. Check |
| 35 | +the :ref:`release notes <release-notes>` for each version to see if there are |
| 36 | +any special instructions. |
| 37 | + |
| 38 | +Run migrations:: |
| 39 | + |
| 40 | + python -m manage migrate |
| 41 | + |
| 42 | +.. warning:: |
| 43 | + |
| 44 | + Since the migrations merge the ``TreeNode`` and ``Page`` models, you should run the |
| 45 | + migration in a test environment first to ensure that the migration runs |
| 46 | + successfully. |
| 47 | + |
| 48 | + |
| 49 | +******************* |
| 50 | +What's new in 5.0.3 |
| 51 | +******************* |
| 52 | + |
| 53 | +Bug Fixes: |
| 54 | +---------- |
| 55 | +* The headless template included inline CSS (#8291) (#8292) (14dd89faf) -- Fabian Braun |
| 56 | +* GrouperAdmin Search in content model (#8284) (#8290) (46f0e0775) -- Muhammad Hassan Siddiqi |
| 57 | +* Allow clicks to propagate to plugins (#8288) (#8289) (2c1ab2d7d) -- Fabian Braun |
| 58 | +* show_placeholder did not respect edit/preview mode and failed loudly (#8272) (#8274) (e7be7bc9b) -- Fabian Braun |
| 59 | +* Allow lazy wizard initialization (#8265) (365185848) -- Fabian Braun |
| 60 | +* Apphook widgets were not always detected correctly (#8263) (ec2f4e815) -- Fabian Braun |
| 61 | +* Migrating from django CMS 3.x failed in some rare cases (#8249) (bcf7f895a) -- jmit-modern |
| 62 | +* Added default_auto_field to cms/apps.py (#8254) (4a12dd38a) -- Fabian Braun |
| 63 | +* 404 not raised in CMS view when no URLs matched (#8240) (3d069cbe5) -- Stefan Wehrmeyer |
| 64 | +* Replaced outdated usage of page__node__path with page__path (#8238) (a9105a738) -- Stefan Wehrmeyer |
| 65 | + |
| 66 | + |
| 67 | + |
| 68 | +Statistics: |
| 69 | +----------- |
| 70 | + |
| 71 | +This release includes 13 pull requests, and was created with the help of the following contributors (in alphabetical order): |
| 72 | + |
| 73 | +* Fabian Braun (6 pull request) |
| 74 | +* Github Release Action (3 pull requests) |
| 75 | +* jmit-modern (1 pull request) |
| 76 | +* Muhammad Hassan Siddiqi (1 pull request) |
| 77 | +* Stefan Wehrmeyer (2 pull requests) |
| 78 | + |
| 79 | +With the review help of the following contributors: |
| 80 | + |
| 81 | +* Fabian Braun |
| 82 | +* Vinit Kumar |
| 83 | + |
| 84 | +Thanks to all contributors for their efforts! |
0 commit comments