=== WP e-Commerce Predictive Search === Contributors: a3rev, A3 Revolution Software Development team Tags: WP e-Commerce Predictive Search, WP e-Commerce, Predictive Search, Live Search, e-commerce, wordpress ecommerce Requires at least: 3.3 Tested up to: 3.4.1 Stable tag: 1.1.2 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.html WP e-Commerce Predictive Search gives your customers an awesome search experience delivering stunning 'live' product search results. == Description == WP e-Commerce 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 drop down to the 'All Results Search Page' that features endless scroll. = Key Features = * Searches your entire WP e-Commerce product database for the product titles 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 dropdown. * Set the number of characters of the product description text to show with each search result. * NEW - Exclude Products from search * Click through from the Widget drop down 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. = Set-Up = Find detailed step-by-step set up and configuration instructions with pretty pictures to guide you in the [plugins documents](http://docs.a3rev.com/user-guides/wp-e-commerce/wpec-predictive-search/) on the a3rev wiki. = Pro Version Upgrade = WP e-Commerce Predictive Search is the upgrade for those WP e-Commerce store owners who want a truly awesome search feature on their site. You will see all of the available upgrade features on the plugins widgets, admin panel and shortcode poup. Upgrading activates all of these advanced features. * Configure each widget to search all 'types' - Products (Lite version does these), - Product Categories, - Product Tags, - Posts, - - Pages - or any combination of the above * Set the number of each search 'type' eg "Product Category" results to show in the search box drop down. * 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 Settings > Store > Predictive Search tab you can now exclude any Product, Product Category, Product tag, Post or Page from showing in the Predictive Search results. * User can configure the All Results Search Page for each result to show Product Categories, Product Tags, Product Prices including 'special' pricing with each result just like the single product pages. * User can set the number of results to show before 'endless scroll' bar. * WP e-Commerce Predictive Search shortcodes - Insert and configure the Search box into any page or post via shortcode. * 'Smart Search' is an intuitive technology that auto detects what product category, product tag, post category, post tag the user is looking at and delivers fast and accurate results from that taxonomy any child categories, tags, post categories and tags. * Configure "Smart Search' or All Products Search from every search widget. * Function and Parameters activated to allow users to manually add and configure Predictive Search to any part of their theme e.g header. * Priority same day support. [Home Page](http://a3rev.com/products-page/wp-e-commerce/wpec-predictive-search-pro/) | [Documentation](http://docs.a3rev.com/user-guides/wp-e-commerce/wpec-predictive-search/) | [Support](http://a3rev.com/products-page/wp-e-commerce/wpec-predictive-search-pro/#help) == 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 WP e-Commerce Predictive Search, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New. In the search field type "WP e-Commerce 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. = Localization = * English (default) - always include. * .po file (wpscps.po) in languages folder for translations. * Your translation? Please do yours and [send it to us](http://www.a3rev.com/contact/) We'll acknowledge your work and link to your site. Please [Contact us](http://www.a3rev.com/contact/) if you'd like to provide a translation or an update. == Screenshots == 1. Set up WP e-Commerce 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 WP e-Commerce Settings. It also auto creates a WP e-Commerce 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 > Settings > Store > Predictive Search 2. Appearance > Widgets 3. Locate WP e-Commerce 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 WP e-Commerce plugin. == Support == Support and access to this plugin documents are available from the [HELP tab](http://a3rev.com/products-page/wp-e-commerce/wpec-predictive-search-pro/#help) on the Pro Versions Home page. == Changelog == = 1.1.2 - 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.1.1 - 2012/11/22 = * Feature: Added exclude individual Products from Predictive Search. From the Settings > Store > 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 / WP e-Commerce or Theme Search functions in theme header has been upgraded to allow for easier global function configuration. Go to the Settings > Store > 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. = 1.1.0 - 2012/09/21 = * Feature: Activated the ability in Lite version to set the number of search results that show in the widget search box drop down. * Feature: Activated the ability in Lite version to set the number of description characters that show in the widget search box drop down. * 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 WP e-Commerce Tab with links to other A3 WP e-Commerce plugins on wordpress.org for ease of navigation. * Tweak: UI changes to Widget to accommodate the new Pro Major Update features. = 1.0.2 - 2012/08/17 = * Fixed: Fixed styling for sidebar widget search box so it shows correctly. * Tweak: Change localization file path from actual to base path * Tweak: Added checkbox to select 'Smart Search' in sidebar widget * Tweak: Added Support and Documentation links to plugins description. * Documentation: Added comprehensive extension documentation to the [a3rev wiki](http://docs.a3rev.com/user-guides/wp-e-commerce/wpec-predictive-search/) = 1.0.1 - 2012/08/03 = * Fixed: Show the 6 results with 100 characters of product description by default when no value is present  in Widget control and Admin panel * Fixed: 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 - 2012/07/30 = * Initial release.