=== Store Locator Plus® for WordPress === Plugin Name: Store Locator Plus® Contributors: charlestonsw Donate link: https://www.storelocatorplus.com/ Tags: blocks, gutenberg, store locator,locator,map,locations,google map,location finder,shop finder,store finder,zip code License: GPL3 Required PHP: 5.6 Requires at least: 5.0 Tested up to: 5.4 Stable tag: 5.5.2 Add a location finder or directory to your site in minutes. Premium add-on library extends functionality with cluster markers, more map controls, categories and more. == Description == [SLP](https://storelocatorplus.com/) | [WordPress Plugins](https://wordpress.storelocatorplus.com) | [Documentation](https://docs.storelocatorplus.com) | [Demo](https://demo.storelocatorplus.com) Help your site visitors find your business with [Store Locator Plus®](https://storelocatorplus.com). Map 10 or tens-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. [Store Locator Plus®](https://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, Blue Bell Creamery, Feeding America, Goodwill, Old Spaghetti Factory, and The Big Green Egg. = 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 Power, 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. = 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 = All of our product customization is now done via our affiliate company [Cyber Sprocket Labs](https://cybersprocket.com/). = Upgrades and Patches = The main product will always remain fully functional. 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. == Follow Us == [Blog](https://www.storelocatorplus.com/news/) == 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: 4.6 * PHP 5.6 = 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 == = Privacy Policy = By using Store Locator Plus® on your website you should incorporate the following on your site: [Third Party Site’s Use of Store Locator Plus® Privacy Policy](https://www.storelocatorplus.com/third-party-sites-use-of-store-locator-plus-privacy-policy/) By default the Store Locator Plus® plugin does NOT have geolocation detection and will not ask for your user's latitude and longitude. You CAN enable that service with the [Power](https://wordpress.storelocatorplus.com/product/power/) add on or by employing our [MySLP SaaS Service](https://my.storelocatorplus.com/) on the Professional or Enterprise level. By default the Store Locator Plus® plugin does NOT record location searches or other data when using the maps. You CAN enable that tracking with the reporting feature provided by the [Power](https://wordpress.storelocatorplus.com/product/power/) add on. = 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 is MySLP? = [MySLP](https://storelocatorplus.com/) is our hosted SaaS service for Store Locator Plus®. We install the software on our servers where you will [login to manage locations](https://dashboard.storelocatorplus.com/) and setup the locator user experience via the map settings. This is a paid monthly service and includes all Google Map fees. It is NOT required to use the WordPress plugins. = What is the difference between MySLP and the WordPress plugins? = [MySLP](https://storelocatorplus.com/) requires no downloads or software installation. With [MySLP](https://storelocatorplus.com/) you are given a small JavaScript snippet that you can put on any web page -- not just WordPress sites. For sites that have a more than 8,000 map views, our MySLP overage rates are 20% less than Google's API direct billing. The [Store Locator Plus WordPress plugins]([MySLP](https://wordpress.storelocatorplus.com/)) are downloadable zip files that you install on your self-managed WordPress site. The base plugin is free. The add ons are paid , but once you purchase and install them you own them. You are responsible for keeping them updated and making sure the web hosting plan you are using can handle the technical requirements. You must also setup and manage your own Google API Keys and have a credit card on file with Google. They will bill you based on how many map views and address lookups you ask them to handle. = 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. = 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. == 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 == = 5.5.2 = * FIXED JavaScript order of precedence to ensure slp_core is loaded before add on JS libraries. = 5.5 = * NEW Gutenberg (WP5) block support with the SLP basic block. Can be used in place of the [slplus] shortcode. * IMPROVED search by name functionality. * IMPROVED shortcode UI to assist with MySLP in-page directory rendering. * FIXED support for Experience Add On "Append This" functionality. * CHANGED support latest Store Locator Plus® Style Gallery entries. * CHANGED requires Power add on to be at least version 5.3.3 * CHANGED SLP no longer allows you to turn off the SLP included Google Maps JS * CHANGED you can no longer enable WP_DEBUG from the SLP General Settings menu, you must edit the wp-config.php * CHANGED you can no longer set PHP timeout limits in SLP, you must set them in your server PHP configuration. * CHANGED custom CSS styles are now handled via your theme or the Experience add-on Custom CSS setting. Legacy CSS files are no longer included in the WPSLP install. = 5.3.2 = * UPDATE the location add/edit form to use Vue for extended data fields as well. * CHANGED premier license validation to 72h check * CHANGE HTTP get requests to use HTTP version 1.1 = 5.3.1 = * NEW settings export and import * PATCHED location extended data inconsistency, manifests as inconsistent category icon markers = 5.3 = * IMPROVED no results message is now a textarea. * IMPROVED results layout processing with new ifnotset directive. * IMPROVED results layout processing to give slp_option shortcodes in the layout the same modifier behavior as slp_location. * IMPROVED manage locations table loading performance for sites with more than a few hundred locations * NEW option retrieval functionality for results and bubble layouts retrieves settings in real-time from server even after page load. Reduces overhead on loading scripts. Shortcode attributes will take precedence. * CHANGED no results message is now fetched in real-time as needed from the server instead of being passed in as a local variable. * CHANGED admin CSS for WP 5.4 compatibility = 5.2.10 = * PATCHED fallback CSS rule to reference https google maps image. = 5.2.8 = * PATCHED production build issue with incomplete admin.css = 5.2.7 = * PATCHED set map center from search widget searches with Experience add on. * PATCHED turning off location sensor with Power add on. * PATCHED passing in of address with allow address in URL for Experience add on. = 5.2.3 = * IMPROVED location add/edit interface. = 5.2.2 = * PATCHED re-instate the recently missing description and hours fields on location edit forms. = 5.2.1 = * PATCHED - remove spans in results city_state_zip to eliminated unexpected block formatting on some themes. = 5.2.0 = * Updated the Vue/Vuetify JavaScript libraries. * NEW [slp_location zipstatecity] to put the zip before the city or state for some European style addresses. * ENHANCE [slp_location citystatezip] to add spans with classes for slp_city, slp_state, slp_zip for improved CSS formatting. * PATCH [slp_location citystatezip] to ensure there is a space between postal code and city when state is missing. = 5.0.5 = * Requires PHP 5.6 and WordPress 4.6 * PATCH make sure region is always sent to geocoding filters. * PATCH improve load locations functionality. = 5.0.4 = * PATCH Set the default map region on the map page to the user-selected Map Domain versus fallback of 'US' when map_region was not used. * PATCH Geocoding for non-US regions when slplus shortcode map_region is not used. * PATCH REST endpoint URLs for migrated sites or sites installed in a subdirectory while retaining a home option set to the base URL. * Show Goecode messages returned from Geocode system when an address lookup fails. * Having problems with Address Lookup on your map? Using permalinks? Make sure you added [REST (wp-json) redirects to your web server rules](https://www.storelocatorplus.com/wordpress-subdirectory-installs-and-the-rest-api/). = 5.0.3 = * IMPROVE Google Location Geocoding from the map interface = 5.0.1 = * IMPROVED any new Store Pages created with the Power add on will have full basic location meta stored in custom fields. * PATCHED [slplus center_map_at="..."] functionality has been restored. * PATCHED [slpplus map-region="..."] functionality has been restored. = 5.0 = * IMPROVED significantly reduce Google Maps geocoding requests by eliminating the geocoding request for the map center on map loading * IMPROVED all geocoding requests now use the country code set via Setting | Map | Map Domain as the region code to assist in geocoding * IMPROVED add the ability to redirect Geocoding requests to a non-google server with the slp_geocode_address geocode reponse * SIMPLIFIED the General | Server Settings using built-in smart defaults for Geocoding Settings on server speed, retries, and maximum delay. * CHANGED all geocoding requests, even from the front-end map now route back to the SLP Plugin which communicates with Google * this will allow future versions to use alternative sources for geocoding results from both the front-end and back-end in SLP