Cette extension n’a pas été testée avec plus de trois mises à jour majeures de WordPress. Elle peut ne plus être maintenue ou supportée et peut avoir des problèmes de compatibilité lorsqu’elle est utilisée avec des versions de WordPress plus récentes.

Cherry Search


With this plugin you will be able to add advanced search functionality to your WordPress website. It is multilingual, and is fully compatible with WooCommerce themes, so you can enhance your eCommerce website with a powerful conversion booster.
The plugin is based on AJAX, which means that the results will be displayed dynamically. Your visitors will immediately see not only the titles of suitable search results, but also their image previews, author, date and other metadata.

Online documentation

Github Repository

Plugin website

Arbitrary section

Plugin Settings

Once the plugin is installed you can see a Cherry Search button in the right sidebar of your admin panel:

Main Settings

Here you can find major plugin settings:

  • Replace the standard search form – This option allows to replace all the standard search forms on your website.
  • Search Button Icon – This option sets search button text.
  • Search Button Text – This option sets search button text.
  • Caption / Placeholder text – This option sets placeholder text in input field.

Search Result Settings

  • Search in – You can select particular search sources. If nothing is selected in the option, search will be made over the entire site.
  • Exclude categories from search results – This option allows to set categories in which search will not be made.
  • Exclude tags from search results – This option allows to set tags in which search will not be made.
  • Exclude post types from search results – This option allows to set post types in which search will not be made.
  • Number of results displayed in one search query -This option will allow you to limit the number of displayed search results. If the overall number of results exceeds previous set limit, the « load more » button will come up..
  • Sort search results by – sort search results by a certain criteria
  • Filter results by – filter search results by ascending or descending order

Visual Settings

  • Show post titles – show/hide post titles
  • Post word count – specify the post word count
  • Show post authors – show/hide post authors
  • Prefix before author’s name – specify the prefix that will be displayed before author’s name
  • Show post thumbnails – show/hide posts thumbnails
  • Enable scrolling for dropdown lists – enable disable scrolling for dropdown search results lists
  • Dropdown list height – specify the dropdown list heigh
  • « View more » button text – add text for “View more button”


  • Negative search results – text that will be displayed if nothing is found
  • Technical error – text that will be displayed during technical error

For developers


The plugin contains templates that can be rewritten in the theme. For that you need to create a templates folder in the root catalog of the theme. In the templates folder, create a cherry-search.

Templates list:

  • Ssearch-form – search form template
  • Ssearch-form-input – search form input template
  • Ssearch-form-submit – search form submit button template
  • Ssearch-form-results-item – template of the element that is displayed in search results
  • Ssearch-form-results-list – dropdown search results list template

If you want to change the search results display type, you need to copy the search-form-results-item.tmpl file into the theme folder.

Example: theme_name / templates / cherry-search / search-form-results-item.tmpl


%%INPUT%% – Returns search-form-input template content

%%SUBMIT%% – Returns search-form-submit template content

%%RESULTS_LIST%% – Returns search-form-results-list template content.

%%SPINNER%% – Contains loader HTML structure

The macro works with filters:

  • cherry_search_spinner_holder -contains loader HTML wrapper markup
  • cherry_search_spinner – contains loader HTML markup

%%ICON%% – Returns Main Settings option value > Search Button Icon

%%SUBMIT_TEXT%% – Returns Main Settings option value > Search Button Text

%%THUMBNAIL%% – Contains post thumbnail. If post doesn’t have a thumbnail, empty string will be returned

$$ACTION$$ – Macro contains links to action forms

$$LINK$$ – Contains post link

$$TITLE$$ – Contains post title

$$CONTENT$$ – Contains part of the post contain

$$AUTHOR$$ – Contains post author

$$READER_TEXT$$ – Contains « Search for: » text

Macro works with cherry_search_reader_text filter

$$PLACEHOLDER$$ – Returns Main Settings -> Placeholder text option value

$$WRAPPER_CLASS$$ – Returns search form wrapper class. Empty by default. If Woocommerce plugin is active the macro contains wc-search-form class.

Macro works with cherry_search_wrapper_class filter

$$FORM_CLASS$$ – Macro returns search form class. Empty by default. If Woocommerce plugin is active the macro contains woocommerce-product-search class.

Macro works with cherry_search_form_class filter

$$INPUT_ID$$ – Macro returns search form field ID. Empty by default. If Woocommerce plugin is active the macro contains id= »woocommerce-product-search-field class.

Macro works with cherry_search_input_id filter

$$SETTINGS$$ – Macro returns search query settings for a particular search form.

Macro works with cherry_search_query_settings


cherry_search_button_icon – Allows to change the icons set, which you want to use buttons for search.

  • Type – array
  • By default:  »

Filter contains an array with the following values:

  • Icon set title
  • Path to css file with icons
  • Css icon prefix css (if required)

cherry_search_limit_content_word – Allows to change search elements word length default value.

  • Type – number
  • By default: 50

