class ViewUI implements ViewEntityInterface (View source)

Stores UI related temporary settings.

Properties

bool $editing

Indicates if a view is currently being edited.

array $changed_display

Stores an array of displays that have been changed.

float $render_time

How long the view takes to render in microseconds.

bool $changed

If this view has been changed.

array $temporary_options

Stores options temporarily while editing.

array $stack

Stores a stack of UI forms to display.

bool $live_preview

Is the view run in a context of the preview in the admin interface.

$renderPreview
protected ViewEntityInterface $storage

The View storage object.

protected array $additionalQueries

Stores a list of database queries run beside the main one from views.

static array $forms

Contains an array of form keys and their respective classes.

Methods

__construct(ViewEntityInterface $storage)

Constructs a View UI object.

mixed
get(string $property_name, $langcode = NULL)

Returns the value of a property.

$this
setStatus(bool $status)

Sets the status of the configuration entity.

$this
set(string $property_name, mixed $value, $notify = TRUE)

Sets the value of a property.

$this
setSyncing($syncing)

Sets the status of the synchronization flag.

setUninstalling($isUninstalling)

{@inheritdoc}

bool
isSyncing()

Returns whether this entity is being changed as part of a synchronization.

bool
isUninstalling()

Returns whether this entity is being changed during the uninstall process.

standardSubmit($form, FormStateInterface $form_state)

Basic submit handler applicable to all 'standard' forms.

standardCancel($form, FormStateInterface $form_state)

Submit handler for cancel button

getStandardButtons($form, FormStateInterface $form_state, $form_id, $name = NULL)

Provide a standard set of Apply/Cancel/OK buttons for the forms. Also provide a hidden op operator because the forms plugin doesn't seem to properly provide which button was clicked.

getOverrideValues($form, FormStateInterface $form_state)

Return the was_defaulted, is_defaulted and revert state of a form.

addFormToStack($key, $display_id, $type, $id = NULL, $top = FALSE, $rebuild_keys = FALSE)

Add another form to the stack; clicking 'apply' will go to this form rather than closing the ajax popup.

submitItemAdd($form, FormStateInterface $form_state)

Submit handler for adding new item(s) to a view.

startQueryCapture()

Set up query capturing.

endQueryCapture()

Add the list of queries run during render to buildinfo.

renderPreview($display_id, $args = [])

No description

false
getFormProgress()

Get the user's current progress through the form stack.

cacheSet()

Sets a cached view object in the shared tempstore.

bool
isLocked()

Returns whether the current view is locked.

__call($method, $args)

Passes through all unknown calls onto the storage object.

array
getDisplay(string $display_id)

Retrieves a specific display's configuration by reference.

string|int|null
id()

Gets the identifier.

string|null
uuid()

Gets the entity UUID (Universally Unique Identifier).

bool
isNew()

Determines whether the entity is new.

string
getEntityTypeId()

Gets the ID of the type of the entity.

string
bundle()

Gets the bundle of the entity.

getEntityType()

Gets the entity type definition.

createDuplicate()

Creates a duplicate of the entity.

static EntityInterface|null
load(mixed $id)

Loads an entity.

static EntityInterface[]
loadMultiple(array $ids = NULL)

Loads one or more entities.

static EntityInterface
create(array $values = [])

Constructs a new entity object, without permanently saving it.

delete()

Deletes an entity permanently.

int
save()

Saves an entity permanently.

Url
urlInfo(string $rel = 'edit-form', array $options = [])

Gets the URL object for the entity.

Url
toUrl(string $rel = 'edit-form', array $options = [])

Gets the URL object for the entity.

string
link(string|null $text = NULL, string $rel = 'edit-form', array $options = [])

Deprecated way of generating a link to the entity. See toLink().

toLink(string|null $text = NULL, string $rel = 'edit-form', array $options = [])

Generates the HTML for a link to this entity.

string|null
label()

Gets the label of the entity.

$this
enforceIsNew(bool $value = TRUE)

Enforces an entity to be new.

array
toArray()

Gets an array of all property values.

language()

