-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
452 lines (349 loc) · 20.7 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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
=== Dave's WordPress Live Search ===
Contributors: csixty4
Donate link: http://catguardians.org
Tags: search, AJAX, live search
Requires at least: 3.6
Tested up to: 4.8
Stable tag: 4.6
License: MIT
License URI: http://daveross.mit-license.org
Adds "live search" functionality to your WordPress site. Uses the built-in search and jQuery.
== Description ==
Dave's WordPress Live Search adds "live search" functionality to your WordPress site. As visitors type words into your WordPress site's search box, the plugin continually queries WordPress, looking for search results that match what the user has typed so far.
The [live search](http://ajaxpatterns.org/Live_Search) technique means that most people will find the results they are looking for before they finish typing their query, and it saves them the step of having to click a submit button to get their search results.
This functionality requires Javascript, but the search box still works normally if Javascript is not available.
http://www.youtube.com/watch?v=7CGR2bJ1mLM
[transcript](http://plugins.svn.wordpress.org/daves-wordpress-live-search/assets/intro_video_transcript.txt)
This plugin is compatible with the [xLanguage](http://wordpress.org/extend/plugins/xlanguage/) and [WPML](http://wpml.org/) plugins for internationalization (i18n) of search results.
== Installation ==
http://www.youtube.com/watch?v=7CGR2bJ1mLM
Dave's WordPress Live Search is a plugin that brings live search, sometimes called "autocomplete", to your WordPress site. Many of the web's most popular destinations use this technique so customers can get right to the information or products they're after, and now you can deliver that same experience to your site's visitors. Like WordPress itself, it's designed to be simple to set up and use right away, but powerful and customizable for advanced users.
You can install the plugin right from WordPress itself by going to the Plugins section, clicking "Add New", and searching for "Dave's WordPress Live Search". Click "install now" to add the plugin to your site. If you prefer to install the plugin manually, it's available for download in the WordPress plugins directory.
After you install the plugin, go to the Settings menu and choose "Live Search". Let's take a look at the main "settings" tab, which controls how the plugin looks and behaves. The "Maximum Results to Display" option lets you limit the number of search results your users see. If you have a large site, you should set this to 5 or less or it might take a long time to display. Remember, your visitors can still click the "search" button like they normally would to get all the matching results. The "Minimum characters" option lets you choose how much people need to type before the plugin starts offering results. The longer you wait before showing results, the better the first set of results will be.
The "Results Direction" setting lets you choose whether the results should grow up or down from the search box. People are used to seeing the results underneath the box, but if space is tight on your site or blog, you should show them above the search box to make sure they fit on the screen.
You can also choose what's included with the search results. They can include a thumnail image, excerpt, even who wrote the content and when. You may want to include the "View more results" link at the bottom of the search results, so users can click through to see more results.
Dave's WordPress Live Search ships with three color schemes: gray, red, and blue. Advanced users and developers can use the other styling options to better match their site's theme.
When you're ready, save your changes, and Dave's WordPress Live Search is ready to use. It automatically attaches itself to any search boxes in your theme, or any search widgets you add, giving your site's visitors a better search experience with a minimum of fuss.
== Screenshots ==
1. Demonstration of Dave's WordPress Live Search
== Frequently Asked Questions ==
== Filters ==
See [filter_examples.php](http://plugins.svn.wordpress.org/daves-wordpress-live-search/trunk/filter_examples.php) in
the plugin files for examples of how to use these filters. Remember, these filters only affect the
Dave's WordPress Live Search display, not the normal WordPress search results or the posts themselves.
1. dwls_alter_results
1. dwls_attachment_thumbnail
1. dwls_post_title
1. dwls_the_excerpt
1. dwls_post_date
1. dwls_author_name
1. dwls_alter_result_template
1. dwls_post_custom
1. dwls_query_fields
== Wish List ==
Features I want to implement in future releases:
1. "No results found" message (optional)
== Changelog ==
= 4.6 =
* 2017-05-01 Dave Ross <[email protected]>
* Fixed cross-site scripting vulnerability in unsanitized "tab" parameter on admin pages
= 4.5 =
* 2016-08-29 Dave Ross <[email protected]>
* Sprinkled more JavaScript pseudo-events throughout the code
* Fixes deprecation warning on PHP 7.x
* Fixed issue where clicking anywhere but the title on 2nd+ search result went to 1st result
= 4.4.1 =
* 2015-10-15 Dave Ross <[email protected]>
* Changed text domain to 'daves-wordpress-live-search'
* Added "Text Domain:" plugin header declaration
* Removed link to CrowdIn for translations
* Removed CrowdIn references from readme
* ^ All this in preparation for WordPress plugin language packs
* Removed Relevanssi reference from readme
= 4.4 =
* 2015-08-19 Dave Ross <[email protected]>
* Fixed issue excerpts not displaying
* Scripts are now enqueued in the footer
* Admin screen titles are now h1 instead of h2 in WordPress 4.3+
= 4.3 =
* 2015-05-10 Dave Ross <[email protected]>
* Added 'underscore' as a dependency for the plugin's JavaScript files
* Updated Copyright dates (yay?)
* Added a file with examples of how to use the different filters
* Don’t specify a schema for admin_url(), let it default to 'admin'
* firstImg() using fixed regex from dwlstng
* Using HTML-escaped tags in Underscore.js template (where appropriate)
= 4.2 =
* 2014-05-10 Dave Ross <[email protected]>
* Fixed a bug parsing the "display thumbnails" and "view more results" settings
= 4.1 =
* 2014-04-17 Dave Ross <[email protected]>
* Use class="no-livesearch" to disable live search on a particular search box
* Fixed a bug saving checkboxes on the "Appearance" tab
= 4.0 =
* 2014-01-12 Dave Ross <[email protected]>
* Removed check for PHP 4. WordPress 3.5 is the minimum and that needs PHP 5 anyway.
* Removed caching. It wasn't effective enough & was a support nightmare.
* Using an Underscore template to render search results
* Ukranian translation by Paul Mall (zlyton)
* Passing extra parameters to WP_Query for faster search queries
* Store "first image" in postmeta
* Query post status "publish" because admin-ajax.php runs in an admin context (oy!)
* Ignore sticky posts.
* Prevent browser autocomplete on individual input fields, not just the form
* Tested with WordPress 3.8!
= 3.3.1 =
* 2013-07-07 Dave Ross <[email protected]>
* Fix for "undefined offset" notice
* Fixed issue with WooCommerce's AJAX search (only registers pre_get_posts handler when going DWLS AJAX request)
= 3.3 =
* 2013-06-05 Dave Ross <[email protected]>
* Added search results width to the customizer
* Faster startup on AJAX requests (fewer includes & hooks registered)
* If SCRIPT_DEBUG is set, use non-minified scripts
* Now uses a proper loop to get search results. Hopefully improves compatibility with other search plugins
* The parameters to the dwls_alter_results hook have changed: array of results (instead of a query object), deprecated (always -1), DavesWordPressLiveSearchResults instance.
* Now uses WordPress's native submit_button() function to generate submit buttons in the admin interface for more consistent styling with the rest of admin
* Requires WordPress 3.5 or higher
= 3.2 =
* 2013-01-22 Dave Ross <[email protected]>
* Fixed a Javascript error when resizing a window
* Removed the "debug" tab - wasn't very useful
* Force a high z-index on the spinner
= 3.1.1 =
* 2012-12-21 Dave Ross <[email protected]>
* Always include the "custom" css file on admin pages. Ensures customizer preview always looks right.
= 3.1 =
* 2012-12-21 Dave Ross <[email protected]>
* German (de_DE) translation
* Color picker for WP 3.5+
= 3.0.1 =
* 2012-11-07 Dave Ross <[email protected]>
* Simplified jQuery selector for older jQuery versions
= 3.0 =
* 2012-11-03 Dave Ross <[email protected]> and many awesome translators!
* Turkish (tr_TR) translation
* French (fr_FR) translation
* Dutch (nl_NL) translation
* Polish (pl_PL) translation
* Portugese (pt_PT) translation
* Improved method of getting the first thumbnail
* Canvas/VML-based spinner eliminates the need for the transparent .gif
* Italian (it_IT) translation
* Spanish (es_ES) translation
* Added hooks & filters for people to plug into DWLS
* Fixed regex parsing issue when permalinks aren't enabled
* Support for multiple search boxes (finally!)
* You can now click anywhere in the result box to go to that result
* WP E-Commerce is officially supported again
* Toggle to enable/disable the_content filter.
* "View more results" is now translatable
* Fix to jQuery dependency definition (great catch by Robert Windisch)
* Rewrote DWLSTransients for faster performance/simplicity
= 2.8 =
* 2012-04-29 Dave Ross <[email protected]>
* Back-ported fix from 3.0 which sets defaults on activation
* Tested for compatibility with WordPress 3.4
= 2.7 =
* 2011-11-10 Dave Ross <[email protected]>
* Slovenian (sl_SI) translation
* Swedish (sv_SE) translation
* Various i18N fixes now that I have translations to work with
= 2.6 =
* 2011-09-15 Dave Ross <[email protected]>
* Fix for search results x positioning
= 2.5 =
* 2011-09-14 Dave Ross <[email protected]>
* WPML compatibility (thanks for the license!)
* Pruned some outdated code
* Better handling of Javascript config variables
= 2.4 =
* 2011-08-29 Dave Ross <[email protected]>
* Fix for i18n loading issue
= 2.3 =
* 2011-08-03 Dave Ross <[email protected]>
* Added a hook to keep Relevanssi integration out of the main code
* i18n for admin screens and user-facing text
= 2.2 =
* 2011-07-27 Dave Ross <[email protected]>
* Option to disable "View more results" link
= 2.1.1 =
* 2011-07-16 Dave Ross <[email protected]>
* Fix for Relevanssi issue
* Passing correct $capability string to admin_menu() - thanks lag47!
* Configurable excerpt length (for Alok)
= 2.1 =
* 2011-05-20 Dave Ross <[email protected]>
* Major code cleanup & streamlining
* Added z-index:999999 to all the default CSS files
* Removed jQuery Dimensions plugin. It's in jQuery core > 1.2.6 & recent WP releases include jQuery 1.4
* (Hopefully) fixed IE8 hang issue (jQuery Dimensions)
= 2.0.2 =
* 2011-03-09 Dave Ross <[email protected]>
* Fix for determining plugin URL when WordPress is installed in a subdirectory
* Sprinkled in static declarations where needed
* Better? fix for determining plugin URL when WP Subdomains is installed
= 2.0.1 =
* 2011-02-28 Dave Ross <[email protected]>
* Pass WP_Query a parameter telling it to only return "publish" items (no drafts) -- WP3.1 regression case?
= 2.0 =
* 2011-02-24 Dave Ross <[email protected]>
* Using wp_ajax actions now (deprecating my bootstrap on every AJAX call)
* Static Javascript (not generated) and inline configuration
* Cached search results for anonymous users
* Debug tab for advanced users. Just shows cache dump for now.
* WordPress 3.1 compatibility!
= 1.20 =
* 2011-01-10 Dave Ross <[email protected]>
* Generate a static version of the Javascript file
= 1.19 =
* 2011-01-09 Dave Ross <[email protected]>
* Fixed bug with Relevanssi and setting to display 0 (unlimited) posts
* Display an alert if another plugin is loading jQuery < 1.2.6
= 1.18 =
* 2010-12-04 Dave Ross <[email protected]>
* Search "any" content (posts, pages, custom post types)
* Better compatibility with Relevanssi plugin (worked with Mikko from that project)
* Minor jQuery performance improvements
= 1.17 =
* 2010-10-25 Dave Ross <[email protected]>
* Split options into "Settings" and "Advanced" tabs
* X Offset setting to position the results dropdown
* Include pages (as well as posts) in search results
* Raised minimum requirement to WP 2.9 (required for "Include pages" change)
= 1.16 =
* 2010-10-07 Dave Ross <[email protected]>
* Fixed "max results" functionality lost when implementing WP E-Commerce compatibility
* Compatibility w/servers that don't allow getimagesize() to use URLs
* Merged in Ron Schirmacher's code for WP E-Commerce tag & meta search
* Compatibility with WP E-Commerce when table names are used
* Fix for autocomplete suppression
= 1.15.1 =
* 2010-08-17 Dave Ross <[email protected]>
* Default hidden source option to 0 (search WP, not WP E-Commerce)
= 1.15 =
* 2010-08-12 Dave Ross <[email protected]>
* Option to not include any additional CSS file (thanks Andy Hall!)
* Support for xLanguage plugin
* Support for searching WP E-Commerce products
* Replaced clearfix that was somehow lost
= 1.14 =
* 2010-07-03 Dave Ross <[email protected]>
* z-index:9999 for cadbloke to keep search results above all other content (that doesn't already have a z-index of 9999 or higher)
* Hidden results display when resizing window http://wordpress.org/support/topic/410612
= 1.13 =
* 2010-05-02 Dave Ross <[email protected]>
* Fixed changelog formatting
* Reposition the search results popup when the window is resized
* Send AJAX results with a test/javascript content-type
= 1.12 =
* 2010-03-23 Dave Ross <[email protected]>
* Now compatible with WP-Subdomains plugin
* Format dates using WordPress date setting
* Added MIT license text to daves-wordpress-live-search.js.php and daves-wordpress-live-search-bootstrap.php files
= 1.11 =
* 2010-02-24 Dave Ross <[email protected]>
* Support for wp-config.php outside main WordPress directory (2.6+)
* Fix to make "view more results" link work on pages other than home
* Fix path to stylesheet directory
* Fix compatibility with child themes
= 1.10 =
* 2010-02-14 Dave Ross <[email protected]>
* Added option for minimum number of characters that need to be entered before triggering a search
* More graceful failure message in PHP4
* Added code to ignore E_STRICT warnings when E_STRICT enabled on PHP 5.3
* Possible fix for compatibility with Relevanssi plugin (some concern this isn't working yet)
* Fix for compatibility with child themes
* Added MIT license to DavesWordPressLiveSearch.php class
= 1.9 =
* 2009-12-02 Dave Ross <[email protected]>
* Tested compatibility with WordPress 2.3-2.9 beta 2
* Fixed stylesheet issue with WordPress 2.5.x
* Set minimum WordPress version to 2.6. Admin page doesn't appear in 2.5.
* Added support for WordPress 2.9 "post thumbnails"
* Put autocomplete="off" on the form instead of the search box (fix for Firefox issue?)
* Use "Display Name" instead of "username"
* Javascript performance improvements
* Added page exception list
* Live search no longer tries to add itself to admin pages
= 1.8 =
* 2009-10-25 Dave Ross <[email protected]>
* Added note about WP-Minify
* Tested with WordPress 2.8.5
* Moved JavaScript to an external file
* Security - nonce checking on admin screen
* Security - check "manage_options" security setting
* Notes on configuration in readme.txt
= 1.7 =
* 2009-08-27 Dave Ross <[email protected]>
* Thumbnails in the search results
* Excerpts in the search results
= 1.6 =
* 2009-08-17 Dave Ross <[email protected]>
* Implemented selectable CSS files
* Fixed a bug that broke live searches containing ' characters
= 1.5 =
* 2009-07-08 Dave Ross <[email protected]>
* Fixed compatibility with Search Everything plugin, possibly others
= 1.4 =
* 2009-06-03 Dave Ross <[email protected]>
* Renamed release 1.3.1 to 1.4 because WordPress.org doesn't seem to like 1.3.1. Seems like kind of a waste to do a full point release for this
* Building permalinks instead of using post guid (problem with posts imported from another blog)
= 1.3 =
* 2009-05-22 Dave Ross <[email protected]>
* Fixed an annoying bug where the search results div collapsed and expanded again every time an AJAX request completed
* Cancel any existing AJAX requests before sending a new one
* Check for PHP 5.x. Displays an error when you try to activate the plugin on PHP < 5
* No longer sends the entire WP_Query object to the browser. This was a potential information disclosure issue, plus it was a lot to serialize on the server and parse in the brower
* Minor code cleanup & optimizations
= 1.2 =
* 2009-04-10 Dave Ross <[email protected]>
* Code cleanup & optimizations
* Styled the admin screen to fit in with WordPress better
* New option: display the results above or below the search box
* Included a note on the admin screen recommending the Google Libraries plugin
= 1.1 =
* 2009-03-30 Dave Ross <[email protected]>
* Code cleanup & optimizations
* Fixed compatibility issues with PHP < 5.2.0 and PHP < 5.1.2
* New option: limit the number of results to display
= 1.0 =
* 2009-03-13 Dave Ross <[email protected]>
* Initial release
== Upgrade Notice ==
= 4.6 =
IMPORTANT: This release fixes a cross-site scripting vulnerability (JVN#14419145) in the plugin's admin settings screens. It's recommended that you upgrade your plugin to version 4.6 immediately.
= 4.2 =
I've dropped support for WordPress 3.5.x in this plugin. There's a good chance that Dave's WordPress Live Search will continue to work with WordPress 3.5.x for a long time, but I've become aware of another plugin which loads the jQuery UI that ships with WordPress and introduces issues with this plugin. Dave's WordPress Live Search now requires WordPress 3.6 or higher, which ships with jQuery UI 1.10 and works great. (Besides, you really should upgrade WordPress anyway to take advantage of the latest features, bugfixes, and security patches).
= 4.1 =
By popular demand, now you can use the class "no-livesearch" on your search input so live search isn't added to it.
= 4.0 =
Welcome to Dave's WordPress Live Search 4.0!
If you've been using this plugin's caching option, please note that it's been removed. WordPress's Transient API just doesn't work in a way that's appropriate for caching Live Search results unless you're using an object caching plugin. If you've experienced a big increase in the size of your database's wp_options table and you want to clean out the excess, try the [Delete Expired Transients](http://wordpress.org/plugins/delete-expired-transients/) plugin. It'll remove expired cache entries since WordPress itself does not.
In place of caching, I've added optimizations to the query WordPress runs for each search request. I've also optimized how thumbnails are determined for posts that don't have featured images, so the plugin doesn't need to figure that out every time it goes to display a result. Searches are still snappy, even on a site with 1,000 posts.
Now, something special for the theme developers: two new filters that will help you customize the way search results look for your visitors:
* The 'dwls_alter_result_template' filter lets you customize the new [Underscore.js template](http://underscorejs.org/#template) used to render the search results box.
* The 'dwls_post_custom' filter lets you modify the search results before they're passed to the Javascript templating engine. You can edit the values that get sent, or add additional fields to the results (such as pricing on an e-commerce site).
The combination of these filters, plus the existing "custom CSS" settings, give you ultimate control over how the search results look.
= 3.3 =
Dave's WordPress Live Search v3.3 requires WordPress 3.5 or higher. Older versions of the plugin are still available from http://wordpress.org/plugins/daves-wordpress-live-search/developers/ if needed.
= 3.1.1 =
If you upgraded to v3.1 in the first 15 minutes or so, this fixes a bug where the customizer preview may not have reflected the right colors if one of the other styling options were selected when the page rendered.
= 3.1 =
Tired of default red, gray, and blue? WordPress 3.5 users can now choose their own colors on the admin page. Click the new "appearance" tab and build your own "custom" style!
= 3.0 =
Version 3.0 includes many bug fixes and improvements, including:
* New translations: Turkish (tr_TR), French (fr_FR), Dutch (nl_NL) translation, Polish (pl_PL), Portugese (pt_PT), Italian (it_IT), Spanish (es_ES)
* Canvas/VML-based spinner for better looks on high-DPI displays
* Added hooks & filters for people to plug into DWLS
* Support for multiple search boxes (finally!)
* You can now click anywhere in the result (instead of just the title)
* WP E-Commerce is officially supported again
* Completely rewritten caching for better performance
For a complete list of changes, see [the changelog](http://wordpress.org/extend/plugins/daves-wordpress-live-search/changelog/).
= 2.6 =
This release fixes the horizontal positioning bug in v2.5.
= 2.5 =
This plugin is now compatible with the WPML internationalization plugin.
= 2.0 =
If you use a caching plugin, please clear your cache after upgrading. New: Performance & compatibility improvements. Works with WordPress 3.1! Debug feature for advanced users.