class BlockDisplayVariant
Same name in this branch
- 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
- 8.x-3.x src/Plugin/DisplayVariant/BlockDisplayVariant.php \Drupal\ctools\Plugin\DisplayVariant\BlockDisplayVariant
- 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
- class \Drupal\Component\Plugin\PluginBase implements \Drupal\Component\Plugin\PluginInspectionInterface, \Drupal\Component\Plugin\DerivativeInspectionInterface
- class \Drupal\Core\Plugin\PluginBase extends \Drupal\Component\Plugin\PluginBase uses \Drupal\Core\StringTranslation\StringTranslationTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait, \Drupal\Core\Messenger\MessengerTrait
- class \Drupal\Core\Display\VariantBase extends \Drupal\Core\Plugin\PluginBase implements \Drupal\Core\Display\VariantInterface uses \Drupal\Core\Plugin\PluginDependencyTrait, \Drupal\Core\Cache\RefinableCacheableDependencyTrait
- class \Drupal\ctools\Plugin\DisplayVariant\BlockDisplayVariant extends \Drupal\Core\Display\VariantBase implements \Drupal\Core\Display\ContextAwareVariantInterface, \Drupal\Core\Plugin\ContainerFactoryPluginInterface, \Drupal\ctools\Plugin\BlockVariantInterface uses \Drupal\ctools\Form\AjaxFormTrait, \Drupal\ctools\Plugin\BlockVariantTrait
- class \Drupal\Core\Display\VariantBase extends \Drupal\Core\Plugin\PluginBase implements \Drupal\Core\Display\VariantInterface uses \Drupal\Core\Plugin\PluginDependencyTrait, \Drupal\Core\Cache\RefinableCacheableDependencyTrait
- class \Drupal\Core\Plugin\PluginBase extends \Drupal\Component\Plugin\PluginBase uses \Drupal\Core\StringTranslation\StringTranslationTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait, \Drupal\Core\Messenger\MessengerTrait
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\DisplayVariantView 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 |