Gets the language of the entity.

access(string $operation = 'view', AccountInterface $account = NULL, bool $return_as_object = FALSE)

Checks data value access.

$this
enable()

Enables the configuration entity.

$this
disable()

Disables the configuration entity.

bool
status()

Returns whether the configuration entity is enabled.

int|string|null
getOriginalId()

Gets the original ID.

$this
setOriginalId(int|string|null $id)

Sets the original ID.

preSave(EntityStorageInterface $storage)

Acts on an entity before the presave hook is invoked.

postSave(EntityStorageInterface $storage, bool $update = TRUE)

Acts on a saved entity before the insert or update hook is invoked.

static 
preCreate(EntityStorageInterface $storage, array $values)

Changes the values of an entity before it is created.

postCreate(EntityStorageInterface $storage)

Acts on a created entity before hooks are invoked.

static 
preDelete(EntityStorageInterface $storage, array $entities)

Acts on entities before they are deleted and before hooks are invoked.

static 
postDelete(EntityStorageInterface $storage, array $entities)

Acts on deleted entities before the delete hook is invoked.

static 
postLoad(EntityStorageInterface $storage, array $entities)

Acts on loaded entities.

getExecutable()

Gets an executable instance for this view.

string
duplicateDisplayAsType(string $old_display_id, string $new_display_type)

Duplicates an existing display into a new display type.

mergeDefaultDisplaysOptions()

Add defaults to the display options.

string[]
uriRelationships()

Gets a list of URI relationships supported by this entity.

referencedEntities()

Gets a list of entities referenced by this entity.

string
url(string $rel = 'edit-form', array $options = [])

Gets the public URL for this entity.

bool
hasLinkTemplate(string $key)

Indicates if a link template exists for a given key.

$this
calculateDependencies()

Calculates dependencies and stores them in the dependency property.

string
getConfigDependencyKey()

Gets the key that is used to store configuration dependencies.

string
getConfigDependencyName()

Gets the configuration dependency name.

string
getConfigTarget()

Gets the configuration target identifier for the entity.

bool
onDependencyRemoval(array $dependencies)

Informs the entity that entities it depends on will be deleted.

array
getDependencies()

Gets the configuration dependencies.

string[]
getCacheContexts()

The cache contexts associated with this object.

string[]
getCacheTags()

The cache tags associated with this object.

int
getCacheMaxAge()

The maximum age for which this object may be cached.

getTypedData()

Gets a typed data object for this entity object.

string|bool
addDisplay(string $plugin_id = 'page', string $title = NULL, string $id = NULL)

Adds a new display handler to the view, automatically creating an ID.

bool
isInstallable()

Checks whether this entity is installable.

$this
setThirdPartySetting(string $module, string $key, mixed $value)

Sets the value of a third-party setting.

mixed
getThirdPartySetting(string $module, string $key, mixed $default = NULL)

Gets the value of a third-party setting.

array
getThirdPartySettings(string $module)

Gets all third-party settings of a given module.

mixed
unsetThirdPartySetting(string $module, string $key)

Unsets a third-party setting.

array
getThirdPartyProviders()

Gets the list of third parties that store information.

$this
trustData()

Sets that the data should be trusted.

bool
hasTrustedData()

Gets whether on not the data is trusted.

$this
addCacheableDependency(CacheableDependencyInterface|object $other_object)

Adds a dependency on an object: merges its cacheability metadata.

$this
addCacheContexts(array $cache_contexts)

Adds cache contexts.

$this
mergeCacheMaxAge(int $max_age)

Merges the maximum age (in seconds) with the existing maximum age.

string[]
getCacheTagsToInvalidate()

Returns the cache tags that should be used to invalidate caches.

$this
addCacheTags(array $cache_tags)

Adds cache tags.

Lock|null
getLock()

Gets the lock on this View.

$this
setLock(Lock $lock)

Sets a lock on this View.

$this
unsetLock()

Unsets the lock on this View.

__set($name, $value)

{@inheritdoc}

__get($name)

{@inheritdoc}

Details

__construct(ViewEntityInterface $storage)

