Deleting bbPress

Codex Home → Getting Started → Installing bbPress → Deleting bbPress

Remove bbPress Data

By default bbPress does not delete any data if the plugin is deactivated and deleted, so that if you have a problem with your current installation of bbPress you can install a clean version of the plugin and still have all of your data like before.

If you ever decide to not run bbPress and you have made a choice in wanting to remove all of the previous data that bbPress has created, you can run the Reset Forums tool to remove all of your bbPress data.

Log into your WordPress back-end.
Go to Tools > Forums > Reset Forums.
Check the “Are you sure you want to do this?” checkbox.
Optional: You may also want to check Delete imported users? as once the bbPress is reset, the meta-data necessary to delete these users will also be removed.
Click Reset bbPress.

Please know that if you see “Deleting Conversion Table… Failed“, it is normal to see this if you did not import from another forum system, as during the import process it adds an extra database table.

Using the Reset Forums tool will remove all bbPress data from your WordPress database, including custom post types, topic tag taxonomy, and bbPress user meta.

However, there was a bug in the older version of bbPress where bbPress will not completely remove the user roles.(See #2580)

So if you are using the older version of bbPress, add this function in your child themes functions.php file.

$wp_roles = new WP_Roles();
$wp_roles->remove_role("bbp_keymaster");
$wp_roles->remove_role("bbp_moderator");
$wp_roles->remove_role("bbp_participant");
$wp_roles->remove_role("bbp_spectator");
$wp_roles->remove_role("bbp_blocked");

Refresh your website, and now all bbPress related user roles have been removed from the database. After that you can remove the code from your child theme’s functions.php file.

Now after removing all the bbPress data, you can proceed to uninstalling bbPress.

Uninstall bbPress

If you ever need to install a fresh version of bbPress because the core files were modified, you are running through a severe issue that you want to try to fix, or that you just do not want to use bbPress anymore, you may follow these steps to uninstall bbPress from your site.

Log into your WordPress back-end.
Go to Plugins > Installed Plugins .
Scroll down until you see bbPress and click Deactivate.
After the page reloads , scroll back down to the bbPress plugin , now click the red Delete link.
You will now see a screen to confirm your deletion of the bbPress plugin, if you are sure you want to remove bbPress from your installation, hit the OK. button.
bbPress is now uninstalled from your site.

bbPress Codex