class BlockPluginCollection

Same name and namespace in other branches
  1. 4.0.x src/Plugin/BlockPluginCollection.php \Drupal\ctools\Plugin\BlockPluginCollection

Provides a collection of block plugins.

Hierarchy

Expanded class hierarchy of BlockPluginCollection

2 files declare their use of BlockPluginCollection
BlockPluginCollectionTest.php in tests/src/Unit/BlockPluginCollectionTest.php
BlockVariantTraitTest.php in tests/src/Unit/BlockVariantTraitTest.php
1 string reference to 'BlockPluginCollection'
BlockDisplayVariant::__sleep in src/Plugin/DisplayVariant/BlockDisplayVariant.php

File

src/Plugin/BlockPluginCollection.php, line 11

Namespace

Drupal\ctools\Plugin
View source 
class BlockPluginCollection extends DefaultLazyPluginCollection {
    
    /**
     * {@inheritdoc}
     *
     * @return \Drupal\Core\Block\BlockPluginInterface
     */
    public function &get($instance_id) {
        return parent::get($instance_id);
    }
    
    /**
     * Returns all blocks keyed by their region.
     *
     * @return array
     *   An associative array keyed by region, containing an associative array of
     *   block plugins.
     */
    public function getAllByRegion() {
        $region_assignments = [];
        foreach ($this as $block_id => $block) {
            $configuration = $block->getConfiguration();
            $region = $configuration['region'] ?? NULL;
            $region_assignments[$region][$block_id] = $block;
        }
        foreach ($region_assignments as $region => $region_assignment) {
            // @todo Determine the reason this needs error suppression.
            @uasort($region_assignment, function (BlockPluginInterface $a, BlockPluginInterface $b) {
                $a_config = $a->getConfiguration();
                $a_weight = $a_config['weight'] ?? 0;
                $b_config = $b->getConfiguration();
                $b_weight = $b_config['weight'] ?? 0;
                if ($a_weight == $b_weight) {
                    return strcmp($a->label(), $b->label());
                }
                return $a_weight > $b_weight ? 1 : -1;
            });
            $region_assignments[$region] = $region_assignment;
        }
        return $region_assignments;
    }

}

Members

Title Modifiers Object type Summary Overriden Title Overrides
BlockPluginCollection::get public function Overrides LazyPluginCollection::get
BlockPluginCollection::getAllByRegion public function Returns all blocks keyed by their region.
DefaultLazyPluginCollection::$configurations protected property The initial configuration for each plugin in the collection.
DefaultLazyPluginCollection::$manager protected property The manager used to instantiate the plugins.
DefaultLazyPluginCollection::$originalOrder protected property The original order of the instances.
DefaultLazyPluginCollection::$pluginKey protected property The key within the plugin configuration that contains the plugin ID. 3
DefaultLazyPluginCollection::addInstanceId public function Adds an instance ID to the available instance IDs. Overrides LazyPluginCollection::addInstanceId
DefaultLazyPluginCollection::getConfiguration public function Gets the current configuration of all plugins in this collection. Overrides LazyPluginCollection::getConfiguration 2
DefaultLazyPluginCollection::initializePlugin protected function Initializes and stores a plugin. Overrides LazyPluginCollection::initializePlugin 2
DefaultLazyPluginCollection::removeInstanceId public function Removes an instance ID. Overrides LazyPluginCollection::removeInstanceId
DefaultLazyPluginCollection::setConfiguration public function Sets the configuration for all plugins in this collection. Overrides LazyPluginCollection::setConfiguration
DefaultLazyPluginCollection::setInstanceConfiguration public function Updates the configuration for a plugin instance.
DefaultLazyPluginCollection::sort public function Sorts all plugin instances in this collection. 1
DefaultLazyPluginCollection::sortHelper public function Provides uasort() callback to sort plugins. 2
DefaultLazyPluginCollection::__construct public function Constructs a new DefaultLazyPluginCollection object. 1
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
LazyPluginCollection::$instanceIds protected property Stores the IDs of all potential plugin instances.
LazyPluginCollection::$pluginInstances protected property Stores all instantiated plugins.
LazyPluginCollection::clear public function Clears all instantiated plugins. 1
LazyPluginCollection::count public function
LazyPluginCollection::getInstanceIds public function Gets all instance IDs.
LazyPluginCollection::getIterator public function
LazyPluginCollection::has public function Determines if a plugin instance exists.
LazyPluginCollection::remove public function Removes an initialized plugin. 1
LazyPluginCollection::set public function Stores an initialized plugin.