Verbb
You are viewing an older version of the Navigation documentation (1.x). View the latest version (3.x) →
Developers

Events

Events can be used to extend the functionality of Navigation.

The beforeSaveNav event

Plugins can get notified before a navigation is saved

use verbb\navigation\events\NavEvent;
use verbb\navigation\services\Navs;
use yii\base\Event;

Event::on(Navs::class, Navs::EVENT_BEFORE_SAVE_NAV, function(NavEvent $e) {
    // Do something
});

The afterSaveNav event

Plugins can get notified after a navigation has been saved

use verbb\navigation\events\NavEvent;
use verbb\navigation\services\Navs;
use yii\base\Event;

Event::on(Navs::class, Navs::EVENT_AFTER_SAVE_NAV, function(NavEvent $e) {
    // Do something
});

The beforeDeleteNav event

Plugins can get notified before a navigation is deleted

use verbb\navigation\events\NavEvent;
use verbb\navigation\services\Navs;
use yii\base\Event;

Event::on(Navs::class, Navs::EVENT_BEFORE_DELETE_NAV, function(NavEvent $e) {
    // Do something
});

The afterDeleteNav event

Plugins can get notified after a navigation has been deleted

use verbb\navigation\events\NavEvent;
use verbb\navigation\services\Navs;
use yii\base\Event;

Event::on(Navs::class, Navs::EVENT_AFTER_DELETE_NAV, function(NavEvent $e) {
    // Do something
});

The beforeSaveNode event

Plugins can get notified before a node is saved. Event handlers can prevent the node from getting sent by setting $event->isValid to false.

use craft\events\ModelEvent;
use verbb\navigation\elements\Node;
use yii\base\Event;

Event::on(Node::class, Node::EVENT_BEFORE_SAVE, function(ModelEvent $e) {
    $node = $e->sender;
    $e->isValid = false;
});

The afterSaveNode event

Plugins can get notified after a node has been saved

use craft\events\ModelEvent;
use verbb\navigation\elements\Node;
use yii\base\Event;

Event::on(Node::class, Node::EVENT_AFTER_SAVE, function(ModelEvent $e) {
    $node = $e->sender;
});

The modifyNodeActive event

Plugins can modify the active state of a node.

use verbb\navigation\elements\Node;
use yii\base\Event;

Event::on(Node::class, Node::EVENT_NODE_ACTIVE, function(Event $e) {
    $node = $e->node;
    $e->isActive = true;
});

The beforeMoveElement event

Plugins can get notified before a node is moved in its structure.

use verbb\navigation\elements\Node;
use craft\events\MoveElementEvent;
use craft\services\Structures;
use yii\base\Event;

Event::on(Structures::class, Structures::EVENT_BEFORE_MOVE_ELEMENT, function(MoveElementEvent $event) {
    $element = $event->element;

    if ($element instanceof Node) {
        // ...
    }
});

The afterMoveElement event

Plugins can get notified after a node is moved in its structure.

use verbb\navigation\elements\Node;
use craft\events\MoveElementEvent;
use craft\services\Structures;
use yii\base\Event;

Event::on(Structures::class, Structures::EVENT_AFTER_MOVE_ELEMENT, function(MoveElementEvent $event) {
    $element = $event->element;

    if ($element instanceof Node) {
        // ...
    }
});
Last updated: May 2, 2026, 3:18:41 PM
Previous Nav Next Extensibility