DocsDevelopers

Hooks and filters

WordPress actions and filters for forms, data sources, dynamic data, Query Loops, analytics, reports, features, the agent and the builder.

Forms#

Hook	Type	Arguments and use
`nativeai_register_form_actions`	action	Register form actions with `register_form_action()`.
`nativeai_register_form_integrations`	action	Register integrations with `register_form_integration()`.
`nativeai_form_submission`	filter	`$submission` — change or check a submission before it’s stored and actions run. Return a `WP_Error` to reject it with a message.
`nativeai_form_submitted`	action	`$submission` — submitted, stored (when the form stores submissions) and its immediate actions ran.
`nativeai_form_succeeded`	action	`$submission` — accepted: stored and its immediate actions succeeded.
`nativeai_form_failed`	action	`$submission, $message` — an action failed; `$message` is what the visitor was told.
`nativeai_form_action_result`	action	`$result, $action, $submission` — after each action runs.
`nativeai_forms_allow_private_urls`	filter	`false, $url` — let form requests reach private or local addresses.

add_filter( 'nativeai_form_submission', function ( $submission ) {
	// Reject submissions from a blocked domain.
	$email = (string) $submission->value( 'email' );
	if ( str_ends_with( strtolower( $email ), '@example.com' ) ) {
		return new WP_Error( 'blocked', 'Please use your work email.' );
	}
	return $submission;
} );

Data sources#

Hook	Type	Arguments and use
`nativeai_data_allow_private_urls`	filter	`false, $url` — let data sources call private or local addresses.
`nativeai_data_rate_limit`	filter	`$per_minute, $source_id` — requests per minute for a source.
`nativeai_data_max_bytes`	filter	`$bytes` — the largest response accepted.

Dynamic data and Query Loops#

Hook	Type	Arguments and use
`nativeai_dynamic_meta_allowed`	filter	`$allowed, $key, $type` — expose or hide a custom field in dynamic data.
`nativeai_query_args`	filter	`$args, $spec, $context` — adjust the WordPress query arguments of Query Loops.
`nativeai_query_post_types`	filter	`$types` — the post types visitors may see in loops (public ones by default).

Analytics#

Hook	Type	Arguments and use
`nativeai_analytics_should_track`	filter	`true` — return false to not count the current request.
`nativeai_analytics_event`	filter	`$row` — change an event before it’s stored; return something that isn’t an array to drop it.
`nativeai_analytics_consent_required`	filter	`false` — require consent before counting, like “Wait for consent”.
`nativeai_analytics_track`	action	`$name, $props` — record a server-side event in the current visit: `do_action( 'nativeai_analytics_track', 'signup', array( 'label' => 'Pro plan', 'value' => 49 ) );`
`nativeai_analytics_conversion`	action	`$goal, $event` — a goal was reached.

Reports and the activity record#

Hook	Type	Arguments and use
`nativeai_report_providers`	action	Register report sections: `Reports\Registry::register( new MyProvider() )`.
`nativeai_report_error_types`	filter	`$types` — the event types the Errors section groups.
`nativeai_report_summary_model`	filter	`''` — the model that writes report summaries.
`nativeai_report_summary_pre`	filter	`null, $facts` — return a summary to skip the AI call.

Add your own events to the activity record — they appear in reports, the Activity screen and the AI’s answers:

\NativeAI\Platform\Events::record( array(
	'type'        => 'backup.completed',
	'module'      => 'backups',
	'severity'    => 'info',
	'summary'     => 'Backup completed (2.4 GB)',
	'object_type' => 'backup',
	'object_id'   => '42',
) );

For repeated events, pass a fingerprint (Events::fingerprint( $type, … ) ignores IDs and numbers) and merge (seconds) so repeats fold into one line.

Features, jobs, notifications and the agent#

Hook	Type	Arguments and use
`nativeai_register_features`	action	Register optional features.
`nativeai_feature_available`	filter	`true, $feature_id, $tier` — whether a feature can be switched on.
`nativeai_feature_toggled`	action	`$feature_id, $on` — a feature was switched on or off.
`nativeai_agent_capabilities`	action	Register capabilities the AI agent can use (see the capability reference).
`nativeai_job_failed`	action	`$job, $error` — a background job ran out of attempts.
`nativeai_notification_delivered`	action	`$notification` — send Native AI notifications elsewhere (Slack, a webhook).

Builder and rendering#

Hook	Type	Arguments and use
`nativeai_editor_head`, `nativeai_editor_footer`	action	Print into the builder’s head and footer.
`nativeai_committed`	action	`$result` — the builder saved changes.
`nativeai_render_element`	filter	`null, $node, $context` — HTML for an element type Native AI doesn’t know; return null to render nothing.