class SmartDateRule in Smart Date 8.2
Same name and namespace in other branches
- 3.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
- 3.0.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
- 3.1.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
- 3.2.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
- 3.3.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
- 3.4.x modules/smart_date_recur/src/Entity/SmartDateRule.php \Drupal\smart_date_recur\Entity\SmartDateRule
Defines the Smart date rule entity.
Plugin annotation
@ContentEntityType(
id = "smart_date_rule",
label = @Translation("Smart date recurring rule"),
handlers = {
"storage" = "Drupal\smart_date_recur\RuleStorage",
"view_builder" = "Drupal\Core\Entity\EntityViewBuilder",
"views_data" = "Drupal\views\EntityViewsData",
"form" = {
"remove" = "Drupal\smart_date_recur\Form\SmartDateRemoveInstanceForm",
}
},
base_table = "smart_date_rule",
data_table = "smart_date_rule_data",
translatable = FALSE,
entity_keys = {
"id" = "rid",
"label" = "rule",
},
links = {
"remove-form" = "/admin/content/smart_date_recur/{smart_date_rule}/instance/remove/{index}",
},
)
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Entity\ContentEntityBase implements \Drupal\Core\Entity\IteratorAggregate, ContentEntityInterface, TranslationStatusInterface uses EntityChangesDetectionTrait, SynchronizableEntityTrait
- class \Drupal\smart_date_recur\Entity\SmartDateRule uses EntityChangedTrait, StringTranslationTrait
- class \Drupal\Core\Entity\ContentEntityBase implements \Drupal\Core\Entity\IteratorAggregate, ContentEntityInterface, TranslationStatusInterface uses EntityChangesDetectionTrait, SynchronizableEntityTrait
Expanded class hierarchy of SmartDateRule
6 files declare their use of SmartDateRule
- Instances.php in modules/
smart_date_recur/ src/ Controller/ Instances.php - RecurRuleUpdate.php in modules/
smart_date_recur/ src/ Plugin/ QueueWorker/ RecurRuleUpdate.php - SmartDateRecurrenceFormatter.php in modules/
smart_date_recur/ src/ Plugin/ Field/ FieldFormatter/ SmartDateRecurrenceFormatter.php - SmartDateRemoveInstanceForm.php in modules/
smart_date_recur/ src/ Form/ SmartDateRemoveInstanceForm.php - SmartDateWidgetBase.php in src/
Plugin/ Field/ FieldWidget/ SmartDateWidgetBase.php
File
- modules/
smart_date_recur/ src/ Entity/ SmartDateRule.php, line 51
Namespace
Drupal\smart_date_recur\EntityView source
class SmartDateRule extends ContentEntityBase {
use EntityChangedTrait;
use StringTranslationTrait;
/**
* The frequency of recurrence.
*
* @var string
*/
protected $freq = '';
/**
* The limit to recurrence.
*
* @var string
*/
protected $limit = '';
/**
* An imploded array of extra parameters, such as increment values.
*
* @var string
*/
protected $parameters = '';
/**
* The assembled rule, as a string.
*
* @var string
*/
protected $rule = '';
/**
* The timestamp for the first instance.
*
* @var int
*/
protected $start = NULL;
/**
* The timezone for the field/rule.
*
* @var string
*/
protected $timezone = NULL;
/**
* {@inheritdoc}
*/
public function getRule() {
return $this
->get('rule')->value;
}
/**
* {@inheritdoc}
*/
public function setRule($rule) {
$this
->set('rule', $rule);
return $this;
}
/**
* {@inheritdoc}
*/
private function makeRuleFromParts() {
$repeat = $this
->get('freq')
->getString();
if (empty($repeat)) {
return FALSE;
}
$rule = new FormattableMarkup('RRULE:FREQ=:freq', [
':freq' => $repeat,
]);
// Processing for extra parameters e.g. INCREMENT, BYMONTHDAY, etc.
$params = $this
->get('parameters')
->getString();
if (!empty($params)) {
$rule .= ';' . $params;
}
// If a limit has been set, add it to the rule definition.
$end = $this
->get('limit')
->getString();
if (!empty($end)) {
$rule .= ';' . $end;
}
$this
->setRule($rule);
return $rule;
}
/**
* Retrieve all overrides created for this rule.
*/
public function getRuleOverrides() {
$result = \Drupal::entityQuery('smart_date_override')
->condition('rrule', $this
->id())
->execute();
$overrides = [];
if ($result && ($overrides_return = SmartDateOverride::loadMultiple($result))) {
foreach ($overrides_return as $override) {
$index = $override->rrule_index
->getString();
$overrides[$index] = $override;
}
}
return $overrides;
}
/**
* Provide a formatted array of instances, with any overrides applied.
*/
public function getRuleInstances($before = NULL, $after = NULL) {
$instances = $this
->makeRuleInstances($before, $after)
->toArray();
$overrides = $this
->getRuleOverrides();
$formatted = [];
foreach ($instances as $instance) {
$index = $instance
->getIndex();
// Check for an override.
if (isset($overrides[$index])) {
// Check for rescheduled, overridden, or cancelled
// and don't use default value.
$override = $overrides[$index];
if ($override->entity_id
->getString()) {
// Overridden, retrieve appropriate entity.
$override_type = 'overridden';
$override = $entity_storage
->load($override['entity_id']);
$field = $override
->get($field_name);
// TODO: drill down and retrieve, replace values.
}
elseif ($override->value
->getString()) {
// Rescheduled, use values from override.
$formatted[$index] = [
'value' => $override->value
->getString(),
'end_value' => $override->end_value
->getString(),
'oid' => $override
->id(),
];
}
else {
// Cancelled.
}
continue;
}
// Use the generated instance as-is.
$formatted[$index] = [
'value' => $instance
->getStart()
->getTimestamp(),
'end_value' => $instance
->getEnd()
->getTimestamp(),
];
}
// Return the assembled array.
return $formatted;
}
/**
* Generate default instances based on rule structure.
*/
public function getNewInstances() {
$month_limit = $this
->getFieldSettings('month_limit');
$before = strtotime('+' . (int) $month_limit . ' months');
$instances = $this
->getStoredInstances();
$last_instance = end($instances);
$new_instances = $this
->makeRuleInstances($before, $last_instance['value']);
return $new_instances;
}
/**
* Helper function to parse instances from storage and return as an array.
*/
public function getStoredInstances() {
$instances = $this->instances
->getValue();
if (is_array($instances)) {
$instances = $instances[0]['data'];
}
return $instances;
}
/**
* Generate default instances based on rule structure.
*/
public function makeRuleInstances($before = NULL, $after = NULL) {
$rrule = $this
->getAssembledRule();
if (empty($rrule)) {
// Required elements missing, so abort.
return FALSE;
}
$constraint = NULL;
if ($before && $after) {
$constraint = new BetweenConstraint(new \DateTime('@' . $after), new \DateTime('@' . $before));
}
elseif ($before) {
$constraint = new BeforeConstraint(new \DateTime('@' . $before));
}
elseif ($after) {
$constraint = new AfterConstraint(new \DateTime('@' . $after));
}
$transformer = new ArrayTransformer();
$instances = $transformer
->transform($rrule, $constraint);
// TODO: Convert the generated instances into an array for later processing.
return $instances;
}
/**
* Retrieve the entity to which the rule is attached.
*/
public function getParentEntity($id_only = FALSE) {
// Retrieve the entity using the rule id.
$rid = $this
->id();
if (empty($rid)) {
return FALSE;
}
$entity_type = $this->entity_type
->getString();
$field_name = $this->field_name
->getString();
$result = \Drupal::entityQuery($entity_type)
->condition($field_name . '.rrule', $rid)
->execute();
$id = array_pop($result);
if ($id_only) {
return $id;
}
$entity_manager = \Drupal::entityTypeManager($entity_type);
$entity_storage = $entity_manager
->getStorage($entity_type);
$entity = $entity_storage
->load($id);
return $entity;
}
/**
* Get the RRule object.
*/
public function getAssembledRule() {
$rule = $this
->makeRuleFromParts();
if (empty($rule)) {
// Required elements missing, so abort.
return FALSE;
}
// TODO: proper timezone handling, allowing for field override.
$tz_string = \Drupal::config('system.date')
->get('timezone')['default'];
$timezone = new \DateTimeZone($tz_string);
$start = new \DateTime('@' . $this
->get('start')
->getString(), $timezone);
$start
->setTimezone($timezone);
$end = new \DateTime('@' . $this
->get('end')
->getString(), $timezone);
$end
->setTimezone($timezone);
$rrule = new Rule($rule, $start, $end);
return $rrule;
}
/**
* Use the transformer to get text output of the rule.
*/
public function getTextRule() {
$freq = $this
->get('freq')
->getString();
$repeat = $freq;
$params = $this
->getParametersArray();
$day_labels = [
'MO' => $this
->t('Monday'),
'TU' => $this
->t('Tuesday'),
'WE' => $this
->t('Wednesday'),
'TH' => $this
->t('Thursday'),
'FR' => $this
->t('Friday'),
'SA' => $this
->t('Saturday'),
'SU' => $this
->t('Sunday'),
];
// Convert the stored repeat value to something human-readable.
if ($params['interval'] && $params['interval'] > 1) {
switch ($repeat) {
case 'DAILY':
$period = $this
->t('days');
break;
case 'WEEKLY':
$period = $this
->t('weeks');
break;
case 'MONTHLY':
$period = $this
->t('months');
break;
case 'YEARLY':
$period = $this
->t('years');
break;
}
$repeat = $this
->t('every :num :period', [
':num' => $params['interval'],
':period' => $period,
]);
}
else {
switch ($repeat) {
case 'DAILY':
$repeat = $this
->t('daily');
break;
case 'WEEKLY':
$repeat = $this
->t('weekly');
break;
case 'MONTHLY':
$repeat = $this
->t('monthly');
break;
case 'YEARLY':
$repeat = $this
->t('annually');
break;
}
}
// Convert the stored day modifier to something human-readable.
if ($params['which']) {
switch ($params['which']) {
case '1':
$params['which'] = $this
->t('first');
break;
case '2':
$params['which'] = $this
->t('second');
break;
case '3':
$params['which'] = $this
->t('third');
break;
case '4':
$params['which'] = $this
->t('fourth');
break;
case '5':
$params['which'] = $this
->t('fifth');
break;
case '-1':
$params['which'] = $this
->t('last');
break;
}
}
// Convert the stored day value to something human-readable.
if (isset($params['day'])) {
switch ($params['day']) {
case 'SU':
case 'MO':
case 'TU':
case 'WE':
case 'TH':
case 'FR':
case 'SA':
$params['day'] = $day_labels[$params['day']];
break;
case 'MO,TU,WE,TH,FR':
$params['day'] = $this
->t('weekday');
break;
case 'SA,SU':
$params['day'] = $this
->t('weekend day');
break;
case '':
$params['day'] = $this
->t('day');
break;
}
}
$start_ts = $this->start;
// TODO: proper timezone handling, allowing for field override.
$tz_string = \Drupal::config('system.date')
->get('timezone')['default'];
// Format the day output.
if ($freq == 'DAILY') {
// No day output required.
$day = '';
}
elseif ($freq == 'WEEKLY') {
if (!empty($params['byday']) && is_array($params['byday'])) {
switch (count($params['byday'])) {
case 1:
$day_output = $day_labels[array_pop($params['byday'])];
break;
case 2:
$day_output = $day_labels[$params['byday'][0]] . ' ' . $this
->t('and') . ' ' . $day_labels[$params['byday'][1]];
break;
default:
$day_output = '';
foreach ($params['byday'] as $key => $day) {
if ($key === array_key_last($params['byday'])) {
$day_output .= $this
->t('and') . ' ' . $day_labels[$day];
}
else {
$day_output .= $day_labels[$day] . ', ';
}
}
break;
}
}
else {
// Default to getting the day from the start date.
$day_labels_by_day_of_week = array_values($day_labels);
$day_output = $day_labels_by_day_of_week[date('N', $start_ts) - 1];
}
$day = $this
->t('on :day', [
':day' => $day_output,
], [
'context' => 'Rule text',
]);
}
else {
$day = date('jS', $start_ts);
if ($params['which']) {
$day = $params['which'] . ' ' . $params['day'];
}
$day = $this
->t('on the :day', [
':day' => $day,
], [
'context' => 'Rule text',
]);
}
// Format the month display, if needed.
if ($freq == 'YEARLY') {
$month = ' ' . $this
->t('of :month', [
':month' => date('F', $start_ts),
], [
'context' => 'Rule text',
]);
}
else {
$month = '';
}
// Format the time display.
// Use the "Time Only" Smart Date Format to allow better formatting.
$format = SmartDateFormat::load('time_only');
$end_ts = $this->end
->getValue()[0]['value'];
if (SmartDateTrait::isAllDay($start_ts, $end_ts, $tz_string)) {
$time = SmartDateTrait::formatSmartDate($start_ts, $end_ts, $format
->getOptions(), $tz_string, 'string');
}
else {
$time_string = SmartDateTrait::formatSmartDate($start_ts, $start_ts, $format
->getOptions(), $tz_string, 'string');
$time = $this
->t('at :time', [
':time' => '',
], [
'context' => 'Rule text',
]) . $time_string;
}
// Process the limit value, if present.
$limit = '';
if ($this->limit) {
list($limit_type, $limit_val) = explode('=', $this->limit);
switch ($limit_type) {
case 'UNTIL':
$limit_ts = strtotime($limit_val);
$format = SmartDateFormat::load('date_only');
$date_string = SmartDateTrait::formatSmartDate($limit_ts, $limit_ts, $format
->getOptions(), $tz_string, 'string');
$limit = ' ' . $this
->t('until :date', [
':date' => $date_string,
]);
break;
case 'COUNT':
$limit = ' ' . $this
->t('for :num times', [
':num' => $limit_val,
]);
}
}
return [
'#theme' => 'smart_date_recurring_text_rule',
'#repeat' => $repeat,
'#day' => $day,
'#month' => $month,
'#time' => $time,
'#limit' => $limit,
];
}
/**
* Retrieve a setting from the field config.
*/
public function getFieldSettings($setting_name, $module = 'smart_date_recur') {
$entity_type = $this->entity_type
->getString();
$bundle = $this->bundle
->getString();
$field_name = $this->field_name
->getString();
$bundle_fields = \Drupal::getContainer()
->get('entity_field.manager')
->getFieldDefinitions($entity_type, $bundle);
$field_def = $bundle_fields[$field_name];
if ($field_def instanceof FieldConfigInterface) {
$value = $field_def
->getThirdPartySetting($module, $setting_name);
}
elseif ($field_def instanceof BaseFieldDefinition) {
// TODO: Document that for custom entities, you must enable recurring
// functionality by adding ->setSetting('allow_recurring', TRUE)
// to your field definition.
$value = $field_def
->getSetting($setting_name);
}
else {
// Not sure what other method we can provide to define this.
$value = FALSE;
}
return $value;
}
/**
* Convert the stored parameters into an array.
*/
public function getParametersArray() {
$params = $this
->get('parameters')
->getString();
$return_array = [
'interval' => NULL,
'which' => '',
'day' => '',
'byday' => [],
];
if ($params && ($params = explode(';', $params))) {
foreach ($params as $param) {
list($var_name, $var_value) = explode('=', $param);
switch ($var_name) {
case 'INTERVAL':
$return_array['interval'] = (int) $var_value;
break;
case 'BYDAY':
$arr = preg_split('/(?<=[-0-9])(?=[,A-Z]+)/i', $var_value);
if ((int) $arr[0]) {
// Starts with a number, so treat as a compound value.
$return_array['which'] = $arr[0];
$return_array['day'] = $arr[1];
}
else {
// Assume this is a multi-day value.
$freq = $this
->get('freq')
->getString();
if ($freq == 'WEEKLY') {
// Split into an array before returning the value.
$return_array['byday'] = explode(',', $arr[0]);
}
else {
$return_array['day'] = $arr[0];
}
}
break;
case 'BYMONTHDAY':
$return_array['which'] = $var_value;
break;
case 'BYSETPOS':
$return_array['which'] = $var_value;
break;
}
}
}
return $return_array;
}
/**
* {@inheritdoc}
*/
public function preSave(EntityStorageInterface $storage) {
parent::preSave($storage);
}
/**
* {@inheritdoc}
*/
public static function postDelete(EntityStorageInterface $storage, array $entities) {
parent::postDelete($storage, $entities);
foreach ($entities as $id => $rrule) {
// Delete any child overrides when a rule is deleted.
$overrides = $rrule
->getRuleOverrides();
foreach ($overrides as $override) {
$override
->delete();
}
}
}
/**
* {@inheritdoc}
*/
public static function baseFieldDefinitions(EntityTypeInterface $entity_type) {
$fields = parent::baseFieldDefinitions($entity_type);
$fields['rule'] = BaseFieldDefinition::create('string')
->setLabel(t('Rule'))
->setDescription(t('The Rule that will be used to generate instances.'))
->setSettings([
'max_length' => 256,
'text_processing' => 0,
])
->setDefaultValue('')
->setDisplayOptions('view', [
'label' => 'hidden',
'type' => 'string',
'weight' => -4,
])
->setDisplayOptions('form', [
'type' => 'string_textfield',
'weight' => -4,
])
->setDisplayConfigurable('form', TRUE)
->setDisplayConfigurable('view', TRUE)
->setRevisionable(TRUE);
// Separate storage for the frequency.
$fields['freq'] = BaseFieldDefinition::create('string')
->setLabel(t('Frequency'))
->setDescription(t('How often the date recurs.'))
->setSetting('is_ascii', TRUE)
->setSetting('max_length', 7)
->setRequired(TRUE);
// Separate storage for the limit.
$fields['limit'] = BaseFieldDefinition::create('string')
->setLabel(t('Limit'))
->setDescription(t('A constraint on how long to recur.'))
->setSetting('max_length', 25)
->setSetting('is_ascii', TRUE);
// Separate storage for extra parameters such as INTERVAL or BYMONTHDAY.
// NOTE: The intention is to store these semicolon-separated.
$fields['parameters'] = BaseFieldDefinition::create('string')
->setLabel(t('Parameters'))
->setDescription(t('Additional parameters to define the recurrence.'))
->setSetting('is_ascii', TRUE);
// TODO: Decide if this field is necessary, given the presence of the Limit.
$fields['unlimited'] = BaseFieldDefinition::create('boolean')
->setLabel(t('Rule'))
->setDescription(t('Whether or not the rule has a limit or end.'))
->setDefaultValue(TRUE)
->setReadOnly(TRUE)
->setRevisionable(TRUE);
$fields['entity_type'] = BaseFieldDefinition::create('string')
->setLabel(t('Entity type'))
->setDescription(t('The entity type on which the date is set.'))
->setSetting('is_ascii', TRUE)
->setSetting('max_length', EntityTypeInterface::ID_MAX_LENGTH);
$fields['bundle'] = BaseFieldDefinition::create('string')
->setLabel(t('Bundle'))
->setDescription(t('The bundle on which the date is set.'))
->setSetting('is_ascii', TRUE)
->setSetting('max_length', EntityTypeInterface::ID_MAX_LENGTH);
$fields['field_name'] = BaseFieldDefinition::create('string')
->setLabel(t('Smart Date field name'))
->setDescription(t('The field name on which the date is set.'))
->setSetting('is_ascii', TRUE)
->setSetting('max_length', FieldStorageConfig::NAME_MAX_LENGTH);
$fields['start'] = BaseFieldDefinition::create('timestamp')
->setLabel(t('Start timestamp value'))
->setRequired(TRUE);
$fields['end'] = BaseFieldDefinition::create('timestamp')
->setLabel(t('End timestamp value'))
->setRequired(TRUE);
$fields['instances'] = BaseFieldDefinition::create('map')
->setLabel(t('Instances'))
->setDescription(t('A serialized array of the instances.'));
return $fields;
}
}
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. | |
ContentEntityBase:: |
protected | property | Language code identifying the entity active language. | |
ContentEntityBase:: |
protected | property | Local cache for the default language code. | |
ContentEntityBase:: |
protected | property | The default langcode entity key. | |
ContentEntityBase:: |
protected | property | Whether the revision translation affected flag has been enforced. | |
ContentEntityBase:: |
protected | property | Holds untranslatable entity keys such as the ID, bundle, and revision ID. | |
ContentEntityBase:: |
protected | property | Local cache for field definitions. | |
ContentEntityBase:: |
protected | property | The array of fields, each being an instance of FieldItemListInterface. | |
ContentEntityBase:: |
protected static | property | Local cache for fields to skip from the checking for translation changes. | |
ContentEntityBase:: |
protected | property | Indicates whether this is the default revision. | |
ContentEntityBase:: |
protected | property | The language entity key. | |
ContentEntityBase:: |
protected | property | Local cache for the available language objects. | |
ContentEntityBase:: |
protected | property | The loaded revision ID before the new revision was set. | |
ContentEntityBase:: |
protected | property | Boolean indicating whether a new revision should be created on save. | |
ContentEntityBase:: |
protected | property | The revision translation affected entity key. | |
ContentEntityBase:: |
protected | property | Holds translatable entity keys such as the label. | |
ContentEntityBase:: |
protected | property | A flag indicating whether a translation object is being initialized. | |
ContentEntityBase:: |
protected | property | An array of entity translation metadata. | |
ContentEntityBase:: |
protected | property | Whether entity validation was performed. | |
ContentEntityBase:: |
protected | property | Whether entity validation is required before saving the entity. | |
ContentEntityBase:: |
protected | property | The plain data values of the contained fields. | |
ContentEntityBase:: |
public | function |
Checks data value access. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Adds a new translation to the translatable object. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the bundle of the entity. Overrides EntityBase:: |
|
ContentEntityBase:: |
public static | function |
Provides field definitions for a specific bundle. Overrides FieldableEntityInterface:: |
4 |
ContentEntityBase:: |
protected | function | Clear entity translation object cache to remove stale references. | |
ContentEntityBase:: |
public | function |
Creates a duplicate of the entity. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Gets a field item list. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Gets the value of the given entity key, if defined. | 1 |
ContentEntityBase:: |
public | function |
Gets the definition of a contained field. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of field definitions of all contained fields. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of all field item lists. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Returns an array of field names to skip in ::hasTranslationChanges. | 1 |
ContentEntityBase:: |
public | function | ||
ContentEntityBase:: |
protected | function | ||
ContentEntityBase:: |
public | function |
Gets the loaded Revision ID of the entity. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the revision identifier of the entity. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of field item lists for translatable fields. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Gets a translated field. | |
ContentEntityBase:: |
public | function |
Gets a translation of the data. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the languages the data is translated to. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translation status. Overrides TranslationStatusInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translatable object referring to the original language. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines whether the entity has a field with the given name. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Checks there is a translation for the given language code. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines if the current translation of the entity has unsaved changes. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the identifier. Overrides EntityBase:: |
|
ContentEntityBase:: |
protected | function | Instantiates a translation object for an existing translation. | |
ContentEntityBase:: |
public | function |
Checks if this entity is the default revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the translation is the default one. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if untranslatable fields should affect only the default translation. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if this entity is the latest revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether this is the latest revision affecting this translation. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines whether a new revision should be created on save. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the translation is new. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the current translation is affected by the current revision. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if the revision translation affected flag value has been enforced. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translation support status. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether entity validation is required before saving the entity. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the label of the entity. Overrides EntityBase:: |
2 |
ContentEntityBase:: |
public | function |
Gets the language of the entity. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Reacts to changes to a field. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Acts on a created entity before hooks are invoked. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Acts on a saved entity before the insert or update hook is invoked. Overrides EntityBase:: |
5 |
ContentEntityBase:: |
public | function |
Acts on a revision before it gets saved. Overrides RevisionableInterface:: |
2 |
ContentEntityBase:: |
public | function |
Gets a list of entities referenced by this entity. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Removes the translation identified by the given language code. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Sets a field value. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Populates the local cache for the default language code. | |
ContentEntityBase:: |
public | function |
Enforces an entity to be saved as a new revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Marks the current revision translation as affected. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Enforces the revision translation affected flag value. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Sets whether entity validation is required before saving the entity. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of all property values. Overrides EntityBase:: |
|
ContentEntityBase:: |
protected | function | Updates language for already instantiated fields. | |
ContentEntityBase:: |
public | function |
Updates the loaded Revision ID with the revision ID. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function | Updates the original values with the interim changes. | |
ContentEntityBase:: |
public | function |
Gets the entity UUID (Universally Unique Identifier). Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Validates the currently set values. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the entity object was a default revision when it was saved. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function | Magic method: Implements a deep clone. | |
ContentEntityBase:: |
public | function |
Constructs an Entity object. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function | Implements the magic method for getting object properties. | |
ContentEntityBase:: |
public | function | Implements the magic method for isset(). | |
ContentEntityBase:: |
public | function | Implements the magic method for setting object properties. | |
ContentEntityBase:: |
public | function |
Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function | Implements the magic method for unset(). | |
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 | |
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 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 |
Returns the cache tags that should be used to invalidate caches. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets the key that is used to store configuration dependencies. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the configuration dependency name. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Gets the configuration target identifier for the entity. Overrides EntityInterface:: |
1 |
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 the original ID. Overrides EntityInterface:: |
1 |
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:: |
protected static | function | Invalidates an entity's cache tags upon delete. | 1 |
EntityBase:: |
protected | function | Invalidates an entity's cache tags upon save. | 1 |
EntityBase:: |
public | function |
Determines whether the entity is new. Overrides EntityInterface:: |
2 |
EntityBase:: |
protected | function | Gets the language manager. | |
EntityBase:: |
public | function |
Deprecated way of generating a link to the entity. See toLink(). Overrides EntityInterface:: |
1 |
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 static | function |
Acts on loaded entities. Overrides EntityInterface:: |
2 |
EntityBase:: |
public static | function |
Changes the values of an entity before it is created. Overrides EntityInterface:: |
5 |
EntityBase:: |
public static | function |
Acts on entities before they are deleted and before hooks are invoked. Overrides EntityInterface:: |
4 |
EntityBase:: |
public | function |
Saves an entity permanently. Overrides EntityInterface:: |
3 |
EntityBase:: |
public | function |
Sets the original ID. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Generates the HTML for a link to this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets a list of URI relationships supported by this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the public URL for this entity. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets an array of placeholders for this entity. | 2 |
EntityBase:: |
protected | function | Gets the UUID generator. | |
EntityChangedTrait:: |
public | function | Gets the timestamp of the last entity change for the current translation. | |
EntityChangedTrait:: |
public | function | Returns the timestamp of the last entity change across all translations. | |
EntityChangedTrait:: |
public | function | Sets the timestamp of the last entity change for the current translation. | |
EntityChangesDetectionTrait:: |
protected | function | Returns an array of field names to skip when checking for changes. Aliased as: traitGetFieldsToSkipFromTranslationChangesCheck | |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
SmartDateRule:: |
protected | property | The frequency of recurrence. | |
SmartDateRule:: |
protected | property | The limit to recurrence. | |
SmartDateRule:: |
protected | property | An imploded array of extra parameters, such as increment values. | |
SmartDateRule:: |
protected | property | The assembled rule, as a string. | |
SmartDateRule:: |
protected | property | The timestamp for the first instance. | |
SmartDateRule:: |
protected | property | The timezone for the field/rule. | |
SmartDateRule:: |
public static | function |
Provides base field definitions for an entity type. Overrides ContentEntityBase:: |
|
SmartDateRule:: |
public | function | Get the RRule object. | |
SmartDateRule:: |
public | function | Retrieve a setting from the field config. | |
SmartDateRule:: |
public | function | Generate default instances based on rule structure. | |
SmartDateRule:: |
public | function | Convert the stored parameters into an array. | |
SmartDateRule:: |
public | function | Retrieve the entity to which the rule is attached. | |
SmartDateRule:: |
public | function | ||
SmartDateRule:: |
public | function | Provide a formatted array of instances, with any overrides applied. | |
SmartDateRule:: |
public | function | Retrieve all overrides created for this rule. | |
SmartDateRule:: |
public | function | Helper function to parse instances from storage and return as an array. | |
SmartDateRule:: |
public | function | Use the transformer to get text output of the rule. | |
SmartDateRule:: |
private | function | ||
SmartDateRule:: |
public | function | Generate default instances based on rule structure. | |
SmartDateRule:: |
public static | function |
Acts on deleted entities before the delete hook is invoked. Overrides EntityBase:: |
|
SmartDateRule:: |
public | function |
Acts on an entity before the presave hook is invoked. Overrides ContentEntityBase:: |
|
SmartDateRule:: |
public | function | ||
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. | |
SynchronizableEntityTrait:: |
protected | property | Whether this entity is being created, updated or deleted through a synchronization process. | |
SynchronizableEntityTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
public | function | ||
TranslationStatusInterface:: |
constant | Status code identifying a newly created translation. | ||
TranslationStatusInterface:: |
constant | Status code identifying an existing translation. | ||
TranslationStatusInterface:: |
constant | Status code identifying a removed translation. |