That would be nice, and I’ll most likely research something similar to this after 2.0. The problem is there is no way to add an additional theme path check on top of the parent theme and the child theme locations. Even then, that doesn’t make the single-, archive-, and page- templates match the HTML structure of your current theme, which means manually editing them anyways.
As annoying as it is to add theme support for bbPress and not have the files there, that’s also the easiest way to communicate ability between theme and plugin. If you add theme support for post thumbnails, and then don’t use post thumbnails in your theme, you just don’t have post thumbnails.
Thank you John for this thread.
I’m currently working on the bbpress-plugin integration for my own themes. One point which is really annoying:
If I add theme-support for bbpress, the plugin only looks for bbpress-templates inside my theme folder. If i haven’t any template files stored there, no fallback is implemented and therefore nothing is displayed.
Wouldn’t it be nice, if bbpress looks first on the child-theme for its specific template-files, second at the parent-theme and last takes the builtin template-files from bbpress-twentyten theme?
The drawback with the currently implementet solution is, that I have to copy every template-file over in my own theme. Regardless of the fact, that I only want to alter one specific template-file. Same goes for a specific css stylesheet.
I looked at the sourcecode and it seems that i can hook into the filter “bbp_get_theme_compat” and simply de/register a new ‘bbpress-style’ stylesheet. But I think I’m not the only one which is looking for a solution inside bbpress-core.
If I missed something, do not hesitate to correct me.
Thanks
Roman
Thank you John for this thread.
I’m currently working on the bbpress-plugin integration for my own themes. One point which is really annoying:
If I add theme-support for bbpress, the plugin only looks for bbpress-templates inside my theme folder. If i haven’t any template files stored there, no fallback is implemented and therefore nothing is displayed.
Wouldn’t it be nice, if bbpress looks first on the child-theme for its specific template-files, second at the parent-theme and last takes the builtin template-files from bbpress-twentyten theme?
The drawback with the currently implementet solution is, that I have to copy every template-file over in my own theme. Regardless of the fact, that I only want to alter one specific template-file. Same goes for a specific css stylesheet.
I looked at the sourcecode and it seems that i can hook into the filter “bbp_get_theme_compat” and simply de/register a new ‘bbpress-style’ stylesheet. But I think I’m not the only one which is looking for a solution inside bbpress-core.
If I missed something, do not hesitate to correct me.
Thanks
Roman
Signup/start page:
Are search, login and register supposed to be on the first page of the forum (typically blog.tld/forums/ ? Neither the twentyten or the themes integration seems to give that.
Is there a widget for signup as well as login? Would be a nice way to have people sign up.
Spam?
How is spam handled? I can see no feature for blocking ip-adresses and blacklisting. Is spam handled with the Akismet plug-in I have already installed in my wordpress installation?
Documentation
Where do I find documentation for the plugin? I see it mentioned in the forum here, but have not been able to find the site.
Will there be a way to merge bbPress 2.0 with 1.0.3?
What version of bbPress are you using?
What version of bbPress are you using?
Check out the Theme Compatibility sticky topic, and confirm that you’ve followed all the steps correctly.
Check out the Theme Compatibility sticky topic, and confirm that you’ve followed all the steps correctly.
A few questions have cropped up already, so lets funnel the discussion here.
bbPress 2.0 introduces a radical new approach at integrating robust new functionality into existing WordPress themes. If you’re an average user looking for a turn-key forum solution, this works out pretty awesomely – If you’re a talented developer trying to beat your own drum, it’s all probably a little bit confusing.
Theme Compatibility
bbPress comes with a child theme of TwentyTen, titled (you guessed it) bbPress – TwentyTen. This theme includes all of the custom bits that bbPress needs to function, broken up into template parts to allow them to be used in several places, like template files, shortcodes, and widgets.
- MOST COMMON – If you’re using any other conventional WordPress theme (TwentyEleven, BP-Default) and find the default template layout of bbPress acceptable, you don’t need to do anything at all – it should just work.
- DO NOT put any custom themes in “/bbpress/bbp-themes/” as they will get wiped out when you update bbPress.
- CUSTOM – If you want to build your own theme or make changes to the existing template files, you’ll need to do the following:
Copy Files
-
If this is not a custom theme under your control (meaning you are not the author) you’ll want to copy the contents of the “/bbpress/bbp-themes/bbp-twentyten” folder into your “wp-content/themes/%YOURTHEMENAME%” folder, where %YOURTHEMENAME% is the name of your custom Child Theme of whatever your current theme is. This is so theme updates don’t wipe out all your hard work later.
-
If you are the author of this theme, then you can copy all the files *out of* the “/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.
- In neither case should a new folder with the name “bbp-twentyten” exist. You are not copying the FOLDER, you are copying what’s IN the folder.
Add Theme Support
Now that you’ve got the files copied over, you’ll need to tell bbPress that you are in control of the theme situation. You do this by adding this to your functions.php file:
add_theme_support( 'bbpress' );
By doing this, you’re telling bbPress that your theme has its own template files to handle all of the new functionality that bbPress adds. This method gives you a single on/off switch to either use the standard theme compatibility, or use your own.
In the future, specialized template compatibility themes can be created either as plugins or child-themes to work like “add on packages” to existing themes, without requiring elaborate edits to existing themes, moving files around, etc…
Shortcodes (as of May 23, 2011)
Whether you rely on theme compatibility, or decide to go the custom route, we’ve included a few standard shortcodes to let you output specific forum content on any post or page in your forums. This is accomplished within an output buffer, so they won’t interfere with any of your existing page or post content. Note that if your theme specifically removes the shortcode functionality, these will not work, and will instead the actual text of the shortcode will appear on your site.
- [bbp-forum-index] – Show the root forums
- [bbp-single-forum id="A forum ID"] – Show a specific forum
- [bbp-topic-index] – Show all topics
- [bbp-single-topic id="A topic ID"] – Show a specific topic
- [bbp-topic-tags] – Show all topic tags
- [bbp-topic-tag] – Show topics of a specific tag
- [bbp-topic-form] – Show the new topic form
- [bbp-reply-form] – Show the new reply form (not commonly used)
- [bbp-single-view id="A view slug"] – Show the topics of a registered view
In the future, we’ll be adding more shortcodes as the needs arise.
That’s it for the first round of explanations. I’ll edit this post as more questions and answers come through.
Hi there !
I already installed the latest version of BB and WP and the forum works.
But my questions is, how do include this forum as “page” or “article” in WordPress and the mainmenu ?
Sorry if im just blind, i searched the whole site and can`t find a step by step solution for it.
I tried to include it with WP plugin “include me” wich don`t seem to work.
Can someone tell me please where i can find it or give me a hint ?!
Thank you in advance, BBpress seems to be the forum for wich im searching for a long time. And sorry for english, i now it`s not that good.
i added the wordpress -bb plugin too and enabled it.
Seems everything fine, but still my question is:
how to include the forum into a page or a articel of WP like its here at your site. I don`t check it.
Greetings
John,
Worked! Ill write an explanation when i get back from work on how to integrate for everyone 
Also, looks like it shows some stuff double? ( the yellow bars saying no forums found
)
http://magic.unique-masters.com/discussions/
cheers,
Aron
John,
Worked! Ill write an explanation when i get back from work on how to integrate for everyone 
Also, looks like it shows some stuff double? ( the yellow bars saying no forums found
)
http://magic.unique-masters.com/discussions/
cheers,
Aron
Sorry; I don’t understand the question. bbPress won’t move any files for you on its own. You mentioned that you’ve physically moved files (hopefully you copied, and did not remove them from the bbPress folder.) By putting
add_theme_support( 'bbpress' );
in your theme, you’re telling bbPress “I don’t need your help anymore and I have everything under control.” If you didn’t copy all of the files correctly, then bbPress won’t know what to do.
Sorry; I don’t understand the question. bbPress won’t move any files for you on its own. You mentioned that you’ve physically moved files (hopefully you copied, and did not remove them from the bbPress folder.) By putting
add_theme_support( 'bbpress' );
in your theme, you’re telling bbPress “I don’t need your help anymore and I have everything under control.” If you didn’t copy all of the files correctly, then bbPress won’t know what to do.
John,
Thanks for your reply! bbPress did not do that, does that have anything to do with folder permissions?
cheers
Aron
John,
Thanks for your reply! bbPress did not do that, does that have anything to do with folder permissions?
cheers
Aron
Since you’re manually adding theme support to your existing theme (as opposed to letting bbPress do it for you) you’ll need to move the other single/archive/page template files from bbp-twentyten into your existing theme too.
Since you’re manually adding theme support to your existing theme (as opposed to letting bbPress do it for you) you’ll need to move the other single/archive/page template files from bbp-twentyten into your existing theme too.
Neat. I definitely like the bbPress forums better.
Neat. I definitely like the bbPress forums better.
You could just as easily put some code in the sidebar.php of your theme to show/hide whenever you want it to. Contextual sidebars are an oft requested WordPress core feature too.
You could just as easily put some code in the sidebar.php of your theme to show/hide whenever you want it to. Contextual sidebars are an oft requested WordPress core feature too.
@jarledb – Eventually bbPress will be on GlotPress, which will enable easier crowd sourcing of translations.
Will look into getting into GlotPress soon.