[_ck_]

== Loss of Admin Access ==

It is possible (most likely during REVERSE integration) for admin access to be lost on the bbPress or WordPress side after you integrate a new install. This is because the role of keymaster is stored in the user-meta and if you have gone from BB_USERS to WP_USERS (and BB_USERMETA to WP_USERMETA) , suddenly there is no longer a level set for the user. So the password/login will work but not admin access.

Fixing this requires the role to be inserted back in the usermeta. This used to require editing the table (ie. with PHPMYADMIN) but I also created a basic plugin to handle the most basic case. Note it requires the keymaster to be user #1. If not, you will have to “hand edit”.

[_ck_]

== Integrating WordPress and bbPress Roles ==

Unfortunately I have no experience in this area as it’s a new feature but maybe someone else can contribute. Seems fairly straightforward though and can be found at the bottom of the integration admin menu page.

[_ck_]

== WordPress & bbPress Cookies ==

We’re going to ignore the new WordPress 2.6 cookie method for now and focus on 2.5+0.9 (2.6 triples the complexity)

FIVE things must be identical in WordPress and bbPress configuration for cookies to be sync’ed and logins to be shared:

1. DATABASE secret key

2. wp-config.php/bb-config secret key

3. cookie DOMAIN

4. cookie PATH

5. cookie hash

If ANY of these are not the same, you will get a weird effect where you can be logged into WordPress and not into bbPress or visa-versa and you won’t be automatically logged into one or the other.

#1 can only be seen under /wordpress/wp-admin/options.php and copied to /bbpress/bb-admin/options-wordpress.php

#2 must be edited in each file as appropriate

wp-config.php

@define(‘SECRET_KEY’,’blahblahblah’);

bb-config.php

@define(‘BB_SECRET_KEY’,’blahblahblah’);

#3 & #4 should be edited in each file as appropriate

#5 is the tricky part – in theory bbPress should create the same hash as WordPress if #1 & #2 are the same but sometimes it gets it wrong for one reason or another. You can override the hash and force it to be identical in both programs. There is no easy way to see what hash WordPress is using, you either have to examine your cookies with a bookmarklet or web developer tool or install a plugin that lets you see/edit your WordPress cookies.

[_ck_]

== The Shared User List (table) ==

The most essential concept to all integration is that WordPress and bbPress just share the same list of users in the database.

This is where some people make a mistake right at the start and accidentally create or keep using two separate copies of the user lists (usually one complete with many users and the other just themselves because it’s a fresh install of bbPress).

If you find that after your integrated install of bbPress that it cannot “see” any of your WordPress uses, you must check that bbPress is using both the correct DATABASE, and the correct TABLE.

The most common name for the user table is called WP_USERS

The WP_ is what we call the prefix and indicates that it’s part of WordPress by default. If bbPress is running by itself and not integrated, the prefix is likely BB_. Unless you are doing reverse integration and don’t want to change the table name, there is a 99.9% chance that your user table should be WP_USERS.

If your bbPress cannot see the WordPress users, check your “User database table prefix” in the bbPress integration admin menu OR add this to the bottom of bb-config.php

$bb->wp_table_prefix = 'wp_';

[_ck_]

== Installation locations for WordPress vs bbPress ==

There are actually a few different arrangements to where WordPress vs bbPress can be installed and I suspect this is where some problems and misunderstandings crop up.

1. WordPress in the “webroot” (highest level directory) and bbPress in a subdirectory.

<– WordPress

|

|–forums <– bbPress

(or visa-versa)

2. bbPress in a WordPress sub-directory

|-blogforums <– bbPress “under” WordPress

(You can make this work but it’s a bit messy, no?)

3. WordPress and bbPress each in their own directory

|–blog <– WordPress

|

|–forums <– bbPress

(I like this methed best, seems the most “logical”)

4. WordPress and bbPress both in the “webroot”

(or other same directory)

This is not recommended at this time. Technically it can be done but you are completely on your own to make it work properly and it’s not designed to work this way. BackPress may eventually change this and even make it the preferred way to function.

Otherwise, 1,2 & 3 are perfectly valid ways to operate. IMHO #3 is easier to manage but that’s that’s just personal opinion.