Constructs a View UI object.

Parameters

ViewEntityInterface $storage

The View storage object to wrap.

mixed get(string $property_name, $langcode = NULL)

Returns the value of a property.

Parameters

string $property_name

The name of the property that should be returned.

$langcode

Return Value

mixed

The property if it exists, or NULL otherwise.

$this setStatus(bool $status)

Sets the status of the configuration entity.

Parameters

bool $status

The status of the configuration entity.

Return Value

$this

$this set(string $property_name, mixed $value, $notify = TRUE)

Sets the value of a property.

Parameters

string $property_name

The name of the property that should be set.

mixed $value

The value the property should be set to.

$notify

Return Value

$this

$this setSyncing($syncing)

Sets the status of the synchronization flag.

Parameters

$syncing

Return Value

$this

setUninstalling($isUninstalling)

{@inheritdoc}

Parameters

$isUninstalling

bool isSyncing()

Returns whether this entity is being changed as part of a synchronization.

If you are writing code that responds to a change in this entity (insert, update, delete, presave, etc.), and your code would result in a change to this entity itself, a configuration change (whether related to this entity, another entity, or non-entity configuration), you need to check and see if this entity change is part of a synchronization process, and skip executing your code if that is the case.

For example, \Drupal\node\Entity\NodeType::postSave() adds the default body field to newly created node type configuration entities, which is a configuration change. You would not want this code to run during an import, because imported entities were already given the body field when they were originally created, and the imported configuration includes all of their currently-configured fields. On the other hand, \Drupal\field\Entity\FieldStorageConfig::preSave() and the methods it calls make sure that the storage tables are created or updated for the field storage configuration entity, which is not a configuration change, and it must be done whether due to an import or not. So, the first method should check $entity->isSyncing() and skip executing if it returns TRUE, and the second should not perform this check.

Return Value

bool

TRUE if the configuration entity is being created, updated, or deleted through a synchronization process.

bool isUninstalling()

Returns whether this entity is being changed during the uninstall process.

If you are writing code that responds to a change in this entity (insert, update, delete, presave, etc.), and your code would result in a configuration change (whether related to this configuration entity, another configuration entity, or non-entity configuration) or your code would result in a change to this entity itself, you need to check and see if this entity change is part of an uninstall process, and skip executing your code if that is the case.

For example, \Drupal\language\Entity\ConfigurableLanguage::preDelete() prevents the API from deleting the default language. However during an uninstall of the language module it is expected that the default language should be deleted.

Return Value

bool

standardSubmit($form, FormStateInterface $form_state)

Basic submit handler applicable to all 'standard' forms.

This submit handler determines whether the user wants the submitted changes to apply to the default display or to the current display, and dispatches control appropriately.

Parameters

$form
FormStateInterface $form_state

standardCancel($form, FormStateInterface $form_state)

Submit handler for cancel button

Parameters

$form
FormStateInterface $form_state

getStandardButtons($form, FormStateInterface $form_state, $form_id, $name = NULL)

Provide a standard set of Apply/Cancel/OK buttons for the forms. Also provide a hidden op operator because the forms plugin doesn't seem to properly provide which button was clicked.

TODO: Is the hidden op operator still here somewhere, or is that part of the docblock outdated?

Parameters

$form
FormStateInterface $form_state
$form_id
$name

getOverrideValues($form, FormStateInterface $form_state)

Return the was_defaulted, is_defaulted and revert state of a form.

Parameters

$form
FormStateInterface $form_state

addFormToStack($key, $display_id, $type, $id = NULL, $top = FALSE, $rebuild_keys = FALSE)

Add another form to the stack; clicking 'apply' will go to this form rather than closing the ajax popup.

Parameters

$key
$display_id
$type
$id
$top
$rebuild_keys

submitItemAdd($form, FormStateInterface $form_state)

Submit handler for adding new item(s) to a view.

Parameters

$form
FormStateInterface $form_state

startQueryCapture()

Set up query capturing.

\Drupal\Core\Database\Database stores the queries that it runs, if logging is enabled.

