Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

bbPress Search Widget

Extended search widget for bbPress 2.3+, plus Forum search Shortcode, plus widgetized not found content area for Form search 'no results'.

What are the supported Shortcode parameters?

Currently, these attributes/ parameters are available:

  • label_text — Label text before the input field (default: Search Forums, Topics, Replies for:)
  • placeholder_text — Input field placeholder text (default: Search Forums, Topics, Replies...)
  • button_text — Submit button text (default: Search)
  • class — Can be a custom class, added to the wrapper div container (default: none, empty)

How to use the Shortcode?

Place the Shortcode tag in any Post, Page, Download product, or Shortcode-aware area. A few examples:

--> displays search box with default values

[bbpress-searchbox label_text=""]
--> will display no label!

[bbpress-searchbox placeholder_text="Search our support forums..." class="my-custom-class"]
--> will display other placeholder, plus add custom wrapper class for custom styling :-)

Can I remove the widgetized content area for forum search "not found"?

Of course, that possible - very easily :). Just add the following line of code to your theme's/ child theme's functions.php file or a functionality plugin:

/** bbPress Search Widget: Remove Widgetized Content Area on "not found" */
add_filter( 'bbpsw_filter_noresults_widgetized', '__return_false' );

How can I style or remove the label "Search forum in topics and replies for"?

(1) There's an extra CSS class included for that, named .bbpsw-label so you can style it with any rules or just remove this label with display:none.

(2) Second option, you can fully remove the label by adding a constant to your theme's/child theme's functions.php file or to a functionality plugin etc.:

/** bbPress Search Widget: Remove Search Label */
define( 'BBPSW_SEARCH_LABEL_DISPLAY', false );

The following FAQ items were for plugin version prior v2.0.0 - but are still there and can be used (backward compatibility!)

How can I change the text of the label "Search forum in topics and replies for"?

(1) You can use the translation language file to use custom wording for that - for English language the file would be /wp-content/plugins/bbpress-search-widget/languages/bbpress-search-widget-en_US.mo. Just via the appropiate language/translation file. For doing that, a .pot/.po file is always included.

(2) Second option: Or you use the built-in filter to change the string. Add the following code to your functions.php file of current them/child theme, just like that:

add_filter( 'bbpsw_filter_label_string', 'custom_bbpsw_label_string' );
 * bbPress Search Widget: Custom Search Label
function custom_bbpsw_label_string() {
    return __( 'Your custom search label text', 'your-theme-textdomain' );

How can I change the text of the placeholder in the search input field?

(1) See above question: via language file!

(2) Or second option, via built-in filter for your functions.php file of theme/child theme:

add_filter( 'bbpsw_filter_placeholder_string', 'custom_bbpsw_placeholder_string' );
 * bbPress Search Widget: Custom Placeholder Text
function custom_bbpsw_placeholder_string() {
    return __( 'Your custom placeholder text', 'your-theme-textdomain' );

How can I change the text of the search button?

(1) Again, see above questions: via language file!

(2) Or second option, via built-in filter for your functions.php file of theme/child theme:

add_filter( 'bbpsw_filter_search_string', 'custom_bbpsw_search_string' );
 * bbPress Search Widget: Custom Search Button Text
function custom_bbpsw_search_string() {
    return __( 'Your custom search button text', 'your-theme-textdomain' );

All the custom & branding stuff code above as well as theme CSS hacks can also be found as a Gist on GitHub: https://gist.github.com/2394575 (you can also add your questions/ feedback there :)

How can I further style the appearance of this widget?

There are CSS classes for every little part included:

  • main widget ID: #bbpress_search-<ID>
  • main widget class: .widget_bbpress_search
  • intro text: .bbpsw-intro-text
  • form wrapper ID: #bbpsw-form-wrapper
  • form: .bbpsw-search-form
  • form div container: .bbpsw-form-container
  • search label: .bbpsw-label
  • input field: .bbpsw-search-field
  • search button: .bbpsw-search-submit
  • outro text: .bbpsw-outro-text

How can I style the actual search results?

This plugin's widget is limited to provide the widget and search functionality itself. Styling the search results output in your THEME or CHILD THEME is beyond the purpose of this plugin. You might style it yourself so it will fit your theme.

In my theme this widget's display is "crashed" - what could I do?

Please report in the support forum here, giving the correct name of your theme/child theme plus more info from where the theme is and where its documentation is located. For example the "iFeature Lite" theme, found on WordPress.org has issues with the CSS styling. For this example theme you found a CSS fix/hack directly here: https://gist.github.com/2394575#file_theme_ifeature_lite.css ---> Just place this additional CSS styling ad the bottom of this file /wp-content/themes/ifeature/css/style.css (please note the /css/ subfolder here!)

Requires: 3.5 and bbPress 2.3+ or higher
Compatible up to: 3.6.1
Last Updated: 4 years ago
Active Installs: 1,000+


5 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,4,4 100,2,2 100,5,5
100,6,6 100,2,2 100,5,5
100,3,3 100,5,5
100,6,6 100,4,4
100,1,1 100,5,5