Why do install locations matter? Most importantly it’s because of how the shared cookie paths are handled. If you don’t change the cookiepath to the webroot (“/”) like I suggest below, one program may not be able to see the other program’s cookies.

[_ck_]

== Regular, Reverse & Complex Integration ==

1. If you already have WordPress and are installing bbPress, that is what I called “regular” or “simple” integration and is the most straightforward.

2. If you first have bbPress installed and are trying to install WordPress afterwards, that is what I call “reverse” integration and while it’s definitely possible, it does require a bit more work initially.

== Levels (or Depth) of Integration ==

There are two levels of integration:

1. User information is shared across both WordPress and bbPress – logins are persistent across both programs and they are essentially “aware” of each other but they still run “standalone” – one at a time, instead of both together – I call this “stand-alone” or “simple” integration.

2. bbPress can be made to run “within” WordPress (or visa versa) – where both programs are fully executed for every page loaded – I call this “full”, “deep” or “complex” integration – and I actually advise AGAINST it heavily. There are various reasons to try to avoid this, including server loads and technical issues with the way templates and plugins are processed.

However it definitely can be done and many people have made it work but future products from Automattic like BackPress will make this process much better and I advise to avoid it for now if possible.

If you insist on trying complex integration you can find some helpful instructions from Aditya Naik over here. They are for bbPress 0.8 so they are a little out of date. Instead of “config.php” use “bb-config.php” and you should NOT install the three plugins he recommends as they are no longer needed in versions 0.9 and 1.0

[_ck_]

== Instant Integration for Power Users ==

If you’ve just installed bbPress 0.9 into a WordPress 2.5 website and followed the integration setup questions but it’s just not integrating correctly and you feel you are fairly web savvy you can try this “shortcut”. (Or read the other posts below for more “theory”.)

** If you have lost admin access entirely, do steps #4+ first and then come back to 1,2,3

1. open this url in a browser window to edit:

http://your-website-url.com/bbpress/bb-admin/options-wordpress.php

(/bbpress/ is your install directory for bbpress)

2. open this url in another browser window for reference:

http://your-website-url.com/wordpress/wp-admin/options.php

(/wordpress/ is your install directory for wordpress)

3. you MUST copy the secret text

from /wordpress/wp-admin/options.php

to WordPress database secret

on /bbpress/bb-admin/options-wordpress.php

They *MUST* be IDENTICAL

4. open to Edit bb-config.php in the bbPress directory

5. open to Edit wp-config.php in the WordPress directory

6. bbPress 0.9

the define("SECRET_KEY","blahblahblah") in

your WordPress wp-config.php MUST MATCH the

define("BB_SECRET_KEY","blahblahblah") in

your bbPress bb-config.php

bbPress 1.0

instead of SECRET_KEY in 1.0 there are 3 replacements

AUTH_KEY

SECURE_AUTH_KEY

LOGGED_IN_KEY

you can go here to generate a complex secret_key(s):

bbPress 0.9: https://api.wordpress.org/secret-key/1.0/

bbPress 1.0: https://api.wordpress.org/secret-key/1.1/

(note you must add the BB_ part for the bb-config.php)

7. Copy all these items into the bottom of bb-config.php and edit as required:

$bb->wp_siteurl = 'http://your-site-url.com/blog/';

// that’s your WordPress URL, not bbPress

$bb->wp_home = 'http://your-site-url.com/blog/';

// almost always the same as siteurl unless you tinker

$bb->wp_table_prefix = 'wp_';

// should almost always be wp_ unless you tinkered

$bb->user_bbdb_name = 'username_wordpress';

// this is the MYSQL database name for *WordPress*

// you can copy it right out of WordPress !

$bb->user_bbdb_user = 'username_wp';

// this is the MYSQL user name for *WordPress*

// you can copy it right out of WordPress !

$bb->user_bbdb_password = 'blahblahblah-changeme';

// this is the MYSQL password for *WordPress*

// you can copy it right out of WordPress !

$bb->user_bbdb_host = 'localhost';

