Adding Merge Tags to existing Triggers

Sometimes it's needed to add your own Merge Tag to already defined Trigger. In example you can add a custom meta Merge Tag to default Post Published Trigger.
To do this simply hook into the action and add your Merge Tag:
// Hook into an action when Merge Tags are attached to Trigger.
add_action( 'notification/trigger/merge_tags', function( $trigger ) {
​
	// Check if registered Trigger is the one you need.
	if ( 'post/post/updated' !== $trigger->get_slug() ) {
		return;
	}
​
	// Pay attention to the Tag type you are defining.
	// If you want to output an HTML, use HtmlTag instead.
	$trigger->add_merge_tag( new BracketSpace\Notification\Defaults\MergeTag\StringTag( [
		'slug'     => 'new_merge_tag',
		'name'     => __( 'New Merge Tag', 'textdomain' ),
		'resolver' => function( $trigger ) {
			return get_post_meta( $trigger->{ $trigger->get_post_type() }->ID, '_my_meta_key', true );
		},
	] ) );
​
} );
Targeting all Post Type Triggers
You can target all the Post Type Triggers like this:
add_action( 'notification/trigger/merge_tags', function( $trigger ) {
​
	if ( ! preg_match( '/post\/(.*)\/(updated|trashed|published|drafted|added|pending|scheduled)/', $trigger->get_slug() )
		return;
	}
​
	// Add your Tag.
​
} );
Global Merge Tags
The Notification plugin also supports global Merge Tags which are added to all Triggers. You can use this nifty function to create one:
use BracketSpace\Notification\Defaults\MergeTag\StringTag;
use BracketSpace\Notification\Register;
​
Register::global_merge_tag( new StringTag( [
	'slug'     => 'option_value',
	'name'     => __( 'Site option', 'textdomain' ),
	'resolver' => function( $trigger ) {
		return get_option( 'your_option_name', 'Default' );
	},
] ) );
Before using any property of the Trigger make sure it's avaible. Global Merge Tags are intended to be loosly connected with any Trigger.
Last modified 1yr ago