wp-staging
Last commit date
Backend
1 day ago
Backup
1 week ago
Basic
1 week ago
Component
1 week ago
Core
1 week ago
Framework
1 day ago
Frontend
5 months ago
Notifications
8 months ago
Staging
1 day ago
assets
1 day ago
languages
1 day ago
resources
1 year ago
vendor_wpstg
1 week ago
views
1 day ago
CONTRIBUTING.md
1 year ago
Deactivate.php
8 months ago
README.md
3 months ago
SECURITY.md
2 years ago
autoloader.php
1 month ago
bootstrap.php
1 month ago
commonBootstrap.php
1 day ago
constantsFree.php
1 day ago
freeBootstrap.php
1 month ago
install.php
1 week ago
opcacheBootstrap.php
1 day ago
readme.txt
1 day ago
runtimeRequirements.php
3 months ago
uninstall.php
1 week ago
wp-staging-error-handler.php
6 months ago
wp-staging.php
1 day ago
readme.txt
310 lines
| 1 | === WP STAGING - WordPress Backup, Restore, Migration & Clone === |
| 2 | |
| 3 | Contributors: WP-Staging, WPStagingBackup, ReneHermi, lucatume, lucasbustamante, alaasalama, fayyazfayzi |
| 4 | Donate link: https://wp-staging.com/backup-wordpress |
| 5 | License: GPLv2 or later |
| 6 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 7 | Tags: backup, wordpress backup, restore, move, transfer |
| 8 | Requires at least: 3.6 |
| 9 | Tested up to: 7.0 |
| 10 | Stable tag: 4.9.1 |
| 11 | Requires PHP: 7.0 |
| 12 | |
| 13 | WordPress backup, restore & migration in minutes. Clone or duplicate your site and test updates safely on a staging copy. 100% unit-tested. |
| 14 | |
| 15 | == Description == |
| 16 | |
| 17 | <h3>WordPress Backup, Restore, Staging, Cloning & Migration — All in One</h3> |
| 18 | |
| 19 | WP STAGING is the all-in-one WordPress backup, restore, staging, cloning, and migration plugin, built for professional workflows with 100% unit-tested code, thousands of automated tests, and extensive end-to-end testing across supported PHP versions. |
| 20 | |
| 21 | Create a full backup or an exact clone or copy of your website in minutes. Use it to duplicate your site, test plugin and theme updates safely, restore your site when needed, move or migrate WordPress to another server, transfer your site to a new host, or build a staging copy before making changes. |
| 22 | |
| 23 | WP STAGING reliably backs up, clones, and migrates WooCommerce stores too, including orders, products, and customer data. |
| 24 | |
| 25 | WP STAGING is developed in Germany and designed for agencies, developers, and businesses that need reliable WordPress backup, recovery, staging, restore, and migration workflows. |
| 26 | |
| 27 | [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") also includes advanced workflows such as [Remote Sync](https://wp-staging.com/docs/pull-a-wordpress-site-from-one-server-to-another/ "Remote Sync - Pull a WordPress Site from One Server to Another"), which lets you pull a WordPress site securely from one server to another using an API key, and [WP STAGING CLI](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Local Docker Development for WordPress"), which can turn a WP STAGING backup into a local Docker-based development site. |
| 28 | |
| 29 | All data stays on your server unless you choose a transfer or remote storage workflow. WP STAGING is designed for speed, reliability, and low-resource environments, including shared hosting. |
| 30 | |
| 31 | WP STAGING automatically performs search and replace for links and paths during cloning, backup, restore, and migration workflows. |
| 32 | |
| 33 | **This staging and backup plugin can clone your website quickly and efficiently, even if it is running on a weak shared hosting server.** |
| 34 | |
| 35 | [vimeo https://vimeo.com/999447985] |
| 36 | |
| 37 | == Frequently Asked Questions == |
| 38 | |
| 39 | = Why should I use a staging site and backup workflow? = |
| 40 | |
| 41 | Plugin updates, theme changes, and custom code should be tested before they reach your live site. A staging workflow lets you clone your production website, test changes safely, and keep a working backup ready in case something goes wrong. Safe updates and update testing on a staging copy protect your live site from broken releases. |
| 42 | |
| 43 | Usually, it is best to run the staging site on an environment as close as possible to the production server. That is the best way to catch compatibility issues before they affect your live site. |
| 44 | |
| 45 | WP STAGING combines backup, restore, staging, and migration in one workflow, so you can protect your live website, reduce downtime risk, and ship changes with more confidence. |
| 46 | |
| 47 | = Is WP STAGING a backup plugin? = |
| 48 | |
| 49 | Yes. WP STAGING started as a staging plugin and grew into a complete WordPress backup plugin, with restore, staging, cloning, and migration in one tool. |
| 50 | |
| 51 | Even the free version lets you create backups and restore them when needed. [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") adds more advanced backup workflows, cloud storage destinations, migration tools, and developer-focused features. |
| 52 | |
| 53 | = How is WP STAGING different from other backup plugins? = |
| 54 | |
| 55 | WP STAGING combines backup, restore, staging, cloning, and migration in one workflow. While many backup plugins focus mainly on archive-based backups or simple migration, WP STAGING also helps you create a working staging copy, test updates safely, and restore your site when needed. |
| 56 | |
| 57 | Some backup plugins focus mainly on creating backup archives, while WP STAGING also creates working staging copies for safer testing and rollback workflows. This is especially useful when you want production-like validation before pushing changes live. |
| 58 | |
| 59 | Some backup plugins may not fully support custom tables in all scenarios. WP STAGING is designed to work reliably with staging workflows and custom table prefixes used by its own cloned environments. |
| 60 | |
| 61 | [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") also includes advanced workflows such as [Remote Sync](https://wp-staging.com/docs/pull-a-wordpress-site-from-one-server-to-another/ "Remote Sync - Pull a WordPress Site from One Server to Another") and [WP STAGING CLI](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Local Docker Development for WordPress"), which can turn a backup into a local Docker-based development site. That makes WP STAGING especially attractive for developers, agencies, and site owners who want more than a basic backup plugin. |
| 62 | |
| 63 | = How do I back up and restore a WordPress site? = |
| 64 | |
| 65 | After installing WP STAGING, go to the backup section in the plugin and create a full-site backup. You can then restore that backup if a plugin update, theme change, deployment, or unexpected issue breaks your site. |
| 66 | |
| 67 | WP STAGING is designed to make backup and restore simple, even on shared hosting and large WordPress installations. |
| 68 | |
| 69 | = What is Remote Sync in WP STAGING Pro? = |
| 70 | |
| 71 | Remote Sync is a Pro feature that lets you pull a WordPress site securely from one server to another using an API key. Instead of manually exporting databases and copying files, you connect the two sites and start the sync from inside WP STAGING. |
| 72 | |
| 73 | This is especially useful for agencies, developers, and site owners who want a faster and more reliable workflow for moving content between WordPress installs. |
| 74 | |
| 75 | Learn more: |
| 76 | [Remote Sync: Pull a WordPress Site from One Server to Another](https://wp-staging.com/docs/pull-a-wordpress-site-from-one-server-to-another/ "Remote Sync - Pull a WordPress Site from One Server to Another") |
| 77 | |
| 78 | = How can I turn a backup into a local Docker development site? = |
| 79 | |
| 80 | [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") includes access to [WP STAGING CLI](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Local Docker Development for WordPress"), which can turn a WP STAGING backup into a local Docker-based WordPress site with one command. |
| 81 | |
| 82 | This is ideal for debugging, QA, development, and reproducing client issues locally. It helps you create repeatable local environments without building custom Docker setups for every project. |
| 83 | |
| 84 | Learn more: |
| 85 | [WP STAGING CLI – Upgrade Now](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Upgrade Now") |
| 86 | |
| 87 | = How do I move, migrate, or transfer a WordPress site to a new host? = |
| 88 | |
| 89 | [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") includes migration and transfer workflows that help you move a WordPress website to another host, transfer your WordPress site to a new host, change the domain, or move to another server. You can move your website between hosts without manual database exports. |
| 90 | |
| 91 | If you want a guided step-by-step walkthrough, see: |
| 92 | [How to Migrate Your WordPress Site to a New Host](https://wp-staging.com/docs/how-to-migrate-your-wordpress-site-to-a-new-host/ "How to Migrate Your WordPress Site to a New Host") |
| 93 | |
| 94 | = How do I duplicate or clone a WordPress site? = |
| 95 | |
| 96 | WP STAGING works as a WordPress duplicator: it can duplicate or clone a WordPress site in a few clicks and create an exact copy of your site for testing, development, or as a safety net. Duplication runs in the background, so you can duplicate even large WordPress sites on shared hosting. If you have used a plugin like Duplicator before, WP STAGING covers the same clone and copy workflows and adds backup, restore, and staging. |
| 97 | |
| 98 | = Why do I need a backup plugin at all? = |
| 99 | |
| 100 | Consistent website backups are the foundation of a robust disaster recovery strategy. They protect your website against failed updates, user mistakes, malware cleanup, hosting issues, hardware failures, software malfunctions, and data loss. |
| 101 | |
| 102 | Backups should include website files, databases, user data, and configuration data. A combination of full backups and incremental backups can improve storage efficiency while keeping restore points current. |
| 103 | |
| 104 | If your website generates leads, sales, traffic, or customer trust, regular backups are not optional. A reliable backup, restore, and recovery workflow lets you roll back your WordPress site and can save hours of downtime and expensive recovery work. |
| 105 | |
| 106 | = Can I activate permalinks on the staging site? = |
| 107 | |
| 108 | Permalinks are disabled on the staging site after the first cloning process. |
| 109 | |
| 110 | Read this guide to activate permalinks on your staging site: |
| 111 | [Activate Permalinks on the Staging Site](https://wp-staging.com/docs/activate-permalinks-staging-site/ "Activate Permalinks on the Staging Site") |
| 112 | |
| 113 | = I cannot log in to the staging or backup site = |
| 114 | |
| 115 | If you use a security plugin such as Wordfence, iThemes Security, All In One WP Security & Firewall, or a plugin that hides the default WordPress login URL, make sure you are running the latest version of WP STAGING. |
| 116 | |
| 117 | If you still cannot log in, go to WP STAGING > Settings and disable WP STAGING extra authentication. Your admin dashboard will still remain protected. |
| 118 | |
| 119 | = Can I just use my local WordPress development system for testing and backup? = |
| 120 | |
| 121 | You can always test your website locally, but if your local hardware and software environment is not an exact clone of your production server, there is no guarantee that every aspect of your local copy will behave the same way. |
| 122 | |
| 123 | Differences in PHP version, server stack, memory, CPU performance, and filesystem behavior can all lead to unexpected results on production. That is why staging on infrastructure close to production remains valuable. |
| 124 | |
| 125 | [WP STAGING | PRO](https://wp-staging.com/backup-wordpress "WP STAGING - Backup & Cloning") also gives you a more advanced local workflow through [WP STAGING CLI](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Local Docker Development for WordPress"), which can turn a backup into a local Docker-based development site. |
| 126 | |
| 127 | = Is WP STAGING available in multiple languages? = |
| 128 | |
| 129 | Yes. WP STAGING is available in multiple languages, and several translations are already complete or nearly complete. |
| 130 | |
| 131 | You can view translated plugin pages here: |
| 132 | |
| 133 | [English](https://wordpress.org/plugins/wp-staging/ "WP STAGING on WordPress.org") |
| 134 | [French](https://fr.wordpress.org/plugins/wp-staging/ "WP STAGING en Français") |
| 135 | [German](https://de.wordpress.org/plugins/wp-staging/ "WP STAGING auf Deutsch") |
| 136 | [Spanish](https://es.wordpress.org/plugins/wp-staging/ "WP STAGING en Español") |
| 137 | [Croatian](https://hr.wordpress.org/plugins/wp-staging/ "WP STAGING na hrvatskom") |
| 138 | [Dutch](https://nl.wordpress.org/plugins/wp-staging/ "WP STAGING in het Nederlands") |
| 139 | [Finnish](https://fi.wordpress.org/plugins/wp-staging/ "WP STAGING suomeksi") |
| 140 | [Greek](https://el.wordpress.org/plugins/wp-staging/ "WP STAGING στα Ελληνικά") |
| 141 | [Hungarian](https://hu.wordpress.org/plugins/wp-staging/ "WP STAGING magyarul") |
| 142 | [Indonesian](https://id.wordpress.org/plugins/wp-staging/ "WP STAGING dalam Bahasa Indonesia") |
| 143 | [Italian](https://it.wordpress.org/plugins/wp-staging/ "WP STAGING in Italiano") |
| 144 | [Persian](https://fa.wordpress.org/plugins/wp-staging/ "WP STAGING به فارسی") |
| 145 | [Polish](https://pl.wordpress.org/plugins/wp-staging/ "WP STAGING po polsku") |
| 146 | [Portuguese (Brazil)](https://br.wordpress.org/plugins/wp-staging/ "WP STAGING em Português do Brasil") |
| 147 | [Russian](https://ru.wordpress.org/plugins/wp-staging/ "WP STAGING по-русски") |
| 148 | [Turkish](https://tr.wordpress.org/plugins/wp-staging/ "WP STAGING Türkçe") |
| 149 | [Vietnamese](https://vi.wordpress.org/plugins/wp-staging/ "WP STAGING bằng Tiếng Việt") |
| 150 | |
| 151 | If you want to help improve translations, please get in touch with us through the support forum. |
| 152 | |
| 153 | = Can I give feedback for WP STAGING? = |
| 154 | |
| 155 | Yes. If something does not work as expected, please open a support request and describe the issue in as much detail as possible. |
| 156 | |
| 157 | We continuously improve WP STAGING based on user feedback, real-world hosting environments, and developer use cases. |
| 158 | |
| 159 | Open support: |
| 160 | [WP STAGING Support Forum](https://wordpress.org/support/plugin/wp-staging/ "WP STAGING Support Forum") |
| 161 | |
| 162 | == WP STAGING FREE - BACKUP & STAGING FEATURES == |
| 163 | |
| 164 | * Clone the entire production site into a subdirectory like example.com/staging-site. |
| 165 | * High-performance backup and cloning, even for websites with very large databases. |
| 166 | * Create full or partial backups — full-site backup, database-only, or files-only backups. |
| 167 | * Scheduled backups with automatic daily backups. |
| 168 | * Easy to use: create a clone or backup in one click. |
| 169 | * Efficient background processing without slowing down your website. |
| 170 | * No Software as a Service and no external account required. |
| 171 | * All your data stays on your server. Your data belongs to you only. |
| 172 | * No server timeouts on huge websites or weak servers. |
| 173 | * Fast backup, clone, and restore workflows depending on site size and server resources. |
| 174 | * Use the clone as part of your backup and update strategy. |
| 175 | * Only administrators can access the cloned or backup website. |
| 176 | * SEO-friendly staging sites with login protection and no-index handling. |
| 177 | * The admin bar on the staging / backup website is orange colored and shows when you work on the staging site. |
| 178 | * Extensive logging features. |
| 179 | * Supports Apache, Nginx, Microsoft IIS, and LiteSpeed Server. |
| 180 | * Every release passes extensive automated tests to keep the plugin robust, reliable, and fast. |
| 181 | * Fast and professional support team. |
| 182 | |
| 183 | == WP STAGING | PRO - BACKUP & STAGING FEATURES == |
| 184 | |
| 185 | The features below are available in [WP STAGING | PRO](https://wp-staging.com/backup-pro-features "WP STAGING | PRO Features"). |
| 186 | |
| 187 | * Remote Sync - Pull a WordPress site securely from one server to another. |
| 188 | * WP STAGING CLI - Turn a backup into a local Docker-based development site. |
| 189 | * Migrate and transfer WordPress to another host or domain. |
| 190 | * Push staging changes to production (staging to live), including plugins, themes, and media files, with one click. |
| 191 | * Clone a backup or staging site to a separate database. |
| 192 | * Choose a custom directory for a backup or cloned site. |
| 193 | * Select a custom subdomain destination like dev.example.com. |
| 194 | * Define user roles for accessing the clone or backup site. This can be clients or external developers. |
| 195 | * Multisite support for migration, backup, and cloning. |
| 196 | * Schedule recurring backups by time and interval. |
| 197 | * Download and upload backups to another server for migration and transfer. |
| 198 | * Backup retention settings. |
| 199 | * Custom backup names. |
| 200 | * Email notifications if a backup cannot be created. |
| 201 | * WordPress multisite backup and restore. |
| 202 | * Cloud backup, offsite backup, and remote backups to external storage providers. |
| 203 | * Backup to Google Drive. |
| 204 | * Backup to Amazon S3. |
| 205 | * Backup to (S)FTP. |
| 206 | * Backup to Dropbox. |
| 207 | * Custom backup folder destinations for cloud storage providers. |
| 208 | * Priority support. |
| 209 | |
| 210 | == DOCUMENTATION == |
| 211 | |
| 212 | <strong>How to Backup and Restore WordPress</strong> |
| 213 | [Backup and Restore WordPress](https://wp-staging.com/docs/how-to-backup-and-restore-your-wordpress-website/ "Backup and Restore WordPress") |
| 214 | |
| 215 | <strong>Backup & Transfer WordPress Site to Another Host</strong> |
| 216 | [How to Migrate Your WordPress Site to a New Host](https://wp-staging.com/docs/how-to-migrate-your-wordpress-site-to-a-new-host/ "How to Migrate Your WordPress Site to a New Host") |
| 217 | |
| 218 | <strong>Remote Sync</strong> |
| 219 | [Pull a WordPress Site from One Server to Another](https://wp-staging.com/docs/pull-a-wordpress-site-from-one-server-to-another/ "Remote Sync - Pull a WordPress Site from One Server to Another") |
| 220 | |
| 221 | <strong>Local Docker Development with WP STAGING CLI</strong> |
| 222 | [WP STAGING CLI – Upgrade Now](https://wp-staging.com/cli/upgrade "WP STAGING CLI - Local Docker Development for WordPress") |
| 223 | |
| 224 | <strong>All Backup Guides</strong> |
| 225 | [All Backup Guides](https://wp-staging.com/docs/category/backup-restore/ "All Backup Guides") |
| 226 | |
| 227 | <strong>Working with Staging Sites</strong> |
| 228 | [Working with Staging Sites](https://wp-staging.com/docs/category/working-with-wp-staging/ "Working with Staging Sites") |
| 229 | |
| 230 | <strong>FAQ for Backup & Cloning</strong> |
| 231 | [FAQ for Backup & Cloning](https://wp-staging.com/docs/category/frequently-asked-questions/ "Backup & Cloning FAQ") |
| 232 | |
| 233 | <strong>Troubleshooting Backup & Cloning</strong> |
| 234 | [Troubleshooting Backup & Cloning](https://wp-staging.com/docs/category/troubleshooting/ "Troubleshooting Backup & Cloning") |
| 235 | |
| 236 | == WP STAGING BACKUP & CLONING TECHNICAL REQUIREMENTS & INFORMATION == |
| 237 | |
| 238 | * Works on latest version of WordPress |
| 239 | * Minimum Supported WordPress Version 3.8 |
| 240 | * Cloning and Backup work on all webhosts |
| 241 | * No extra libraries required |
| 242 | * Backup & cloning supports huge websites |
| 243 | * Custom backup format is much faster and smaller than any tar or zip compression |
| 244 | * Backup & cloning works in low memory & shared hosting environments |
| 245 | |
| 246 | == SUPPORT == |
| 247 | |
| 248 | [WP STAGING Backup & Cloning](https://wp-staging.com/backup-wordpress "WP STAGING Backup & Cloning") |
| 249 | |
| 250 | == Installation == |
| 251 | |
| 252 | = Installation via admin plugin search = |
| 253 | |
| 254 | 1. Go to Plugins > Add new. Select "Author" from the dropdown near search input. |
| 255 | 2. Search for "WP STAGING". |
| 256 | 3. Find "WP STAGING - WordPress Backup, Restore & Migration" and click the "Install Now" button. |
| 257 | 4. Activate the plugin. |
| 258 | 5. The plugin should be shown below settings menu. |
| 259 | |
| 260 | = Admin Installer via zip = |
| 261 | |
| 262 | 1. Visit the Add New plugin screen and click the "Upload Plugin" button. |
| 263 | 2. Click the "Browse..." button and select the zip file of our plugin. |
| 264 | 3. Click "Install Now" button. |
| 265 | 4. Once uploading is done, activate WP STAGING - WordPress Backup, Restore & Migration. |
| 266 | 5. The plugin should be shown below the settings menu. |
| 267 | |
| 268 | == Screenshots == |
| 269 | |
| 270 | 1. Create new WordPress staging / backup site (Dark Mode) |
| 271 | 2. Create new WordPress staging / backup site (Lite Mode) |
| 272 | 3. Select name for staging / backup site (Lite Mode) |
| 273 | 4. Create Full Site Backup (Dark Mode) |
| 274 | 5. Create Full Site Backup (Lite Mode) |
| 275 | 6. Cloning / backup processing (Dark Mode) |
| 276 | 7. Backup Complete (Dark Mode) |
| 277 | 8. Login to staging site |
| 278 | 9. Staging demo site |
| 279 | |
| 280 | == Changelog == |
| 281 | |
| 282 | = 4.9.1 = |
| 283 | * Enh: Extend wpstg_file_permission filter with an optional file path argument for granular per-file permission control. #5237 |
| 284 | * Enh: Hide tables from other staging sites when selecting what to copy. #5251 |
| 285 | * Enh: Improve the plugin description and wording in the readme. #5262 |
| 286 | * Fix: Allow capital letters and spaces in staging site names. #5280 |
| 287 | * Fix: Correct dark theme colors in the staging setup modal exclude-rule fields and labels. #5283 |
| 288 | * Fix: Ensure staging sites remain protected by the login prompt when access control is enabled. #5278 |
| 289 | * Fix: Expand and collapse staging folders from the caret icon. #5274 |
| 290 | * Fix: Improve backup and restore error handling to avoid silent failures and retry loops. #3681 |
| 291 | * Fix: Populate previously selected exclude rules in the staging site Update and Reset modals. #5288 |
| 292 | * Fix: Prevent "Deselect all" tables button from re-selecting tables on the staging Update/Reset modal. #5283 |
| 293 | * Fix: Refresh the push files summary when selecting, deselecting or toggling folders, and align it with the create staging summary. #5283 |
| 294 | * Fix: Remove misleading "Small Server Settings" link from backup and restore error messages. #3681 |
| 295 | * Fix: Remove the redundant usage tracking opt-in admin banner. The first-install consent modal and the Settings toggle remain the way to enable or disable sending usage data. #5289 |
| 296 | * Fix: Resolve fatal error on staging site Update/Reset when exclude rules exist. #5283 |
| 297 | * Fix: Show the cache-clear notice instead of the staging site URL in the Next-Gen push success modal. #5283 |
| 298 | * Fix: Uniquify the inlined SVG element ids in the analytics consent modal to avoid duplicate-id collisions, and update the affected unit test snapshots. #5296 |
| 299 | * Fix: Update the create staging summary when toggling between current site and entire network options. #5283 |
| 300 | * Fix: Use default plugin paths on staging sites with default WordPress structure to fix subsite asset loading on network staging. #4681 |
| 301 | * Fix: Use the selected staging engine when pushing a staging site instead of the previous selection. #5283 |
| 302 | |
| 303 | WP STAGING Backup & Cloning | Full changelog: |
| 304 | [https://wp-staging.com/wp-staging-changelog](https://wp-staging.com/wp-staging-changelog) |
| 305 | |
| 306 | == Upgrade Notice == |
| 307 | |
| 308 | Compatible up to WordPress 7.0. |
| 309 | Many improvements for reliability and bug fixes. Please update to the latest version! |
| 310 |