Linux 软件免费装
Banner图

bbPress Search Widget

开发者 daveshine
deckerweb
更新时间 2019年2月22日 05:51
捐献地址: 去捐款
PHP版本: 3.5 and bbPress 2.3+ 及以上
WordPress版本: 5.1
版权: GPL-2.0+
版权网址: 版权信息

标签

widget shortcode search not found custom post type search widget reply bbpress forum forums topic deckerweb topics replies bbPress 2.0 searching widget-only

下载

1.0 1.1 1.2 2.0.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 Useful for/ Use Cases Localization Feedback Tips & More

安装:

  1. Upload the entire 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
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. On the regular WordPress Widgets settings page just drag the bbPress: Forum Search Widget to your favorite widget area, setup a few options and you're done :)
  4. (Optional) Or use the built-in Shortcode to place a little bbPress search box anywhere Shortcodes are supported. See FAQ here for parameters... :)
PLEASE NOTE: You need WordPress 3.5 or higher AND bbPress 2.3 or higher for this plugin in order to work! So, just update your install! Note for legacy installs: If you have an install with older versions you can still use version 1.1.0 or 1.2.0 of this plugin, just download from here: http://wordpress.org/extend/plugins/bbpress-search-widget/developers/ (Just beware of updates then, until you upgraded your whole install :) Note for own translation/wording: For custom and update-secure language files please upload them to /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").

屏幕截图:

  • bbPress Search Widget: the extended search widget with its options. ([Click here for larger version of screenshot](https://www.dropbox.com/s/aqi4hmk520vvn8x/screenshot-1.png))
  • bbPress Search Widget: the new widgetized not found content area in Widgets admin. ([Click here for larger version of screenshot](https://www.dropbox.com/s/kr6b40ta0358arh/screenshot-2.png))
  • bbPress Search Widget in a sidebar: default state (shown here with [the free Autobahn Child Theme for Genesis Framework](http://genesisthemes.de/en/genesis-child-themes/autobahn/)). ([Click here for larger version of screenshot](https://www.dropbox.com/s/c4jz6z6781r45vz/screenshot-3.png))
  • bbPress Search Widget in a sidebar: custom intro and outro text shown - all parts can by styled individually, just [see FAQ section here](http://wordpress.org/extend/plugins/bbpress-search-widget/faq/) for custom CSS styling. ([Click here for larger version of screenshot](https://www.dropbox.com/s/aszrnexdyn2c9l4/screenshot-4.png))
  • bbPress Search Widget: widgetized content area in action, when forum search returned no results. ([Click here for larger version of screenshot](https://www.dropbox.com/s/n6rbejr2tsmavx7/screenshot-5.png))
  • bbPress Search Widget: plugin help tab system. ([Click here for larger version of screenshot](https://www.dropbox.com/s/pi1yz1geth0c5cm/screenshot-6.png))

升级注意事项:

2.0.0 Major additions & improvements: Added Shortcode; improved Widget; code/ documentation improvements. New partly Spanisch & French translations, updated German translations and .pot file for all translators. 1.2.1 (Private development version.) 1.2 Several additions & improvements: Added new CSS selector for improved styling & compatibility with themes. Added help tab system. Further optimized loading of admin stuff. Also, updated language files together width German translations. 1.1 Several changes and improvements - Improved search results display and theme compatibility. The forum post type selection is gone, now automatically searches in topics and replies. Also, updated language files together width German translations. 1.0 Just released into the wild.

常见问题:

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: ` [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 :-) `

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!)

更新日志:

2.0.0 (2013-05-02) 1.2.x (2012) 1.2.0 (2012-05-23) 1.1.0 (2012-04-15) 1.0.0 (2011-10-10)