=== WooCommerce Predictive Search  ===

Contributors: a3rev, A3 Revolution Software Development team
Tags: WooCommerce Predictive Search, WooCommerce, Predictive Search, Live Search, e-commerce,  wordpress ecommerce
Requires at least: 3.3
Tested up to: 3.5.1
Stable tag: 2.0.2
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

WooCommerce Predictive Search gives your customers an awesome search experience delivering stunning 'live' product search results.
 
== Description ==

WooCommerce Predictive Search queries <strong>your entire product database</strong> while you type. It delivers users instant and changing results as they type in the dropdown which shows the product thumbnail, product title and description. Users can click through from the dropdown to the 'All Results Search page' that features endless scroll. 
 
= Key Features =

* New Feature Pretty URL for the All Search Results pages.
* Use 'live search' to wow your customers - fast and accurate.
* Add and configure a search box to any widgetized area on your site.
* Shows the results beautifully in the widget drop-down with Product Thumbnail, Title and description text.
* Searches your entire WooCommerce product database for the product name that match what is being typed.
* Set the number of Product results to show in the drop down.
* Add description text to show by default inside each Widget Search box.
* Set the number of characters of the product description text to show with each search result.
* Exclude Products from Predictive Search. 
* Click through from the Widget dropdown to the 'All Results Search Page'.
* 'All Results Search Page' shows products thumbnail, Title as a clickable link to the product and product text description.
* 'All Results Search Page' features endless scroll - allows the page to load quickly and show 'infinite' number of results. 

= Support =

If you have any problem with installing and activating the Free lite version please post your support request here on the WordPress support forum. PLEASE if you have a problem DO NOT just give the plugin a bad star rating and review without first requesting support. Giving the plugin a bagging without affording us the opportunity to help solve the issue is in our opinion very unfair.

