Views: Query Alter¶

Plugin ID: eca_views:query_alter

Available since: 2.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:args:?]`	The list of arguments given to the view.
`[event:display_id]`	The display_id of the view.
`[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.

Fires during the build phase, after all handlers have added their conditions but before the query is finalized. This is the place to add extra WHERE conditions, JOINs, or modify sort orders dynamically.

Useful for row-level access control, dynamic filtering based on user context, or adding conditions beyond what Views handlers provide.

Fields¶

View — config key: view_id

Select the view from the list.

Type: select · Required: yes · Default: empty string

Allowed values depend on the configuration of the target site.

Value format: The machine name of a view on the target site.

Select the View this event should react to. Only enabled Views are listed.

Display — config key: display_id

Provide the view display id to which to respond. Leave empty to respond on any display.

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

Value format: The machine name of a display within the selected view, for example default or page_1.

The machine name of a specific display (e.g., page_1, block_1). Leave empty to react to all displays of the selected View.