Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\block;
Chris@0: 
Chris@0: use Drupal\Component\Plugin\Exception\PluginException;
Chris@0: use Drupal\Component\Plugin\PluginManagerInterface;
Chris@0: use Drupal\Core\Plugin\DefaultSingleLazyPluginCollection;
Chris@0: 
Chris@0: /**
Chris@0:  * Provides a collection of block plugins.
Chris@0:  */
Chris@0: class BlockPluginCollection extends DefaultSingleLazyPluginCollection {
Chris@0: 
Chris@0:   /**
Chris@0:    * The block ID this plugin collection belongs to.
Chris@0:    *
Chris@0:    * @var string
Chris@0:    */
Chris@0:   protected $blockId;
Chris@0: 
Chris@0:   /**
Chris@0:    * Constructs a new BlockPluginCollection.
Chris@0:    *
Chris@0:    * @param \Drupal\Component\Plugin\PluginManagerInterface $manager
Chris@0:    *   The manager to be used for instantiating plugins.
Chris@0:    * @param string $instance_id
Chris@0:    *   The ID of the plugin instance.
Chris@0:    * @param array $configuration
Chris@0:    *   An array of configuration.
Chris@0:    * @param string $block_id
Chris@0:    *   The unique ID of the block entity using this plugin.
Chris@0:    */
Chris@0:   public function __construct(PluginManagerInterface $manager, $instance_id, array $configuration, $block_id) {
Chris@0:     parent::__construct($manager, $instance_id, $configuration);
Chris@0: 
Chris@0:     $this->blockId = $block_id;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    *
Chris@0:    * @return \Drupal\Core\Block\BlockPluginInterface
Chris@0:    */
Chris@0:   public function &get($instance_id) {
Chris@0:     return parent::get($instance_id);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   protected function initializePlugin($instance_id) {
Chris@0:     if (!$instance_id) {
Chris@0:       throw new PluginException("The block '{$this->blockId}' did not specify a plugin.");
Chris@0:     }
Chris@0: 
Chris@0:     try {
Chris@0:       parent::initializePlugin($instance_id);
Chris@0:     }
Chris@0:     catch (PluginException $e) {
Chris@0:       $module = $this->configuration['provider'];
Chris@0:       // Ignore blocks belonging to uninstalled modules, but re-throw valid
Chris@0:       // exceptions when the module is installed and the plugin is
Chris@0:       // misconfigured.
Chris@0:       if (!$module || \Drupal::moduleHandler()->moduleExists($module)) {
Chris@0:         throw $e;
Chris@0:       }
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0: }