Plugin

MoonFactory Connector

The bridge between your WordPress site and the MoonFactory portal.

Features

  • Lightweight Umami tracking script injection (privacy-first, no cookies)
  • Option to exclude logged-in administrators from tracking
  • REST API for remote configuration and management
  • Detailed health checks (DB status, disk usage, active plugins, WP version)
  • Periodic heartbeat reporting to the MoonFactory portal
  • Backward-compatible with MoonFactory Analytics plugin options

MoonFactory Connector is the primary integration point between a client’s WordPress site and the MoonFactory portal. It replaces the older standalone MoonFactory Analytics plugin with a unified surface that handles analytics, health monitoring, and heartbeat reporting — all behind one activation.

What it does

Analytics

A lightweight Umami tracking script is injected into every page. No cookies, no third-party beacons, GDPR-clean by default. Logged-in administrators can be excluded from tracking with a single toggle; data already shows them separately so it rarely matters anyway.

Health checks

The plugin exposes a /wp-json/moonfactory/health endpoint that reports:

  • Database connectivity and query latency
  • Disk usage and free space
  • Active plugin inventory (slug, version, active state)
  • WordPress core version
  • PHP version

The portal polls this endpoint on a 15-minute cadence. Failures open a ticket automatically.

Heartbeat

Every hour, the plugin POSTs a signed heartbeat to the portal’s /api/internal/wp-heartbeat endpoint. The signature is a shared X-Connector-Token that maps to the wp_site_credentials row for this site. Heartbeats keep the portal’s live-health dashboard accurate between polls.

Supersedes MoonFactory Analytics

If you’re currently running the standalone MoonFactory Analytics plugin, Connector is a drop-in upgrade. It reads the same option keys, so settings migrate automatically. After Connector is activated, the old plugin can be deactivated and removed.

Installation

Connector is installed and kept up-to-date automatically on every MoonFactory-managed site. The portal handles deployment, activation, and configuration — there is nothing to do by hand.