forked from bearded-avenger/wp-live-search
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
executable file
·169 lines (121 loc) · 5.43 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
=== WP Live Search V2 ===
Contributors: Shambix, dukessa, nphaskins
Author URI: http://www.shambix.com
Plugin URI: https://github.com/Jany-M/wp-live-search
Tags: search, live search, api, rest api, search api, json
Requires at least: 4.4
Tested up to: 4.7.2
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
A super light-weight live search plugin that utilizes the WP REST API.
== Description ==
WP Live Search 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](https://github.com/bearded-avenger/wp-live-search)
Here's some documentation.
[http://bearded-avenger.github.io/wp-live-search/](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"]`
== Installation ==
1. Navigate to 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `wp-live-search.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard
= Using FTP =
1. Download `wp-live-search.zip`
2. Extract the `wp-live-search` directory to your computer
3. Upload the `wp-live-search` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard
== Frequently Asked Questions ==
= How do I work it? =
It's a shortcode. Add [wp_live_search] to a page. See above for some options.
= What is required for this to work? =
The WP REST API (V1) plugin (the official one) from the WordPress REST API Team.
= Does it support featured images? =
Yes
= Does it support showing content? =
Yes
= Does it support custom post types? =
Yes
= Can I use multiple on one page? =
No
= Can I disable the style sheet from loading? =
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.
= Can I override the display item? =
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.
== Screenshots ==
1. basic design
2. compact mode
== Changelog ==
= 2.0 =
* added compatibility with latest WP API in core (no more extra plugins needed)
* restored multi post logics
= 0.9 =
* added some CSS classes wpls--empty and wpls--full to the custom target div to aid in custom theming
* added logic to prevent searching on escape or arrow keys
= 0.8 =
* added "dropdown" option mode for use in small spaces
* added "results_style" option for use in small spaces
* added "excerpt" option to show excerpt
* added five action hooks
= 0.7.1 =
* fixed target="" feature only receiving one search result
= 0.7 =
* fixed results being returned in reverse order
* added multiple post type support by using type="typeone,typetwo" multi="true"
* added an option to set the number of results returned
* added a "compact" mode option to that it can be used in places like a header widget
* improved styling
= 0.6 =
* added custom post type support
= 0.5 =
* added an option to specify a target div for the search results to be sent to
* replaced all inline js styles with CSS classes
= 0.4.1 =
* removed the search being closed when you click out
* added an icon that will clear the search
= 0.4 =
* dont allow empty values and spaces for search
* allow enter to search so long as nothing is empty
* added a template function
* added searchAction schema
* misc style improvements
* added a define to allow CSS file not be loaded
* returns 20 results for now until we work in pagination/lazy loading
= 0.3 =
* featured image support
* renamed to WP Live Search
= 0.2 =
* added some styles
* added a loading indicator
* added option to set entries text
* misc fixes