Hooks and filters

Add these in your theme’s functions.php or a small plugin. Hooks used only to wire the free plugin and Pro together are left out.

The fast endpoint and filters

Vireo records each view through a small endpoint that loads WordPress without your plugins or theme, so it’s fast. Code you add can’t run there. If you use any of these filters, Vireo notices and records views through the standard admin-ajax.php route instead, which is slower but sees your code:

vireo_trust_proxy_headers, vireo_beacon_rate_limit_per_minute, vireo_beacon_rate_limit_shard_keys, vireo_honor_opt_out, vireo_bot_ua_pattern, vireo_bot_signatures, vireo_geo_country_headers, vireo_buffer_dir_max_bytes, vireo_headless_allowed_origins.

Before Vireo Analytics 0.12.5, vireo_beacon_rate_limit_shard_keys, vireo_buffer_dir_max_bytes and vireo_bot_signatures were missing from that check, so setting one of them left views on the fast endpoint, where it had no effect. From 0.12.5 they switch the route like the others.

Vireo checks the endpoint when it’s activated and then once an hour, so a change to either filter takes effect at the next check.

Tracking

// Keep the tracker off a landing page used for ad tests.
add_filter( 'vireo_load_tracking_script', function ( $load ) {
	return is_page( 'ad-test' ) ? false : $load;
} );

Bots and counting

// Recognise another assistant as an AI referrer.
add_filter( 'vireo_ai_sources', function ( $map ) {
	$map['Example AI'] = '(^|\.)example-ai\.com$';
	return $map;
} );

Proxies and addresses

add_filter( 'vireo_trust_proxy_headers', '__return_true' );
add_filter( 'vireo_trusted_proxies', function ( $cidrs ) {
	$cidrs[] = '203.0.113.0/24'; // Your load balancer.
	return $cidrs;
} );

Headless and connected sites

// Front end serves posts under /blog/ while WordPress has them at the root.
add_filter( 'vireo_headless_post_id', function ( $post_id, $path ) {
	if ( $post_id || 0 !== strpos( $path, '/blog/' ) ) {
		return $post_id;
	}
	return url_to_postid( home_url( substr( $path, 5 ) ) );
}, 10, 2 );

REST API, abilities and MCP

Dashboard and data

Functions

vireo_track_event( string $name, string $value = '' ): bool

Records a custom event from PHP. The name keeps only a-z, 0-9, _ and -, and name and value are cut to 100 characters. Returns false if the name is empty after cleaning. See Events and broken links.

Pro