BuddyPress Documentation


BuddyPress Documentation

Upgrading from RC-1

ContentsGetting StartedInstalling BuddyPress → Upgrading from RC-1

In versions of BuddyPress prior to RC-2 the installation procedure was radically different. It’s very important to read through these upgrade instructions if you are currently using RC-1 or older. From version 1.0 themes will always be backwards compatible. We have made these changes as it will make the installation and theming process much simpler for everyone from 1.0 onwards.

These upgrade instructions are most important for people using custom themes. If you are using the default plugins and themes with no modifications, you are safe to delete everything and re-install (follow the installation instructions still) your data will be preserved in the new version.

Please note: WordPress MU 2.7.1 is required for this version. BuddyPress will not run with single-user WordPress at this time.

Upgrading the Plugin Files

  1. Delete all the BuddyPress plugins from /mu-plugins/
  2. Log into you WordPress admin area as a site admin and head to the “Plugins” menu. If you see a red error message saying that the menu must be activated first, please click the link and activate the plugins menu (check the box at the bottom of the page).
  3. Once activated, select the “Add New” submenu under the plugins menu. Type “BuddyPress” in the search box and locate the BuddyPress plugin entry in the list. Hit the “Install” link, and then the “Install Now” button in the popup.
  4. Enter your FTP details so BuddyPress can be downloaded and installed. If you cannot use FTP, please manually download BuddyPress and install it in “/wp-content/plugins/buddypress/”.
  5. Head back to the plugins admin panel. You will need to activate the “BuddyPress” plugin by clicking the “Activate Site Wide” or “Activate” link (both will work).

Upgrading the Theme files

If you are using the default themes with no changes:

  1. Delete the /wp-content/member-themes/ directory and /wp-content/themes/buddypress-home/ directory.
  2. Move /wp-content/plugins/buddypress/bp-themes/ to /wp-content/bp-themes/
  3. Move /wp-content/bp-themes/bphome/ to /wp-content/themes/bphome/

If you are using your own customized BuddyPress theme:

  1. Copy the functions.php in /bpmember/ theme to your own BuddyPress theme’s functions.php file.
  2. Copy the header.php from the /bpmember/ theme to your own BuddyPress theme, make any adjustments you need.
  3. Copy the /directories/ folder from the /bpmember/ theme into your own BuddyPress theme. Directories (members/groups/blogs) now have proper template files that you can modify in your BuddyPress theme.
  4. Copy the “directories.css” file from the /css/ directory into your own BuddyPress theme’s /css/ directory (or paste the styles into your style.css file if you do not have a css directory.
  5. Copy /bpmember/profile/index.php into your BuddyPress theme’s /profile/ directory
  6. Make sure your BuddyPress theme is sitting in /wp-content/bp-themes/[theme-name] NOT /wp-content/member-themes/[theme-name]

If you are using a modified version of the BuddyPress home theme:

  1. Copy the functions.php in /bphome/ theme to your own home theme’s functions.php file.
  2. Copy the header.php from the /bphome/ theme to your own home theme, make any adjustments you need.

Please make sure you have followed each and every step before you ask in the forums. We will keep updating this upgrade page if we find anything that has been missed.