Skip to content

Installing the ECA module

This document explains how to install the Events - Conditions - Actions (ECA) module on your Drupal site. The installation process includes both the core ECA module and a modeler, which provides the user interface for creating automation models.

Prerequisites

Before installing ECA, your Drupal site should be up and running with administrative access. You need to have Composer installed to manage the module dependencies.

Installing with Composer

Use Composer to download the eca Drupal module and the recommended BPMN.iO modeler. The BPMN.iO modeler provides a visual interface for creating your automation models.

1
composer require drupal/eca drupal/bpmn_io

Enabling the modules

After downloading the modules, you need to enable them in Drupal. You can do this through Drupal's administrative interface or using drush.

In Drupal, sign in as an administrator and go to the Extend page (/admin/modules). Find and enable the following modules: ECA Core, ECA Base and BPMN.iO Modeller. Select "Install" to complete the process.

Alternatively, if you prefer using drush, you can enable the modules with this command:

1
drush -y pm:install eca eca_base bpmn_io

Additional ECA sub-modules

You might want to install additional ECA sub-modules. These sub-modules add support for extra events, conditions, and actions.

ECA is also supported by a large number of Drupal contributed modules. Review the extension guide and plugin documentation to learn about available modules and how they can help you build more sophisticated automation models.

Next steps

After completing the installation, you can begin exploring ECA's capabilities. Start by learning about basic ECA concepts, read the usage guide, or explore the library of example models for common use cases.