Skip to content

Views: Query Alter

Available since: 2.0.0

Provided tokens

Token Description
[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

Select the view from the list.

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

Display

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

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