开发者 |
daveshine
deckerweb |
---|---|
更新时间 | 2019年2月22日 05:51 |
捐献地址: | 去捐款 |
PHP版本: | 3.5 and bbPress 2.3+ 及以上 |
WordPress版本: | 5.1 |
版权: | GPL-2.0+ |
版权网址: | 版权信息 |
Great Helper Tool for bbPress 2.3+ ;-)
This small and lightweight plugin is pretty much like the regular, packaged bbPress search widget but just offers up to 13 awesome options for you! For example, easily change the search, placeholder and button texts. Also, set visibility options or add optional intro/ outro texts. -- How awesome is that?! :)
Just drag the widget to your favorite widget area and enjoy to have a customized forum-limited search function for your bbPress install ;-).
Since v2.0.0 you can also use the Shortcode [bbpress-searchbox]
anywhere Shortcodes are supported. New feature is also the widgetized content area for forum search that brings no results. Now you can customize this status to your liking and are no longer dependent of the (lame) default string. --- Futher, the plugin is also fully Multisite compatible, you can also network-enable it if ever needed (per site use is recommended).
Features
[bbpress-searchbox]
to have bbPress Forum specific search box anywhere Shortcodes are supported. (See FAQ here for the supported parameters.)bbpress-search-widget.pot
) for translators is also always included :)bbpress-search-widget
folder to the /wp-content/plugins/
directory -- or just upload the ZIP package via 'Plugins > Add New > Upload' in your WP Admin/wp-content/languages/bbpress-search-widget/
(just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like bbpress-search-widget-en_US.mo/.po
to achieve that (for creating one see the tools on "Other Notes").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)Place the Shortcode tag in any Post, Page, Download product, or Shortcode-aware area. A few examples: ` [bbpress-searchbox] --> 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 :-) `
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' );
(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!)
(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' );
/**
(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' );
/**
(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' );
/**
There are CSS classes for every little part included:
#bbpress_search-<ID>
.widget_bbpress_search
.bbpsw-intro-text
#bbpsw-form-wrapper
.bbpsw-search-form
.bbpsw-form-container
.bbpsw-label
.bbpsw-search-field
.bbpsw-search-submit
.bbpsw-outro-text
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.
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!)
/wp-content/languages/buddypress-toolbar/
(just create this folder) - this enables you to use complete custom wording or translations.