class ConfigCollectionEvents

Same name in other branches
  1. 11.x core/lib/Drupal/Core/Config/ConfigCollectionEvents.php \Drupal\Core\Config\ConfigCollectionEvents

Defines events for working with configuration collections.

Configuration collections are often used to store configuration-related data, like overrides. The use case is determined by the module that provides the collection. A classic example is to store the translated parts of various configuration objects. Using a collection allows this data to be imported and exported alongside regular configuration. It also allows the data to be created when installing an extension. In both the import/export and extension installation situations, collection data is stored in subdirectories.

Hierarchy

Expanded class hierarchy of ConfigCollectionEvents

See also

\Drupal\Core\Config\ConfigCrudEvent

8 files declare their use of ConfigCollectionEvents
CheckpointStorage.php in core/lib/Drupal/Core/Config/Checkpoint/CheckpointStorage.php
ConfigImporterTest.php in core/tests/Drupal/KernelTests/Core/Config/ConfigImporterTest.php
ConfigInstallTest.php in core/tests/Drupal/KernelTests/Core/Config/ConfigInstallTest.php
EventSubscriber.php in core/modules/config/tests/config_collection_install_test/src/EventSubscriber.php
EventSubscriber.php in core/modules/config/tests/config_events_test/src/EventSubscriber.php

... See full list

File

core/lib/Drupal/Core/Config/ConfigCollectionEvents.php, line 19

Namespace

Drupal\Core\Config
View source 
final class ConfigCollectionEvents {
    
    /**
     * Event dispatched when saving configuration not in the default collection.
     *
     * This event allows modules to react whenever an object that extends
     * \Drupal\Core\Config\StorableConfigBase is saved in a non-default
     * collection. The event listener method receives a
     * \Drupal\Core\Config\ConfigCrudEvent instance.
     *
     * Note: this event is not used for configuration in the default collection.
     * See \Drupal\Core\Config\ConfigEvents::SAVE instead.
     *
     * @Event
     *
     * @var string
     *
     * @see \Drupal\Core\Config\ConfigCrudEvent
     * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
     * @see \Drupal\language\Config\LanguageConfigOverride::save()
     *
     * @see \Drupal\Core\Config\ConfigEvents::SAVE
     */
    const SAVE_IN_COLLECTION = 'config.save.collection';
    
    /**
     * Event dispatched when deleting configuration not in the default collection.
     *
     * This event allows modules to react whenever an object that extends
     * \Drupal\Core\Config\StorableConfigBase is deleted in a non-default
     * collection. The event listener method receives a
     * \Drupal\Core\Config\ConfigCrudEvent instance.
     *
     * Note: this event is not used for configuration in the default collection.
     * See \Drupal\Core\Config\ConfigEvents::DELETE instead.
     *
     * @Event
     *
     * @see \Drupal\Core\Config\ConfigEvents::DELETE
     * @see \Drupal\Core\Config\ConfigCrudEvent
     * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
     * @see \Drupal\language\Config\LanguageConfigOverride::delete()
     *
     * @var string
     */
    const DELETE_IN_COLLECTION = 'config.delete.collection';
    
    /**
     * Event dispatched when renaming configuration not in the default collection.
     *
     * This event allows modules to react whenever an object that extends
     * \Drupal\Core\Config\StorableConfigBase is renamed in a non-default
     * collection. The event listener method receives a
     * \Drupal\Core\Config\ConfigCrudEvent instance.
     *
     * Note: this event is not used for configuration in the default collection.
     * See \Drupal\Core\Config\ConfigEvents::RENAME instead.
     *
     * @Event
     *
     * @see \Drupal\Core\Config\ConfigEvents::RENAME
     * @see \Drupal\Core\Config\ConfigCrudEvent
     * @see \Drupal\Core\Config\ConfigFactoryOverrideInterface::createConfigObject()
     *
     * @var string
     */
    const RENAME_IN_COLLECTION = 'config.rename.collection';
    
    /**
     * Event dispatched to collect information on all config collections.
     *
     * This event allows modules to add to the list of configuration collections
     * retrieved by \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo().
     * The event listener method receives a
     * \Drupal\Core\Config\ConfigCollectionInfo instance.
     *
     * @Event
     *
     * @see \Drupal\Core\Config\ConfigCollectionInfo
     * @see \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo()
     * @see \Drupal\Core\Config\ConfigFactoryOverrideBase
     *
     * @var string
     */
    const COLLECTION_INFO = 'config.collection_info';

}

Members

Title Modifiers Object type Summary
ConfigCollectionEvents::COLLECTION_INFO constant Event dispatched to collect information on all config collections.
ConfigCollectionEvents::DELETE_IN_COLLECTION constant Event dispatched when deleting configuration not in the default collection.
ConfigCollectionEvents::RENAME_IN_COLLECTION constant Event dispatched when renaming configuration not in the default collection.
ConfigCollectionEvents::SAVE_IN_COLLECTION constant Event dispatched when saving configuration not in the default collection.

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