class ReactionRuleConfig in Rules 8.3
Reaction rule configuration entity to persistently store configuration.
Plugin annotation
@ConfigEntityType(
id = "rules_reaction_rule",
label = @Translation("Reaction Rule"),
label_collection = @Translation("Reaction Rules"),
label_singular = @Translation("reaction rule"),
label_plural = @Translation("reaction rules"),
label_count = @PluralTranslation(
singular = "@count reaction rule",
plural = "@count reaction rules",
),
handlers = {
"storage" = "Drupal\rules\Entity\ReactionRuleStorage",
"list_builder" = "Drupal\rules\Controller\RulesReactionListBuilder",
"form" = {
"add" = "\Drupal\rules\Form\ReactionRuleAddForm",
"edit" = "\Drupal\rules\Form\ReactionRuleEditForm",
"delete" = "\Drupal\Core\Entity\EntityDeleteForm",
},
},
admin_permission = "administer rules",
config_prefix = "reaction",
entity_keys = {
"id" = "id",
"label" = "label",
"status" = "status",
},
config_export = {
"id",
"label",
"events",
"description",
"tags",
"config_version",
"expression",
},
links = {
"collection" = "/admin/config/workflow/rules",
"edit-form" = "/admin/config/workflow/rules/reactions/edit/{rules_reaction_rule}",
"delete-form" = "/admin/config/workflow/rules/reactions/delete/{rules_reaction_rule}",
"enable" = "/admin/config/workflow/rules/reactions/enable/{rules_reaction_rule}",
"disable" = "/admin/config/workflow/rules/reactions/disable/{rules_reaction_rule}",
"break-lock-form" = "/admin/config/workflow/rules/reactions/edit/break-lock/{rules_reaction_rule}",
}
)
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
- class \Drupal\rules\Entity\ReactionRuleConfig implements RulesUiComponentProviderInterface
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
Expanded class hierarchy of ReactionRuleConfig
2 files declare their use of ReactionRuleConfig
- rules.install in ./
rules.install - Install, update and uninstall functions for the Rules module.
- RulesReactionController.php in src/
Controller/ RulesReactionController.php
File
- src/
Entity/ ReactionRuleConfig.php, line 59
Namespace
Drupal\rules\EntityView source
class ReactionRuleConfig extends ConfigEntityBase implements RulesUiComponentProviderInterface {
/**
* The unique ID of the Reaction Rule.
*
* @var string
*/
public $id = NULL;
/**
* The label of the Reaction rule.
*
* @var string
*/
protected $label;
/**
* The description of the rule, which is used only in the user interface.
*
* @var string
*/
protected $description = '';
/**
* The "tags" of a Reaction rule.
*
* @var string[]
*/
protected $tags = [];
/**
* The version the Reaction rule was created for.
*
* @var int
*/
protected $config_version = Rules::CONFIG_VERSION;
/**
* The expression plugin specific configuration as nested array.
*
* @var array
*/
protected $expression = [
'id' => 'rules_rule',
];
/**
* Stores a reference to the executable expression version of this component.
*
* @var \Drupal\rules\Engine\ExpressionInterface
*/
protected $expressionObject;
/**
* The events this reaction rule is reacting on.
*
* Events array. The array is numerically indexed and contains arrays with the
* following structure:
* - event_name: String with the event machine name.
* - configuration: An array containing the event configuration.
*
* @var array
*/
protected $events = [];
/**
* Sets a Rules expression instance for this Reaction rule.
*
* @param \Drupal\rules\Engine\ExpressionInterface $expression
* The expression to set.
*
* @return $this
*/
public function setExpression(ExpressionInterface $expression) {
$this->expressionObject = $expression;
$this->expression = $expression
->getConfiguration();
return $this;
}
/**
* Gets a Rules expression instance for this Reaction rule.
*
* @return \Drupal\rules\Engine\ExpressionInterface
* A Rules expression instance.
*/
public function getExpression() {
// Ensure that an executable Rules expression is available.
if (!isset($this->expressionObject)) {
$this->expressionObject = $this
->getExpressionManager()
->createInstance($this->expression['id'], $this->expression);
}
return $this->expressionObject;
}
/**
* {@inheritdoc}
*
* Gets the Rules component that is invoked when the events are dispatched.
* The returned component has the definitions of the available event context
* set.
*/
public function getComponent() {
$component = RulesComponent::create($this
->getExpression());
$component
->addContextDefinitionsForEvents($this
->getEventNames());
return $component;
}
/**
* {@inheritdoc}
*/
public function updateFromComponent(RulesComponent $component) {
// Note that the available context definitions stem from the configured
// events, which are handled separately.
$this
->setExpression($component
->getExpression());
return $this;
}
/**
* Returns the Rules expression manager.
*
* @todo Actually we should use dependency injection here, but is that even
* possible with config entities? How?
*
* @return \Drupal\rules\Engine\ExpressionManager
* The Rules expression manager.
*/
protected function getExpressionManager() {
return \Drupal::service('plugin.manager.rules_expression');
}
/**
* {@inheritdoc}
*/
public function createDuplicate() {
$duplicate = parent::createDuplicate();
unset($duplicate->expressionObject);
return $duplicate;
}
/**
* Overrides \Drupal\Core\Entity\Entity::label().
*
* When a certain component does not have a label return the ID.
*/
public function label() {
if (!($label = $this
->get('label'))) {
$label = $this
->id();
}
return $label;
}
/**
* Returns the description.
*/
public function getDescription() {
return $this->description;
}
/**
* Checks if there are tags associated with this config.
*
* @return bool
* TRUE if the config has tags.
*/
public function hasTags() {
return !empty($this->tags);
}
/**
* Returns the tags associated with this config.
*
* @return string[]
* The numerically indexed array of tag names.
*/
public function getTags() {
return $this->tags;
}
/**
* Gets configuration of all events the rule is reacting on.
*
* @return array
* The events array. The array is numerically indexed and contains arrays
* with the following structure:
* - event_name: String with the event machine name.
* - configuration: An array containing the event configuration.
*/
public function getEvents() {
return $this->events;
}
/**
* Gets machine names of all events the rule is reacting on.
*
* @return string[]
* The array of fully qualified event names of the rule.
*/
public function getEventNames() {
$names = [];
foreach ($this->events as $event) {
$names[] = $event['event_name'];
}
return $names;
}
/**
* {@inheritdoc}
*/
public function calculateDependencies() {
parent::calculateDependencies();
$this
->addDependencies($this
->getComponent()
->calculateDependencies());
return $this->dependencies;
}
/**
* Magic clone method.
*/
public function __clone() {
// Remove the reference to the expression object in the clone so that the
// expression object tree is created from scratch.
unset($this->expressionObject);
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CacheableDependencyTrait:: |
protected | property | Cache contexts. | |
CacheableDependencyTrait:: |
protected | property | Cache max-age. | |
CacheableDependencyTrait:: |
protected | property | Cache tags. | |
CacheableDependencyTrait:: |
protected | function | Sets cacheability; useful for value object constructors. | |
ConfigEntityBase:: |
private | property | Whether the config is being deleted by the uninstall process. | |
ConfigEntityBase:: |
protected | property | The language code of the entity's default language. | |
ConfigEntityBase:: |
protected | property | The original ID of the configuration entity. | |
ConfigEntityBase:: |
protected | property | The enabled/disabled status of the configuration entity. | 4 |
ConfigEntityBase:: |
protected | property | Third party entity settings. | |
ConfigEntityBase:: |
protected | property | Trust supplied data and not use configuration schema on save. | |
ConfigEntityBase:: |
protected | property | The UUID for this entity. | |
ConfigEntityBase:: |
protected | property | Information maintained by Drupal core about configuration. | |
ConfigEntityBase:: |
protected | function | Overrides \Drupal\Core\Entity\DependencyTrait:addDependency(). | |
ConfigEntityBase:: |
public | function |
Disables the configuration entity. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Enables the configuration entity. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns the value of a property. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns the cache tags that should be used to invalidate caches. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Gets the configuration dependency name. Overrides EntityBase:: |
|
ConfigEntityBase:: |
protected static | function | Gets the configuration manager. | |
ConfigEntityBase:: |
public | function |
Gets the configuration target identifier for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the configuration dependencies. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the original ID. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the list of third parties that store information. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets all third-party settings of a given module. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
protected | function | Gets the typed config manager. | |
ConfigEntityBase:: |
public | function |
Gets whether on not the data is trusted. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
protected static | function |
Override to never invalidate the individual entities' cache tags; the
config system already invalidates them. Overrides EntityBase:: |
|
ConfigEntityBase:: |
protected | function |
Override to never invalidate the entity's cache tag; the config system
already invalidates it. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Checks whether this entity is installable. Overrides ConfigEntityInterface:: |
2 |
ConfigEntityBase:: |
public | function |
Overrides Entity::isNew(). Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Returns whether this entity is being changed during the uninstall process. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Deprecated way of generating a link to the entity. See toLink(). Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Informs the entity that entities it depends on will be deleted. Overrides ConfigEntityInterface:: |
7 |
ConfigEntityBase:: |
public static | function |
Acts on entities before they are deleted and before hooks are invoked. Overrides EntityBase:: |
8 |
ConfigEntityBase:: |
public | function |
Acts on an entity before the presave hook is invoked. Overrides EntityBase:: |
13 |
ConfigEntityBase:: |
public | function |
Saves an entity permanently. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Sets the value of a property. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Sets the original ID. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Sets the status of the configuration entity. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Sets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function | ||
ConfigEntityBase:: |
public static | function | Helper callback for uasort() to sort configuration entities by weight and label. | 6 |
ConfigEntityBase:: |
public | function |
Returns whether the configuration entity is enabled. Overrides ConfigEntityInterface:: |
4 |
ConfigEntityBase:: |
public | function |
Gets an array of all property values. Overrides EntityBase:: |
2 |
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Sets that the data should be trusted. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Unsets a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the public URL for this entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Constructs an Entity object. Overrides EntityBase:: |
10 |
ConfigEntityBase:: |
public | function |
Overrides EntityBase:: |
4 |
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | Aliased as: traitSleep | 1 |
DependencySerializationTrait:: |
public | function | 2 | |
DependencyTrait:: |
protected | property | The object's dependencies. | |
DependencyTrait:: |
protected | function | Adds multiple dependencies. | |
DependencyTrait:: |
protected | function | Adds a dependency. Aliased as: addDependencyTrait | |
EntityBase:: |
protected | property | Boolean indicating whether the entity should be forced to be new. | |
EntityBase:: |
protected | property | The entity type. | |
EntityBase:: |
protected | property | A typed data object wrapping this entity. | |
EntityBase:: |
public | function |
Checks data value access. Overrides AccessibleInterface:: |
1 |
EntityBase:: |
public | function |
Gets the bundle of the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
public static | function |
Constructs a new entity object, without permanently saving it. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Deletes an entity permanently. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Enforces an entity to be new. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | Gets the entity manager. | |
EntityBase:: |
protected | function | Gets the entity type bundle info service. | |
EntityBase:: |
protected | function | Gets the entity type manager. | |
EntityBase:: |
public | function |
The cache contexts associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The maximum age for which this object may be cached. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The cache tags associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
Gets the key that is used to store configuration dependencies. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the entity type definition. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the ID of the type of the entity. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | The list cache tags to invalidate for this entity. | |
EntityBase:: |
public | function |
Gets a typed data object for this entity object. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Indicates if a link template exists for a given key. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the identifier. Overrides EntityInterface:: |
11 |
EntityBase:: |
public | function |
Gets the language of the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets the language manager. | |
EntityBase:: |
protected | function | Gets an array link templates. | 1 |
EntityBase:: |
public static | function |
Loads an entity. Overrides EntityInterface:: |
|
EntityBase:: |
public static | function |
Loads one or more entities. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Acts on a created entity before hooks are invoked. Overrides EntityInterface:: |
4 |
EntityBase:: |
public static | function |
Acts on deleted entities before the delete hook is invoked. Overrides EntityInterface:: |
16 |
EntityBase:: |
public static | function |
Acts on loaded entities. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Acts on a saved entity before the insert or update hook is invoked. Overrides EntityInterface:: |
14 |
EntityBase:: |
public static | function |
Changes the values of an entity before it is created. Overrides EntityInterface:: |
5 |
EntityBase:: |
public | function |
Gets a list of entities referenced by this entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Generates the HTML for a link to this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets a list of URI relationships supported by this entity. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | Gets an array of placeholders for this entity. | 2 |
EntityBase:: |
public | function |
Gets the entity UUID (Universally Unique Identifier). Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets the UUID generator. | |
PluginDependencyTrait:: |
protected | function | Calculates and adds dependencies of a specific plugin instance. | 1 |
PluginDependencyTrait:: |
protected | function | Calculates and returns dependencies of a specific plugin instance. | |
PluginDependencyTrait:: |
protected | function | Wraps the module handler. | 1 |
PluginDependencyTrait:: |
protected | function | Wraps the theme handler. | 1 |
ReactionRuleConfig:: |
protected | property | The version the Reaction rule was created for. | |
ReactionRuleConfig:: |
protected | property | The description of the rule, which is used only in the user interface. | |
ReactionRuleConfig:: |
protected | property | The events this reaction rule is reacting on. | |
ReactionRuleConfig:: |
protected | property | The expression plugin specific configuration as nested array. | |
ReactionRuleConfig:: |
protected | property | Stores a reference to the executable expression version of this component. | |
ReactionRuleConfig:: |
public | property | The unique ID of the Reaction Rule. | |
ReactionRuleConfig:: |
protected | property | The label of the Reaction rule. | |
ReactionRuleConfig:: |
protected | property | The "tags" of a Reaction rule. | |
ReactionRuleConfig:: |
public | function |
Calculates dependencies and stores them in the dependency property. Overrides ConfigEntityBase:: |
|
ReactionRuleConfig:: |
public | function |
Creates a duplicate of the entity. Overrides ConfigEntityBase:: |
|
ReactionRuleConfig:: |
public | function |
Gets the Rules component that is invoked when the events are dispatched.
The returned component has the definitions of the available event context
set. Overrides RulesUiComponentProviderInterface:: |
|
ReactionRuleConfig:: |
public | function | Returns the description. | |
ReactionRuleConfig:: |
public | function | Gets machine names of all events the rule is reacting on. | |
ReactionRuleConfig:: |
public | function | Gets configuration of all events the rule is reacting on. | |
ReactionRuleConfig:: |
public | function | Gets a Rules expression instance for this Reaction rule. | |
ReactionRuleConfig:: |
protected | function | Returns the Rules expression manager. | |
ReactionRuleConfig:: |
public | function | Returns the tags associated with this config. | |
ReactionRuleConfig:: |
public | function | Checks if there are tags associated with this config. | |
ReactionRuleConfig:: |
public | function |
Overrides \Drupal\Core\Entity\Entity::label(). Overrides EntityBase:: |
|
ReactionRuleConfig:: |
public | function | Sets a Rules expression instance for this Reaction rule. | |
ReactionRuleConfig:: |
public | function |
Updates the configuration based upon the given component. Overrides RulesUiComponentProviderInterface:: |
|
ReactionRuleConfig:: |
public | function | Magic clone method. | |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
protected | property | Whether this entity is being created, updated or deleted through a synchronization process. | |
SynchronizableEntityTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
public | function |