=== Store Locator Plus for WordPress === Plugin Name: Store Locator Plus Contributors: charlestonsw Donate link: https://www.storelocatorplus.com/ Tags: map, locations, directory, directions, google map, location finder, locator, postal code, shop finder, store finder, store locator, zip code License: GLPv2 or later Requires at least: 3.8 Tested up to: 4.8 Stable tag: 4.8.3 Add a location finder or directory to your site in minutes. Extensive premium add-on library available! == Description == [Product Page](https://www.storelocatorplus.com/) | [Video](https://www.youtube.com/channel/UCJIMv63upz-qIaB5EcursyQ) | [Demo](https://www.knowledgetrail.com/route-manager-frequently-asked-questions/) | [User Guide](https://demo.storelocatorplus.com) | [AddOns](https://wordpress.storelocatorplus.com) | [Managed Service](https://my.storelocatorplus.com) Help your site visitors find your business with [Store Locator Plus](https://www.storelocatorplus.com). Map 10 or 10's of thousands of locations across the globe. Highly customizable location search and directory building is possible with our [premium add ons]((https://wordpress.storelocatorplus.com). The base plugin if fully functional and as no location limit restrictions and includes all of the main features you need to get a locator installed quickly and easily on your site. Learn about updates or follow our How To videos on our YouTube channel. [youtube https://www.youtube.com/playlist?list=PLP4RKgpdF-0eahOHMUuLqTfg8EjCQ58Wp] [Store Locator Plus](https://www.storelocatorplus.com/) has all the features you need to create a location finder on your website. Whether you have ten locations or ten-thousand, you can manage them with WordPress. There is no special programming or extra setup required. Enter your locations, create a page and put the SLPLUS short code on it. The Store Locator Plus search form and map will "magically" appear. The Store Locator Plus plugin is used by some of the biggest international brands like Bosch, Goodwill, Old Spaghetti Factory, and The Big Green Egg. It has been used to created interactive store finder maps, service directories, and as a product finder. Visit the [SLP Customers page](https://wordpress.storelocatorplus.com/mindset/slp-customers/) to see a sample of some of the people that are using the plugin today. = Features = * Supports tens or tens-of-thousands of locations. * Fully customizable with basic HTML and CSS which can be managed via the admin panel with select [Add Ons](https://wordpress.storelocatorplus.com/product-category/slp4-products/). * A bundled REST API provides an easy way to build mobile apps and custom framework interfaces. * Supports multiple [countries](https://docs.storelocatorplus.com/blog/tag/countries/) and [languages](https://docs.storelocatorplus.com/blog/tag/languages/). * Extensive [Add On](https://wordpress.storelocatorplus.com/) library available. * Free support at our [forum](https://wordpress.storelocatorplus.com/forums/). = Add-Ons = **Get It All** with a [Premier Subscription](https://wordpress.storelocatorplus.com/product/premier-subscription/) This optional subscription service is a great way to support the plugin. The subscription is not required; your base plugin as well as any add-on packs will always remain fully functional. The Premier Subscription gives subscribers access to Premier-Member-only sections of the site including a "always first" support forum where questions are answered within 1 business day and follow on direct email is provided for more complex questions or issues. Premier Members have access to the live chat Slack channel for Store Locator Plus. Premier Members have an "everything offered" downloads page which includes all production plugins and add-on packs as well as early access to pre-release products. Subscription pricing is locked in at the original price when signing up even as the features and services grow. Premier subscriptions include the [Premier Plugin](https://wordpress.storelocatorplus.com/product/premier-plugin/) with new features added on a regular basis. WooCommerce integration, territories, cluster map markers, and more come with the Premier add on. **Customize The User Experience** with the [Experience](https://wordpress.storelocatorplus.com/product/experience) add-on. * Custom tailor the results output with a custom HTML/shortcode admin entry. * Change sort order on the the results. * Works with other add-on packs, like Tagalong, to show per-location icons. * Modify location field labels. * Custom tailor the search form with a HTML/shortcode admin entry. * Turn the search interface on/off. * Works with other add-on packs to display category drop downs, tag drop downs, and other search features. * Custom tailor the map info bubble custom HTML/shortcode admin entry. * Center the starting map at any location in the world. * Turn the map display on or off or let the user decide with a slider switch. * Modify the built-in Google Map controls. * Put location search in your widget-enabled areas. * Direct users to the default map page, or show results right in the widget area. * This add on replaces the now-defunct legacy Enhanced Map, Enhanced Search, and Widgets Add Ons. **Enterprise Location Management and Reporting** via [Power](https://wordpress.storelocatorplus.com/product/power/) * Location Sensor support. * Data import and export. * Location search reporting. * Categorize locations. * Assign map markers and icons to locations. * Assign multiple categories to a single location. * Create SEO friendly per-location pages. * Directory building options. * City/State/Country list can link directly to the locator page with automatic search results showing the locations. * Adds a dozen extra contact specific data fields for each location. * Adds a half-dozen new fields to the basic location data. = Third Party Add-Ons = **Allow Users To Manage Locations** with [User Managed Locations](https://wordpress.storelocatorplus.com/product/slp4-user-managed-locations/) * Provides a user capabilities interface to grant/deny access to SLP location management on a user-by-user basis. * Site administrators have access to the full management interface. * Users granted location management capabilities can add, edit, and delete locations they own from their WordPress login. **Add Custom Data Fields** with [Extended Data Manager](https://wordpress.storelocatorplus.com/product/extended-data-manager/) * Add custom data fields to your location data. * Choose which fields to show or hide, including fields created by other add-ons. **Add Social Media** links for all of your locations with [Social Media Extender](https://wordpress.storelocatorplus.com/product/slp4-social-media-extender/) * Setup links to Facebook, Twitter, Linked In, or Instagram * Add any social media service with a configurable URL and icon builder * Show the icons on the search result listings **Connect Gravity Forms** with [Gravity Forms Integration](https://wordpress.storelocatorplus.com/product/gravity-forms-integration/) * Use Gravity Forms to build forms that load up location data from site visitors. **Add Events** with [Event Location Manager](https://wordpress.storelocatorplus.com/product/event-location-manager/) * Connect your locations to specific events. = Support = Support for the plugin can be found in the [Forums](https://wordpress.storelocatorplus.com/forums/). If you have an urgent issue or want one-on-one support you can [purchase premium support](https://wordpress.storelocatorplus.com/product/product-support). You can also view the [Product Documentation](https://docs.storelocatorplus.com/) for more information. = Special Requests = I accept feature requests for all plugins. The most requested features will make it into the next version if time permits. If you need something NOW, or are looking for something beyond a basic "tweak" of the plugin, please check out the [Customization Service](https://wordpress.storelocatorplus.com/product/customization/). = Upgrades and Patches = The main product will always remain fully functional and free. The product is tested with each new WordPress release and updated as required. If you'd like to have some of the latest "bells & whistles" [purchasing add-ons](https://wordpress.storelocatorplus.com/) is a great way to help support product development. = My Philosophy = I strive to create code that runs efficiently and without bugs. Well-written plugins are few and far between. While there are plenty of plugins that look nice, many of those plugins, including the "cool shiny ones" have hidden problems. Over 90% of the plugins available on the WordPress plugin directory generate dozens, if not hundreds, of warnings and errors when you turn off the "hide all the problems" settings. These hidden problems impact memory usage, fill up disk space, and reduce performance. While you may not see the errors on your WordPress site, they are still being tracked. The more errors, the more disk I/O, the slower the app. During my 20 years of software development, I have found that leaving "innocuous" warnings in place tends to lead to trouble further down the road. Warnings today often become errors tomorrow. Many programming languages, PHP included, continue to tighten security and close loopholes that are typically found living near warning messages. Some warnings are telling you to "change this now, it will be gone tomorrow". Eventually tomorrow will come. While my plugins may not be the prettiest on the block, I do try to make sure that all the hidden stuff you don't see is designed as well as it can be. My code is not perfect, but when I find a bug I try to fix it fast. If I create a bug I try to fix it even faster. I like to write plugins that last. I hope you appreciate my work. = Rate This Plugin = Please [rate this plugin](https://wordpress.org/extend/plugins/store-locator-le/)! Rating the plugin, hopefully with 5 stars, helps increase the exposure on WordPress, which generates more downloads and purchases of add-ons. The more add-ons I sell the easier it is to put food on the table and give me more time to code cool new features. Give us a chance to address your concerns if this plugin doesn't earn 5 stars by [contacting us](https://www.storelocatorplus.com/contact-us/) directly or by posting in the [support forum](https://www.storelocatorplus.com/forums/) at the website. == Follow Us == [Blog](https://www.storelocatorplus.com/news/) | [Twitter](https://www.youtube.com/c/Storelocatorplus) | [Google+](https://plus.google.com/b/104522888087133315735/) | [YouTube](https://www.youtube.com/c/Storelocatorplus) | [FaceBook](https://www.facebook.com/storelocatorplus/) == Keywords == maps, locations, finder, directory, plugin, wordpress, store locator, google maps, wordpress map plugin, wp, wordpress locator, gps, search, retail finder, store finder, business directory, business listings == Installation == You can find the [Getting Started With Store Locator Plus Video on YouTube](https://www.youtube.com/watch?v=b51J1ay7fyk). = Requirements = * WordPress: 3.8 (Version 4.4 is recommended) * jQuery: 1.7 (same as WordPress 3.3, comes with WordPress) * PHP 5.2.4 (Version 5.6 is recommended for security reasons, per WordPress) * MySQL 5.0.15 (Version 5.6 is recommended for security reasons, per WordPress) = Main Plugin = 1. Search for "Store Locator Plus" via Plugins/Add New on your WordPress admin panel. 2. Click install. 3. Get a [Google API key](https://developers.google.com/maps/documentation/javascript/get-api-key) and save it under the General / Server / API Key settings. 4. Add your locations through the 'Locations' page in the Store Locator admin panel 5. Create or edit a page and add the [[SLPLUS] shortcode](https://docs.storelocatorplus.com/blog/tag/shortcode/). == Frequently Asked Questions == = How do I report a bug? = Post in the [support forum](https://wordpress.storelocatorplus.com/forums/). You can also [contact us](https://www.storelocatorplus.com/contact-us/) via email. = What are the Add Ons? = Add ons extend the functionality of the plugin beyond the basic service and features and can be purchased ala-carte. This gives those customers who want more out of the plugin the extra features they desire while keeping the main plugin as efficient as possible for everyone else. It also provides a great way to support future development while getting a "little something extra" when contributing to the development of the product. All plugins are true add-on packs. They are non-destructive OPTIONAL additions to the base plugin. They do not require the base plugin to be uninstalled or re-installed. Installing an add-on pack will not change location data or modify base plugin settings. = What are the terms of the license? = The license is GPL. Learn more on the [License Terms page](https://wordpress.storelocatorplus.com/products/general-eula/). = How can I translate the plugin into my language? = Store Locator Plus is now part of the WordPress Translate system. You can translate this readme file and the text strings in the main Store Locator Plus plugin at [Translate.WordPress.Org](https://translate.wordpress.org/projects/wp-plugins/store-locator-le). For the Add Ons, the language files are distributed with each add-on pack. If you translate an Add On send the .po and .mo files to support@storelocatorplus.com. == Screenshots == 1. Big Map Plugin Style on Big Map WordPress Theme 2. Manage Locations Interface 3. Search Settings with [Experience Add On](https://wordpress.storelocatorplus.com/product/experience/) 4. Map Settings 5. Plugin Style Selector 6. Cluster Markers with [Premier Add On](https://wordpress.storelocatorplus.com/product/premier-subscription/) 7. SEO via [Power Add On](https://wordpress.storelocatorplus.com/product/power/) 8. Bulk Import with [Power Add On](https://wordpress.storelocatorplus.com/product/power/) 9. Directions from results link == Changelog == = 4.8.3 = * Make built-in Smart Options a little smarter when something is deactivated and a setting goes away. * Fix manage locations hide columns and pagination for MySLP. * Fix location edit/add on non-English sites. = 4.8.2 = * Add a nicer notification for missing home/end icons on the Settings interface. * Remove obsolete legacy code to lighten the disk and memory impact. * Fix Premier license validation on multisite. * Enhanced Results is officially deprecated. Users must be using version 4.7 or earlier of SLP to continue using the legacy add on. = 4.8.1 = * Prevent add ons from consuming lots of memory and possibly crashing the site when they call the is_CheckTrue() method improperly. = 4.8 = * Manage Locations UX has been updated: uses WordPress-standard Screen Options to set number of locations to show on a page and show/hide columns. * Manage Locations Edit / Add has been updated: uses JavaScript interface and overlay windows to edit locations. * Adding a location via the Manage Locations form no longer requires the store name to be set. * Lighten the data load going to the JavaScript front end to alleviate browser congestion and improve performance. * Uses minified JS for slp_core if available. * Patch to fix the [Power Add On](https://wordpress.storelocatorplus.com/product/power/) CSV Import duplicate handler. * Patch to deal with [Experience Add On](https://wordpress.storelocatorplus.com/product/experience/) hide_search_form shortcode issue. * New Smart Option interface for add ons reduces redundant code. * Tagalong is no longer compatible with SLP, upgrade to the [Power Add On](https://wordpress.storelocatorplus.com/product/power/). = 4.7.11 = * Minor updates to the AJAX processor for extended add on features. * Make sure the add on disabler catches early errors like the one that came up in Pro Pack legacy (no longer compatible). * Auto-disable Pro Pack to prevent admin page crashes. = 4.7.10 = Changes * Added Search Form Style for styling interactive jQuery locator elements. * Improved notifications on Premier Subscription status for Premier members. * Tested with WP 4.7.5 * The [Power Add On](https://wordpress.storelocatorplus.com/product/power/) must be upgraded to version 4.7.11 or higher. * The [Premier Add On](https://wordpress.storelocatorplus.com/product/premier-subscription/) must be upgraded to version 4.7.10 or higher. * The legacy Enhanced Map Add On is no longer supported. Upgrade to the [Experience Add On](https://wordpress.storelocatorplus.com/product/experience/). * Pro Pack is not longer supported, upgrade to the [Power Add On](https://wordpress.storelocatorplus.com/product/power/). = 4.7.9 = Changes * The "Experience" tab is now named "Settings" to better reflect its purpose. = 4.7.8 = Enhancements * Use minified admin CSS when available. * Fix CSS loading with some themes that are not co-mingling minified and non-minified CSS properly such as the Store Locator Plus theme we use on our SLP branded sites. = 4.7.7 = Enhancements * Use WP Best Practices minimalist plugin loader approach to reduce overall WordPress plugin overhead. Fixes * Fix problem in activation module when upgrading from older SLP modules that would break some sites on initial distance calculation. = 4.7.6 = Enhancements * Improved add on update checking. * Extended JavaScript interface for external applications including [MySLP](https://my.storelocatorplus.com/). * Code simplification for less disk & memory storage. * Improved code architecture takes advantage of PHP5 and PHP7 caching,especially [opCache](https://wordpress.org/plugins/opcache/) which can significantly improve performance. * Much less data I/O during location search means slightly faster location searches that use less RAM on the server when running. Changes * [Premier](https://wordpress.storelocatorplus.com/product/premier-subscription/) , [Power](https://wordpress.storelocatorplus.com/product/power/), and [Experience](https://wordpress.storelocatorplus.com/product/experience/) all require version 4.7.6. Fixes * Fix Map Center setting for users upgrading from SLP 4.7.3/4.7.4 where map center was stored incorrectly. = 4.7.5 = Enhancements * Custom Map Markers and Icons now has a direct upload interface with media manager. Changes * Legacy Widgets Add On no longer supported, use [Experience](https://wordpress.storelocatorplus.com/product/experience/) = 4.7.4 = Fix the rogue "add_on" for people that upgraded from an older version of SLP. = 4.7.3 = Enhancements * A new plugin style gallery taps into our live style server for a wider selection of map styles. * [Premier Member](https://wordpress.storelocatorplus.com/product/premier-subscription/) styles from our style gallery is now shown alongside standard plugin styles. * Add new [slp_option name="