=== 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 Stable tag: 1.0.8 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 your entire product database 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 = * Searches your entire WooCommerce product database for the product name that match what is being typed. * Shows the results beautifully in the widget drop-down with Product Thumbnail, Title and description text. * Set the number of Product results to show in the drop down. * Set the number of characters of the product description text to show with each search result. * New Feature 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. * Add search box to any widgetized area on your site. = Documentation = Find detailed step-by-step set up and configuration instructions in the [plugins documents](http://docs.a3rev.com/user-guides/woocommerce/woo-predictive-search/) on the a3rev wiki. = Pro Version Upgrade = The Pro Version upgrade for WooCommerce Predictive Search is the Ultimate search engine tool for your site. You will see all of the available upgrade features on the plugins widgets, admin panel and shortcode pop-up. Upgrading activates all of these advanced features. * Configure Predictive search for these search 'types': - Product names (Lite Version includes this) - Product SKU's - Product Categories - Product Tags - Post titles - Page titles - or any combination of these. * Add Search boxes by - Widgets in any Widgetized area of the theme (Lite Version includes this) - In any Page or post via 'Shortcode' - Anywhere in the theme via the Predictive Serach Function. * Set the number of each search 'type' of results to show in the search box drop down from the widget, shortcode pop up or function. * Use drag and drop in the widget to set the search 'type' order that the results show in the drop down. * NEW - Exclude From Search Results 'Exclude From Predictive Search' Functionality. From the WooCommerce > Settings > Predictive Search tab you can now exclude any Product, Product Category, Product tag, Post or Page from showing in the Predictive Search results. * Where there are more results than show in the drop down pages are auto generated showing all results for: - Product names (Lite Version includes this) - Product SKU's - Product Categories - Product Tags - Posts - Pages - all results pages are sorted and viewable from a single page. * All Search Results Page features include: - Set the number of results to show before endless scroll feature clicks in. - Set the number of Description text characters to show with the results. - Show products prices including 'specials' pricing. - Show 'add to cart' button for each product - Show Product Categories that the result is also assigned to.(Clickable link to that Category page) - Show Product Tags that the result is also assigned to (clickable link to that Tag page) . * Shorcodes - WooCommerce Predictive Search shortcodes - Insert and configure the Search box into any page or post via shortcode. * 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 if activated. - Configure "Smart Search' or All Products Search from every search widget. * Predictive Search Function - Function and Parameters activated to allow users to manually add and configure Predictive Search to any part of their theme e.g header. = Plugins Resources = [Home Page](http://a3rev.com/shop/woocommerce-predictive-search/) | [Documentation](http://docs.a3rev.com/user-guides/woocommerce/woo-predictive-search/) | [Support](http://a3rev.com/shop/woocommerce-predictive-search/#tab-reviews) = 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 == Support and access to this plugin documents are available from the [HELP tab](http://a3rev.com/shop/woocommerce-predictive-search/#tab-reviews) on the Pro Versions Home page. == Changelog == = 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  Vunerability 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.