django cms 4.1.x Documentation

• 语言: 英语
• 格式: .pdf
• 来源: docs.django-cms.org

摘要

文档主要介绍了Django CMS 4.1.x版本的发布说明，包括新功能、bug修复、与Django和Python的兼容性，以及第三方插件的更新。文档详细列出了各个版本的改进内容，如状态指示器的显示、页面树的改进、插件管理的优化等，并提供了升级指导和兼容性建议。

AI总结

### Django CMS 4.1.x Documentation Summary

#### 1. **Compatibility**
- **Django**: Supports Django 3.2 to 5.0. Only the latest release of each series is recommended and supported.
- **Python**: Supports Python 3.8, 3.9, 3.10, 3.11, and 3.12.

#### 2. **New Features in 4.1**
- **Status Indicators**: Added status indicators (public and empty) in the page tree. Third-party packages like `djangocms-versioning` can extend this functionality.
- **RTL Support**: Improved support for right-to-left languages, including enhanced CSS and JS assets.
- **Performance Improvements**: Faster menu rendering in the page tree, reducing database hits.
- **Fallback Language Handling**: Renders fallback language titles in the page tree and respects toolbar language settings.

#### 3. **Bug Fixes**
- **Plugin Management**: Fixed issues with plugin tree inconsistencies when moving plugins between placeholders.
- **Page Tree Rendering**: Empty page contents now render correctly.
- **Slug Handling**: Fixed issues where changing a page slug did not refresh URLs.
- **Translation Issues**: Resolved translation-related errors and rendering problems.
- **Browser Compatibility**: Fixed issues with placeholder inheritance, apphooked URLs, and page editing in non-CMS pages.
- **Security and Stability**: Silenced deprecation warnings and resolved migration issues with Django 1.11 and newer.

#### 4. **Backward-Incompatible Changes**
- **TitleExtension Renamed**: `TitleExtension` in `cms.extensions.models` has been renamed to `PageContentExtension`. Third-party packages using this class must update their code.
- **Monkey Patching Removed**: Django CMS 4.1 no longer supports monkey patching for `djangocms-versioning` versions below 2.0.

#### 5. **Third-Party Packages**
- Several third-party packages, including `djangocms-versioning`, `djangocms-text-ckeditor`, and `djangocms-frontend`, are compatible with Django CMS 4.1.x. Some packages may require updates for full compatibility.

#### 6. **Upgrade Notes**
- **Database Backup**: Always backup your database before upgrading.
- **Migrations**: Run `python manage.py migrate` after upgrading to ensure all models and migrations are up-to-date.
- **Pending Deprecations**: Django 1.6, 1.7, and Python 2.6 are no longer supported in newer versions.

#### 7. **Known Issues and Resolutions**
- **Toolbar and Form Issues**: Resolved errors in the admin page tree and form rendering.
- **Cache and Rendering**: Fixed issues with placeholder inheritance and cached content display.

#### 8. **Summary of Key Improvements**
- Enhanced right-to-left language support.
- Faster and more efficient menu rendering.
- Improved error handling and stability.
- Better compatibility with modern Django and Python versions.

This summary highlights the major updates, bug fixes, and compatibility changes in Django CMS 4.1.x, providing a clear overview of its features and requirements.