ConditionPluginCollection.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/Condition/ConditionPluginCollection.php
  2. 8.9.x core/lib/Drupal/Core/Condition/ConditionPluginCollection.php
  3. 11.x core/lib/Drupal/Core/Condition/ConditionPluginCollection.php

Namespace

Drupal\Core\Condition

File

core/lib/Drupal/Core/Condition/ConditionPluginCollection.php

View source
<?php

namespace Drupal\Core\Condition;

use Drupal\Component\Plugin\Context\ContextInterface;
use Drupal\Core\Plugin\DefaultLazyPluginCollection;

/**
 * Provides a collection of condition plugins.
 */
class ConditionPluginCollection extends DefaultLazyPluginCollection {
    
    /**
     * An array of collected contexts for conditions.
     *
     * @var \Drupal\Component\Plugin\Context\ContextInterface[]
     */
    protected $conditionContexts = [];
    
    /**
     * {@inheritdoc}
     *
     * @return \Drupal\Core\Condition\ConditionInterface
     */
    public function &get($instance_id) {
        return parent::get($instance_id);
    }
    
    /**
     * {@inheritdoc}
     */
    public function getConfiguration() {
        $configuration = parent::getConfiguration();
        // Remove configuration if it matches the defaults.
        foreach ($configuration as $instance_id => $instance_config) {
            $default_config = [];
            $default_config['id'] = $instance_id;
            $default_config += $this->get($instance_id)
                ->defaultConfiguration();
            // In order to determine if a plugin is configured, we must compare it to
            // its default configuration. The default configuration of a plugin does
            // not contain context_mapping and it is not used when the plugin is not
            // configured, so remove the context_mapping from the instance config to
            // compare the remaining values.
            unset($instance_config['context_mapping']);
            ksort($default_config);
            ksort($instance_config);
            // With PHP 8 type juggling, there should not be an issue using equal
            // operator instead of identical operator. Allowing looser comparison here
            // will prevent configuration from being erroneously exported when values
            // are updated via form elements that return values of the wrong type, for
            // example, '0'/'1' vs FALSE/TRUE.
            if ($default_config == $instance_config) {
                unset($configuration[$instance_id]);
            }
        }
        return $configuration;
    }
    
    /**
     * Sets the condition context for a given name.
     *
     * @param string $name
     *   The name of the context.
     * @param \Drupal\Component\Plugin\Context\ContextInterface $context
     *   The context to add.
     *
     * @return $this
     */
    public function addContext($name, ContextInterface $context) {
        $this->conditionContexts[$name] = $context;
        return $this;
    }
    
    /**
     * Gets the values for all defined contexts.
     *
     * @return \Drupal\Component\Plugin\Context\ContextInterface[]
     *   An array of set contexts, keyed by context name.
     */
    public function getConditionContexts() {
        return $this->conditionContexts;
    }

}

Classes

Title Deprecated Summary
ConditionPluginCollection Provides a collection of condition plugins.

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