// 99.9% of the time it’s going to be localhost, unless you are on DreamHost or some other weird ISP

$bb->custom_user_table = 'wp_users';

// 99.9% of the time it’s going to be wp_users

$bb->custom_user_meta_table = 'wp_usermeta';

// 99.9% of the time it’s going to be wp_usermeta

$bb->authcookie = 'wordpress_12345678901234567890123456789012';

// in theory you should be able to leave this out

// but this is going to be copied from WordPress cookie

// this *must* match the WordPress setting

// do NOT use the 1234567 part, use your own cookiehash from WordPress – see the note at the very bottom

$bb->cookiedomain = '.your-domain-name.com';

// note the leading DOT – this is important

// this *must* match the WordPress setting

$bb->cookiepath = '/';

// I *highly* recommend you set the cookie path to /

// this *must* match the WordPress setting

$bb->sitecookiepath = '/';

// I *highly* recommend you set the cookie path to /

// this *must* match the WordPress setting

8. Copy all these items into the bottom of wp-config.php and edit as required:

$wp->cookiedomain = '.your-domain-name.com';

define(COOKIE_DOMAIN,'.your-domain-name.com');

// note the leading DOT – this is important

// we list both for WordPress legacy compatibility

$wp->cookiepath = '/';

$wp->sitecookiepath = '/';

define('COOKIEPATH', '/' );

define('SITECOOKIEPATH', '/');

// I *highly* recommend you set the cookie path to /

---

Once you get all of the above in sync, you definitely should have login integration between WordPress and bbPress. If not, you’ve either made a typo/mistake or you have a more complex setup (ie. reverse integration)

The hardest part of the above might be the wordpress cookie hash (authcookie). In theory you should be able to leave it out and bbPress should automatically create the same hash as WordPress if the secret keys and salt are the same but sometimes it gets it wrong for one reason or another and you have to force it to be correct.

Unfortunately WordPress does not list the cookie hash on the options page and if you don’t know how to examine your wordpress cookies, this is impossible. Fortunately there is a plugin to look at (and even change) your wordpress cookies:

http://www.2diabolos.com/blog/wp-content/uploads/_setCookieParams.zip

or you can use this bookmarklet to show all the cookies your browser has for a website:

http://javascript.about.com/library/blbcookie.htm

[_ck_]

There are way too many integration questions lately so I am going to try to gather some current info here.

This is an unofficial help guide to try to make a fairly straightforward operation as painless as possible. Feel free to contribute and we’ll edit as necessary.

There is a “power user” shortcut below, but I am also going to try to explain more of the concepts so integration is less “magic” and easier to understand.

With bbPress 0.9, integration is “officially” supported and there is an attempt to make it much easier to accomplish during install but it’s not flawless by any means because of the wide range of possible configurations by users.

update: for adventurous bbPress users, a 1.0 alpha is available that should integrate with WordPress 2.6 – however it is not possible to downgrade back to bbPress 0.9 (because of database changes) afterwards so please keep that in mind – also there are three new items that have to be sync’ed between WP 2.7 and bb 1.0

As of February 2009 it is now possible to use WordPress 2.6, 2.7 or 2.8 with bbPress 0.9 where previously you had to use the unstable bbPress 1.0 alpha. Although WordPress has radically changed the way cookies are used in those versions compared to 2.5, you can either downgrade the WordPress cookie method to the one used in 2.5 via this plugin or you can allow bbPress 0.9 to use the newer WordPress cookies via this plugin.

Keep in mind if you are already using bbPress 1.0 you cannot simply downgrade to bbPress 0.9 because of database changes. However you can always upgrade from bbPress 0.9 to 1.0, so please start with 0.9 instead of 1.0 alpha when possible.

To integrate with WordPress 2.3 see here for extra instructions..

ATTENTION PHP 4 users with WordPress 2.5.0 (aka 2.5)

You MUST upgrade to 2.5.1 – there is a compatibility bug.

Assuming you have access to your bbPress admin area, virtually all integration adjustments (as of 0.9) after installation can now be made at

http://your-website-url.com/your-bbpress-directory/bb-admin/options-wordpress.php