endQueryCapture()

Add the list of queries run during render to buildinfo.

renderPreview($display_id, $args = [])

No description

Parameters

$display_id
$args

false getFormProgress()

Get the user's current progress through the form stack.

Return Value

false

if the user is not currently in a multiple-form stack. Otherwise, an associative array with the following keys:

  • current: The number of the current form on the stack.
  • total: The total number of forms originally on the stack.

cacheSet()

Sets a cached view object in the shared tempstore.

bool isLocked()

Returns whether the current view is locked.

Return Value

bool

TRUE if the view is locked, FALSE otherwise.

__call($method, $args)

Passes through all unknown calls onto the storage object.

Parameters

$method
$args

array getDisplay(string $display_id)

Retrieves a specific display's configuration by reference.

Parameters

string $display_id

The display ID to retrieve, e.g., 'default', 'page_1', 'block_2'.

Return Value

array

A reference to the specified display configuration.

string|int|null id()

Gets the identifier.

Return Value

string|int|null

The entity identifier, or NULL if the object does not yet have an identifier.

string|null uuid()

Gets the entity UUID (Universally Unique Identifier).

The UUID is guaranteed to be unique and can be used to identify an entity across multiple systems.

Return Value

string|null

The UUID of the entity, or NULL if the entity does not have one.

bool isNew()

Determines whether the entity is new.

Usually an entity is new if no ID exists for it yet. However, entities may be enforced to be new with existing IDs too.

Return Value

bool

TRUE if the entity is new, or FALSE if the entity has already been saved.

string getEntityTypeId()

Gets the ID of the type of the entity.

Return Value

string

The entity type ID.

string bundle()

Gets the bundle of the entity.

Return Value

string

The bundle of the entity. Defaults to the entity type ID if the entity type does not make use of different bundles.

EntityTypeInterface getEntityType()

Gets the entity type definition.

Return Value

EntityTypeInterface

The entity type definition.

EntityInterface createDuplicate()

Creates a duplicate of the entity.

Return Value

EntityInterface

A clone of $this with all identifiers unset, so saving it inserts a new entity into the storage system.

static EntityInterface|null load(mixed $id)

Loads an entity.

Parameters

mixed $id

The id of the entity to load.

Return Value

EntityInterface|null

The entity object or NULL if there is no entity with the given ID.

static EntityInterface[] loadMultiple(array $ids = NULL)

Loads one or more entities.

Parameters

array $ids

An array of entity IDs, or NULL to load all entities.

Return Value

EntityInterface[]

An array of entity objects indexed by their IDs.

static EntityInterface create(array $values = [])

Constructs a new entity object, without permanently saving it.

Parameters

array $values

(optional) An array of values to set, keyed by property name. If the entity type has bundles, the bundle key has to be specified.

Return Value

EntityInterface

The entity object.

delete()

Deletes an entity permanently.

int save()

Saves an entity permanently.

When saving existing entities, the entity is assumed to be complete, partial updates of entities are not supported.

Return Value

int

Either SAVED_NEW or SAVED_UPDATED, depending on the operation performed.

Exceptions

EntityStorageException

Url urlInfo(string $rel = 'edit-form', array $options = [])

Gets the URL object for the entity.

Parameters

string $rel

The link relationship type, for example: canonical or edit-form.

array $options

See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return Value

Url

The URL object.

Url toUrl(string $rel = 'edit-form', array $options = [])

Gets the URL object for the entity.

The entity must have an id already. Content entities usually get their IDs by saving them.

URI templates might be set in the links array in an annotation, for example:

Parameters

string $rel

The link relationship type, for example: canonical or edit-form.

array $options

See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return Value

Url

The URL object.

Exceptions

EntityMalformedException
UndefinedLinkTemplateException

Deprecated way of generating a link to the entity. See toLink().

Parameters

string|null $text

(optional) The link text for the anchor tag as a translated string. If NULL, it will use the entity's label. Defaults to NULL.

string $rel

(optional) The link relationship type. Defaults to 'canonical'.

array $options

See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return Value

string

