class MenuLinksetRoutes

Same name in other branches
  1. 11.x core/modules/system/src/Routing/MenuLinksetRoutes.php \Drupal\system\Routing\MenuLinksetRoutes

Dynamically defines routes for menu linkset endpoints.

Hierarchy

Expanded class hierarchy of MenuLinksetRoutes

1 string reference to 'MenuLinksetRoutes'
system.services.yml in core/modules/system/system.services.yml
core/modules/system/system.services.yml
1 service uses MenuLinksetRoutes
system.menus.route_subscriber in core/modules/system/system.services.yml
Drupal\system\Routing\MenuLinksetRoutes

File

core/modules/system/src/Routing/MenuLinksetRoutes.php, line 18

Namespace

Drupal\system\Routing
View source
class MenuLinksetRoutes extends RouteSubscriberBase implements ContainerInjectionInterface {
    
    /**
     * An array of enabled authentication provider IDs.
     *
     * @var string[]
     */
    protected readonly array $providerIds;
    
    /**
     * EventSubscriber constructor.
     *
     * @param string[] $authenticationProviders
     *   An array of authentication providers, keyed by ID.
     * @param \Drupal\Core\Config\ConfigFactoryInterface $configFactory
     *   The config factory.
     * @param \Drupal\Core\Routing\RouteBuilderInterface $routeBuilder
     *   The route builder.
     */
    public function __construct(array $authenticationProviders, ConfigFactoryInterface $configFactory, RouteBuilderInterface $routeBuilder) {
        $this->providerIds = array_keys($authenticationProviders);
    }
    
    /**
     * Alter routes.
     *
     * If the endpoint is configured to be enabled, dynamically enable all
     * authentication providers on this module's routes since they cannot be known
     * in advance.
     *
     * @param \Symfony\Component\Routing\RouteCollection $collection
     *   A collection of routes.
     */
    public function alterRoutes(RouteCollection $collection) {
        if ($this->configFactory
            ->get('system.feature_flags')
            ->get('linkset_endpoint')) {
            $collection->get('system.menu.linkset')
                ->setOption('_auth', $this->providerIds);
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function onConfigSave(ConfigCrudEvent $event) {
        $saved_config = $event->getConfig();
        if ($saved_config->getName() === 'system.feature_flags' && $event->isChanged('linkset_endpoint')) {
            $this->routeBuilder
                ->setRebuildNeeded();
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public static function getSubscribedEvents() : array {
        $events = parent::getSubscribedEvents();
        // Run after the route alter event subscriber.
        $events[ConfigEvents::SAVE][] = [
            'onConfigSave',
            0,
        ];
        return $events;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) {
        return new static($container->getParameter('authentication_providers'), $container->get('config.factory'), $container->get('router.builder'));
    }
    
    /**
     * Returns an array of route objects.
     *
     * @return \Symfony\Component\Routing\Route[]
     *   An array of route objects.
     */
    public function routes() {
        $routes = [];
        // Only enable linkset routes if the related config option is enabled.
        if ($this->configFactory
            ->get('system.feature_flags')
            ->get('linkset_endpoint')) {
            $routes['system.menu.linkset'] = new Route('/system/menu/{menu}/linkset', [
                '_controller' => 'Drupal\\system\\Controller\\LinksetController::process',
            ], [
                '_access' => 'TRUE',
            ], [
                'parameters' => [
                    'menu' => [
                        'type' => 'entity:menu',
                    ],
                ],
            ]);
        }
        return $routes;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
MenuLinksetRoutes::$providerIds protected property An array of enabled authentication provider IDs.
MenuLinksetRoutes::alterRoutes public function Alter routes. Overrides RouteSubscriberBase::alterRoutes
MenuLinksetRoutes::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
MenuLinksetRoutes::getSubscribedEvents public static function Overrides RouteSubscriberBase::getSubscribedEvents
MenuLinksetRoutes::onConfigSave public function
MenuLinksetRoutes::routes public function Returns an array of route objects.
MenuLinksetRoutes::__construct public function EventSubscriber constructor.
RouteSubscriberBase::onAlterRoutes public function Delegates the route altering to self::alterRoutes(). 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.