Troubleshooting

Plugin activation fatal

Usually two plugin folders in wp-content/plugins. Deactivate all copies, delete duplicates, keep one mindful-events-sync folder.

Too many centres imported

Set Centre import country under Settings → Reference Data. Ensure hub centres have centre_country set.

Event pushed but organiser missing on hub

Pull reference data first. Local organiser must have _mindful_hub_entity_id. Check Sync Log.

Connection / HMAC failures

Verify hub URL, satellite ID, API key, and HMAC secret match Connected Sites on the hub. Check server clock skew.

Cron not running

Use system cron + WP-CLI (wp cron event run --due-now) on production. Reference pulls and retries depend on wp-cron or real cron.

Duplicate events on hub

Ensure each event has a stable _mindful_sync_id and satellites send idempotency_token on push.