An HTML string containing a link to the entity.

Generates the HTML for a link to this entity.

Parameters

string|null $text

(optional) The link text for the anchor tag as a translated string. If NULL, it will use the entity's label. Defaults to NULL.

string $rel

(optional) The link relationship type. Defaults to 'canonical'.

array $options

See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return Value

Link

A Link to the entity.

Exceptions

EntityMalformedException
UndefinedLinkTemplateException

string|null label()

Gets the label of the entity.

Return Value

string|null

The label of the entity, or NULL if there is no label defined.

$this enforceIsNew(bool $value = TRUE)

Enforces an entity to be new.

Allows migrations to create entities with pre-defined IDs by forcing the entity to be new before saving.

Parameters

bool $value

(optional) Whether the entity should be forced to be new. Defaults to TRUE.

Return Value

$this

array toArray()

Gets an array of all property values.

Return Value

array

An array of property values, keyed by property name.

LanguageInterface language()

Gets the language of the entity.

Return Value

LanguageInterface

The language object.

bool|AccessResultInterface access(string $operation = 'view', AccountInterface $account = NULL, bool $return_as_object = FALSE)

Checks data value access.

Parameters

string $operation

The operation to be performed.

AccountInterface $account

(optional) The user for which to check access, or NULL to check access for the current user. Defaults to NULL.

bool $return_as_object

(optional) Defaults to FALSE.

Return Value

bool|AccessResultInterface

The access result. Returns a boolean if $return_as_object is FALSE (this is the default) and otherwise an AccessResultInterface object. When a boolean is returned, the result of AccessInterface::isAllowed() is returned, i.e. TRUE means access is explicitly allowed, FALSE means access is either explicitly forbidden or "no opinion".

$this enable()

Enables the configuration entity.

Return Value

$this

$this disable()

Disables the configuration entity.

Return Value

$this

bool status()

Returns whether the configuration entity is enabled.

Status implementations for configuration entities should follow these general rules:

  • Status does not affect the loading of entities. I.e. Disabling configuration entities should only have UI/access implications.
  • It should only take effect when a 'status' key is explicitly declared in the entity_keys info of a configuration entity's annotation data.
  • Each entity implementation (entity/controller) is responsible for checking and managing the status.

Return Value

bool

Whether the entity is enabled or not.

int|string|null getOriginalId()

Gets the original ID.

Return Value

int|string|null

The original ID, or NULL if no ID was set or for entity types that do not support renames.

$this setOriginalId(int|string|null $id)

Sets the original ID.

Parameters

int|string|null $id

The new ID to set as original ID. If the entity supports renames, setting NULL will prevent an update from being considered a rename.

Return Value

$this

preSave(EntityStorageInterface $storage)

Acts on an entity before the presave hook is invoked.

Used before the entity is saved and before invoking the presave hook. Note that in case of translatable content entities this callback is only fired on their current translation. It is up to the developer to iterate over all translations if needed. This is different from its counterpart in the Field API, FieldItemListInterface::preSave(), which is fired on all field translations automatically.

Parameters

EntityStorageInterface $storage

The entity storage object.

Exceptions

Exception

postSave(EntityStorageInterface $storage, bool $update = TRUE)

Acts on a saved entity before the insert or update hook is invoked.

Used after the entity is saved, but before invoking the insert or update hook. Note that in case of translatable content entities this callback is only fired on their current translation. It is up to the developer to iterate over all translations if needed.

Parameters

EntityStorageInterface $storage

The entity storage object.

bool $update

TRUE if the entity has been updated, or FALSE if it has been inserted.

static preCreate(EntityStorageInterface $storage, array $values)

Changes the values of an entity before it is created.

Load defaults for example.

Parameters

EntityStorageInterface $storage

The entity storage object.

array $values

An array of values to set, keyed by property name. If the entity type has bundles the bundle key has to be specified.

postCreate(EntityStorageInterface $storage)

Acts on a created entity before hooks are invoked.

Used after the entity is created, but before saving the entity and before any of the presave hooks are invoked.

