Programmatic Notifications

The notifications doesn't necessarly have to be saved in WordPress database nor loaded from JSON files. A good example is dynamic trigger testing where all the notifications are created on the fly.

Basic example

You can define the notification with a simple array. Below is a minimal example with all the required parameters.

if ( function_exists( 'notification' ) ) :
notification( [
	'title'    => 'My programmatic notification', // For internal reference.
	'trigger'  => 'trigger_slug', // Trigger slug (can be a Triggerable object).
	'carriers' => [ // An array with format: carrier_slug => data array
		'email' => [
			'activated'  => true, // Must be true.
			'enabled'    => true, // Must be true.
			'subject'    => 'Email from ghost notification!', 
			'body'       => 'This is nice, {user_first_name}, huh?',
			'recipients' => [
				[
					'type'      => 'administrator',
					'recipient' => '',
				],
				[
					'type'      => 'email',
					'recipient' => '{user_email}',
				],
			],
		],
	],
	'enabled'  => true, // Must be true.
] );
endif;

You can reference the Carrier fields by checking the source code. You should check the add_form_field method calls which will contain the field slug and other useful info about the type.

All arguments

All arguments available:

if ( function_exists( 'notification' ) ) :
notification( [
	'hash'     => 'my_programmatic_notification', // Unique notification hash, automatically generated.
	'title'    => 'My programmatic notification',
	'trigger'  => 'trigger_slug',
	'carriers' => [
		'email' => [
			'activated'  => true,
			'enabled'    => true,
			'subject'    => 'Email from ghost notification!', 
			'body'       => 'This is nice, {user_first_name}, huh?',
			'recipients' => [
				[
					'type'      => 'administrator',
					'recipient' => '',
				],
				[
					'type'      => 'email',
					'recipient' => '{user_email}',
				],
			],
		],
	],
	'enabled'  => true,
	'extras'   => [], // Extra data array, ie. config for add-ons.
	'version'  => time(), // Version of the notification, should be a timestamp. Default: current time.
] );
endif;