Removing the WP Foreman plugin

To stop managing a website with WP Foreman, disconnect it, delete the plugin in WordPress, then remove the site from WP Foreman.

1. In the site’s WordPress admin, go to Settings › WP Foreman and click Disconnect.
2. Go to Plugins, click Deactivate under WP Foreman, then click Delete. With plugin 0.10.4 or newer, this removes everything the plugin stored (see below).
3. In WP Foreman, open the site’s Site settings and use Remove this site. See Disconnecting a site.

On an older plugin, update it first, then delete it, so the cleanup runs.

What deleting the plugin removes

• The connection keys, so nothing can send the site commands as WP Foreman any more.
• Its settings: the plugin’s name and visibility (white label), the site-log notes waiting to be sent, and the last WP Admin sign-in.
• Leftovers from backups and form tests that were cut off part-way.
• Its temporary folder, wp-content/uploads/wpforeman-tmp.
• Anything a restore that never finished left behind: its temporary database tables and its small helper file in wp-content/mu-plugins.

On a multisite network this runs for every site in the network.

Disconnect on its own works differently: it removes the connection keys but keeps the white-label and site-log settings, so if you connect the site again it looks the same as before.

Deleted by FTP or through the host?

WordPress only runs a plugin’s cleanup when you delete it from the Plugins page. If the plugin folder was deleted another way (FTP, the host’s file manager, wp plugin delete), its settings and keys are still in the database. Remove them with WP-CLI from the site’s folder:

wp option list --search='wpforeman_*' --field=option_name | xargs -n1 wp option delete
wp option list --search='_wpf_test_*' --field=option_name | xargs -n1 wp option delete
rm -rf wp-content/uploads/wpforeman-tmp

No WP-CLI? Upload the plugin again, activate it, then deactivate and delete it from the Plugins page.