See the @link entity_crud Entity CRUD topic @endlink for more information.

Parameters

EntityStorageInterface $storage

The entity storage object.

static preDelete(EntityStorageInterface $storage, array $entities)

Acts on entities before they are deleted and before hooks are invoked.

Used before the entities are deleted and before invoking the delete hook.

Parameters

EntityStorageInterface $storage

The entity storage object.

array $entities

An array of entities.

static postDelete(EntityStorageInterface $storage, array $entities)

Acts on deleted entities before the delete hook is invoked.

Used after the entities are deleted but before invoking the delete hook.

Parameters

EntityStorageInterface $storage

The entity storage object.

array $entities

An array of entities.

static postLoad(EntityStorageInterface $storage, array $entities)

Acts on loaded entities.

Parameters

EntityStorageInterface $storage

The entity storage object.

array $entities

An array of entities.

ViewExecutable getExecutable()

Gets an executable instance for this view.

Return Value

ViewExecutable

A view executable instance.

string duplicateDisplayAsType(string $old_display_id, string $new_display_type)

Duplicates an existing display into a new display type.

For example clone to display a page display as a block display.

Parameters

string $old_display_id

The origin of the duplicated display.

string $new_display_type

The display type of the new display.

Return Value

string

The display ID of the new display.

mergeDefaultDisplaysOptions()

Add defaults to the display options.

string[] uriRelationships()

Gets a list of URI relationships supported by this entity.

Return Value

string[]

An array of link relationships supported by this entity.

EntityInterface[] referencedEntities()

Gets a list of entities referenced by this entity.

Return Value

EntityInterface[]

An array of entities.

string url(string $rel = 'edit-form', array $options = [])

Gets the public URL for this entity.

Parameters

string $rel

The link relationship type, for example: canonical or edit-form.

array $options

See \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for the available options.

Return Value

string

The URL for this entity.

bool hasLinkTemplate(string $key)

Indicates if a link template exists for a given key.

Parameters

string $key

The link type.

Return Value

bool

TRUE if the link template exists, FALSE otherwise.

$this calculateDependencies()

Calculates dependencies and stores them in the dependency property.

Return Value

$this

string getConfigDependencyKey()

Gets the key that is used to store configuration dependencies.

Return Value

string

The key to be used in configuration dependencies when storing dependencies on entities of this type.

string getConfigDependencyName()

Gets the configuration dependency name.

Configuration entities can depend on content and configuration entities. They store an array of content and config dependency names in their "dependencies" key.

Return Value

string

The configuration dependency name.

string getConfigTarget()

Gets the configuration target identifier for the entity.

Used to supply the correct format for storing a reference targeting this entity in configuration.

Return Value

string

The configuration target identifier.

bool onDependencyRemoval(array $dependencies)

Informs the entity that entities it depends on will be deleted.

This method allows configuration entities to remove dependencies instead of being deleted themselves. Configuration entities can use this method to avoid being unnecessarily deleted during an extension uninstallation. For example, entity displays remove references to widgets and formatters if the plugin that supplies them depends on a module that is being uninstalled.

If this method returns TRUE then the entity needs to be re-saved by the caller for the changes to take effect. Implementations should not save the entity.

Parameters

array $dependencies

An array of dependencies that will be deleted keyed by dependency type. Dependency types are, for example, entity, module and theme.

Return Value

bool

TRUE if the entity has been changed as a result, FALSE if not.

array getDependencies()

Gets the configuration dependencies.

Return Value

array

An array of dependencies, keyed by $type.

string[] getCacheContexts()

The cache contexts associated with this object.

These identify a specific variation/representation of the object.

Cache contexts are tokens: placeholders that are converted to cache keys by the @cache_contexts_manager service. The replacement value depends on the request context (the current URL, language, and so on). They're converted before storing an object in cache.

Return Value

string[]

An array of cache context tokens, used to generate a cache ID.

string[] getCacheTags()

The cache tags associated with this object.

When this object is modified, these cache tags will be invalidated.

Return Value

string[]

A set of cache tags.

int getCacheMaxAge()

