class BlockDisplayVariant

Same name in this branch
  1. 4.0.x tests/modules/ctools_block_display_test/src/Plugin/DisplayVariant/BlockDisplayVariant.php \Drupal\ctools_block_display_test\Plugin\DisplayVariant\BlockDisplayVariant
Same name in other branches
  1. 8.x-3.x src/Plugin/DisplayVariant/BlockDisplayVariant.php \Drupal\ctools\Plugin\DisplayVariant\BlockDisplayVariant
  2. 8.x-3.x tests/modules/ctools_block_display_test/src/Plugin/DisplayVariant/BlockDisplayVariant.php \Drupal\ctools_block_display_test\Plugin\DisplayVariant\BlockDisplayVariant

Provides a base class for a display variant that simply contains blocks.

Hierarchy

Expanded class hierarchy of BlockDisplayVariant

2 files declare their use of BlockDisplayVariant
BlockDisplayVariant.php in tests/modules/ctools_block_display_test/src/Plugin/DisplayVariant/BlockDisplayVariant.php
BlockDisplayVariantTest.php in tests/src/Unit/BlockDisplayVariantTest.php

File

src/Plugin/DisplayVariant/BlockDisplayVariant.php, line 22

Namespace

Drupal\ctools\Plugin\DisplayVariant
View source
abstract class BlockDisplayVariant extends VariantBase implements ContextAwareVariantInterface, ContainerFactoryPluginInterface, BlockVariantInterface {
    use AjaxFormTrait;
    use BlockVariantTrait;
    
    /**
     * The context handler.
     *
     * @var \Drupal\Core\Plugin\Context\ContextHandlerInterface
     */
    protected $contextHandler;
    
    /**
     * The UUID generator.
     *
     * @var \Drupal\Component\Uuid\UuidInterface
     */
    protected $uuidGenerator;
    
    /**
     * The current user.
     *
     * @var \Drupal\Core\Session\AccountInterface
     */
    protected $account;
    
    /**
     * The token service.
     *
     * @var \Drupal\Core\Utility\Token
     */
    protected $token;
    
    /**
     * An array of collected contexts.
     *
     * This is only used on runtime, and is not stored.
     *
     * @var \Drupal\Component\Plugin\Context\ContextInterface[]
     */
    protected $contexts = [];
    
