A super light-weight live search plugin that utilizes the WP REST API.
WP Live Search (beta) is a search plugin for WordPress that returns results as the user types for what they are looking. It currently supports posts, pages, post types, including multiple post types, and design modes.
This is very much a working prototype, so please log any issues you find on the Github repo below.
https://github.com/bearded-avenger/wp-live-search
Here’s some documentation.
http://bearded-avenger.github.io/wp-live-search/
Add the shortcode [wp_live_search]
to a page or something. There’s a few shortcode attributes that you can use, and are as follows:
type=””
Your choices are posts
or pages
. Defaults to posts
. You can also pass type,type
to search multiple post types. For example type=”recipes,books”
multi=””
By default this is turned off. Set this to true only if you’re using multiple post types above.
placeholder=””
The text displayed in the input. Defaults to Search...
.
number=””
Total search result to return. Default is 20
excerpt=”true”
Show the excerpt along with the title and featured image (if set)
compact=”true”
Makes a tiny WP Live Search for use in header widgets and such
dropdown=”true”
Display search results as a drop-down instead of pushing down the content around it
results=””
The text displayed for the results. Defaults to entries found
.
results_style=”inside”
Displays the “entries found” inside of the input area, useful for using in areas like header widgets where space is minimal.
target=””
An optional target UL parent to send the search results to. Example target="#someotherdiv"
.
Here are a couple examples:
Default Usage:
[wp_live_search]
Use in Header Widget:
[wp_live_search compact=”true” dropdown=”true” results=”found” results_style=”inside”]
Search through multiple post types:
[wp_live_search multi=”true” type=”posts,page”]
wp-live-search.zip
from your computeraesop-core.zip
wp-live-search
directory to your computerwp-live-search
directory to the /wp-content/plugins/
directoryIt’s a shortcode. Add [wp_live_search] to a page. See above for some options.
The WP REST API (V1) plugin (the official one) from the WordPress REST API Team.
Yes
Yes
Yes
No
Yes just use define('WPLS_DISABLE_STYLE', true)
and the CSS file will not load. However you will want to make sure you at least copy over .wpls–show and .wpls–hide. JS uses these classes for things and the search may not appear correctly without them.
Yep! Just copy over the function from underscore-template.php (without the function exists) and drop it into any plugin. Note, pluggable functions wont run in a theme file, themes run too late, so this needs to be in a plugin file. From here you can modify the temlate as needed.