wpvivid-backup-monitor

A lightweight WordPress mu-plugin that monitors the WPvivid local backup folder and keeps your disk usage under control — useful when remote SFTP/cloud storage fails silently and backups accumulate locally.

The problem

WPvivid falls back to local storage when a remote destination (SFTP, Google Drive, etc.) fails. It does this silently — no email, no warning. Over time, local backups pile up and fill your disk.

What this plugin does

• Runs daily via WP-Cron
• Checks the total size of the wpvividbackups folder
• Soft limit — sends an email alert so you can investigate
• Hard limit — automatically deletes the oldest .zip backups, keeps the newest N, then sends a cleanup report
• Only targets .zip files — never touches folders, logs, or index files

Installation

1. Download wpvivid-monitor.php
2. Open the file and set your configuration at the top:

define('WBMON_BACKUP_DIR',    WP_CONTENT_DIR . '/wpvividbackups');
define('WBMON_SOFT_LIMIT_GB', 5);          // email alert threshold
define('WBMON_HARD_LIMIT_GB', 10);         // auto-delete threshold
define('WBMON_KEEP_MIN',       2);          // minimum backups to always keep
define('WBMON_ALERT_EMAIL',   'your@email.com');

3. Upload to wp-content/mu-plugins/wpvivid-monitor.php

mu-plugins are loaded automatically — no activation needed.

Requirements

• WordPress 5.0+
• PHP 7.4+
• WPvivid Backup Plugin (free or pro)
• A working mailer — WP Mail SMTP recommended

Testing

Add ?wbmon_test=2 to any page URL while logged in as admin:

https://yoursite.com/?wbmon_test=2

This always sends a test email and shows the current folder size on screen — useful to verify both the mailer and folder path are configured correctly.

For a dry run of the actual check logic (sends email only if a limit is exceeded):

https://yoursite.com/?wbmon_test=1

WP-Cron reliability

WP-Cron only fires when someone visits your site. For reliable scheduling, set up an external cron job that hits:

https://yoursite.com/wp-cron.php?doing_wp_cron

Most hosting control panels support this. Free alternative: cron-job.org.

Email examples

Soft limit alert:

Subject: [My Site] ⚠️ WPvivid: backup folder is 6.3 GB

⚠️ The backup folder has reached 6.3 GB (soft limit: 5 GB).

Folder: /var/www/html/wp-content/wpvividbackups
Hard limit (auto-delete): 10 GB

Likely cause: SFTP backup is failing and backups are being stored locally.
Please check WPvivid → Remote Storage settings.

Hard limit — after cleanup:

Subject: [My Site] 🚨 WPvivid: backups automatically cleaned up

🚨 HARD LIMIT exceeded — automatic cleanup performed.

Size before: 11.2 GB (limit: 10 GB)
Size after:  3.1 GB
Deleted backups:
  - backup_2025_03_10_120000.zip
  - backup_2025_03_17_120000.zip
  - backup_2025_03_24_120000.zip

Please check your SFTP connection in WPvivid — backups are being
stored locally because SFTP is failing.

License

MIT