Lightweight WordPress analytics plugin for saraichinwag.com. Tracks custom events missed by GA4, stores them locally in the database, and provides an admin dashboard.

• WordPress 6.0+
• PHP 7.4+

1. Upload the sarai-analytics folder to wp-content/plugins/.
2. Activate Sarai Analytics in the WordPress admin.
3. The events table ({prefix}sarai_events) is created automatically on activation.

No configuration required. The plugin works out of the box. Customize behavior with filters (see Hooks/Filters).

A lightweight JavaScript tracker (assets/js/tracker.js) is automatically enqueued on all frontend pages. It:

• Respects Do Not Track browser settings
• Sends events via fetch() to the REST endpoint
• Receives the list of allowed event types via wp_localize_script

Endpoint: POST /wp-json/sarai-analytics/v1/event

Authentication: None required (public endpoint).

Parameters:

Responses:

Rate limit: 10 events per session (configurable via sarai_analytics_rate_limit filter).

Sarai_Analytics::track( 'custom_event', array( 'key' => 'value' ), 'https://page.url' );

Or fire the generic hook from any plugin:

do_action( 'sarai_analytics_track', 'event_type', array( 'key' => 'value' ), 'https://page.url' );

random_click, image_mode, smi_click, search, page_view, nav_click, smi_payment, smi_job_status, spawn_credits, spawn_provisioning, spawn_domain

Tools → Sarai Analytics — view event counts (7/30 days), top search queries, top referrers, and recent events.

The plugin automatically listens to hooks from other plugins:

• Sell My Images: smi_payment_completed, smi_job_status_changed
• Spawn: spawn_credits_purchased, spawn_provisioning_complete, spawn_provisioning_failed, spawn_domain_renewed, spawn_auto_refill_success

Registers abilities via the WordPress Abilities API (wp_abilities_api_init):

• sarai-analytics/get-event-counts — Event counts by type for N days
• sarai-analytics/get-top-searches — Most common search queries

Events are stored in {prefix}sarai_events:

// Add a custom event type
add_filter( 'sarai_analytics_allowed_events', function( $events ) {
    $events[] = 'custom_event';
    return $events;
} );

See the docs/ directory for detailed documentation on each subsystem.