CINXE.COM

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("http://bbpress.org/documentation/integration-with-wordpress/","20101027171903","https://web.archive.org/","web","/_static/", "1288199943"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" />  <meta http-equiv="X-UA-Compatible" content="IE=8"/> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <title>bbPress » Integration with WordPress</title> <meta name="robots" content="all"/> <meta http-equiv="imagetoolbar" content="no"/> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <link rel="stylesheet" href="/web/20101027171903cs_/http://bbpress.org/common-theme/960/reset.css" type="text/css"/> <link rel="stylesheet" href="/web/20101027171903cs_/http://bbpress.org/common-theme/960/text.css" type="text/css"/> <link rel="stylesheet" href="/web/20101027171903cs_/http://bbpress.org/common-theme/960/960.css" type="text/css"/> <link rel="stylesheet" href="https://web.archive.org/web/20101027171903cs_/http://bbpress.org/blog-wp-content/themes/bb/style.css?1" type="text/css"/> <link rel="shortcut icon" type="image/ico" href="/web/20101027171903im_/http://bbpress.org/favicon.ico"/> <link rel="alternate" type="application/rss+xml" title="RSS 2.0" href="https://web.archive.org/web/20101027171903/http://bbpress.org/feed/"/> <link rel="alternate" type="application/rss+xml" title="bbPress Blog 禄 Integration with WordPress Comments Feed" href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/integration-with-wordpress/feed/"/> <link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://bbpress.org/wordpress/xmlrpc.php?rsd"/> <link rel="wlwmanifest" type="application/wlwmanifest+xml" href="http://bbpress.org/wordpress/wp-includes/wlwmanifest.xml"/> <link rel="index" title="bbPress Blog" href="http://bbpress.org/"/> <link rel="up" title="Documentation" href="http://bbpress.org/documentation/"/> <link rel="prev" title="Installation" href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/installation/"/> <link rel="next" title="Customization" href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/customization/"/> <meta name="generator" content="WordPress 3.0.1"/> <link rel="canonical" href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/integration-with-wordpress/"/> </head> <body id="BODYID"> <div id="bborg-banner-container"> <div id="bborg-banner" role="banner" class="container_12"> <div class="grid_3"> <h1 id="bborg-title"><a href="/web/20101027171903/http://bbpress.org/">bbPress</a></h1> </div> <div class="grid_9"> <ul id="bborg-nav"> <li><a href="/web/20101027171903/http://bbpress.org/">Home</a></li> <li><a href="/web/20101027171903/http://bbpress.org/plugins/">Plugins</a></li> <li><a href="/web/20101027171903/http://bbpress.org/about/">About</a></li> <li><a class="current" href="/web/20101027171903/http://bbpress.org/documentation/">Docs</a></li> <li><a href="/web/20101027171903/http://bbpress.org/blog/">Blog</a></li> <li><a href="forums/">Forums</a></li> <li><a class="download" href="download/">Download</a></li> </ul> </div> <div class="clear"></div> </div> </div> <div class="clear"></div> <div id="bborg-login-container"> <div class="container_12"> <h2>Integration with WordPress</h2> </div> <div class="clear"></div> </div> <div role="main" id="main" class="container_12"><div class="homebox grid_12"> <div id="sidebar"> <div id="submenu"> <ul> <li class="page_item "><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/">Documentation</a></li> <li class="page_item page-item-35"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/installation/" title="Installation">Installation</a></li> <li class="page_item page-item-277"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/get-involved/" title="Get Involved">Get Involved</a></li> <li class="page_item page-item-338"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/template-tags/" title="Template Tags">Template Tags</a></li> <li class="page_item page-item-51"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/upgrading/" title="Upgrading">Upgrading</a></li> <li class="page_item page-item-42"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/faq/" title="FAQ">FAQ</a></li> <li class="page_item page-item-37"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/customization/" title="Customization">Customization</a></li> <li class="page_item page-item-61"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/themes/" title="Themes聽and聽Templates">Themes and Templates</a></li> <li class="page_item page-item-36 current_page_item"><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/documentation/integration-with-wordpress/" title="Integration with WordPress">Integration with WordPress</a></li> </ul> </div> </div> <div class="post"> <div class="storycontent"> <p>bbPress integration should work with most recent version of WordPress in the 2.9.x series. You should <a href="https://web.archive.org/web/20101027171903/http://codex.wordpress.org/Upgrading_WordPress">upgrade your blog</a> before trying to get WordPress and bbPress talking to each other.</p> <p>If you absolutely <em>must</em> integrate with a version of WordPress prior to version 2.5, then read <a href="https://web.archive.org/web/20101027171903/http://bbpress.org/forums/topic/how-to-integrate-bbpress-09-with-wordpress-23-or-lower">this topic</a> in the forums for details on how to do it.</p> <h3 id="db">Database</h3> <p>bbPress can share user data with an existing WordPress installation. All you need to do is specify the location of that database on installation or afterwards in the “WordPress Integration” section of the “Settings” area in your bbPress admin.</p> <h3 id="cookie">Cookies</h3> <p>Integrating cookies allows your users to log in to either your WordPress blog or your bbPress forums and be effectively logged in to both. This feature requires your WordPress and bbPress installations to exist in the same domain name, or at least in sub-domains of the same domain name.</p> <p>See the “WordPress Integration” section of the “Settings” area in your bbPress admin for the settings you need to add to your WordPress config file after you have added the WordPress information in the “Cookies” form there.</p> <h3 id="reg">Registration</h3> <p>When a user registers on your bbPress forum, your WordPress blog doesn’t know about it (and vice versa). The user will be created, but WordPress won’t know what <a href="https://web.archive.org/web/20101027171903/http://codex.wordpress.org/Roles_and_Capabilities">user role</a> to apply.</p> <p>In the “WordPress Integration” section of the “Settings” area in your bbPress admin you will find a “User Role Map” where you can set which roles will be applied to users who register on your forums. Users who register on your WordPress blog will have the appropriate role applied to their account when they first login to bbPress.</p> <p>If you don’t setup a role map, then this will not work. When you do setup a role map (or change it) any users who are missing either role will be updated, but existing roles will not be affected.</p> <h3 id="func">Functions (optional)</h3> <p>bbPress will not have access to WordPress’ functions unless you manually tell bbPress to load WordPress first. This integration step is also known as “deep” integration, it is a totally optional part of integration and is not required to get shared cookies and logins working. In order to do it, you need to put <code>require_once(dirname(__FILE__) . '/path/to/wp-load.php');</code> in bbPress’ <code>bb-config.php</code> (<code>wp-load.php</code> is in the same directory as WordPress’ <code>wp-config.php</code> file, so if your bbPress folder is directly inside your WordPress folder, the command becomes <code>require_once(dirname(__FILE__) . '/../wp-load.php');</code>).</p> <p>Doing this will add quite a lot of weight to your bbPress installation as it will cause WordPress to load in it’s entirety. Your best option is to try to emulate the functionality you require inside a bbPress plugin.</p> </div> <div class="feedback"> </div> </div> </div> </div> <div class="clear"></div> <div id="bborg-contentinfo" role="contentinfo" class="container_12"> <div id="bborg-extra" class="grid_2"> <ul> <li><a href="/web/20101027171903/http://bbpress.org/about/privacy/">Privacy</a></li> <li><a href="/web/20101027171903/http://bbpress.org/about/gpl/"><abbr title="GNU Public License">GPL</abbr></a></li> </ul> </div> <div id="bborg-also" class="grid_8"> <h2>See also:</h2> <ul> <li><a href="https://web.archive.org/web/20101027171903/http://wordpress.org/">WordPress.org</a></li>  <li><a href="https://web.archive.org/web/20101027171903/http://wordpress.tv/">WordPress.TV</a></li> <li><a href="https://web.archive.org/web/20101027171903/http://wordcamp.org/">WordCamp</a></li> <li><a href="https://web.archive.org/web/20101027171903/http://jobs.wordpress.net/">WP Jobs</a></li> <li><a href="https://web.archive.org/web/20101027171903/http://ma.tt/">Matt</a></li> <li><a href="https://web.archive.org/web/20101027171903/http://www.facebook.com/pages/bbPress/37285629283/">Fan bbPress on Facebook</a></li> <li><a href="https://web.archive.org/web/20101027171903/http://bbpress.org/blog/feed/" class="feed">Blog Feed</a></li> </ul> </div> <div class="clear"></div> </div> <script src="https://web.archive.org/web/20101027171903js_/http://www.google-analytics.com/urchin.js" type="text/javascript"> </script> <script type="text/javascript"> _uacct = "UA-52447-7"; urchinTracker(); </script> </body> </html>