Background Jobs and WP-CLI

Included in Free - Pro runs its own jobs (export, webhooks, digest), documented in the Pro developer guide.

Scheduled jobs#

Jobs are registered on init. If Action Scheduler is loaded (it is bundled in vendor/), jobs go into its mediashield group; otherwise WP-Cron is used, with a monthly interval added through cron_schedules.

Hook	When	What it does	Details
ms_cleanup_inactive_sessions	Hourly, recurring	Sets is_active = 0 on sessions with no heartbeat for 10 minutes.	Only flips the flag. Reads that count active sessions use a 5 minute window themselves.
ms_archive_old_sessions	Monthly, recurring	Moves sessions older than ms_session_retention_months to ms_watch_sessions_archive.	Does nothing while the option is 0 (the default).
ms_restore_archived_sessions	One-off, re-queues itself every minute	Moves archived rows back to the live table, 2000 per pass.	Queued by the 1.3.0 upgrade. Batch filter: mediashield_restore_archive_batch_size (100-20000).
ms_claim_uploaded_files	One-off, re-queues itself every minute	Writes _ms_owned_file for each video that has none, oldest video first.	Queued by the 1.4.0 upgrade while ms_file_claims_pending is set. Batch filter: mediashield_claim_files_batch_size (50-1000, default 200).

The bundled EDD licensing SDK also schedules its own weekly licence check, which is not part of MediaShield's jobs.

Two things run on delete rather than on a schedule: before_delete_post cascades for videos and playlists (see Database Tables), and the GDPR exporter and eraser run when WordPress asks for them.

To run a job by hand with WP-CLI:

wp action-scheduler run --group=mediashield
wp cron event run ms_cleanup_inactive_sessions

The first form works when Action Scheduler is the scheduler, the second when WP-Cron is.

WP-CLI commands#

Registered only when WP_CLI is defined. There are two command groups and four commands.

wp mediashield repair bunny-urls#

Since 1.3.0. Finds videos pasted from a Bunny dashboard URL that were saved as self-hosted with no platform video ID, and rewrites them to the Bunny shape (platform bunny, bare GUID, library ID, unsigned embed URL).

Flag	Meaning
(none) or --dry-run	Report what would change. This is the default.
--execute	Write the repairs.

Bunny collection URLs are reported for manual fixing and never rewritten.

wp mediashield repair bunny-urls
wp mediashield repair bunny-urls --execute

wp mediashield scale#

A development tool that checks hot-path query budgets against a synthetic dataset. Do not run it on a production site. Synthetic rows use user IDs from 1000000 up so they can be removed cleanly.

Command	What it does
seed	Inserts sessions and milestones. Flags: --users (default 10000), --sessions-per-user (default 10), --milestones-per-session (1-4, default 4), --batch (default 5000, minimum 100).
benchmark	Times the hot-path queries and exits with an error if any is over its budget.
teardown	Deletes every synthetic row and the synthetic video post.

wp mediashield scale seed --users=10000 --sessions-per-user=10
wp mediashield scale benchmark
wp mediashield scale teardown