Health and maintenance

HappenBoard → Settings → Health answers two questions: is anything wrong, and can I fix it from here. WordPress Site Health only tells you; this screen also acts. Like the rest of Settings, it is administrator-only.

Scheduled tasks

The first card is the one that matters most. HappenBoard sends reminder emails and runs calendar sync through WordPress scheduled events, and those only fire if something triggers them.

By default WordPress runs its schedule when someone visits your site. On a quiet site nobody visits at three in the morning, so a reminder due then goes out whenever the next visitor happens to arrive. The card shows a green notice when everything is firing on time, and a warning when it is not.

Underneath, three readings:

  • Mode: whether the traffic-triggered schedule is running, or whether it has been switched off in favour of a server cron.
  • Overdue: how many scheduled tasks are more than five minutes past their due time.
  • Action Scheduler: whether that library is present on the site, which some plugins bring with them.

Three or more overdue tasks raise a warning. If the traffic-triggered schedule has been switched off and tasks are still piling up, nothing is running them at all and the card turns red.

The fix, shown on screen when it is needed, is two lines. Add define( 'DISABLE_WP_CRON', true ); to your wp-config.php, then have your host run wp cron event run --due-now every minute. Most hosting control panels have a cron section for exactly this. Your confirmation and reminder emails become reliable the moment it is in place.

A link at the bottom of the card opens WordPress Site Health, where HappenBoard also registers a test of its own.

System

A one-line summary of your HappenBoard, WordPress and PHP versions, followed by each of the plugin’s database tables with its installed version. A tick means the table matches what this version of HappenBoard expects. A version followed by a note to run migrations means it does not, and the next card has the button.

The four maintenance actions

Each has a plain description on its left and a button on its right.

  • Run migrations creates or updates the plugin’s database tables. Use it when the System card flags a table, or after an update that did not finish cleanly. It reports how many tables changed, or tells you everything was already current. Running it when nothing needs doing is harmless.
  • Clear caches deletes HappenBoard’s temporary stored values and its rate-limit counters. They rebuild themselves the next time they are needed. Reach for it when a calendar or list block shows stale dates, or when a form is refusing submissions because a counter is stuck.
  • Re-arm reminders reschedules the reminder for every upcoming appointment booking. It is the recovery button after a period when the schedule was not running, or after importing bookings that arrived without their reminders attached.
  • Purge orphan bookings permanently deletes bookings whose booking type has since been removed. It is marked as destructive because it is: those bookings cannot be recovered afterwards.

Every action reports what it did in a short message. The first and last also refresh the screen so you can see the effect immediately.

The WordPress Site Health entries

HappenBoard adds itself to Tools → Site Health in two places, both read-only.

  • Under Status, a scheduled-tasks test that repeats the cron verdict and spells out the server cron fix.
  • Under Info, a HappenBoard panel listing the plugin version, the cron mode, the overdue count, whether Action Scheduler is available, how many booking reminders are pending, and the installed table versions.

That panel is the fastest thing to copy into a support request.

What’s next