[5.1] Implement onAfterInitialiseRouter event

libraries/src/Event/Router/AfterInitialiseRouterEvent.php

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * Joomla! Content Management System
+ *
+ * @copyright  (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\CMS\Event\Router;
+
+// phpcs:disable PSR1.Files.SideEffects
+
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Event class for AfterInitialiseRouter event
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+class AfterInitialiseRouterEvent extends RouterEvent
+{
+}

libraries/src/Event/Router/RouterEvent.php

@@ -0,0 +1,70 @@
+<?php
+
+/**
+ * Joomla! Content Management System
+ *
+ * @copyright  (C) 2023 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\CMS\Event\Router;
+
+use Joomla\CMS\Event\AbstractImmutableEvent;
+use Joomla\CMS\Router\Router;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Class for Application's Router events
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+abstract class RouterEvent extends AbstractImmutableEvent
+{
+    /**
+     * Constructor.
+     *
+     * @param   string  $name       The event name.
+     * @param   array   $arguments  The event arguments.
+     *
+     * @throws  \BadMethodCallException
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function __construct($name, array $arguments = [])
+    {
+        if (!\array_key_exists('router', $arguments)) {
+            throw new \BadMethodCallException("Argument 'router' of event {$name} is required but has not been provided");
+        }
+
+        parent::__construct($name, $arguments);
+    }
+
+    /**
+     * Setter for the router argument.
+     *
+     * @param   Router  $value  The value to set
+     *
+     * @return  Router
+     *
+     * @since  __DEPLOY_VERSION__
+     */
+    protected function onSetRouter(Router $value): Router
+    {
+        return $value;
+    }
+
+    /**
+     * Get the event's router object
+     *
+     * @return  Router
+     *
+     * @since  __DEPLOY_VERSION__
+     */
+    public function getRouter(): Router
+    {
+        return $this->arguments['router'];
+    }
+}

libraries/src/Router/SiteRouter.php

@@ -14,8 +14,10 @@
 use Joomla\CMS\Component\Router\RouterInterface;
 use Joomla\CMS\Component\Router\RouterLegacy;
 use Joomla\CMS\Component\Router\RouterServiceInterface;
+use Joomla\CMS\Event\Router\AfterInitialiseRouterEvent;
 use Joomla\CMS\Factory;
 use Joomla\CMS\Menu\AbstractMenu;
+use Joomla\CMS\Plugin\PluginHelper;
 use Joomla\CMS\Uri\Uri;
 
 // phpcs:disable PSR1.Files.SideEffects
@@ -94,6 +96,12 @@ public function __construct(CMSApplication $app = null, AbstractMenu $menu = nul
 
         $this->attachParseRule([$this, 'parseRawRoute'], self::PROCESS_DURING);
         $this->attachBuildRule([$this, 'buildBase'], self::PROCESS_AFTER);
+
+        PluginHelper::importPlugin('system', null, true, $this->app->getDispatcher());
+        $this->app->getDispatcher()->dispatch(
+            'onAfterInitialiseRouter',
+            new AfterInitialiseRouterEvent('onAfterInitialiseRouter', ['router' => $this])
+        );
     }
 
     /**

plugins/system/languagefilter/services/provider.php

@@ -41,7 +41,6 @@ function (Container $container) {
                     Factory::getApplication(),
                     $container->get(LanguageFactoryInterface::class)
                 );
-                $plugin->setSiteRouter($container->get(SiteRouter::class));
 
                 return $plugin;
             }

plugins/system/languagefilter/src/Extension/LanguageFilter.php

@@ -14,6 +14,7 @@
 use Joomla\CMS\Application\CMSApplicationInterface;
 use Joomla\CMS\Association\AssociationServiceInterface;
 use Joomla\CMS\Component\ComponentHelper;
+use Joomla\CMS\Event\Router\AfterInitialiseRouterEvent;
 use Joomla\CMS\Factory;
 use Joomla\CMS\Filesystem\Folder;
 use Joomla\CMS\Language\Associations;
@@ -27,6 +28,8 @@
 use Joomla\CMS\Uri\Uri;
 use Joomla\Component\Menus\Administrator\Helper\MenusHelper;
 use Joomla\Event\DispatcherInterface;
+use Joomla\Event\Priority;
+use Joomla\Event\SubscriberInterface;
 use Joomla\Filesystem\Path;
 use Joomla\Registry\Registry;
 use Joomla\String\StringHelper;
@@ -40,7 +43,7 @@
  *
  * @since  1.6
  */
-final class LanguageFilter extends CMSPlugin
+final class LanguageFilter extends CMSPlugin implements SubscriberInterface
 {
     use SiteRouterAwareTrait;
 
@@ -158,15 +161,38 @@ public function __construct(
     }
 
     /**
-     * After initialise.
+     * Returns an array of CMS events this plugin will listen to and the respective handlers.
+     *
+     * @return  array
+     *
+     * @since  __DEPLOY_VERSION__
+     */
+    public static function getSubscribedEvents(): array
+    {
+        /**
+         * Note that onAfterInitialise must be the first handlers to run for this
+         * plugin to operate as expected. These handlers load compatibility code which
+         * might be needed by other plugins
+         */
+        return [
+            'onAfterInitialiseRouter' => ['onAfterInitialiseRouter', Priority::HIGH],
+        ];
+    }
+
+    /**
+     * After initialise router.
      *
      * @return  void
      *
-     * @since   1.6
+     * @since   __DEPLOY_VERSION__
      */
-    public function onAfterInitialise()
+    public function onAfterInitialiseRouter(AfterInitialiseRouterEvent $event)
     {
-        $router = $this->getSiteRouter();
+        $router = $event->getArgument('router');
+
+        if (!is_a($router, 'Joomla\CMS\Router\SiteRouter')) {
+            return;
+        }
 
         // Attach build rules for language SEF.
         $router->attachBuildRule([$this, 'preprocessBuildRule'], Router::PROCESS_BEFORE);