If you’ve lost admin access or it’s not working correctly, most adjustments can be done instead via simple edits to the bb-config.php (and wp-config.php) files. I personally prefer this bb-config.php method because it will override any mistakes in the database regardless.

TABLE OF CONTENTS:

1. Instant Integration for Power Users
2. Regular, Reverse & Complex Integration
3. Levels (or Depth) of Integration
4. Installation locations for WordPress vs bbPress
5. The Shared User List (table)
6. WordPress & bbPress Cookies
7. Integrating WordPress and bbPress Roles
8. Loss of Admin Access
9. Users Registered via bbPress appear as “anonymous” in WordPress
10. Security Considerations when Integrated

.

(there is also a wealth of experience available via the “integration” tag on the forum here)

[_ck_]

If you were not integrated before and had both WP and bbPress setup, you have two user tables and will lose the bbPress users (in theory).

My “fix-admin-access” plugin may give you access but keep in mind if you have two separate tables you are going to lose the info in one. You also must be user #1 or it won’t work at all (I should enhance that plugin eventually to do some other tricks).

Hopefully you are using the WP user table – so try the plugin above and then make sure you login with your WP info, not your bbPress info, into bbPress. I think some people miss this point, that if you integrate into WordPress, you must use your WP login on bbPress.

[falcon1986]

I didn’t give any thought to my bbPress 0.9.0.2 installation before upgrading my WordPress 2.5.1 installation to v2.6. Before the upgrade, the integration was perfect. I didn’t notice the “broken” integration since my browser was set to remember my login information, but once I visited this forum, threads like these forced me to investigate and realize the sad truth!

I hope an update to bbPress comes soon.

[falcon1986]

Use the bbPress Latest Discussions plugin for WordPress. It may not have been updated in a while, but it still works with WordPress 2.6 and bbPress 0.9.0.2.

BTW, WordPress 2.6 breaks login integration with bbPress 0.9.0.2. Look out for a bbPress update soon.

[724719]

ok i found out how to put bbPress in WP . all i did was put this in wp-config.php:-

define('ABSPATH', dirname(__FILE__).'/');

require_once(ABSPATH.'wp-settings.php');

require_once('path/to/bbpress/config.php');

?>

…..But how do I show a list of the latest 5 topics ?

[724719]

I know this is on the forum but for the life of me i just cannot find it. But I need to show the latest threads on my wordpress site.

I remember there was something like adding one line to the wp config file or something like that. does anyone know how to go about doing this and show the latest threads?

thanks

[756769]

I recently installed bbpress as I was already using a wordpress blog and wanted to add a simple forum to my site. As a strictly technophobic, *simple* was the key point!

After installing bbpres successfully, I thought it would be nice to integrate the 2. I followed the instructions, but now find when I log-in to the forum as admin I only get an ordinary users rights, ie I can no longer access the admin screens, even if I try to access the url/bb-admin.

Is there any way I can restore admin rights? or cancel the integration and put thing back as they were? Would a complete re-installation solve the problem? And if so would I lose the forum posts I already put up?

[_ck_]

WordPress doesn’t fall back to the regular user name when there’s no nickname? Weird. I’ve been out of touch with the WordPress side for too long perhaps.

This might be something Sam overlooked in the integration process. We’ll have to ask him when he gets back next week.

update: see this post for a fix:

https://bbpress.org/forums/topic/why-is-integration-so-troublesom#post-17389

[_ck_]

If you are changing a function in pluggable.php, the good news is you do not have to change the core. Just copy the function to a new plugin and edit it there. The plugin will load before “pluggable.php” and superceed the core function. No core edits required.

Glad you got it working but I really dislike “display names” and I think it’s the worst concept in WordPress. Very bad idea to allow users to spoof other names. Even the “impostercide” plugin doesn’t solve all the issues. No other blog/forum system has such a quirky concept.

BTW make sure you do NOT use the “Display Name” plugin for bbPress. It has a great deal of issues with other plugins and causes some weird behavior.

[_ck_]

Oh and “separate wp database”. Does this mean you decided NOT to install bbPress’s tables into the same db as WordPress but a whole new mysql db? I’m not even sure the automated integration can handle that.

