=== Autocompleter ===
Contributors: Nik Chankov
Donate link: http://nik.chankov.net/autocompleter/
Tags: search, autocomplete, ajax
Requires at least: 2.6.x
Tested up to: 2.7.1
Stable tag: 1.2.0

Adding autocomplete functionality to the blog search input field. The values provided are the tags and categories used in the blog.

== Description ==

This plugin adding autocomplete functionality to search input field. It is using core jQuery library as well as
autocomplete jquery plugin from http://www.pengoworks.com/workshop/jquery/autocomplete.htm

This plugin requires zero configuration, but since version 1.2.0 there is admin screen where you can enable the extra 'number of matches' next to each option.
You just need to activate and it's ready to be used in the blog. The plugin is tested
with Wordpress 2.6.5, but until there aren't big core changes, it sould work for all future releases. I don't have
information if this plugin will work with older versions of Wordpress, but for sure it is working with 2.6.x. The last version 1.2.0 is tested on WP 2.7.1.

New in 1.2: This version could display number of matches found in the blog.

I would appreciate if you write an review/post in your blog with a link to my page: <a href="http://nik.chankov.net">nik.chankov.net</a>.
Thanks!

== Thanks to ==

* <a href="http://nik.chankov.net">My Self :)</a>
* <a href="http://jquery.com">jquery.com</a>
* <a href="http://www.pengoworks.com/workshop/jquery/autocomplete.htm">jQuery Autocomplete Plugin</a>
* <a href="http://csixty4.com/">Dave Ross</a> for the hint with name selector :)

== Installation ==

This section describes how to install the plugin and get it working.

1. Download the plugin from the <a href="http://wordpress.org/extend/plugins/autocompleter/">Wordpress repository</a>
2. Upload `autocompleter` to the `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. {Optional} If you want to change the apperience of the dropdown, just play with autocompleter.css in the plugin folder.
5. {Optional for 1.2.0} Go to Admin area under the Settings section. There is Autocompleter menu from which you can extend the plugin with 'matched items' option.

== Frequently Asked Questions ==

= Why this plugin is useful for users of your blog? =

It's useful because they can easily check what themes you writing for, and this way they could find the desired article more easily.

= Is it possible to use it with non standart search like Google Custom Search Engine or similar? =

Well, depends. Current version (1.1.2) reqires the name of the input field to be "s", so if your search field has such name, there is no problem at all.

= Is it heavy for my blog? =

No, it selecting results from two joined tables, and it is not heavy at all.

= Is it secure? =

Thank you for that question :). Actually it's escaping the search string with functions provided from Wordpress, so if you find Wordpress secure, means
that the plugin is secure as well.

Use <a href="http://nik.chankov.net/contact">Contact the author</a> for suport and other questions. Thanks!

== Change log ==

* 1.2.0 [03 Apr 2009] - adding number of matches per item suggestion
* 1.1.2 [05 Feb 2009] - removing dependance from id="s".
* 1.1 [28 Nov 2008] - small fix removing htmlentities(), because it damages the results 
* 1.0 [28 Nov 2008] - initial submit of the plugin

== Screenshots ==

1. Autocompleter 1.1.2
2. Autocompleter 1.2.0 with number of matches