diff --git a/migrations/53-54/new-deprecations.md b/migrations/53-54/new-deprecations.md index 8863e143..d27ae1b5 100644 --- a/migrations/53-54/new-deprecations.md +++ b/migrations/53-54/new-deprecations.md @@ -6,17 +6,19 @@ New Deprecations ================ :::tip[Developer Note] - Since this version of Joomla has not been released yet, this page can change anytime. + This version of Joomla has not yet been released, so this page is subject to change at any time. + Deprecations added up to and including version 5.4.0-alpha3 are listed below. ::: All the new deprecations you should be aware of — and what you should use instead. -## Class deprecations +## Class Deprecations Planned to be removed in Joomla! 7.0. -### Deprecation of UCM system -In Joomla 3.2, the `Unified Content Model` was introduced, which was supposed to be a universal system for all content in Joomla. The concept turned out to be not viable and the remnants of this have now been deprecated for removal in Joomla 7.0. The following classes have been deprecated without replacement: +### Deprecation of UCM System + +In Joomla 3.2, the Unified Content Model (UCM) was introduced, which was supposed to be a universal system for all content in Joomla. The concept turned out to be not viable and the remnants of this have now been deprecated for removal in Joomla 7.0. The following classes have been deprecated without replacement: - `Joomla\CMS\Table\Ucm` - `Joomla\CMS\UCM\UCM` @@ -24,28 +26,50 @@ In Joomla 3.2, the `Unified Content Model` was introduced, which was supposed to - `Joomla\CMS\UCM\UCMContent` - `Joomla\CMS\UCM\UCMType` -Related PR: https://github.com/joomla/joomla-cms/pull/44910 +Related PR: [44910](https://github.com/joomla/joomla-cms/pull/44910) – Deprecating UCM code + +### Random Image Module + +[45648](https://github.com/joomla/joomla-cms/pull/45648) – Convert mod_random_image to service provider + +- ❌ Avoid using the `getRandomImage()` static method. + - ✅ Instead use the non-static `getImage()` method. +- ❌ Avoid using the `getImages()` static method. + - ✅ Instead use the non-static `getImagesFromFolder()` method. +- ❌ Avoid using the `getFolder()` static method. + - ✅ Instead use the non-static `getSanitizedFolder()` method. -## Deprecation of `registerListeners()` +### Deprecation of `registerListeners()` [43395](https://github.com/joomla/joomla-cms/pull/43395) – CMSPlugin: deprecation for registerListeners - ❌ `registerListeners()` is deprecated in both `Joomla\CMS\Extension\PluginInterface` and `Joomla\CMS\Plugin\CMSPlugin`. -- ✅ Instead, implement the `SubscriberInterface`. The method is no longer required in this case. + - ✅ Instead, implement the `SubscriberInterface`. The method is no longer required in this case. -## Deprecation of `$_db`, `getDbo()`, and `setDbo()` +### Deprecation of `$_db`, `getDbo()`, and `setDbo()` [45165](https://github.com/joomla/joomla-cms/pull/45165) – Replace table _db with DatabaseAwareTrait - ❌ Do not access the `Joomla\CMS\Table\Table::_db` property directly — it will be removed in the future. - ❌ Avoid using the `getDbo()` and `setDbo()` methods — they will also be removed. -- ✅ Use **`getDatabase()`** and **`setDatabase()`** instead. + - ✅ Use `getDatabase()` and `setDatabase()` instead. Sample: - ```php - $db = $this->getDatabase(); - $this->setDatabase($db); - ``` + ```php + $db = $this->getDatabase(); + $this->setDatabase($db); + ``` ## Language String Deprecation -Planned to be removed in Joomla! 6.0 is the language string: +Planned to be removed in Joomla! 6.0 are the language keys: * [45564](https://github.com/joomla/joomla-cms/pull/45564) – Deprecate language string - * ❌ `COM_JOOMLAUPDATE_VIEW_DEFAULT_UPDATES_INFO_TESTING` + * ❌ Avoid using the `COM_JOOMLAUPDATE_VIEW_DEFAULT_UPDATES_INFO_TESTING` language key. +* [45725](https://github.com/joomla/joomla-cms/pull/45725) – Deprecate language string + * ❌ Avoid using the `COM_FINDER_CONFIG_HILIGHT_CONTENT_SEARCH_TERMS_LABEL` language key. + * ✅ Use `COM_FINDER_CONFIG_HIGHLIGHT_CONTENT_SEARCH_TERMS_LABEL` instead. +* [45727](https://github.com/joomla/joomla-cms/pull/45727) – Deprecate language string Mis_typed + * ❌ Avoid using the `JERROR_LAYOUT_MIS_TYPED_ADDRESS` language key. + * ✅ Use `JERROR_LAYOUT_MISTYPED_ADDRESS` instead. +* [45706](https://github.com/joomla/joomla-cms/pull/45706) – configurated + * ❌ Avoid using the `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURATED` language key. + * ✅ Use `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURED` instead. + * ❌ Avoid using the `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURATED_ADMIN` language key. + * ✅ Use `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURED_ADMIN` instead. diff --git a/migrations/53-54/new-features.md b/migrations/53-54/new-features.md index a34ff49b..7c18ed04 100644 --- a/migrations/53-54/new-features.md +++ b/migrations/53-54/new-features.md @@ -9,16 +9,23 @@ All the new features that have been added to version 5.4, along with any changes :::tip[Developer & Tester Note] Since this version of Joomla has not been released yet, this page can change anytime. - Currently, it lists the new features for 5.4.0-alpha1. + The new features up to and including 5.4.0-alpha3 are listed. ::: ## Admin Backend
Automated Core Updates -* [45143](https://github.com/joomla/joomla-cms/pull/45143) Automated Core Updates client functionality. -* [45517](https://github.com/joomla/joomla-cms/pull/45517) Automated Updates information added. -* [45547](https://github.com/joomla/joomla-cms/pull/45547) Improve autoupdate UX for local site + +Automated Updates implements *The Update Framework* (TUF), a secure software update distribution system +designed to prevent supply chain attacks when automatically updating Joomla core minor versions. +This is especially important for applying security fixes quickly and reliably. + +* [45143](https://github.com/joomla/joomla-cms/pull/45143) Add Automated Core Updates client functionality +* [45517](https://github.com/joomla/joomla-cms/pull/45517) Add Automated Updates information as fieldset description +* [45547](https://github.com/joomla/joomla-cms/pull/45547) Improve Automated Update UX for local sites +* [45685](https://github.com/joomla/joomla-cms/pull/45685) Notify all super users of Automated Updates +* [45669](https://github.com/joomla/joomla-cms/pull/45669) Improve Automated Update Quickicon language keys and icon --- @@ -32,6 +39,9 @@ Please ensure the test instance is accessible from the Internet
Use of 'None' in Various Filter Options and List Views + +New *None* options improve filtering and display of items without authors, tags, users or field groups. + * [45232](https://github.com/joomla/joomla-cms/pull/45232) New '- None -' author filter option in the Articles view to select articles associated with deleted user entries. * [45274](https://github.com/joomla/joomla-cms/pull/45274) New '- None -' tag filter option in the Articles view @@ -50,6 +60,9 @@ Please ensure the test instance is accessible from the Internet
More Links for User-Friendliness + + New links make it easier to access related views directly from update notifications and checks. + * [45318](https://github.com/joomla/joomla-cms/pull/45318) Added a link to more easily open the 'System – Maintenance – Database' view from the Pre-Update Check. * [45318](https://github.com/joomla/joomla-cms/pull/45318) Added a link to more easily open the