[755833]

Well I fixed it, if anyone (incl. developers) are interested. Unfortunately it requires modifying a line of core application code…

pluggable.php in bb-includes

Line 502

$bbdb->insert( $bbdb->users,

compact( ‘user_login’, ‘user_pass’, ‘user_nicename’, ‘user_email’, ‘user_url’, ‘user_registered’ )

);

Replace with

// bbPress / WordPress bug fix added display name to wordpress

$display_name = $user_login;

$bbdb->insert( $bbdb->users,

compact( ‘user_login’, ‘user_pass’, ‘user_nicename’, ‘user_email’, ‘user_url’, ‘user_registered’, ‘display_name’ )

);

[_ck_]

It’s really confusing me why suddenly there are so many people having trouble integrating bbPress 0.9 with WordPress 2.5

You aren’t trying to do what I call “reverse integration” are you – where you install bbPress first and THEN install WordPress? That can only lead to lots of problems (and tears).

Anyway, the automated integration process should pretty solid, except the part where you have to copy the secret key manually (which I strongly disagree with but that’s the way Sam wants to do it).

I think I need to install a fresh copy of 2.5 and try integrating 0.9 to see what all these issues are.

[_ck_]

If you are getting anonymous users, I suspect you haven’t setup integration properly and they are not sharing the same user table.

As far as your other observations (and I felt he same way in the beginning too) you have to realize that (easy) integration was only a priority starting with 0.9

(you can see how complicated the process used to be under 0.8 here – note most of that is not needed now)

Until 0.9, bbPress was just something that ran wordpress.org for Matt and there was no attitude to make integration work. There were tons of problems with usernames etc. and all integration had to be done manually with lots of plugins to fix things.

Then attitudes changed when Matt got funding and decided to use the bbPress code to power TalkPress (essentially forums for users on WordPress.com) Sam and MDA have done a great deal of work to make integration work better but it definitely has a way to go (and should become painless and super-easy IMHO).

So 0.9 has made integration easier but keep in mind bbPress is not even 1.0 yet, so officially it’s not even a released product. The radical cookie changes in 2.6 will take awhile for bbPress to catchup, it’s always been that way.

ps. if it’s not obvious, I am in no way officially associated with Automattic/WordPress/bbPress. Just a plugin developer. And I am not paid. My opinions are definitely just my own and not any kind of official statement.

[_ck_]

Malfhok, you’ll notice that you cannot stay logged into both sides of WordPress and bbPress if you use the admin area. The cookies have completely changed on the WordPress side.

[755833]

From what I can tell the anonymous issue is because users that register through bbPress get added to the wp_users table but the display_name field is left empty. Where do I change the query to put the user_nicename into the display_name on registration, like WordPress does? I’m not sure why bbPress doesn’t do this automatically.

[755833]

I’m not meaning to be rude or anything but I’m struggling to understand why two bits of software made by the same company are so hard to integrate? I’ve never managed to get integration working fully and I always get to the point where users who registered through the forum post on the WordPress blog show up as Anonymous… which basically renders the whole process pointless. I’ve managed to get WordPress and vBulletin to integrate seamlessly, but not bbPress.

bbPress and WordPress are both great pieces of software in their own right, but when it comes to integration with each other they are pretty weak. For example, the new bbPress isn’t compatible with WordPress 2.6 because of an issue with cookie management in WordPress… for the integration to work we now have to wait for bbPress to release an update which according to a moderator on here will be a while away.

There are also so many unsolved integration threads here that it’s very difficult to find any one collection of possible solutions. I appreciate the amount of work that goes into this kind of software and time required to provide support. I’m just feeling a bit frustrated

[755833]

I too would like a solution to this. There is a plugin available to do this but it doesn’t work on wordpress 2.5.1. I think I may just have to hack the bbPress registraton queries.

[_ck_]

nv1962, it would be a good plugin to learn/practice from. Roughly 3-5 lines total. Essentially you’d add an action to bb_send_headers and just like my plugin above, if the bb_get_location==”register-page” you echo the redirect header for the wordpress page (and then do a die() so no other code can execute until it redirects).