bbPress 2.0 Basics
bbPress 2.0 is out and I’m excited. While there is still room to grow (and JTrip will be the first to tell you this), it is a great improvement over previous versions of the plugin. Thanks John James Jacoby and the bbPress team for all your hard word; it’s greatly appreciated.
It’s easy to get up and running. Just down the plugin and activate (http://bbpress.org). It’s easy and works well. However, if you want to start customizing the layout and styles, that’s where it’s get a bit more technical and less plug-and-play. But here’s a few tips for the less obvious mechanics:
Add Forums to Navigation (2 options):
- Use Custom Links to add “/forums” to a menu (this link may differ if you change the base for forums in the forum settings)
- Create a page and use shortcode [bbp-forum-index]; add that page to a menu
Custom Theming
- Use the default (easiest option)
- Replace Styles
- Remove the bbPress styles.css
remove_action( ‘bbp_enqueue_scripts’, ‘bbp_theme_compat_enqueue_css’ ); - Copy default styles to your theme’s stylesheet
/wp-content/plugins/bbpress/bbp-themes/bbp-twentyten/css/bbpress.css - Adjust styles to your whimsy
- Remove the bbPress styles.css
- Replace template files
- Copy files from “/bbpress/bbp-themes/bbp-twentyten” folder into the folder of your theme, and make your own edits from there. The files to copy include the single-*, archive-*, page-*, and anything in the subfolders
- Replace all files, there is no defaulting
- Add add_theme_support( ‘bbpress’ ); to functions.php
Shortcodes
* Forums
[bbp-forum-index] – Show the forum index/archive
[bbp-single-forum id=$forum_id] – Show a single forums topics
* Topics
[bbp-topic-index] – Show the topics index/archive
[bbp-topic-form] – Show the new topic form
[bbp-single-topic id=$topic_id] – Show a single topic
* Topic Tags
[bbp-topic-tags] – Show a tag cloud of all topic tags
[bbp-single-topic-tag] – Show the topics within a specific tag
* Replies
[bbp-reply-form] – Show the topic reply form
* Views
[bbp-single-view] – Show topics associated with a specific view
* Account
[bbp-login] – Show the login screen
[bbp-register] – Show the register screen
[bbp-lost-pass] – Show the lost password screen
If you have any other questions, check out the bbPress forums. It’s a great resource and John is particularly diligent about answering questions. I don’t know how it does it.