cherry_search_reader_text – Allows to change Search for: text.

  • Type – string

cherry_search_icon_prefix – Filter defines whether to add a prefix class to the icon font. For example in font-awesome – fa fa-search font

  • Type – bool
  • By default: true

cherry_search_icon – Filter allows to change the HTML markup of the search button icon.

  • Type – string
  • By default: <span class="cherry-search__icon %s"></span>

cherry_search_submite_text – Filter allows to change the HTML markup of the search button text.

  • Type – string
  • By default: <span class="cherry-search__submite_text">%s</span>

cherry_search_spinner_holder – Filter allows to change the loader wrapper HTML markup.

  • Type – string
  • By default: <div class="cherry-search__spinner_holder">%s</div>

cherry_search_spinner – Filter allows to change the loader HTML markdown.

  • Type – string
  • By default: <div class="cherry-search__spinner"><div class="rect1"></div><div class="rect2"></div><div class="rect3"></div><div class="rect4"></div><div class="rect5"></div></div>

cherry_search_thumbnail_html – Filter allows to change post thumbnail HTML wrapper markup.

  • Type – string
  • By default: <span class="cherry-search__item-thumbnail">%s</span>

cherry_search_author_html – Filter allows to change Filter allows to change post author name HTML wrapper markup.

  • Type – string
  • By default: <span>%1$s </span> <em>%2$s</em>

cherry_search_more_button_html – Filter allows to change the more-button HTML markdown. Button text is set in the option Visual settings -> « Show more » button text.

  • Type – string
  • By default: <li class="cherry-search__more-button">%s</li>

cherry_search_wrapper_class – The filter allows to add or replace new class to the search form wrapper.

  • Type – string
  • By default: ( If WooCommerce is activated « wc-search-form » is used by default )

cherry_search_form_class – The filter allows to add or replace new class to the search form.

  • Type – string
  • By default: ( If WooCommerce is activated « woocommerce-product-search » is used by default )

cherry_search_input_id – The filter allows to change or add new ID to the search form input field.

  • Type – string
  • By default: ( If WooCommerce is activated « id= »woocommerce-product-search-field » is used by default )

cherry_search_query_settings – The filter allows to change search query settings.

  • Type – string

Captures d’écran

  • Cherry search form in sidebar.
  • Cherry search form on page.
  • Plugin main settings.
  • Plugin search results settings.
  • Search form shortcode.


  1. Upload cherry-testi folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Cherry Search->Settings screen to configure the plugin

Online documentation


How to use?

There are several ways to enable the plugin on your website. You can either:

  1. Turn on a “Replace the standard search” option in your dashboard
  2. Insert a shortcode [cherry_search_form] into any element of the layout
  3. Or insert the following PHP code into the necessary files of your website:


25 novembre 2018
Your plugin is what we've been looking for for a long time. It's very complex and it does its job. I do not know if he misses something, but I personally did not find it at the moment.
14 septembre 2018
The plugin looks great. But there is no option to sort by "relevance", therefore it will bring ANY post/page that has the word you are looking for, but without being relevant to the user. Let's say you have a post that its title is "wordpress search", and then you link to this post from another page that says "wordpress search click here"... ... to this plugin both will be equally important and will show the latest one instead of the one with the title.
24 août 2018
If you go in with open eyes, there's little to complain about. It just works and the settings panel has a good UI. There are still some things to wish for, instead of making a list I'm just going to say this: Let this one be reborn as "JETsearch", add an Elementor Search Widget and have it prosper in the excellent Crocoblock Service. Cheers 😉
21 février 2018
Seems to ignore two or more word search strings, returning dumb listings of whole posts that might contain any one of them, that the user then has to read right through to even find. Really this 'search' tool seems to be no more than a gimmick, and it brings the user no closer to any content relevant to their need. For this to be useful it would need to behave much like google search does, displaying snippets in context from any relevant posts, with the full search string highlighted
24 décembre 2017
I selected some categories to exclude from search but those didn’t excluded , it looks like plugin have a bug preventing excluding categories, and the author doesn't eve care for this issue, I wrote about it about 3 weeks ago and no response.
Lire les 8 avis

Contributeurs & développeurs

« Cherry Search » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.


“Cherry Search” a été traduit dans 2 locales. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « Cherry Search » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.



  • Initial release


Added :

  • Compatibility with WooCommerce
  • Search field shortcode
  • Macro
    • $$FORM_CLASS$$
    • $$INPUT_ID$$
    • $$SETTINGS$$
  • Filters
    • cherry_search_wrapper_class
    • cherry_search_form_class
    • cherry_search_input_id
    • cherry_search_query_settings

Fixed :

  • WooCommerce issue in the product page.


Fixed :

  • Fixed php error on search page.


  • Fixed bugs.


  • Fixed bugs.


  • Fixed bugs.


  • Fixed bugs.
  • Update Cherry Framework.