BoldGrid Backup


WordPress backup and restoration with update protection.

Technical Documentation

Auto Updates & Rollback Settings

Plugin Auto-Updates and Theme Auto-Updates

Taken from WordPress』 Configuring Automatic Background Updates

By default, automatic background updates only happen for plugins and themes in special cases, as determined by the API response, which is controlled by the WordPress security team for patching critical vulnerabilities. To enable or disable updates in all cases, you can leverage the auto_update_$type filter, where $type would be replaced with 「plugin」 or 「theme」.

When these features are enabled, BoldGrid Backup will add auto_update_plugin and auto_update_theme filters so that any plugin that has an update available will update.

Auto Backup Before Updates

Before WordPress does any auto updates, it fires the pre_auto_update hook. If the user has the Auto Backup Before Updates option enabled, then a backup will occur before the auto update.

Auto Rollback

Auto Rollback is the feature within the BoldGrid Backup plugin that recommends making updates before performing any updates. If you disable this feature, then BoldGrid Backup will not recommend updates.

Example notice:

BoldGrid Backup – Update Protection

On this page you are able to update WordPress, Plugins, and Themes. It is recommended to backup your site before performing updates. If you perform a backup here, before performing updates, then an automatic rollback is possible.

Update protection not available until you click Backup Site Now and a backup is created.


Minimum Requirements

  • PHP 5.4 or higher
  • At least one of the following PHP execution functions enabled: 「popen」, 「proc_open」, 「exec」, 「shell_exec」, 「passthru」, or 「system」.
  • A Cron system with the 「crontab」 utility, or WP Cron.
  • A WP_Filesystem FS_METHOD being 「direct」.


  1. Upload the entire boldgrid-backup folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.


Fatal Error blocked me from WP

This damned plugin nearly gave me a heart attack. I don’t use many plugins and I have a tiny site, so it’s not a conflict thing. I activated this plugin and immediately got an error that starts off like this…」Fatal error: Uncaught Error: Call to undefined function wp_generate_password() in /www/htdocs/w0151c7d」
It blocked me getting into any part of WordPress, and I couldn’t deactivate the plugin. I was sweating bullets until a reboot and about half an hour had passed and I was suddenly allowed in to deactivate it. And I know I’m not the first with this issue; it’s right there on BoldGrid’s own troubleshooting page. Others have it too. Horrible experience.

Best Backup Plugin I’ve Tried By Far

I’ve tried a lot of backup solutions for WordPress, and I was so frustrated by all of them that I was using a script I wrote myself. BoldGrid’s backup and upgrade manager is the first one I’ve tried that runs reliably, doesn’t slow down my site, and even uploads all of my backups to my Amazon S3 bucket. One thing in particular I need is to keep my files in a reasonable format, which this one does by keeping it in a standard tar.gz. This means I can use it to migrate my sites easily from one host to another, or from my local development server to my hosted server.



“BoldGrid Backup” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。


將 BoldGrid Backup 外掛本地化為台灣繁體中文版。


任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄



Release date: Dec 4th, 2018

  • New feature: Added auto-update settings for individual plugins and themes.
  • New feature: Added limited-lifetime download links for archive files.
  • New feature: Added import backup archive from URL address.
  • New feature: Added progress bar to show status of backups.
  • New feature: Adding the ability to set and title and description to a backup.
  • New feature: Adding the ability to flag a backup as being proteced (excluded from retention).
  • Update: Update protection is now valid for 1 hour after a full backup from the WordPress Updates or Plugins page.
  • Update: Made the Backup Archives page the default page in the admin menu.
  • Bug fix: Set a default backup directory if path in settings is not valid. Remove filters before fixing home and siteurl on restore.
  • Bug fix: Some HTML was caught in translations.
  • Bug fix: Duplicate emails were sent when a backup was complete, fixed.
  • Bug fix: Preserve timestamp on ftp / sftp uploads.
  • Bug fix: Fixed CLI support detection on some EA4 servers.
  • Update: Save settings and reload to the current section.
  • Update: Reorganized settings sections.


Release Date: July 31st, 2018

  • New feature: Preflight test to see if server time zone matches cron time.
  • Bug fix: argv variables missing, Enabled register_argc_argv within cron command.
  • Bug fix: Failed crons now write to log.


Release Date: July 17th, 2018

  • Bug fix: Fixed and improved php-cli detection.
  • Bug fix: Fixed 「Undefined index 『plugins'」 bug.
  • Update: Cleaned up codebase to pass PHP CodeSniffer.


Release Date: June 11th, 2018

  • Bug fix: System Cron detection failed in some environments.
  • Update: Clarified verbiage on setting up Premium connect key.


Release Date: May 25th, 2018

  • Update: Detect and use available resources to trigger cron tasks. Added cURL support.


Release Date: May 24th, 2018

  • Update: Ran PHPCBF to beautify PHP code.
  • Update: $_POST sanitization
  • Update: Cron system updated to avoid calling core files directly


Release Date: April 11th, 2018

  • New feature: Archive browser, the ability to see what’s in a backup.
  • New feature: Database browser, the ability to see at a high level what’s in a backup.
  • New feature: 1 click restore database only.
  • New feature: FTP / SFTP support added.
  • New feature: Control which files and database tables are backed up.
  • Compatibility: PclZip support added for creating archives.
  • Compatibility: WP Cron support added for scheduled backups.
  • Compatibility: PHP Script used to backup database, rather than system commands.
  • Improvement: Update admin pages to use WP UI/UX standards.
  • Improvement: Improved UI in regards to time zones.
  • Improvement: Failed items on Preflight Check page are highlighted in red.
  • Improvement: Send email if backup fails via cron.
  • Improvement: More details in Preflight Check to help with troubleshooting.
  • Bug fix: Bug fixed with auto restoration feature.