The maximum age for which this object may be cached.

Return Value

int

The maximum time in seconds that this object may be cached.

ComplexDataInterface getTypedData()

Gets a typed data object for this entity object.

The returned typed data object wraps this entity and allows dealing with entities based on the generic typed data API.

Return Value

ComplexDataInterface

The typed data object for this entity.

string|bool addDisplay(string $plugin_id = 'page', string $title = NULL, string $id = NULL)

Adds a new display handler to the view, automatically creating an ID.

Parameters

string $plugin_id

(optional) The plugin type from the Views plugin annotation. Defaults to 'page'.

string $title

(optional) The title of the display. Defaults to NULL.

string $id

(optional) The ID to use, e.g., 'default', 'page_1', 'block_2'. Defaults to NULL.

Return Value

string|bool

The key to the display in $view->display, or FALSE if no plugin ID was provided.

bool isInstallable()

Checks whether this entity is installable.

For example, a default view might not be installable if the base table doesn't exist.

Return Value

bool

TRUE if the entity is installable, FALSE otherwise.

$this setThirdPartySetting(string $module, string $key, mixed $value)

Sets the value of a third-party setting.

Parameters

string $module

The module providing the third-party setting.

string $key

The setting name.

mixed $value

The setting value.

Return Value

$this

mixed getThirdPartySetting(string $module, string $key, mixed $default = NULL)

Gets the value of a third-party setting.

Parameters

string $module

The module providing the third-party setting.

string $key

The setting name.

mixed $default

The default value

Return Value

mixed

The value.

array getThirdPartySettings(string $module)

Gets all third-party settings of a given module.

Parameters

string $module

The module providing the third-party settings.

Return Value

array

An array of key-value pairs.

mixed unsetThirdPartySetting(string $module, string $key)

Unsets a third-party setting.

Parameters

string $module

The module providing the third-party setting.

string $key

The setting name.

Return Value

mixed

The value.

array getThirdPartyProviders()

Gets the list of third parties that store information.

Return Value

array

The list of third parties.

$this trustData()

Sets that the data should be trusted.

If the data is trusted then dependencies will not be calculated on save and schema will not be used to cast the values. Generally this is only used during module and theme installation. Once the config entity has been saved the data will no longer be marked as trusted. This is an optimization for creation of configuration during installation.

Return Value

$this

bool hasTrustedData()

Gets whether on not the data is trusted.

Return Value

bool

TRUE if the configuration data is trusted, FALSE if not.

$this addCacheableDependency(CacheableDependencyInterface|object $other_object)

Adds a dependency on an object: merges its cacheability metadata.

Parameters

CacheableDependencyInterface|object $other_object

The dependency. If the object implements CacheableDependencyInterface, then its cacheability metadata will be used. Otherwise, the passed in object must be assumed to be uncacheable, so max-age 0 is set.

Return Value

$this

$this addCacheContexts(array $cache_contexts)

Adds cache contexts.

Parameters

array $cache_contexts

The cache contexts to be added.

Return Value

$this

$this mergeCacheMaxAge(int $max_age)

Merges the maximum age (in seconds) with the existing maximum age.

The max age will be set to the given value if it is lower than the existing value.

Parameters

int $max_age

The max age to associate.

Return Value

$this

Exceptions

InvalidArgumentException

string[] getCacheTagsToInvalidate()

Returns the cache tags that should be used to invalidate caches.

This will not return additional cache tags added through addCacheTags().

Return Value

string[]

Set of cache tags.

$this addCacheTags(array $cache_tags)

Adds cache tags.

Parameters

array $cache_tags

The cache tags to be added.

Return Value

$this

Lock|null getLock()

Gets the lock on this View.

Return Value

Lock|null

The lock, if one exists.

$this setLock(Lock $lock)

Sets a lock on this View.

Parameters

Lock $lock

The lock object.

Return Value

$this

$this unsetLock()

Unsets the lock on this View.

Return Value

$this

__set($name, $value)

{@inheritdoc}

Parameters

$name
$value

__get($name)

{@inheritdoc}

Parameters

$name