=== 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.5.1 Stable tag: 2.0 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 engine 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 = * WP e-Commerce Predictive Search engine delivers 100% accurate results, 100% of the time. * New Feature Pretty URL for the All Search Results pages. * Use 'live search' to wow your customers by delivering deadly, super fast search results. * 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 WP e-Commerce 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/wp-e-commerce/wpec-predictive-search/) and guide to setting up the Compare Products plugin on your WP e-Commerce store.If you have questions - again please post them to the support forum here. = Pro Version Upgrade = WP e-Commerce Predictive Search is now the most powerful site search engine ever developed, because with the Pro version you can optimize your entire site search to perform just the way you want it too. No matter how your customers or clients search the all new Predictive Search 'Focus keyword' feature allows you to configure your site search feature to return the results you want when you want it. Total Control. = Pro Version advanced features = = 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 WP e-Commerce 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 = * WP e-Commerce 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. = Localization = * English (default) - always included. * .po file (wpscps.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. = Plugins Resources = [Home Page](http://a3rev.com/shop/wp-e-commerce-predictive-search-pro/) | [Documentation](http://docs.a3rev.com/user-guides/wp-e-commerce/wpec-predictive-search/) | == 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. == 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/shop/wp-e-commerce-predictive-search-pro/#help_tab) on the Pro Versions Home page. == Changelog == = 2.0 - 2013/04/20 = * Feature: Newly developed mysql command that makes the Predictive Search Engine results 100% accurate, 100% of the time. Install this upgrade and try it out for yourself - you will be absolutely amazed, excited, over the moon like we are about it. * 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 Widgets, Shortcode or the Search Function * Feature: All Results search page shortcode now shows as an image in the Search results page Visual text editor instead of the shortcode [ecommerce_search]. We have used an image to overcome some confusion about if the shortcode was a3rev Predictive Search or a WP e-Commerce shortcode function. Also has instructions (in English) about moving the shortcode to another page. After you upgrade, take a look. * Feature: Major UI upgrade. We have completely rewritten the plugins admin panel and the Predictive Search tab on the WP e-Commerce > Store settings. Content is now broken into sub nav tabs for ease of use. The tabs are Predictive Search | All Results Search Pages | Exclude Content | Search Function, with styling to be added in the next feature upgrade. * Feature: Added a new Chosen styling lib for drop-downs and Options this was important because it now makes excluding content a very easy thing to do for each content search taxonomy. * Feature: Added when install and activate plugin link redirects to the Predictive Search admin page instead of the wp-plugins dashboard. * Fixed: Made new ajax filters to stop plugins like Role Scoper filtering predictive search functions. * Fixed: Posts that do not have any meta data not showing in search results. * Fixed: Don't show [shortcodes] in search results descriptions. * Fixed: Updated all Javascript functions so that the plugin is compatible with jQuery Version1.9 and backwards to version 1.6. WordPress still uses jQuery version 1.8.3. In themes that use Google js Library instead of the WordPress jQuery then there was trouble because Google uses the latest jQuery version 1.9. There are a number of functions in jQuery Version 1.9 that have been depreciated and hence this was causing errors with the jQuery function in the plugin. * Fixed: Link from search box drop down footer to All Results Search pages not working in Internet Explorer 8, 9 and 10. * Fixed: All Results pages returning a 404 page not found when custom permalinks set with a trailing slash. When a sites custom permalinks where set with a trailing slash this caused an extra / in the Results Search pages URL resulting in a 404. The plugin now checks if the trailing slash is present and allows for that to produce the correct URL. * Fixed: Bug for users who have https: (SSL) on their sites wp-admin but have http on sites front end. This was causing search results to show a -1 in the drop down instead of the results because wp-admin with SSL applied only allows https:, but the url of admin-ajax.php is http: and it is denied hence returning the ajax -1 error. Fixed by writing a filter to recognize when https is configured on wp-admin and parsing correctly. If you do not have this configuration nothing changes for you, if you do have https on your wp-admin (or install it in the future) and http on the front end then Predictive Search now automatically detects that and works as it should. * Fixed: Search function and shortcodes not working on themes that call the wpautop function before the shortcode function (very poor practice). The wpautop function auto adds the <p> tag to all white space in php functions and thus breaks our function. We use internal script rather than a js file for the search function and shortcodes because a js file is always called on each page load even when it is not required. We have removed all white spaces and problem no longer exists. * Fixed: Undefined variable mediumSRC notice showing in search box dropdown when product does not have a featured image.We fixed by defining the variable. * Fixed: Full WP_DEG run. All Uncaught exceptions fixed. * Tweak: Jumped version from 1.1.4 to 2.0 to keep in sync with the Pro Version. * Tweak: Updated plugin wiki docs to include new features and admin dashboard layout features. = 1.1.4 - 2013/01/09 = * 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.1.3 - 2012/12/18 = * Feature: Added get Product Name results character description from Products 'Additional 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.1.2 - 2012/11/27 = * 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. == Upgrade Notice == = 2.0 = Major feature upgrade. Please install now for 100% accurate search, 100% of the time. Also includes 9 known bug fixes.