    /**
     * Constructs a new BlockDisplayVariant.
     *
     * @param array $configuration
     *   A configuration array containing information about the plugin instance.
     * @param string $plugin_id
     *   The plugin ID for the plugin instance.
     * @param mixed $plugin_definition
     *   The plugin implementation definition.
     * @param \Drupal\Core\Plugin\Context\ContextHandlerInterface $context_handler
     *   The context handler.
     * @param \Drupal\Core\Session\AccountInterface $account
     *   The current user.
     * @param \Drupal\Component\Uuid\UuidInterface $uuid_generator
     *   The UUID generator.
     * @param \Drupal\Core\Utility\Token $token
     *   The token service.
     * @param \Drupal\Core\Block\BlockManagerInterface $block_manager
     *   The block manager.
     * @param \Drupal\Core\Condition\ConditionManager $condition_manager
     *   The condition manager.
     */
    public function __construct(array $configuration, $plugin_id, $plugin_definition, ContextHandlerInterface $context_handler, AccountInterface $account, UuidInterface $uuid_generator, Token $token, BlockManagerInterface $block_manager, ConditionManager $condition_manager) {
        // Inject dependencies as early as possible, so they can be used in
        // configuration.
        $this->contextHandler = $context_handler;
        $this->account = $account;
        $this->uuidGenerator = $uuid_generator;
        $this->token = $token;
        $this->blockManager = $block_manager;
        $this->conditionManager = $condition_manager;
        parent::__construct($configuration, $plugin_id, $plugin_definition);
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
        return new static($configuration, $plugin_id, $plugin_definition, $container->get('context.handler'), $container->get('current_user'), $container->get('uuid'), $container->get('token'), $container->get('plugin.manager.block'), $container->get('plugin.manager.condition'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function defaultConfiguration() {
        return parent::defaultConfiguration() + [
            'blocks' => [],
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function calculateDependencies() {
        foreach ($this->getBlockCollection() as $instance) {
            $this->calculatePluginDependencies($instance);
        }
        return $this->dependencies;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getConfiguration() {
        return [
            'blocks' => $this->getBlockCollection()
                ->getConfiguration(),
        ] + parent::getConfiguration();
    }
    
    /**
     * {@inheritdoc}
     */
    public function setConfiguration(array $configuration) {
        // Preserve the uuid.
        if ($this->configuration && !empty($this->configuration['uuid'])) {
            $configuration['uuid'] = $this->configuration['uuid'];
        }
        parent::setConfiguration($configuration);
        $this->getBlockCollection()
            ->setConfiguration($this->configuration['blocks']);
        return $this;
    }
    
    /**
     * Gets the contexts.
     *
     * @return \Drupal\Component\Plugin\Context\ContextInterface[]
     *   An array of set contexts, keyed by context name.
     */
    public function getContexts() {
        return $this->contexts;
    }
    
    /**
     * Sets the contexts.
     *
     * @param \Drupal\Component\Plugin\Context\ContextInterface[] $contexts
     *   An array of contexts, keyed by context name.
     *
     * @return $this
     */
    public function setContexts(array $contexts) {
        $this->contexts = $contexts;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function contextHandler() {
        return $this->contextHandler;
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getBlockConfig() {
        return $this->configuration['blocks'];
    }
    
    /**
     * {@inheritdoc}
     */
    protected function uuidGenerator() {
        return $this->uuidGenerator;
    }
    
    /**
     * {@inheritdoc}
     */
    public function __sleep() {
        $vars = parent::__sleep();
        // Gathered contexts objects should not be serialized.
        if (($key = array_search('contexts', $vars)) !== FALSE) {
            unset($vars[$key]);
        }
        // The block plugin collection should also not be serialized, ensure that
        // configuration is synced back.
        if (($key = array_search('blockPluginCollection', $vars)) !== FALSE) {
            if ($this->blockPluginCollection) {
                $this->configuration['blocks'] = $this->blockPluginCollection
                    ->getConfiguration();
            }
            unset($vars[$key]);
        }
        return $vars;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
AjaxFormTrait::getAjaxAttributes public static function Gets attributes for use with an AJAX modal.
AjaxFormTrait::getAjaxButtonAttributes public static function Gets attributes for use with an add button AJAX modal.
BlockDisplayVariant::$account protected property The current user.
BlockDisplayVariant::$contextHandler protected property The context handler.
BlockDisplayVariant::$contexts protected property An array of collected contexts.
BlockDisplayVariant::$token protected property The token service.
BlockDisplayVariant::$uuidGenerator protected property The UUID generator.
BlockDisplayVariant::calculateDependencies public function Calculates dependencies for the configured plugin. Overrides VariantBase::calculateDependencies
BlockDisplayVariant::contextHandler protected function
BlockDisplayVariant::create public static function Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface::create
BlockDisplayVariant::defaultConfiguration public function Gets default configuration for this plugin. Overrides VariantBase::defaultConfiguration
BlockDisplayVariant::getBlockConfig protected function Returns the configuration for stored blocks. Overrides BlockVariantTrait::getBlockConfig
BlockDisplayVariant::getConfiguration public function Gets this plugin's configuration. Overrides VariantBase::getConfiguration
BlockDisplayVariant::getContexts public function Gets the contexts. Overrides ContextAwareVariantInterface::getContexts
BlockDisplayVariant::setConfiguration public function Sets the configuration for this plugin instance. Overrides VariantBase::setConfiguration
BlockDisplayVariant::setContexts public function Sets the contexts. Overrides ContextAwareVariantInterface::setContexts
BlockDisplayVariant::uuidGenerator protected function Returns the UUID generator. Overrides BlockVariantTrait::uuidGenerator
BlockDisplayVariant::__construct public function Constructs a new BlockDisplayVariant. Overrides VariantBase::__construct
BlockDisplayVariant::__sleep public function
BlockVariantTrait::$blockManager protected property The block manager.
BlockVariantTrait::$blockPluginCollection protected property The plugin collection that holds the block plugins.
BlockVariantTrait::$eventDispatcher protected property The event dispatcher.
BlockVariantTrait::addBlock public function
BlockVariantTrait::eventDispatcher protected function Gets the event dispatcher.
BlockVariantTrait::getBlock public function
BlockVariantTrait::getBlockCollection protected function Returns the block plugins used for this display variant.
BlockVariantTrait::getBlockManager protected function Gets the block plugin manager.
BlockVariantTrait::getRegionAssignment public function
BlockVariantTrait::getRegionAssignments public function
BlockVariantTrait::getRegionName public function
BlockVariantTrait::getRegionNames abstract public function 2
BlockVariantTrait::removeBlock public function
BlockVariantTrait::updateBlock public function
CacheableDependencyTrait::$cacheContexts protected property Cache contexts.
CacheableDependencyTrait::$cacheMaxAge protected property Cache max-age.
CacheableDependencyTrait::$cacheTags protected property Cache tags.
CacheableDependencyTrait::getCacheContexts public function 4
CacheableDependencyTrait::getCacheMaxAge public function 4
CacheableDependencyTrait::getCacheTags public function 4
CacheableDependencyTrait::setCacheability protected function Sets cacheability; useful for value object constructors.
DependencyTrait::$dependencies protected property The object's dependencies.
DependencyTrait::addDependencies protected function Adds multiple dependencies.
DependencyTrait::addDependency protected function Adds a dependency.
PluginDependencyTrait::calculatePluginDependencies protected function Calculates and adds dependencies of a specific plugin instance. 1
PluginDependencyTrait::getPluginDependencies protected function Calculates and returns dependencies of a specific plugin instance.
PluginDependencyTrait::moduleHandler protected function Wraps the module handler. 1
PluginDependencyTrait::themeHandler protected function Wraps the theme handler. 1
PluginInspectionInterface::getPluginDefinition public function Gets the definition of the plugin implementation. 6
PluginInspectionInterface::getPluginId public function Gets the plugin ID of the plugin instance. 2
RefinableCacheableDependencyTrait::addCacheableDependency public function 1
RefinableCacheableDependencyTrait::addCacheContexts public function
RefinableCacheableDependencyTrait::addCacheTags public function
RefinableCacheableDependencyTrait::mergeCacheMaxAge public function
VariantBase::access public function Determines if this display variant is accessible. Overrides VariantInterface::access
VariantBase::adminLabel public function Returns the admin-facing display variant label. Overrides VariantInterface::adminLabel
VariantBase::buildConfigurationForm public function Form constructor. Overrides PluginFormInterface::buildConfigurationForm
VariantBase::getWeight public function Returns the weight of the display variant. Overrides VariantInterface::getWeight
VariantBase::id public function Returns the unique ID for the display variant. Overrides VariantInterface::id
VariantBase::label public function Returns the user-facing display variant label. Overrides VariantInterface::label
VariantBase::setWeight public function Sets the weight of the display variant. Overrides VariantInterface::setWeight
VariantBase::submitConfigurationForm public function Form submission handler. Overrides PluginFormInterface::submitConfigurationForm
VariantBase::validateConfigurationForm public function Form validation handler. Overrides PluginFormInterface::validateConfigurationForm
VariantInterface::build public function Builds and returns the renderable array for the display variant. 3