=== Store Locator Plus for WordPress ===
Plugin Name:  Store Locator Plus
Contributors: charlestonsw, DeBAAT
Donate link: https://www.storelocatorplus.com/product/store-locator-plus-4/
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.6.1
Stable tag: 4.6.1

Add a location finder or directory to your site in minutes. Extensive premium add-on library available!

== Description ==

Store Locator Plus is a location mapping and directory system with  over 10,000 active installations.
Learn more at the [Store Locator Plus website](https://www.storelocatorplus.com/).
Try it at our [Demo Site](http://demo.storelocatorplus.com).
Or read about implementation details on our [Docs Site](http://docs.storelocatorlpus.com).

For the latest updates and news follow us on [Twitter](https://twitter.com/locatorplus/).

https://www.youtube.com/watch?v=Gl4V-oz7-IU

= Details =

[Store Locator Plus](http://wordpress.org/extend/plugins/store-locator-le) 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, Tommy Hilfiger, 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](/http://demo.storelocatorplus.com/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://www.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](http://docs.storelocatorplus.com/blog/tag/countries/) and [languages](http://docs.storelocatorplus.com/blog/tag/languages/).
* Extensive [Add On](https://www.storelocatorplus.com/product-category/slp4-products/) library available.
* Free support at our [forum](https://www.storelocatorplus.com/forums/).

= Add-Ons =

**Get It All** with a [Premier Subscription](https://www.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://www.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://www.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.

**Enterprise Location Management and Reporting** via [Power](https://www.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://www.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://www.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://www.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://www.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://www.storelocatorplus.com/product/event-location-manager/)

* Connect your locations to specific events.

= Support =

Support for the plugin can be found in the [Forums](https://www.storelocatorplus.com/forums/).

If you have an urgent issue or want one-on-one support you can [purchase premium support](https://www.storelocatorplus.com/product/product-support).

You can also view the [Product Documentation](http://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://www.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://www.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](http://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/mindset/contact-us/) directly or by posting in the [support forum](https://www.storelocatorplus.com/forums/) at the website.

== 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](http://docs.storelocatorplus.com/blog/tag/shortcode/).

== Frequently Asked Questions ==

= How do I report a bug? =

Post in the [support forum](https://www.storelocatorplus.com/forums/).
You can also [contact us](https://www.storelocatorplus.com/mindset/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://www.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://www.storelocatorplus.com/product/experience/)
4. Map Settings
5. Plugin Style Selector
6. Cluster Markers with [Premier Add On](https://www.storelocatorplus.com/product/premier-subscription/)
7. SEO via [Power Add On](https://www.storelocatorplus.com/product/power/)
8. Bulk Import with [Power Add On](https://www.storelocatorplus.com/product/power/)
9. Directions from results link

== Changelog ==

= 4.6.1 =

Enhancements

* Allow add-ons to load JS on a per-admin-tab basis.  Reduces browser overhead and memory footprint on admin pages.
* Simplify and improve the new option manager.  More consistent option handling, more security option management, better performance.
* Add a simplified object builder for add ons for lower memory consumption.

Fixes

* Checkbox on/off validation for all add ons - fixes instant checkbox saving on admin panel for some add on options.

Changes

* Expose various internal methods for the [MySLP](http://my.storelocatorplus.com) SaaS service.
* All language files are now pulled from the [Translate.WordPress.Org](https://translate.wordpress.org/projects/wp-plugins/store-locator-le) website.
* Missing translations?  See [Translate.WordPress.Org](https://translate.wordpress.org/projects/wp-plugins/store-locator-le) and add your translation updates there.

= 4.6 =

Enhancements

* Manage Locations now has fast delete on single location delete icon.
* Provide mechanism for add ons to serve per-admin-page specific JS.
* If there is a newer version of an active SLP add on report it on the plugins page.

Fixes

* Corner cases on location ID validation.  Fixes the [Power Add On](https://www.storelocatorplus.com/product/power/) assignment of categories on add locations.
* Fixes the duplicates handling on location import.
* Smart/fast option saving for add on packs including [Power Add On](https://www.storelocatorplus.com/product/power/) import options.
* Fix the onchange trigger on admin form drop down menus allowing for smart/fast option saving on drop down menus.
* Eliminate the duplicate dialogue boxes on manage location bulk actions.

Changes

* Zoom Adjustment set to 0 (was 1 for older Google Maps implementations).  Only for new installs.
* [Gravity Forms Locations](https://www.storelocatorplus.com/product/gravity-forms-locations/) and [Gravity Forms Integration](https://www.storelocatorplus.com/product/gravity-forms-integration/) add ons must be upgraded to version 4.5+.

= 4.5.13 =

* Only show survey request on SLP dashboard pages.

= 4.5.11 =

Enhancements

* Security Patch:  Fix XSS on location management admin tab with start parameter.

= 4.5.10 =

Enhancements

* Better messages and links for add ons disabled for compatibility.
* Update the How To Use with better instructions for getting a Google API key.  See our [Getting Started Guide](http://docs.storelocatorplus.com/blog/getting-started/)
* Update Brewery Plugin Style to Rev 03 for better compatibility with [Brewery by Rescue Themes](https://rescuethemes.com/wordpress-themes/brewery/)

= 4.5.09 =

Enhancements

* Update How To Use to make note of the requirement to get a Google Maps API Key since June 2016.
* Add the Google Server API Key setting to the Info tab if it has not been set.
* Add a new slp_report_query_result hook for better results reporting on location load/search.

Fixes

* Labels and messages can be set to blank.

= 4.5.08 =

Enhancements

* Performance improvement on extended data field processing.
* Add filters slp_radius_behavior_description and slp_radius_behavior_selections to allow add on packs to extend radius behavior options.
* AJAX location search now supports multiple disparate search queries for extended add on search features.
* Updated [Brewery Rev 02](https://rescuethemes.com/wordpress-themes/brewery/) Plugin Style.
* More file path changes to attempt to work around PHP symlink quirks.

Changes

* Radius Behavior is a new base plugin setting set to "always_use".  The [Premier](https://www.storelocatorplus.com/product/premier-subscription/) and Experience](https://www.storelocatorplus.com/product/experience/) Add Ons extend this setting.
* Dropped slpplus.initOptions() support.  Some older SLP add ons may be deactivated and require an upgrade to a newer version.
* Dropped slpplus.is_Extended() support.  Some older SLP add ons may be deactivated and require an upgrade to a newer version.
* Dropped slplus.register_addon support.  Some older SLP add ons may be deactivated and require an upgrade to a newer version.
* Dropped slplus.versionCheck() support.  Some older SLP add ons may be deactivated and require an upgrade to a newer version.
* Added query_slug to slp_location_filters_for_AJAX filter.  Default slug is 'standard_location_search'.
* Added query_slug to slp_location_having_filters_for_AJAX filter.  Default slug is 'standard_location_search'.
* Added query_slug to slp_ajaxsql_fullquery filter.  Default slug is 'standard_location_search'.
* Added query_slug to slp_ajaxsql_queryparams filter.  Default slug is 'standard_location_search'.
* Added query_slug to slp_ajaxsql_results filter.  Default slug is 'standard_location_search'.
* Add slp_ajax_execute_location_query_start and slp_ajax_execute_location_query_end actions for AJAX query handling.
* Updated symlink path testing.


= 4.5.07 =

Enhancements

* Add layout support for 3rd party buttons for UML/GFI add on.
* Improved WPML support.
* The Google Map now responds to changes in the WPML selected language on the user interface.

Changes

* Drop find label button support for legacy Enhanced Search versions prior to 4.3.  Will need to upgrade ES to 4.4+ or use [Experience Add On](https://www.storelocatorplus.com/product/premier/).
* Drop defunct getWPMLText() function, may require legacy add ons to be updated to latest version.
* Drop the unused slp_generalsettings_modify_adminpanel filter.
* Drop the slplus->addons property.  Make break older legacy add on packs.  Upgrade the add on packs to version 4.5+.
* Drop CSVImport base class.   Pro Add On and Tagalong Add On will need to be updated to version 4.5.07.

= 4.5.06 =

Enhancements

* Search Form Radius selector label is assigned a class of 'empty' or 'text length_<#>' where <#> is the number of characters in the radius label for easier CSS formatting.
* Search Form Input boxes now have a class assigned based on whether or not the label is empty.  label_empty and label_text make it easier to change the input width based on whether or not a label is present.
* Updated Twenty Sixteen Plugin Style to Rev 05.  Leverages the new label and input CSS rules.

Fixes

* Restore Store Pages to sidebar menu when active.

Changes

* Add on framework no longer preloads csl-script (slp.js) when loading the userinterface.js files.
* Add a slp_radius_selections filter for Experience add on to augment radius selector drop down with a first entry.

= 4.5.05 =

Enhancements

* Reduced overhead on admin pages.

Fixes

* Extended Data display on add/edit locations addressed for older extended data manager installations.
* Fix blog switching error on multisite installs using Network Activate.
Note: Network Activated Multisite installs using paid add ons should have an active Premier Subscription for proper multisite licensing.

Changes

* Turn off SSL validation of peers on the update server.  If your server's SSL cert is expired/invalid the version check on add on packs will now run anyway.

= 4.5.03 =

Fix

* Save changed to default country conversion to the CCTLD as the slug.
* Delete location fully on first attempt when Pages add on is active.
* Do not run upgrade of settings overhead when deactivating the plugin.
* Multisite installs with Network Activation on the SLPLUS plugin properly migrates all subsite options to the latest release.

= 4.5.01 =

Enhancements

* Add support for add on pack Apply To All actions

Fixes

* Fix private property warning on upgrade.

= 4.5 =

Enhancements

* New filter slp_extended_data_update to be triggered any time extended location data is being updated.
* Eliminate duplicate data save call when updating locations with extended data.
* Add a popup notice when the reset manage locations button finishes processing.
* Locations / Manage display drop down now warns if you select more than 500 locations at one time.
* Locations / Manage display is now an instant-action drop down.
* SLP records the active version of jQuery running on the UI on the page with the [slplus] shortcode.
* Manage Locations Apply To All button allows actions to run on all locations for addons that are SLP 4.5 aware.

Fixes

* No country index 'unitedstates' on Country Manager when installing in some languages.
* Fix Italy CCTLD to 'it' was incorrectly set to 'il'.
* If the language translation file for the 'km' setting was not done consistently the km distance calculations would be incorrect.

Changes

* The 'miles' and 'km' setting for the search form radius setting has moved to the Text Manager class for consistency.  Non-English installs will need to update their translations at the [Translating WordPress](https://translate.wordpress.org/projects/wp-plugins/store-locator-le) site.
* If you create a new translation set for Store Locator Plus for the following languages, please notify support@storelocatorplus.com: de_DE, es_ES, fr_FR, it_IT, ja_JP, lt_LT, pt_BR, sr_RS, zh_CN, zh_TW.
