WP Manifestindependent plugin directory
manifest / updates / wpvivid-backup-monitor

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.

by mr-flibble · github.com/mr-flibble/wpvivid-backup-monitor

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/mr-flibble/wpvivid-backup-monitor/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/mr-flibble/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');
  1. 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