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.

Easy Digital Downloads Search Widget

Description

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

  • Improved search results display for themes and (EDD) “Downloads” post type detection/ restriction.
  • Optional widget display options for faster setup.
  • Two – fully optional – text fields: “Intro text” and “Outro text” to display for example additional Downloads or user instructions. Just leave blank to not use them!
  • Shortcode [edd-searchbox] to have (EDD) “Downloads” specific search box anywhere Shortcodes are supported. (See FAQ here for the supported parameters.)
  • Lots of filter hooks & action hooks throughout the plugin, making it even more flexible and developer friendly
  • Fully WPML compatible!
  • Fully Multisite compatible, you can also network-enable it if ever needed (per site use is recommended).
  • Tested with WordPress branches: 3.5, plus upcoming 3.6, as well as with older branches 3.3 and 3.4 – also in debug mode (no stuff there, ok? 🙂

Localization

A plugin from deckerweb.de and GenesisThemes

Feedback

  • I am open for your suggestions and feedback – Thank you for using or trying out one of my plugins!
  • Drop me a line @deckerweb on Twitter
  • Follow me on my Facebook page
  • Or follow me on +David Decker on Google Plus 😉

Tips & More

Plugin Links

Donate

Enjoy using Easy Digital Downloads Search Widget? Please consider making a small donation to support the project’s continued development.

Translations

  • English – default, always included
  • German (de_DE): Deutsch – immer dabei! Download auch via deckerweb.de
  • For custom and update-secure language files please upload them to /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 following tools).

Easy plugin translation platform with GlotPress tool: Translate “Easy Digital Downloads Search Widget”…

Note: All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome “Codestyling Localization” plugin and for validating the “Poedit Editor”, which works fine on Windows, Mac and Linux.

Additional Info

Idea Behind / Philosophy: A search feature or a widget is just missing yet for the new and awesome Easy Digital Downloads forum plugin. So I just set up this little widget. It’s small and lightweight and only limited to this functionality.

Screenshots

Installation

  1. Upload the entire 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
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. On the regular WordPress Widgets settings page just drag the EDD Downloads Search to your favorite widget area and you’re done 🙂

How It Works

  • All is done smoothly under the surface 🙂
  • Downloads: searches in Downloads title, Downloads content/excerpts.

Note for own translation/wording: For custom and update-secure language files please upload them to /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”).

FAQ

What are the supported Shortcode parameters?

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)
How to use the Shortcode?

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 :-)
How can I style or remove the label “Search downloads for”?

(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 );
How can I change the text of the label “Search downloads 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/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' );
/**
 * Easy Digital Downloads Search Widget: Custom Search Label
 */
function custom_eddsw_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( 'eddsw_filter_placeholder_string', 'custom_eddsw_placeholder_string' );
/**
 * Easy Digital Downloads Search Widget: Custom Placeholder Text
 */
function custom_eddsw_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( 'eddsw_filter_search_string', 'custom_eddsw_search_string' );
/**
 * Easy Digital Downloads Search Widget: Custom Search Button Text
 */
function custom_eddsw_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/2857613 (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: #edd_search-<ID>
  • main widget class: .widget_edd_search
  • intro text: .eddsw-intro-text
  • form wrapper ID: #eddsw-form-wrapper
  • form: .eddsw-search-form
  • form div container: .eddsw-form-container
  • search label: .eddsw-label
  • input field: .eddsw-search-field
  • search button: .eddsw-search-submit
  • outro text: .eddsw-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/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!)

Contributors & Developers

“Easy Digital Downloads Search Widget” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.1.0 (2013-04-29)

  • NEW: Added input options to Widget directly for: Label text, Placeholder text, Search button text — now it’s really easy to change this stuff, right? 🙂
  • NEW: Added widget display options to have faster setup of the widget. Default setting is “global” (as was before). — Note: If the provided options are not enough, just use the default setting and use other plugins like “Widget Logic” or “Widget Display” to setup more complex widget display behaviors.
  • NEW: Added Shortcode to display a little (EDD) “Downloads”-specific search box anywhere, see FAQ here for supported parameters.
  • UPDATE: Some code refactoring for improved performance and better future maintenance.
  • UPDATE: Improved and extended help tab system.
  • CODE: Some code/ documentation updates & improvements.
  • UPDATE: Updated German translations and also the .pot file for all translators!
  • UPDATE: Initiated new three digits versioning, starting with this version.
  • UPDATE: Moved screenshots to ‘assets’ folder in WP.org SVN to reduce plugin package size.
  • NEW: Added banner image on WordPress.org for better plugin branding 🙂

1.0.0 (2012-06-02)

  • Initial release