A feature plugin now only for testing Rollback Auto Update, aka Rollback part 3. Manual Rollback of update failures has been committed in WordPress 6.

Andy Fragen

Ari Stathopoulos

Colin Stewart

Paul Biron

<p>This is a feature plugin is for testing Rollback Auto-Update, aka Rollback part 3. This feature only protects plugins during the auto-update process.</p>
<p>As part of the normal Rollback process, the currently installed version of the plugin is moved to <code>wp-content/upgrade-temp-backup/plugins</code>. An active plugin is checked to ensure it doesn’t cause a PHP fatal error when visiting the site. An inactive plugin is not checked because it cannot cause your site to white screen.</p>
<p>Rollback parts 1 was merged into WordPress 6.2 as the <code>move_dir()</code>. Rollback part 2 was merged into WordPress 6.3 and protects the manual update process of plugins and themes.</p>
<ul>
<li><a href="https://core.trac.wordpress.org/changeset/53578" rel="nofollow ugc">r53578</a></li>
<li><a href="https://core.trac.wordpress.org/changeset/55204" rel="nofollow ugc">r55204</a></li>
<li><a href="https://core.trac.wordpress.org/changeset/55219" rel="nofollow ugc">r55219</a></li>
<li><a href="https://core.trac.wordpress.org/changeset/55220" rel="nofollow ugc">r55220</a></li>
<li><a href="https://core.trac.wordpress.org/changeset/55223" rel="nofollow ugc">r55223</a></li>
<li><a href="https://core.trac.wordpress.org/changeset/55720" rel="nofollow ugc">r55720</a></li>
</ul>
<h3>Testing</h3>
<ul>
<li>Requires WordPress 6.3</li>
<li>This <strong>only</strong> works on auto-updates.</li>
<li>Run the following commands from the terminal. You might need to run the command several times to get it started:<br />
wp cron event run wp_version_check</li>
<li>When updating a plugin, you should be able to see the old plugin in the <code>wp-content/upgrade-temp-backup/plugins/PLUGINNAME</code> folder. The same should apply for themes. Since updates sometimes run fast and we may miss the folder creation during testing, you can simulate an update failure to demonstrate.</li>
<li>When a plugin auto-update fails, the previous version should be restored. To test that, change the version of a plugin to a previous number, run the update, and on fail the previous version (the one where you changed the version number) should still be installed on the site. To simulate an update failure and confirm this works, use the built-in <strong>Simulate failure</strong> link. Just activate/deactivate from the <code>plugins.php</code> page action link. This link will only be present if the plugin has an update pending.</li>
</ul>
<h3>Reporting</h3>
<p>Please submit <a href="https://github.com/afragen/rollback-update-failure/issues" rel="nofollow ugc">issues</a> and <a href="https://github.com/afragen/rollback-update-failure/pulls" rel="nofollow ugc">PRs</a> to GitHub.</p>
<p>Logo from a meme generator. <a href="http://hyperboleandahalf.blogspot.com/2010/06/this-is-why-ill-never-be-adult.html" rel="nofollow ugc">Original artwork</a> by Allie Brosh.</p>


Alternatives to Rollback Auto Update

Top alternatives