This extension provides Shortcodes that generate both search forms and results pages for SearchWP search engines. It’s useful if you’re not comfortable (or able) to edit theme files directly to implement your search form(s) and results loops.
After activating Shortcodes, the following will be available to you:
| Shortcode | Attribute(s) |
|---|---|
searchwp_search_formOutputs a search form for a specific search engine |
target — The form action (Default is the existing permalink)engine — Search engine name (Default is default)var — The search query variable name (Default is swpquery)button_text — Form button text (Default is Search)placeholder — Form input placeholder text (Default is Search) |
searchwp_search_resultsOutputs the list of search results once a search has been submitted |
engine — Search engine name (Default is default)posts_per_page — How many posts per page to display Note that this is not a self-closing Shortcode, the markup for each search result should be nested inside, see sample below for examplevar — The search query variable name (Default is swpquery) |
searchwp_search_result_linkOutputs a link to the current search result |
direct — Either “true” or “false”, when true link directly to the permalink, if it’s an attachment link directly to it’s URL, not the parent page |
searchwp_search_result_excerptOutputs the excerpt for the current search result |
None |
searchwp_search_results_noneOutput if no search results were found |
NoneNote that this is not a self-closing Shortcode, the markup for each search result should be nested inside, see sample below for example |
searchwp_search_results_paginationOutput pagination of search results |
engine — Search engine name (Default is default)direction — Either “prev” or “next”link_text — The text to use in the linkvar — The search query variable name (Default is swpquery) |
searchwp_search_results_paginate_linksOutput paginated links for search results |
engine — Search engine name (Default is default)var — The search query variable name (Default is swpquery)In addition to the above, arguments from paginate_links are also supported. |
searchwp_search_result_imageOutput Featured Image for the current result |
size — Image size (Default is thumb) |
searchwp_search_result_permalinkOutput permalink for the current result |
direct — Whether to link directly to Media files (Default is 'true') |
Here is a sample of a comprehensive implementation of Shortcodes that searches a supplemental engine with a name of my_test_engine :
| <h3>Search Form</h3> | |
| [searchwp_search_form engine=”my_test_engine” target=”http://example.com/supplemental-search/” var=”searchvar” button_text=”Find Results”] | |
| <div class=”search-results-wrapper“> | |
| Total Results: [searchwp_total_results engine=”my_test_engine” var=”searchvar”] | |
| [searchwp_search_results engine=”my_test_engine” var=”searchvar” posts_per_page=2] | |
| <h2>[searchwp_search_result_link direct=”true”]</h2> | |
| [searchwp_search_result_excerpt] | |
| [/searchwp_search_results] | |
| </div> | |
| <div class=”no-search-results-found“> | |
| [searchwp_search_results_none] | |
| No results found, please search again. | |
| [/searchwp_search_results_none] | |
| </div> | |
| <div class=”search-results-pagination“> | |
| [searchwp_search_results_pagination direction=”prev” link_text=”Previous” var=”searchvar” engine=”my_test_engine”] | |
| [searchwp_search_results_pagination direction=”next” link_text=”Next” var=”searchvar” engine=”my_test_engine”] | |
| </div> |
You can customize the attributes as per the table above.
User Reviews
There are no reviews yet.