Release Date: August 8th, 2017

  • Update: Bump version.


Release Date: July 20th, 2017

  • Update: Updated plugin URI.

Release Date: June 27th, 2017


  • New feature: Added auto-update settings for plugins and themes.
  • Bug fix: Skip node_modules paths when creating archives.


Release Date: May 16th, 2017

  • Bug fix: Fixed undefined property when pre-flight test fails.
  • Bug fix: Fixed an undefined index when home dir is not writable.
  • Bug fix: Fixed auto plugin update.


Release Date: May 2nd, 2017

  • Bug fix: Added check and load before using get_plugin_data() for updates.


Release Date: April 4th, 2017

  • Bug fix: After migrating a site via boldgrid-backup, the backup directory was not updated if invalid.


Release Date: February 20th, 2017

  • Bug fix: Fixed issue when installing plugins from the Tools Import page.
  • Bug fix: Fixed check for system tar and zip.
  • Bug fix: Fixed method of locating home directory.


Release Date: February 9th, 2017

  • Update: Show how long the site was paused for.
  • Update: Auto show move backups message.
  • Bug fix: Fixed plugin update checks for some scenarios (WP-CLI, Plesk, etc).


Release Date: February 7th, 2017

  • Bug fix: Fixed plugin update checks for some scenarios (WP-CLI, Plesk, etc).
  • Bug fix: Backing up fails after 5 minutes.


Release Date: January 10th, 2017

  • Update: Update support urls.
  • Update: Close session on gathering disk space api call.
  • Bug fix: Fixed missing link in email.
  • Bug fix: Uncaught TypeError: wp.template is not a function.
  • Testing: Tested on WordPress 4.7.


Release Date: December 20th, 2016

  • Update: Show backup limits to users.
  • Update: Misc notices.
  • Update: Disable backup now button.
  • Update: Prevent backup if account is too large.


Release Date: December 6th, 2016

  • Update: Move backups when changing backup directory.
  • Update: Improve time to calculate disk space.
  • Bug fix: Added double-quote encapsulation to password in mysqldump defaults file.
  • Bug fix: Typo fix.


Release Date: November 15th, 2016

  • Update: Modify 『last created archive』 message with link to archives.
  • Update: Modify backup success message with link to settings.
  • Update: Modify BoldGrid Backup menus.
  • Update: Adjust display of preflight check.
  • Update: Free limitations to days of the week.
  • Update: Free limitations to retention.
  • Update: Standard tooltips.
  • Update: Add intro message to Archive page.
  • Update: Modify backup id section on archives page.
  • Update: Modify Backup Site messages.
  • Update: Cache disk space data.
  • Update: Add free / premium messages next to disk / db sizes.
  • Misc: Added plugin requirements to readme.txt file.


Release Date: October 12th, 2016

  • Update: Bump version.


Release Date: September 20th, 2016

  • Bug fix: Added handling for restoration if site URL changed. Fixed upload button in Chrome.
  • Bug fix: Load BoldGrid settings from the correct WP option (site/blog).
  • Bug fix: Fixed typo in archive deletion confirmation dialogue.
  • Update: Set version constant from plugin file.
  • Misc: Updated readme.txt for Tested up to 4.6.1.


Release Date: September 7th, 2016

  • New feature: Added the ability to upload a backup archive.
  • Bug fix: Fixed errors during deactivation.
  • Bug fix: Update class was not getting current plugin version.


Release Date: August 23rd, 2016

  • Bug fix: Updates via adminajax now updates the rollback timer.
  • Misc: Updated readme.txt for Tested up to: 4.6.


Release Date: August 9th, 2016

  • New feature: Added XHProf for optional PHP profiling. Can be enabled in 「config.local.php」 by setting 「xhprof」 to true.
  • Bug fix: Fixed auto-update action hook.
  • Bug fix: Changed restore and delete buttons to POST forms, to resolve issue with people reloading the restore URL.
  • Bug fix: Reworked error notices for restoration. Emptying archive list before updating after performing a backup.
  • Bug fix: Disabled backup and restore buttons after starting a restoration.
  • Bug fix: Removed homedir not writable notice; moved info to the functionality test page.
  • Bug fix: Removed add cron action on activation.
  • Redesign: Changed backup duration display seconds to 2 decimal places.
  • Rework: Settings page will now load if functionality test fails.
  • Rework: Cleanup for the rollback admin notice.
  • Rework: Added a warning in the notice for restorations (may get logged-out).
  • Rework: Moved cron methods to a new class.
  • Rework: Reworked for translations.


Release Date: July 22nd, 2016

  • Rework: Removed notice for staged pending rollback.


Release Date: July 6th, 2016

  • New feature: Added setting for notification email address.
  • New feature: Added setting for backup directory.
  • New feature: Cancel auto-rollback if a restoration is performed.
  • New feature: Added Rollback Site Now button in the rollback notice.
  • New feature: Made it possible to change siteurl and retain matched archives (backups made as of this update).
  • New feature: Added capability for auto-updates by BoldGrid API response.
  • Redesign: Formatted the Functionality Test page.
  • Bug fix: Removed PHP SAPI check in cron script.
  • Bug fix: Restoration cron did not always complete.
  • Bug fix: Better aligned rollback countdown timer with cron job.
  • Bug fix: Provided message for empty archive list.
  • Bug fix: Rollback information is now removed after timer reaches 0:00.
  • Bug fix: Test for crontab now works when crontab is empty.
  • Bug fix: Now closing PHP session on backup, download, and restore, so that other PHP requests from the client may load.
  • Testing: Tested on WordPress 4.5.3.


Release Date: June 21st, 2016

  • Initial public release.