Events
Workflow provides events for extending its functionality. Modules and plugins can register event listeners, typically in their init() methods, to modify Workflow’s behavior.
Submission Events
The beforeSaveSubmission event
The event that is triggered before a submission is saved. You can set $event->isValid to false to prevent saving.
use craft\events\ModelEvent;
use verbb\workflow\elements\Submission;
use yii\base\Event;
Event::on(Submission::class, Submission::EVENT_BEFORE_SAVE, function(ModelEvent $event) {
$submission = $event->sender;
$event->isValid = false;
});The afterSaveSubmission event
The event that is triggered after a submission is saved.
use craft\events\ModelEvent;
use verbb\workflow\elements\Submission;
use yii\base\Event;
Event::on(Submission::class, Submission::EVENT_AFTER_SAVE, function(ModelEvent $event) {
$submission = $event->sender;
});The afterGetReviewerUserGroups event
The event that is triggered after registering user groups for reviewers.
use verbb\workflow\events\ReviewerUserGroupsEvent;
use verbb\workflow\services\Submissions;
use yii\base\Event;
Event::on(Submissions::class, Submissions::EVENT_AFTER_GET_REVIEWER_USER_GROUPS, function(ReviewerUserGroupsEvent $event) {
$submission = $event->submission;
$userGroups = $event->userGroups;
});The definePublisherSelfApproval event
The event that is triggered when Workflow determines whether a publisher may approve a submission they also submitted as editor. You can set $event->allowSelfApproval to change the outcome for that request.
The event is not triggered when the submitting editor is a different user than $event->user.
use verbb\workflow\events\DefinePublisherSelfApprovalEvent;
use verbb\workflow\services\Submissions;
use yii\base\Event;
Event::on(Submissions::class, Submissions::EVENT_DEFINE_PUBLISHER_SELF_APPROVAL, function(DefinePublisherSelfApprovalEvent $event) {
$user = $event->user;
$submission = $event->submission;
$site = $event->site;
// ...
});Email Events
The prepareEditorEmail event
The event that is triggered when preparing the editor email.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\PrepareEmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_PREPARE_EDITOR_EMAIL, function(PrepareEmailEvent $event) {
$editor = $event->editor;
$submission = $event->submission;
// ...
});The beforeSendEditorEmail event
The event that is triggered before an email is sent to an editor.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\EmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_BEFORE_SEND_EDITOR_EMAIL, function(EmailEvent $event) {
$mail = $event->mail;
$user = $event->user;
$submission = $event->submission;
// ...
});The prepareReviewerEmail event
The event that is triggered when preparing the reviewer email.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\PrepareEmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_PREPARE_REVIEWER_EMAIL, function(PrepareEmailEvent $event) {
$reviewers = $event->reviewers;
$submission = $event->submission;
// ...
});The beforeSendReviewerEmail event
The event that is triggered before an email is sent to a reviewer.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\EmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_BEFORE_SEND_REVIEWER_EMAIL, function(EmailEvent $event) {
$mail = $event->mail;
$user = $event->user;
$submission = $event->submission;
// ...
});The preparePublisherEmail event
The event that is triggered when preparing the publisher email.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\PrepareEmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_PREPARE_PUBLISHER_EMAIL, function(PrepareEmailEvent $event) {
$publishers = $event->publishers;
$submission = $event->submission;
// ...
});The beforeSendPublisherEmail event
The event that is triggered before an email is sent to a publisher.
The isValid event property can be set to false to prevent the email from being sent.
use verbb\workflow\events\EmailEvent;
use verbb\workflow\services\Emails;
use yii\base\Event;
Event::on(Emails::class, Emails::EVENT_BEFORE_SEND_PUBLISHER_EMAIL, function(EmailEvent $event) {
$mail = $event->mail;
$user = $event->user;
$submission = $event->submission;
// ...
});Review Events
The beforeSaveReview event
The event that is triggered before a review is saved.
use verbb\workflow\events\ReviewEvent;
use verbb\workflow\services\Reviews;
use yii\base\Event;
Event::on(Reviews::class, Reviews::EVENT_BEFORE_SAVE_REVIEW, function(ReviewEvent $event) {
$review = $event->review;
$isNew = $event->isNew;
// ...
});The afterSaveReview event
The event that is triggered after a review is saved.
use verbb\workflow\events\ReviewEvent;
use verbb\workflow\services\Reviews;
use yii\base\Event;
Event::on(Reviews::class, Reviews::EVENT_AFTER_SAVE_REVIEW, function(ReviewEvent $event) {
$review = $event->review;
$isNew = $event->isNew;
// ...
});The beforeDeleteReview event
The event that is triggered before a review is deleted.
use verbb\workflow\events\ReviewEvent;
use verbb\workflow\services\Reviews;
use yii\base\Event;
Event::on(Reviews::class, Reviews::EVENT_BEFORE_DELETE_REVIEW, function(ReviewEvent $event) {
$review = $event->review;
// ...
});The afterDeleteReview event
The event that is triggered after a review is deleted.
use verbb\workflow\events\ReviewEvent;
use verbb\workflow\services\Reviews;
use yii\base\Event;
Event::on(Reviews::class, Reviews::EVENT_AFTER_DELETE_REVIEW, function(ReviewEvent $event) {
$review = $event->review;
// ...
});