diff --git a/migrations/64-70/compat-plugin.md b/migrations/64-70/compat-plugin.md new file mode 100644 index 000000000..6f344af64 --- /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 7.0](../64-70/compat-plugin.md) section +::: diff --git a/migrations/64-70/index.md b/migrations/64-70/index.md new file mode 100644 index 000000000..9e56eb7a9 --- /dev/null +++ b/migrations/64-70/index.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 985 +title: 6.4 to 7.0 +--- + +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 000000000..d7a9b7bc0 --- /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 7.0 yet +::: diff --git a/migrations/64-70/new-features.md b/migrations/64-70/new-features.md new file mode 100644 index 000000000..5a3099e71 --- /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. diff --git a/migrations/64-70/removed-backward-incompatibility.md b/migrations/64-70/removed-backward-incompatibility.md new file mode 100644 index 000000000..f4dc2c90c --- /dev/null +++ b/migrations/64-70/removed-backward-incompatibility.md @@ -0,0 +1,17 @@ +--- +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. + +## Removal of static methods in module helpers + +- PR: https://github.com/joomla/joomla-cms/pull/45860 +- PR: https://github.com/joomla/joomla-cms/pull/47460 +- Files: modules/\*/src/Helper/\*.php & administrator/modules/\*/src/Helper/\*.php +- Description: Modules traditionally were written with a static helper class to retrieve data from the system. This isn't desirable from a dependency injection perspective and thus the modules were rewritten to use instantiated helper objects instead with dependency injection. The static methods were kept as a proxy to the new instantiated objects for version 5 and 6 of the CMS and with 7.0 these static methods were removed. Instantiate the helper object and call the non-static version of the respective method instead. +