Once you have the plugin installed and activated please refer to the plugins comprehensive [Online Documentation](http://docs.a3rev.com/user-guides/woocommerce/woo-predictive-search/) and guide to setting up the Compare Products plugin on your WooCommerce store.If you have questions - again please post them to the support forum here.

= Pro Version Upgrade =

WooCommerce Predictive Search allows you to optimize your site search just the way you want it with 100% accuracy while delivering your customers stunning 'live search' results for your entire site. <strong>Pro Version advanced features.</strong>

= Site Search Optimization: =
* Predictive Search 'Focus keywords' gives you 100% accuracy in Optimizing your entire site anyway you want. Optimize your 'site search' by adding a 'Focus Keywords or Keyword Phrases' to any product page, post, wp-page just like an SEO plugin except it is for site search not external search engines and its 100% accurate and super fast.
* Predictive Search meta section on each product page, post and page for setting 'Focus Keywords and Keyword Phrases'.
* Exclude any product, post or page from Predictive Search results Globally from the admin panel or right from the Predictive Search Meta on product, post or page.
* Integration with SEO plugins. Can be a massive time saver. Configure your plugin with the click of a mouse to use Focus Keywords that are set on an SEO plugin you are using. Include any 'Focus Keywords' that have been set while optimizing the site content for search engine search.  
* Currently supports * Yoasts WordPress SEO and the * All in One SEO plugins. If you use another WordPress SEO Plugin and would like to see it included in the list of supported plugins please just let us know and we will look in including support for it in future updates.

= General =
* Use 'live search' to wow your customers - fast and deadly accurate.
* Add Predictive Search anywhere on your site via unlimited Widgets, Shortcodes and Search functions
* Fully customizable - define what gets searched and what shows in the search box drop down.
* Easy to read and easy to sort All Search Results pages featuring endless scroll. 
* Pretty URL's for the All Search Results pages.
* Search by Product name, Product SKU, Product Categories, Product tags, posts and Pages and any combination of these
* Configure Search of your entire WooCommerce product database by Product titles, SKU's, Product Categories and Tags, exclude any. 

= All Search Results Pages: =
* To see more results for the search Click through from the Widget drop down footer to the 'All Results Search Page'. Design like the facebook search.
* All Results Search Page' shows products thumbnail, Title as a clickable link to the product and product text description.
* User can configure the All Results Search Page for each result to show 
 - Number of Characters of description text to show
 - Product Categories, 
 - Product Tags, 
 - Product Prices including 'special' pricing with each result.
 - Add to cart button
 - Number of results to show before 'endless scroll' bar.

* 'All Results Search Page' features endless scroll - allows the page to load quickly and show 'infinite' number of results. 

= Widget Search =
* Configure each widget to search all 'types'
 - Product name, 
 - Product SKU,
 - Product Categories, 
 - Product Tags, 
 - Posts, 
 - Pages 
 - or any combination of these.

* Set the number of each search 'type' eg Product category results to show in the search box dropdown.
* Use drag and drop to set the search 'type' order that the results show in the drop down.
* All Search results page sorted is auto sorted into results types configured for the widget.

= Shortcodes =
* WooCommerce Predictive Search shortcodes - Insert and configure the Search box into any page or post via shortcode.
* Customize shortcodes search box dimensions and alignment on page.
* Full customization just like the Widget search

= Smart Search =
* 'Smart Search'. An intuitive technology that auto detects if the page is Product Category, Product tag, Post Category or Post tag and features results from that taxonomy. This delivers extremely relevant  search results.
* Activate Smart search in any widget or any search function.
* Activate or deactivate the 'Smart Search" feature with the click of a mouse.

= Search Function =
* Add a Predictive Search box to any part of your site that is not widgetized via the Predictive search Function.
* From the admin panel configure all the Parameters of the Search function then just use the short function code to add the Search box where ever you want it. example in the header.
* Once installed change the parameters of the global search from the admin panel.
* Full documentation instructions on how to add the search function to your sites header.
* Back up 'Book a Service' with us to place the search function if your theme requires advanced CSS skills and you don't have easy access to a coder.
 
= Plugins Resources = 

[Home Page](http://a3rev.com/shop/woocommerce-predictive-search/) |
[Documentation](http://docs.a3rev.com/user-guides/woocommerce/woo-predictive-search/) |
 

= Localization =

* English (default) - always included. *.po file (woops.po) in languages folder for translations.
* If you do a translation for your site please send it to us for inclusion in the plugin language folder. We'll acknowledge your work here. [Go here](http://www.a3rev.com/contact/) to send your translation files to us.

== Installation ==

= Minimum Requirements =

* WordPress 3.3 or greater
* PHP version 5.2.4 or greater
* MySQL version 5.0 or greater
 
= Automatic installation =

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install of WooCommerce Predictive Search, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New. 

In the search field type "WooCommerce Predictive Search" and click Search Plugins. Once you have found our plugin you can install it by simply clicking Install Now. After clicking that link you will be asked if you are sure you want to install the plugin. Click yes and WordPress will automatically complete the installation. 

= Manual installation =

The manual installation method involves downloading our plugin and uploading it to your web server via your favorite FTP application.

1. Download the plugin file to your computer and unzip it
2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installations wp-content/plugins/ directory.
3. Activate the plugin from the Plugins menu within the WordPress admin.

== Screenshots ==

1. Set up WooCommerce Predictive Search Widget. Set Title that show on the front end. Set the number of results to show in the dropdown. Set the number of characters of the description text to show with each result. Link to the All Search Results Page shows at the bottom of the widget. 

2. All Search Results Page with Endless Scroll. Please note the image shows results with Prices, Product Categories and Product Tags - these are Pro Version features that are NOT activated on the Lite Version.

3. The plugin adds a Predictive Search tab to your WooCommerce Settings. It also auto creates a WooCommerce Predictive Search page on your site with the predictive search shortcode embedded. This is for the 'All Results Search Page' creation. You can change the pages location if you know what you are doing.

4. The plugin auto adds a Predictive search Shortcode icon to all of your pages and posts visual editors. Note: Shortcodes are not a supported feature on the lite version.


== Usage ==

1. WP admin > WooCommerce > Settings > Predictive Search Tab

2. Appearance > Widgets

3. Locate WooCommerce Predictive Search widget and drag it into the sidebar where you want it to show. 

4.Give the widget a Title and click SAVE.
 
5. Enjoy.

== Frequently Asked Questions ==

= When can I use this plugin? =

You can use this plugin only when you have installed the WooCommerce plugin.
 
== Support ==


== Changelog ==

= 2.0.2 - 2013/03/15 =
* Feature: All Results search page shortcode now shows as an image in the Search results page Visual text editor instead of the shortcode [woocommerce_search]. We have used an image to overcome some confusion about if the shortcode was a3rev Predictive Search or a WooCommerce shortcode function. Also has instructions (in English) about moving the shortcode to another page. After you upgrade, take a look

= 2.0.1 - 2013/03/13 =
* Fixed : Can't activate the plugin on some sites . The problem was in php configuration differences .It was caused by php configuration related to short <?php syntax which allows to use <? instead. Thanks to WordPress member Ovidiu for firstly reporting this then giving us ftp and wp-admin access to see and find the problem on his server.


= 2.0 - 2013/02/28 =
* Feature: Updated all plugin code to be WooCommerce V2.0 compatible with backward compatibility.
* Feature: Added 'Pretty URL' support to replace the All Search Results pages parameter driven URLS
* Feature: Added the ability to add text content that shows inside the Search box. Added as a Global setting or can be individually set on each Widget
* Feature: Added a new styling lib for drop-downs and Options this was important because it now uses the same lib as WooCommerce uses to makes excluding Products from Predictive Serach very easy and quick.
* Fixed: Undefined variable mediumSRC notice showing in search box dropdown when product does not have a featured image.We fixed by defining the variable.
* Tweak: Jumped version to 2.0 to keep in synch with the Pro Version.


= 1.0.8 - 2013/01/08 = 
* Tweak: Updated Support and Pro Version link URL's on wordpress.org description, plugins and plugins dashboard. Links were returning 404 errors since the launch of the all new a3rev.com mobile responsive site as the base e-commerce permalinks is changed.


= 1.0.7 - 2012/12/18 =
* Feature: Added get Product Name results character description from Products 'short description' if no content is entered for Product description.
* Fixed: Plugin now supports themes that use post_type array rather than post_type string. If the theme post_type is array plugin will now use function is_array() and in_array() instead of trim() function to generate the All Search Results pages. Thanks to Dietmar Hohn of Germany for working with us on this quirky bug fix.


= 1.0.6 - 2012/11/27 =
Security - Vulnerability Fix - please update your plugin now.

* Fixed: XSS Vulnerabilities. Added strip tags function to stop XSS injections by adding script via the predictive search box. Thanks to Jason Flemming for alerting us to this issue.


= 1.0.5 - 2012/11/22 =
* Fixed: Version 1.0.4 fix where we removed Predictive Search filter 'posts_search' from single product page edit page to fix the Cross sells and Upsells search caused the Products search filter to be corrupted because we use Wordpress ajax to show results in the widget drop down. The ajax is called from admin-ajax.php file in admin so it also did not add the filter and show incorrect results.
* Feature: Added exclude individual Products from Predictive Search. From the WooCommerce > Settings > Predictive Search tab enter the Product custom post ID of any products that you do not want included in Predictive Search results.
* Feature: Added Exclude all search types to the admin panel. Exclude Product category, Product tag, Posts and pages is a Pro version feature but this keeps up the code compatibility between the Pro and Lite versions for seamless upgrades.
* Feature - Change to admin panel for Predictive Search Function to keep the Lite and Pro Versions in sync for seamless upgrade - Pro Version Search function for replacing WordPress / WooCommerce or Theme Search functions in theme header has been upgraded to allow for easier global function configuration. Go to the WooCommerce > Settings > Predictive Search and you will see that with the Pro Version you can now add and update the function search values on that page. Once values are added and the page updated Pro version license holders can just add the global function to their header.php file.
* Tweak: Added link on admin panel to our latest WooCommerce Lite Version plugin - WooCommerce Widget Product Slideshow.   


= 1.0.4 - 2012/11/16 =
* Fixed: Removed Predictive Search filter 'posts_search' from single product page edit page. The filter was causing the 'Related Products' Up-Sells and Cross-Sells 'Search for a Product' in the WooCommerce meta not to work at times on both the Lite version and the Pro version.
* Tweak: Added link to our latest WooCommerce plugin - WooCommerce Widget Product Slideshow to the list of available A3 WooCommerce plugins on the Predictive Search admin tab.


= 1.0.3 - 2012/09/25 =
* Feature: Automated the All Results Search page endless scroll feature. No longer have to click the bar to see more results.
* Tweak: Edited widget, shortcode pop up and function to show Pro Version new Search by Product SKU feature
* Tweak: Edited admin page to show new Pro Version add to cart feature on All Search Results page.
* Tweak: Updated readme for WordPress description text. 


= 1.0.2 - 2012/09/14 =
* Feature: Activated the ability in Lite version to set the number of search results that show in the widget search box dropdown. 
* Feature: Activated the ability in Lite version to set the number of description characters that show in the widget search box dropdown.
* Feature: Added Documentation and Support Links to plugins description.
* Feature: Added Plugin Documents to the a3rev wiki.
* Tweak: Added screenshots to the wordpress.org listing.
* Tweak: Updated Predictive Search WooCommerce Tab with links to other A3 WooCommerce plugins on wordpress.org for ease of navigation.
* Tweak: UI changes to Widget to accommodate the new Pro Major Update features. 


= 1.0.1 - 2012/08/03 =
* Fix: Show the 6 results with 100 characters of product description by default when no value is present in Widget control and Admin panel
* Fix: Change z-index for search box from 1001 to 99 so that themes nav bar dropdowns slide over it instead of behind the search box
* Feature: Hide the description when enter 0 as the number of description characters in the sidebar widget and Admin panel.
* Feature: Show first thumb image in product gallery if the product does not have feature image.


= 1.0.0 - 2012/08/01 =
* Initial release.