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:
http://trac.mu.wordpress.org/browser/trunk/README.txt
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:
http://trac.buddypress.org/browser/trunk/INSTALL-README.txt
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:
http://trac.buddypress.org/browser/trunk
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!
Thanks for the writeup, it’s good read about your experiences getting up and running.
I would strongly reccommend not using the tagged components at the moment, and sticking to the trunk version. The benefit of this is you will get the absolute latest version, as well as being able to download everything in one zip. The tagged components are quite out of date at the moment.
You can get a copy of the latest trunk version in one zip package by visiting this page and hitting the “Zip Archive” link a the bottom.
Andy you don’t know how long I was looking for that link yesterday! haha
Thanks for the suggestion. I’ll update this post to use the trunk zip archive instead. Much easier!
Here’s the link as I missed it off in the last commment:
http://trac.buddypress.org/browser/trunk
Hi Brad,
After installing buddypress. I am getting this error of
Warning: require_once(WP_CONTENT_DIR/member-themes/buddypress-member/index.php) [function.require-once]: failed to open stream:
Can u please help me to solve this problem
Waiting for your reply.
Thanks
Binson
Hey Binson,
They actually made a change to the BuddyPress profile theme location since I wrote this article. The related blog post is here:
http://buddypress.org/forums/topic.php?id=257
As stated you will need to move /wp-content/themes/buddypress-member/ to /wp-content/member-themes/buddypress-member/
I’m going to update this article shortly to reflect this change.
Hey Brad,
Actually i knew this change, have already done the changes that where required still itz showing the same error and also in admin area no themes are been displayed in buddypress theme area. Waiting for your reply.
Thanks
I’m using the most recent trunk for Buddy Press and I’m installing it on WPMu 2.6.5 (a test site) at http://blogpeoria.org
For some reason, the stylesheets don’t seem to be loading when I go into the Members area. I’ve tried it in different browsers.
@Billy – Did you fix the issue? I just looked at your member profiles and they seem to displayed properly. Might also want to upgrade since the beta was released Monday
Its an awesome post. It really helped me installing buddypress.
After installing buddypress. I am getting this error
Registration has been disabled has been disabled how to activate?
under Site Admin > Options you can enable registration for WordPress MU
thanks Brad Williams for answer but I don”t found Admin > Options
in http://buddypress.freenice.org/wp-admin/index.php
i found settings and nothing about enable registration !!
Trying to install a buddypress/MU/bbpress full integration.
I am getting consistent errors when I try and create groups. It tells me: There was an error saving group details. Please try again.
I have been through this tutorial several times:
http://theeasybutton.com/blog/2009/04/30/integrating-buddypress-10-wpmu-and-bbpress/
It still appears that the login syncing is not working. Not sure what else to try.
Same error here: “There was an error saving group details, please try again”.
I am using the very latest BuddyPress build – trunk-r1704 downloaded today, latest WordPress-mu-2.8.4a and bbpress-1.0.2 forum.
Related to group creation error…
I also noticed error in the log file that “WordPress database error Table ‘wp_mu.wp_bp_groups’ doesn’t exist”
Anybody has an idea where to look for the solution?
Same to me 🙁
I have just installed Buddypress which is working fine but I can’t now access my wordpress administrator account. When I login to WP I just get logged into my buddypress site and the admin link does not allow me to do much. Anyone know how I can get back to my control panel?
Thanks,
Can you guys help me with this:
http://i630.photobucket.com/albums/uu22/s2ne1/myblogsremove.png
This post is now 3 years old!
Would I ask too much or would it even be “rude” if someone updated this post on the current stand of it? Is this post still necessary to read or is this on of the 7,398.289.795 post on the internet that contributes to Google being still the biggest content vacuum cleaner? 😉
Hi Karty,
I can ask the guys to write a follow up to this post. I believe a majority of the advice is still relevant if you replace all the WP MU references with MultiSite. In the meantime, you can find more information about installing BuddyPress here: http://buddypress.org/community/groups/installing-buddypress/forum/