New Deprecations
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
Planned to be removed in Joomla! 7.0.
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
Joomla\CMS\UCM\UCMBase
Joomla\CMS\UCM\UCMContent
Joomla\CMS\UCM\UCMType
Related PR: 44910 – Deprecating UCM code
Random Image Module
45648 – Convert mod_random_image to service provider
- ❌ Avoid using the
getRandomImage()
static method.- ✅ Instead use the non-static
getImage()
method.
- ✅ Instead use the non-static
- ❌ Avoid using the
getImages()
static method.- ✅ Instead use the non-static
getImagesFromFolder()
method.
- ✅ Instead use the non-static
- ❌ Avoid using the
getFolder()
static method.- ✅ Instead use the non-static
getSanitizedFolder()
method.
- ✅ Instead use the non-static
Deprecation of registerListeners()
43395 – CMSPlugin: deprecation for registerListeners
- ❌
registerListeners()
is deprecated in bothJoomla\CMS\Extension\PluginInterface
andJoomla\CMS\Plugin\CMSPlugin
.- ✅ Instead, implement the
SubscriberInterface
. The method is no longer required in this case.
- ✅ Instead, implement the
Deprecation of $_db
, getDbo()
, and setDbo()
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()
andsetDbo()
methods — they will also be removed.- ✅ Use
getDatabase()
andsetDatabase()
instead. Sample:$db = $this->getDatabase();
$this->setDatabase($db);
- ✅ Use
Language String Deprecation
Planned to be removed in Joomla! 6.0 are the language keys:
- 45564 – Deprecate language string
- ❌ Avoid using the
COM_JOOMLAUPDATE_VIEW_DEFAULT_UPDATES_INFO_TESTING
language key.
- ❌ Avoid using the
- 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.
- ✅ Use
- ❌ Avoid using the
- 45727 – Deprecate language string Mis_typed
- ❌ Avoid using the
JERROR_LAYOUT_MIS_TYPED_ADDRESS
language key.- ✅ Use
JERROR_LAYOUT_MISTYPED_ADDRESS
instead.
- ✅ Use
- ❌ Avoid using the
- 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.
- ✅ Use
- ❌ 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.
- ✅ Use
- ❌ Avoid using the