[_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_]

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).

[_ck_]

Well login integration is not as important as the register part. As far as your instructions, I wouldn’t recommend deleting the contents of a core file but the redirect part is okay.

It occurs to me, it’s actually possible to redirect the register page in bbpress to the wordpress side via plugin with no edits required anywhere.

Remember that bbPress registration process should catch up to the WordPress side eventually. In fact I like it’s layout better but WordPress’s is more mature code-wise.

[_ck_]

Yes, this is why I always recommend to people when integrating with WordPress that they redirect all login and registration links to the wordpress side. It’s had years of development in that area.

In any case, here is a simple plugin to prevent duplicate email addresses. Unfortunately bbPress has no way to place custom error messages on the page without template hacking but this should do:

<?php

/*

Plugin Name: no duplicate email addresses

Author: _ck_

*/



if ($_POST && bb_get_location()=="register-page") {add_filter('bb_verify_email','no_duplicate_email');}



function no_duplicate_email($email) {

if ($email) {global $bbdb; if (!$bbdb->get_row($bbdb->prepare("SELECT * FROM $bbdb->users WHERE user_email = %s", $email))) {return $email;}

else {add_action('bb_foot','no_duplicate_email_alert'); return false;}}

}

function no_duplicate_email_alert() {echo "<scr"."ipt>alert('".__("email address already registered")."');</script>";}

?>

(bbPress 0.9 or higher required)

[Alvaro Degives-Mas]

(Subtitle: how to use registration protection/filtering in WP for bbPress – the lazy but effective way!)

Say: you’re a PHP newbie (like me), want to run bbPress and WP, and have successfully completed the installation of the plugin to integrate the bbPress user database with WP’s (whew!) and then you discover that people can register via either the bbPress or WP . Suppose furthermore that you’re getting hammered by nasty bots registering themselves, and have an open self-registration policy on your WP blog/CMS, and therefore installed a nifty registration screening plugin (oh say, WP-reCAPTCHA) and would like to use that for bbPress.

How could you do that? With two simple edits you can:

1) Open the register.php file of bbPress (in bbPress’ root directory) and delete EVERYTHING in it, and save your cleaned-out register.php file back to its place on the server (saving an empty file is to avoid a possible “file not found” error after the next step)

2) Open (or create if you don’t have it – which would be rare) a .htaccess file in the web server’s root directory and add the following single line (it’s displayed here on two lines, but really ought to be a single line!), and put that at/near the top of your .htaccess file (assuming your bbPress install sits in the /forum sub directory; else, modify accordingly to point to the register.php file):

Redirect permanent /forum/register.php http://www.example.com/wp-login.php?action=register

Make sure you substitute “example.com” with your own domain (of course).

3) This step is non-existent. Instead, enjoy your newfound unified registration bliss for dummies!

[chrishajer]

I would back up your database first, just to be sure.

If you delete all the files, nothing happens to WordPress.

If you delete all the bb_ tables, that does not affect WordPress.

I’m not sure how you get rid of the bb users from the wp_users table. But once you delete all the bb_ tables from the database, you should verify that you can log in to WordPress admin fine. You might want to manually delete the bb users from the wp_users table, but you’d have to be careful if they created any content in WordPress that would be keyed to their id.

I think this covers integration:

https://bbpress.org/documentation/integration-with-wordpress/