Skip to content

Commit b547241

Browse files
authored
Changes in migrations for 5.4.0-alpha3 (#490)
* Changes in migrations for 5.4.0-alpha3 * At least one sentence for each feature. * Added #45706 Language Key Deprecations
1 parent 25931da commit b547241

File tree

2 files changed

+56
-19
lines changed

2 files changed

+56
-19
lines changed

migrations/53-54/new-deprecations.md

Lines changed: 39 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,46 +6,70 @@ New Deprecations
66
================
77

88
:::tip[Developer Note]
9-
Since this version of Joomla has not been released yet, this page can change anytime.
9+
This version of Joomla has not yet been released, so this page is subject to change at any time.
10+
Deprecations added up to and including version 5.4.0-alpha3 are listed below.
1011
:::
1112

1213
All the new deprecations you should be aware of — and what you should use instead.
1314

14-
## Class deprecations
15+
## Class Deprecations
1516

1617
Planned to be removed in Joomla! 7.0.
1718

18-
### Deprecation of UCM system
19-
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:
19+
### Deprecation of UCM System
20+
21+
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:
2022

2123
- `Joomla\CMS\Table\Ucm`
2224
- `Joomla\CMS\UCM\UCM`
2325
- `Joomla\CMS\UCM\UCMBase`
2426
- `Joomla\CMS\UCM\UCMContent`
2527
- `Joomla\CMS\UCM\UCMType`
2628

27-
Related PR: https://github.com/joomla/joomla-cms/pull/44910
29+
Related PR: [44910](https://github.com/joomla/joomla-cms/pull/44910) – Deprecating UCM code
30+
31+
### Random Image Module
32+
33+
[45648](https://github.com/joomla/joomla-cms/pull/45648) – Convert mod_random_image to service provider
34+
35+
- ❌ Avoid using the `getRandomImage()` static method.
36+
- ✅ Instead use the non-static `getImage()` method.
37+
- ❌ Avoid using the `getImages()` static method.
38+
- ✅ Instead use the non-static `getImagesFromFolder()` method.
39+
- ❌ Avoid using the `getFolder()` static method.
40+
- ✅ Instead use the non-static `getSanitizedFolder()` method.
2841

29-
## Deprecation of `registerListeners()`
42+
### Deprecation of `registerListeners()`
3043
[43395](https://github.com/joomla/joomla-cms/pull/43395) – CMSPlugin: deprecation for registerListeners
3144

3245
-`registerListeners()` is deprecated in both `Joomla\CMS\Extension\PluginInterface` and `Joomla\CMS\Plugin\CMSPlugin`.
33-
- ✅ Instead, implement the `SubscriberInterface`. The method is no longer required in this case.
46+
- ✅ Instead, implement the `SubscriberInterface`. The method is no longer required in this case.
3447

35-
## Deprecation of `$_db`, `getDbo()`, and `setDbo()`
48+
### Deprecation of `$_db`, `getDbo()`, and `setDbo()`
3649
[45165](https://github.com/joomla/joomla-cms/pull/45165) – Replace table _db with DatabaseAwareTrait
3750

3851
- ❌ Do not access the `Joomla\CMS\Table\Table::_db` property directly — it will be removed in the future.
3952
- ❌ Avoid using the `getDbo()` and `setDbo()` methods — they will also be removed.
40-
- ✅ Use **`getDatabase()`** and **`setDatabase()`** instead.
53+
- ✅ Use `getDatabase()` and `setDatabase()` instead.
4154
Sample:
42-
```php
43-
$db = $this->getDatabase();
44-
$this->setDatabase($db);
45-
```
55+
```php
56+
$db = $this->getDatabase();
57+
$this->setDatabase($db);
58+
```
4659

4760
## Language String Deprecation
4861

49-
Planned to be removed in Joomla! 6.0 is the language string:
62+
Planned to be removed in Joomla! 6.0 are the language keys:
5063
* [45564](https://github.com/joomla/joomla-cms/pull/45564) – Deprecate language string
51-
*`COM_JOOMLAUPDATE_VIEW_DEFAULT_UPDATES_INFO_TESTING`
64+
* ❌ Avoid using the `COM_JOOMLAUPDATE_VIEW_DEFAULT_UPDATES_INFO_TESTING` language key.
65+
* [45725](https://github.com/joomla/joomla-cms/pull/45725) – Deprecate language string
66+
* ❌ Avoid using the `COM_FINDER_CONFIG_HILIGHT_CONTENT_SEARCH_TERMS_LABEL` language key.
67+
* ✅ Use `COM_FINDER_CONFIG_HIGHLIGHT_CONTENT_SEARCH_TERMS_LABEL` instead.
68+
* [45727](https://github.com/joomla/joomla-cms/pull/45727) – Deprecate language string Mis_typed
69+
* ❌ Avoid using the `JERROR_LAYOUT_MIS_TYPED_ADDRESS` language key.
70+
* ✅ Use `JERROR_LAYOUT_MISTYPED_ADDRESS` instead.
71+
* [45706](https://github.com/joomla/joomla-cms/pull/45706) – configurated
72+
* ❌ Avoid using the `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURATED` language key.
73+
* ✅ Use `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURED` instead.
74+
* ❌ Avoid using the `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURATED_ADMIN` language key.
75+
* ✅ Use `PLG_SYSTEM_SCHEMAORG_FIELD_SCHEMA_DESCRIPTION_NOT_CONFIGURED_ADMIN` instead.

migrations/53-54/new-features.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,23 @@ All the new features that have been added to version 5.4, along with any changes
99

1010
:::tip[Developer & Tester Note]
1111
Since this version of Joomla has not been released yet, this page can change anytime.
12-
Currently, it lists the new features for 5.4.0-alpha1.
12+
The new features up to and including 5.4.0-alpha3 are listed.
1313
:::
1414

1515
## Admin Backend
1616

1717
<details>
1818
<summary><strong>Automated Core Updates</strong></summary>
19-
* [45143](https://github.com/joomla/joomla-cms/pull/45143) Automated Core Updates client functionality.
20-
* [45517](https://github.com/joomla/joomla-cms/pull/45517) Automated Updates information added.
21-
* [45547](https://github.com/joomla/joomla-cms/pull/45547) Improve autoupdate UX for local site
19+
20+
Automated Updates implements *The Update Framework* (TUF), a secure software update distribution system
21+
designed to prevent supply chain attacks when automatically updating Joomla core minor versions.
22+
This is especially important for applying security fixes quickly and reliably.
23+
24+
* [45143](https://github.com/joomla/joomla-cms/pull/45143) Add Automated Core Updates client functionality
25+
* [45517](https://github.com/joomla/joomla-cms/pull/45517) Add Automated Updates information as fieldset description
26+
* [45547](https://github.com/joomla/joomla-cms/pull/45547) Improve Automated Update UX for local sites
27+
* [45685](https://github.com/joomla/joomla-cms/pull/45685) Notify all super users of Automated Updates
28+
* [45669](https://github.com/joomla/joomla-cms/pull/45669) Improve Automated Update Quickicon language keys and icon
2229

2330
---
2431

@@ -32,6 +39,9 @@ Please ensure the test instance is accessible from the Internet
3239

3340
<details>
3441
<summary>Use of 'None' in Various Filter Options and List Views</summary>
42+
43+
New *None* options improve filtering and display of items without authors, tags, users or field groups.
44+
3545
* [45232](https://github.com/joomla/joomla-cms/pull/45232) New '- None -' author filter option in the Articles view
3646
to select articles associated with deleted user entries.
3747
* [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
5060

5161
<details>
5262
<summary>More Links for User-Friendliness</summary>
63+
64+
New links make it easier to access related views directly from update notifications and checks.
65+
5366
* [45318](https://github.com/joomla/joomla-cms/pull/45318) Added a link to more easily open the
5467
'System – Maintenance – Database' view from the Pre-Update Check.
5568
* [45318](https://github.com/joomla/joomla-cms/pull/45318) Added a link to more easily open the

0 commit comments

Comments
 (0)