Skip to content

Entity reference field selection

Plugin ID: content_entity:reference_selection

Available since: 1.0.0

Provided tokens

Token Description
[user] The current user.
Alias: current_user
[htmx] Information about the current HTMX request.
[htmx:is_request] Whether the current request was sent by HTMX ("1" or "0").
[htmx:boosted] Whether the current request was boosted by HTMX ("1" or "0").
[htmx:history_restore] Whether the current request is for HTMX history restoration ("1" or "0").
[htmx:target] The value of the HX-Target request header.
[htmx:trigger] The value of the HX-Trigger request header.
[htmx:trigger_name] The value of the HX-Trigger-Name request header.
[htmx:current_url] The value of the HX-Current-URL request header.
[event] The event.
[event:machine_name] The machine name of the ECA event.
[session_user] The user account that dispatched the event, regardless if ECA is processing models under a different account. This is only available if ECA is configured to always run under a specific account.
[entity] The entity of the event.
[ENTITY_TYPE] The entity of the event under the name of its entity type.

Reacts when entity reference field of specific content entities are selected.

Fields

Type (and bundle) — config key: type

Type: select · Required: no · Default: _all

Allowed values depend on the configuration of the target site.

Value format: <entity_type_id> <bundle>, space separated. Use _all as a wildcard in either position.

This field provides a list with all created content entities and its bundles. You can also select -any-, if you want to react to all types or bundles. In configuration, the value is a single string holding the entity type ID and the bundle separated by one space, for example node article, where the wildcard _all stands for -any- in either position. See Authoring models as configuration.

Restrict by field (machine name) — config key: field_name

The machine name of the field to restrict the event trigger.

Type: textfield · Required: no · Default: empty string

The machine name of the entity reference field to react to. Leave empty to react to all entity reference fields using the ECA handler.

Token name holding the selection — config key: token_name

The name of the token to hold the selection. Please provide the token name only, without brackets.

Type: textfield · Required: no · Default: empty string

The token name to hold the selection results. After ECA actions run, the entities in this token become the referenceable entities.