Module Description
ECA is the no-code solution that empowers you to orchestrate your Drupal site.
ECA is a powerful, versatile, and user-friendly rules engine for Drupal 9+. The core module is a processor that validates and executes event-condition-action plugins. Integrated with graphical user interfaces like BPMN.iO, Camunda, ECA Core Modeller or other possible future modellers, ECA is a robust system for building conditionally triggered action sets.
Invitation to online ECA meetings We used to meet every other Wednesday in the #ECA Drupal Slack Channel where all topics around ECA got discussed. This was for maintainers, users, networkers and everyone else with some sort of interest in ECA and its ecosystem. Since the attendance declined, that regular meeting is on hold as we're all present in that channel all around the clock.
On Friday afternoons (1pm UTC), there is usually an ECA live session where we build something for or with ECA. Anyone can join, either in watch-only mode or by getting into the session as a co-host. The schedule, content and links are always announced before the session in the Slack channel linked above.
How it works
ECA gets triggered for every Drupal event. It validates these events against event-condition-action models and processes all the models for the current event. Like Drupal Rules, ECA leverages existing components of Drupal core, i.e. events and actions. It comes with its own plugin manager for conditions, which results in all three components (events, conditions, actions) being available as plugins that can easily be extended by other modules. ECA models are stored in config, so they can be imported and exported via the admin UI or Drush.
ECA Guide To learn all about ECA, and it's growing ecosystem, please visit the ECA Guide which provides a range of useful content:
* Explaining ECA and how it works
* Describing the main ECA concepts and how you can use them for your models
* Documentation of modellers and all plugins
* A library with downloadable ECA models to learn from
* Video tutorials
There is more to come all the time. So, it's always worth checking back.
User interface
ECA Core is a processing engine that runs in the background. It needs an integrated modeller – a front-end tool with which you define event-condition-action models (a.k.a. rules). ECA provides a plugin manager with an interface to easily integrate existing tools that already provide that capability. And if the modeller supports templates for events, conditions and actions, ECA will provide them for all the plugins that are available on the current Drupal site.
Modellers ECA is currently integrated with the following modellers:
* BPMN.iO: JavaScript-based implementation for building models as two-dimensional diagrams, integrated into the Drupal admin UI
* Camunda: user-friendly desktop client for designing and deploying automated processes
* ECA Core Modeller: "low-level" modelling tool using Drupal core's form API
Important: You will need to install the modeller separately You will find instructions on how to install and use the modeller you select over at their respective project pages and in the documentation.
On production sites, however, you can run ECA models without having any modeller being available or enabled.
Features
* Plugin managers for modellers, events, and conditions
* Interfaces and abstract base classes and traits
* Integration of all actions from the Drupal core Actions module and all available contrib modules
* Extensive context stack support (optional with Context Stack)
* Support for caching, loops, logging, states, tokens, etc.
* Prevents recursions
* TypedData support
* Tagging for event characterization
* Models are stored in config, so they can be imported and exported via Drush or the configuration management UI
Included sub-modules
Installing ECA Core has no dependencies other than Drupal Core! Additional functionality with extra events, conditions and actions can be tailored to the needs of each Drupal site. Currently, these sub-modules are packaged with ECA and can be enabled individually:
* ECA Access: Events and actions to control access on entities and fields
* ECA Base: Base events, conditions and actions
* ECA Cache: Actions to read, write or invalidate cache items
* ECA Config: Config events
* ECA Content: Content entity events, conditions and actions
* ECA Endpoint - since 1.1.0: Events to define your own endpoint/routes on the fly and actions to interact with their requests and responses
* ECA Form: Form API events, conditions and actions
* ECA Log: Events and actions for Drupal log messages
* ECA Migrate: Migrate events
* ECA Misc: Miscellaneous events and conditions from Drupal core and the kernel
* ECA Queue: Events, conditions and actions for queued operations.
* ECA Render - since 1.1.0: Events and actions to work with Drupal's render API for blocks, views and all around themes and Twig
* ECA User: User events, conditions and actions
* ECA Views: Execute and export Views query results within ECA
* ECA Workflow: Content entity workflow actions
The sub-modules extend ECA with plugins for events, conditions and actions. In addition, there is the sub-module ECA UI which gives you access to the ECA admin interface and ECA Development which brings a couple of Drush commands for ECA developers.
Installation
It is simple to get started with ECA on any existing Drupal 9+ site: download the code with Composer; download your choice of integrated modeller (see above) with Composer; enable ECA, the sub-modules you want to use, and the modeller. No further configuration required.
More integrations
The maintainers are interested to help maintainers of other Drupal modules to integrate their projects with ECA by providing either event, condition or action plugins - or all three of them. In this issue we maintain a list of modules, where discussion or even work has already been started and where you can follow its progress.
Modules integrating with ECA
* Modellers:
* BPMN.iO
* Camunda
* ECA Core Modeller
* ECA integrations with other modules:
* ECA Commerce
* ECA Content Access
* ECA Context
* ECA Entity Share
* ECA Flag
* ECA Metatag
* ECA Parameters
* ECA State Machine
* ECA Tamper
* ECA VBO
* ECA View data export
* ECA Webform
* Other modules:
* Augmentor AI
* Bookable Calendar
* CrowdSec
* DANSE
* Drupal Remote Dashboard
* Easy Email
* Group Actions
* HTTP Client Manager
* HTTP Client Manager Issuu Oembed
* IOC: Internet Of Contributors
* Prompt AI
* Push Framework
Requirements
* Drupal 9+
* PHP 7.4+
Documentation Please follow the links in the right column, especially the documentation link which gets you to the ECA Guide. And if you want to help out, please get in touch. Contributors are very welcome, and there is a lot to do.
And here are some links to further information:
* Blog: ECA for Drupal: Successful launch, moving on
* Blog: Drupal ECA integrates bpmn.io
* Blog: ECA rules engine for Drupal: RC1 released
* Blog: State of ECA: What's new in Drupal's new rules engine with beta-2
* Blog: Event Condition Action - Business Process Modelling in Drupal 9+
* Slides ECA RC1 (June 2022)
* Video Part 1
* Video Part 2
* Video from SFDUG presentation
* Video from NWDUG presentation
Join the team
Not only are developers needed, we have so much more that needs to be addressed. Here is a list but even that may not be complete:
* Development
* ECA and plugins
* Optimization of the integrated BPMN.iO client
* Writing tests
* Review and feedback
* Support (Issue queue and in chats)
* Documentation
* Translations
* Descriptions on the drupal.org project pages
* Spread the word
Please get in touch by opening an issue in the issue queue, sending the maintainers a message on their drupal.org profile or head over to Drupal Slack #ECA channel.
Credits: ECA Logo by Nico Grienauer
ECA is a powerful, versatile, and user-friendly rules engine for Drupal 9+. The core module is a processor that validates and executes event-condition-action plugins. Integrated with graphical user interfaces like BPMN.iO, Camunda, ECA Core Modeller or other possible future modellers, ECA is a robust system for building conditionally triggered action sets.
Invitation to online ECA meetings We used to meet every other Wednesday in the #ECA Drupal Slack Channel where all topics around ECA got discussed. This was for maintainers, users, networkers and everyone else with some sort of interest in ECA and its ecosystem. Since the attendance declined, that regular meeting is on hold as we're all present in that channel all around the clock.
On Friday afternoons (1pm UTC), there is usually an ECA live session where we build something for or with ECA. Anyone can join, either in watch-only mode or by getting into the session as a co-host. The schedule, content and links are always announced before the session in the Slack channel linked above.
How it works
ECA gets triggered for every Drupal event. It validates these events against event-condition-action models and processes all the models for the current event. Like Drupal Rules, ECA leverages existing components of Drupal core, i.e. events and actions. It comes with its own plugin manager for conditions, which results in all three components (events, conditions, actions) being available as plugins that can easily be extended by other modules. ECA models are stored in config, so they can be imported and exported via the admin UI or Drush.
ECA Guide To learn all about ECA, and it's growing ecosystem, please visit the ECA Guide which provides a range of useful content:
* Explaining ECA and how it works
* Describing the main ECA concepts and how you can use them for your models
* Documentation of modellers and all plugins
* A library with downloadable ECA models to learn from
* Video tutorials
There is more to come all the time. So, it's always worth checking back.
User interface
ECA Core is a processing engine that runs in the background. It needs an integrated modeller – a front-end tool with which you define event-condition-action models (a.k.a. rules). ECA provides a plugin manager with an interface to easily integrate existing tools that already provide that capability. And if the modeller supports templates for events, conditions and actions, ECA will provide them for all the plugins that are available on the current Drupal site.
Modellers ECA is currently integrated with the following modellers:
* BPMN.iO: JavaScript-based implementation for building models as two-dimensional diagrams, integrated into the Drupal admin UI
* Camunda: user-friendly desktop client for designing and deploying automated processes
* ECA Core Modeller: "low-level" modelling tool using Drupal core's form API
Important: You will need to install the modeller separately You will find instructions on how to install and use the modeller you select over at their respective project pages and in the documentation.
On production sites, however, you can run ECA models without having any modeller being available or enabled.
Features
* Plugin managers for modellers, events, and conditions
* Interfaces and abstract base classes and traits
* Integration of all actions from the Drupal core Actions module and all available contrib modules
* Extensive context stack support (optional with Context Stack)
* Support for caching, loops, logging, states, tokens, etc.
* Prevents recursions
* TypedData support
* Tagging for event characterization
* Models are stored in config, so they can be imported and exported via Drush or the configuration management UI
Included sub-modules
Installing ECA Core has no dependencies other than Drupal Core! Additional functionality with extra events, conditions and actions can be tailored to the needs of each Drupal site. Currently, these sub-modules are packaged with ECA and can be enabled individually:
* ECA Access: Events and actions to control access on entities and fields
* ECA Base: Base events, conditions and actions
* ECA Cache: Actions to read, write or invalidate cache items
* ECA Config: Config events
* ECA Content: Content entity events, conditions and actions
* ECA Endpoint - since 1.1.0: Events to define your own endpoint/routes on the fly and actions to interact with their requests and responses
* ECA Form: Form API events, conditions and actions
* ECA Log: Events and actions for Drupal log messages
* ECA Migrate: Migrate events
* ECA Misc: Miscellaneous events and conditions from Drupal core and the kernel
* ECA Queue: Events, conditions and actions for queued operations.
* ECA Render - since 1.1.0: Events and actions to work with Drupal's render API for blocks, views and all around themes and Twig
* ECA User: User events, conditions and actions
* ECA Views: Execute and export Views query results within ECA
* ECA Workflow: Content entity workflow actions
The sub-modules extend ECA with plugins for events, conditions and actions. In addition, there is the sub-module ECA UI which gives you access to the ECA admin interface and ECA Development which brings a couple of Drush commands for ECA developers.
Installation
It is simple to get started with ECA on any existing Drupal 9+ site: download the code with Composer; download your choice of integrated modeller (see above) with Composer; enable ECA, the sub-modules you want to use, and the modeller. No further configuration required.
More integrations
The maintainers are interested to help maintainers of other Drupal modules to integrate their projects with ECA by providing either event, condition or action plugins - or all three of them. In this issue we maintain a list of modules, where discussion or even work has already been started and where you can follow its progress.
Modules integrating with ECA
* Modellers:
* BPMN.iO
* Camunda
* ECA Core Modeller
* ECA integrations with other modules:
* ECA Commerce
* ECA Content Access
* ECA Context
* ECA Entity Share
* ECA Flag
* ECA Metatag
* ECA Parameters
* ECA State Machine
* ECA Tamper
* ECA VBO
* ECA View data export
* ECA Webform
* Other modules:
* Augmentor AI
* Bookable Calendar
* CrowdSec
* DANSE
* Drupal Remote Dashboard
* Easy Email
* Group Actions
* HTTP Client Manager
* HTTP Client Manager Issuu Oembed
* IOC: Internet Of Contributors
* Prompt AI
* Push Framework
Requirements
* Drupal 9+
* PHP 7.4+
Documentation Please follow the links in the right column, especially the documentation link which gets you to the ECA Guide. And if you want to help out, please get in touch. Contributors are very welcome, and there is a lot to do.
And here are some links to further information:
* Blog: ECA for Drupal: Successful launch, moving on
* Blog: Drupal ECA integrates bpmn.io
* Blog: ECA rules engine for Drupal: RC1 released
* Blog: State of ECA: What's new in Drupal's new rules engine with beta-2
* Blog: Event Condition Action - Business Process Modelling in Drupal 9+
* Slides ECA RC1 (June 2022)
* Video Part 1
* Video Part 2
* Video from SFDUG presentation
* Video from NWDUG presentation
Join the team
Not only are developers needed, we have so much more that needs to be addressed. Here is a list but even that may not be complete:
* Development
* ECA and plugins
* Optimization of the integrated BPMN.iO client
* Writing tests
* Review and feedback
* Support (Issue queue and in chats)
* Documentation
* Translations
* Descriptions on the drupal.org project pages
* Spread the word
Please get in touch by opening an issue in the issue queue, sending the maintainers a message on their drupal.org profile or head over to Drupal Slack #ECA channel.
Credits: ECA Logo by Nico Grienauer
Module Link
Project Usage
1493
Security Covered
Covered By Security Advisory
Version Available
Production
Module Summary
ECA is a no-code solution that empowers users to orchestrate Drupal sites by validating and executing event-condition-action plugins with a powerful rules engine.
Data Name
eca
OPENAI CHATBOT
OPENAI CHATBOT
