Yesterday we setup our first installation of BuddyPress, the WordPress MU specific plugin package that transforms any WPMU installation in to a social networking platform.
BuddyPress is still in a pre-release state, and therefore the installation process has not been streamlined into a nice easy package. I decided to write this article to help anyone else who is trying to install BuddyPress for the first time. This article is very detailed so beginners and experts alike can setup BuddyPress!
Step 1 Install WordPress MU
I’m not going to write how to install WordPress MU. WPMU is as easy to install as regular WordPress and the installation guide can be found here:
One thing to note – When you install WordPress MU, DO NOT edit/rename the wp-config-sample.php file. This is a common mistake made as that is what most people do to install WordPress. If you edit this file your WordPress MU site will display a blank page. WPMU will automatically rename/edit the wp-config-sample.php file during the setup process.
Step 2 Visit the BuddyPress Installation Page
Visit the official installation page located here: http://trac.buddypress.org/wiki/installing-buddypress
This is where you will find the current installation guide and required components for the BuddyPress install. You can read the installation guide here:
The installation guide helps, but there are a few issues it fails to address.
Step 3 Download the required BuddyPress components
Since BuddyPress is in pre-release, you will need to download the installation package from the BuddyPress trunk located here:
Scroll down to the bottom and click the link titled Zip Archive. This will download the most recent release of the BuddyPress framework.
Step 4 Unzip the components
Extract all of the components from the ZIP file inside the trunk folder to a directory on your computer.
Step 5 Install the plugins and theme
Now comes the time to install the components to your WordPress MU installation. Upload all of the component directories and files (except for buddypress-theme) that you extracted during the previous step to the wp-content/mu-plugins folder. Your mu-plugins directory should look similar to the screenshot on the left.
Open the buddypress-theme folder. The two folders inside are buddypress-member and buddypress-home. Navigate to wp-content/themes/ directory on your WordPress MU installation. Delete the home folder from your server and upload the buddypress-member and buddypress-home directory from your computer to the themes folder.
Step 6 Setup BuddyPress in WordPress MU
Now log in to your WordPress MU admin dashboard. If you copied all of the plugin files and directories to the correct places you will now notice a few new admin sections under Site Admin called BuddyPress, Groups, and Profile Fields.
If you receive an error message stating “Registration has been disabled” you need to enable registration on your WordPress MU site. Navigate to Site Admin > Options and Enable Registrations where it says Allow new registrations
The final step is to enable the BuddyPress Home Theme on your site. Navigate to Site Admin > Themes and activate the BuddyPress Home Theme. Now navigate to Design > Themes and click the BuddyPress Home Theme and activate it for your specific site. Now you can view the new theme via your main site URL.
Congratulations! You have just setup a vanilla install of BuddyPress for WordPress MU!
Common BuddyPress Issues and Errors
Error Message: The image you upload must have dimensions of 450 x 450 pixels or larger.
When you upload a Profile Avatar you receive the above error message. BuddyPress is very picky about image sizes. You must upload an image larger than 450×450 for the upload to work. Also verify you have the proper write permissions on the directory wp-content/blogs.dir
Error Message: Please make sure your BuddyPress enabled theme includes a header.php and footer.php file
This error means you have not uploaded the theme folders and files properly to the wp-content/themes directory. You need to extract two folders inside buddypress-theme from the trunk zip, buddypress-member and buddypress-home. Both of these folders need to be placed in your wp-content/themes directory for the profile theme to work. Make sure you delete the old home directory that WPMU created first.
Error Message: Registration has been disabled
You need to enable registration on your WordPress MU site. Navigate to Site Admin > Options and Enable Registrations where it says Allow new registrations.
I hope this article helps anyone wanting to install BuddyPress. If I missed anything or you run in to errors not covered please post a comment. This post will make a nice repository for helping others along the way and we’ll try to help as best we can.
WebDevStudios.com is learning the ins and outs of BuddyPress so we can offer this service to our clients. If you are interested in launching a BuddyPress site, please contact us!