开发者 |
daveshine
deckerweb |
---|---|
更新时间 | 2019年2月22日 05:57 |
捐献地址: | 去捐款 |
PHP版本: | 3.3 及以上 |
WordPress版本: | 5.1 |
版权: | GPL-2.0+ |
版权网址: | 版权信息 |
Nice Little Helper Tool for EDD :-)
This small and lightweight plugin is pretty much like the regular WordPress search widget but limited to only search the post type of the new and awesome Easy Digital Downloads plugin: Downloads.
Just drag the widget to your favorite widget area and enjoy finally to have Downloads-limited search function for your Easy Digital Downloads install ;-).
Since v1.1.0 you can also use the Shortcode [edd-searchbox]
. Futher, the plugin is also fully Multisite compatible, you can also network-enable it if ever needed (per site use is recommended).
Features
[edd-searchbox]
to have (EDD) "Downloads" specific search box anywhere Shortcodes are supported. (See FAQ here for the supported parameters.)edd-search-widget.pot
) for translators is also always included :)edd-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/edd-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 edd-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 downloads for:
)placeholder_text
— Input field placeholder text (default: Search downloads...
)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: ` [edd-searchbox] --> displays search box with default values [edd-searchbox label_text=""] --> will display no label! [edd-searchbox placeholder_text="Search our digital products..." class="my-custom-class"] --> will display other placeholder, plus add custom wrapper class for custom styling :-) `
(1) There's an extra CSS class included for that, named .eddsw-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. - this will work for both, Widget & Shortcode:
/** Easy Digital Downloads Search Widget: Remove Search Label */ define( 'EDDSW_SEARCH_LABEL_DISPLAY', false );
(1) You can use the translation language file to use custom wording for that - for English language the file would be /wp-content/plugins/edd-search-widget/languages/edd-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( 'eddsw_filter_label_string', 'custom_eddsw_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( 'eddsw_filter_placeholder_string', 'custom_eddsw_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( 'eddsw_filter_search_string', 'custom_eddsw_search_string' );
/**
There are CSS classes for every little part included:
#edd_search-<ID>
.widget_edd_search
.eddsw-intro-text
#eddsw-form-wrapper
.eddsw-search-form
.eddsw-form-container
.eddsw-label
.eddsw-search-field
.eddsw-search-submit
.eddsw-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/2857613#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!)