From 6acda231385e808d6c8e99cd39d289698c347b14 Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Sat, 28 Feb 2026 13:34:03 +0100 Subject: [PATCH 1/8] Migration stubs for 7.0 --- migrations/64-70/compat-plugin.md | 28 ++++++++++++++++++++++++++++ migrations/64-70/index.md | 10 ++++++++++ migrations/64-70/new-deprecations.md | 16 ++++++++++++++++ migrations/64-70/new-features.md | 13 +++++++++++++ 4 files changed, 67 insertions(+) create mode 100644 migrations/64-70/compat-plugin.md create mode 100644 migrations/64-70/index.md create mode 100644 migrations/64-70/new-deprecations.md create mode 100644 migrations/64-70/new-features.md diff --git a/migrations/64-70/compat-plugin.md b/migrations/64-70/compat-plugin.md new file mode 100644 index 00000000..f7b39384 --- /dev/null +++ b/migrations/64-70/compat-plugin.md @@ -0,0 +1,28 @@ +--- +sidebar_position: 4 +--- + +Compatibility Plugin +==================== + +:::tip[Developer Note] + Since this version of Joomla has not been released yet, this page can change anytime. +::: + +:::warning[Developer Note] + Heads-up, don't create a plugin as `behaviour` plugin because it's possible that this group get removed at some point. +::: + +## Joomla 7 Compatibility Plugin + +In Joomla! 7.0 the Compatibility Plugin introduced in Joomla! 6.0 will be replaced by a new plugin +called "Behaviour - Backward Compatibility 7". + +Despite the warning about the potential removal of the `behaviour` plugin type, this compatibility plugin still uses +this type to ensure it loads before any other plugin, as this is critical for backward compatibility functionality. + +### Detailed documentation + +:::warning[Reader Note] + Please read the [Compatibility Plugin 6.0](../54-60/compat-plugin.md) section +::: diff --git a/migrations/64-70/index.md b/migrations/64-70/index.md new file mode 100644 index 00000000..8a537083 --- /dev/null +++ b/migrations/64-70/index.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 989 +title: 6.0 to 6.1 +--- + +Joomla 6.4 to 7.0 Upgrade Notes +=============================== + +An explanation of the code changes for each version of Joomla. +If you follow from the version of your current code until the version you want to support you should come across all the changes you need to make. diff --git a/migrations/64-70/new-deprecations.md b/migrations/64-70/new-deprecations.md new file mode 100644 index 00000000..b9f340b7 --- /dev/null +++ b/migrations/64-70/new-deprecations.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 2 +--- + +New Deprecations +================ + +:::tip[Developer Note] + Since this version of Joomla has not been released yet, this page can change anytime. +::: + +All the new deprecations that should be aware of and what you should now be using instead. + +:::tip[Reader Note] + No deprecations have been introduced in Joomla 6.1 yet +::: diff --git a/migrations/64-70/new-features.md b/migrations/64-70/new-features.md new file mode 100644 index 00000000..5a3099e7 --- /dev/null +++ b/migrations/64-70/new-features.md @@ -0,0 +1,13 @@ +--- +sidebar_position: 1 +--- + +New Features +============ + +:::tip[Developer Note] + Since this version of Joomla has not been released yet, this page can change anytime. +::: + +All the new features that have been added to this version. +Any changes in best practice. From 8a780584edf5dd23f9b9eea8e0281e46f9823bf9 Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Sat, 28 Feb 2026 13:41:32 +0100 Subject: [PATCH 2/8] Update index.md --- migrations/64-70/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/migrations/64-70/index.md b/migrations/64-70/index.md index 8a537083..865a88d0 100644 --- a/migrations/64-70/index.md +++ b/migrations/64-70/index.md @@ -1,6 +1,6 @@ --- sidebar_position: 989 -title: 6.0 to 6.1 +title: 6.4 to 7.0 --- Joomla 6.4 to 7.0 Upgrade Notes From 207ed29cce93c6244578f4be988fb8d7f46e1c32 Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Sat, 28 Feb 2026 13:41:59 +0100 Subject: [PATCH 3/8] Update new-deprecations.md --- migrations/64-70/new-deprecations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/migrations/64-70/new-deprecations.md b/migrations/64-70/new-deprecations.md index b9f340b7..d7a9b7bc 100644 --- a/migrations/64-70/new-deprecations.md +++ b/migrations/64-70/new-deprecations.md @@ -12,5 +12,5 @@ New Deprecations All the new deprecations that should be aware of and what you should now be using instead. :::tip[Reader Note] - No deprecations have been introduced in Joomla 6.1 yet + No deprecations have been introduced in Joomla 7.0 yet ::: From 6a8b69f278a392dc867c25a767072268abea9263 Mon Sep 17 00:00:00 2001 From: Harald Leithner Date: Fri, 6 Mar 2026 10:15:12 +0100 Subject: [PATCH 4/8] Apply suggestion from @HLeithner --- migrations/64-70/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/migrations/64-70/index.md b/migrations/64-70/index.md index 865a88d0..9e56eb7a 100644 --- a/migrations/64-70/index.md +++ b/migrations/64-70/index.md @@ -1,5 +1,5 @@ --- -sidebar_position: 989 +sidebar_position: 985 title: 6.4 to 7.0 --- From 8447c440f9c965721e771b13c45ca497f333d7c9 Mon Sep 17 00:00:00 2001 From: Harald Leithner Date: Fri, 6 Mar 2026 10:16:54 +0100 Subject: [PATCH 5/8] Apply suggestion from @HLeithner --- migrations/64-70/compat-plugin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/migrations/64-70/compat-plugin.md b/migrations/64-70/compat-plugin.md index f7b39384..b790d87c 100644 --- a/migrations/64-70/compat-plugin.md +++ b/migrations/64-70/compat-plugin.md @@ -24,5 +24,5 @@ this type to ensure it loads before any other plugin, as this is critical for ba ### Detailed documentation :::warning[Reader Note] - Please read the [Compatibility Plugin 6.0](../54-60/compat-plugin.md) section + Please read the [Compatibility Plugin 6.0](../64-70/compat-plugin.md) section ::: From 8710c3ee93fac7964cf3a420f6f6320eeb161381 Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Sat, 21 Mar 2026 18:05:19 +0100 Subject: [PATCH 6/8] Fix path --- migrations/64-70/compat-plugin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/migrations/64-70/compat-plugin.md b/migrations/64-70/compat-plugin.md index b790d87c..6f344af6 100644 --- a/migrations/64-70/compat-plugin.md +++ b/migrations/64-70/compat-plugin.md @@ -24,5 +24,5 @@ this type to ensure it loads before any other plugin, as this is critical for ba ### Detailed documentation :::warning[Reader Note] - Please read the [Compatibility Plugin 6.0](../64-70/compat-plugin.md) section + Please read the [Compatibility Plugin 7.0](../64-70/compat-plugin.md) section ::: From 2841de085ae8c4105cda0ff9f2098cd031284ed4 Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Fri, 3 Apr 2026 20:10:03 +0200 Subject: [PATCH 7/8] Create 7.0 stub --- migrations/64-70/removed-backward-incompatibility.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 migrations/64-70/removed-backward-incompatibility.md diff --git a/migrations/64-70/removed-backward-incompatibility.md b/migrations/64-70/removed-backward-incompatibility.md new file mode 100644 index 00000000..de32eb38 --- /dev/null +++ b/migrations/64-70/removed-backward-incompatibility.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 3 +--- + +Removed and Backward Incompatibility +==================================== + +All the deprecated features that have now been removed and any backward incompatibilities. +There should be an explanation of how to mitigate the removals / changes. + From e40e37db4ce3f00af36c0adacfdcf88e2ff6ae5d Mon Sep 17 00:00:00 2001 From: Hannes Papenberg Date: Fri, 3 Apr 2026 20:21:43 +0200 Subject: [PATCH 8/8] Removal of custom DB object from Table class --- migrations/64-70/removed-backward-incompatibility.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/migrations/64-70/removed-backward-incompatibility.md b/migrations/64-70/removed-backward-incompatibility.md index de32eb38..45558588 100644 --- a/migrations/64-70/removed-backward-incompatibility.md +++ b/migrations/64-70/removed-backward-incompatibility.md @@ -8,3 +8,7 @@ Removed and Backward Incompatibility All the deprecated features that have now been removed and any backward incompatibilities. There should be an explanation of how to mitigate the removals / changes. +## Removal of the custom DB object from `Table` Class +The `\Joomla\CMS\Table\Table` class has custom methods to access the database object, namely `getDbo()`, `setDbo()`, `getDatabase()` and `setDatabase()`. Internally it also has `$this->_db` to save the database object. In Joomla 7.0, the attribute and the custom methods were removed in favour of the `DatabaseAwareTrait`, which provides the `getDatabase()` and `setDatabase()` for all relevant core classes. Only `getDbo()` was kept to soften the transition for third party code. Please migrate all calls for `getDbo()` in your code to use `getDatabase()` instead. The legacy `getDbo()` method will be removed in Joomla 8.0. + +PR: https://github.com/joomla/joomla-cms/pull/47440