=== Google Maps Store Locator for WordPress ===
Contributors: viadat
Donate link: http://www.viadat.com/donate/
Tags: business locations, dealer locator, dealer locater, store locator, store locater, mapping, mapper, google, google maps, buddypress, shop locator, shop finder,  location finder, places, stores, maps, coordinates, latitude, longitude, geo, geocoding, shops, ecommerce, e-commerce, zipcode, zip code search
Requires at least: 2.5
Tested up to: 3.4.1
Stable tag: 1.9.2

A store locator plugin that gives you the ability to effectively show important locations in an easily searchable manner using Google Maps.

== Description ==

= Provides Mapping, Display, and Search of Locations For: =
* Those of you who create sites for clients using WordPress
* Those of you who want to show your important locations (stores, buildings, points of interest, etc.) in an easily searchable manner.

Also referred to as a dealer locator (locater), shop finder, and zip code or zipcode search.
Its strength is in its flexibility to allow you to easily manage a few or a thousand or more locations through the admin interface.

= Great Built-In Functionality & Features =
* You can use it for numerous countries, which will continue to be added as Google adds new countries to their Google Maps API.  See the documentation for the latest
* Supports international languages and character sets 
* Allows you to use unique map icons or your own custom map icons --- great for branding your map
* Gives your map the desired look by using our Map Designer™ interface in the WordPress admin section
* Pick other cool Google Maps options, such as an inset box, zoom level, map types (street, satellite, hybrid, physical), and more
* You can use miles or kilometers
* Automatically restricts loading of Javascript & CSS to only pages that display the map (or that might need access to the JS & CSS) for better site performance
* Option to show dropdown list of cities allows visitors to quickly see where your locations are and choose their search accordingly

= Upgrades =
If you need additional features, enhance your store locator with addons & themes. [Upgrade Here](http://www.viadat.com/products-page/)

= Other Links =
[Downloads](http://www.viadat.com/store-locator/) | [Addons & Themes](http://www.viadat.com/products-page/) | [Blog - New Features & Updates](http://www.viadat.com/category/store-locator/) | [Documentation](http://docs.viadat.com/)

= Special Thanks to Translators (Email new translations to info{at}viadat{dot}com) =
* Simon Schmid: German (Deutsche), Italian (Italiano), Czech (Cestina), French (Francais)
* Gwyn Fisher: Spanish (Espanol)
* [Josef Klimosz](http://pepa.rudice.eu/): Czech (Cestina)(updated)
* [Willem-Jan Korsten](http://www.ezhome.nl/): Dutch (Nederlands)
* [Marcelo V. Araujo](http://www.mgerais.net/): Portuguese (Portugues)
* [Reno](http://www.creaprime.fr): French (Francais)(updated)
* [Alf Vidar Snaeland](http://www.fastfrilans.no): Norwegian (Norsk)
* [Laifeilim](http://www.fileem.com): Simplified Chinese
* Victor Ukhimenko: Russian
* [Rene](http://wpwebshop.com): Turkish
* [Outshine Solutions](http://outshinesolutions.com): Hindi

(If you provide your web address, we'll link back to you)

== Installation ==

= Main Plugin =
1. Upload the `store-locator` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Sign up for a Google Maps API Key for your domain at http://code.google.com/apis/maps/signup.html
4. Add your locations through the 'Add Locations' page in the Store Locator admin panel
5. Place the code '[STORE-LOCATOR]' (case-sensitive) in the body of a page or a post to display your store locator

= Addons =
1. Unzip & Upload the entire add-on folder to the `/wp-content/uploads/sl-uploads/addons` directory (note the new location for addons as of v1.2.37).
2. Activate the add-on by updating the Activation Key that you receive after purchase at the bottom of the "News & Upgrades" Page.

= Themes =
1. Unzip & Upload the entire theme folder to the `wp-content/uploads/sl-uploads/themes` directory (note the new location for themes as of v1.2.37).
2. Select theme from the theme dropdown menu under the "Design" section on the "Map Designer"™ Page.

= Icons =
1. There are some default icons in the `/wp-content/plugins/store-locator/icons` directory. 
2. Add your own custom icons in to `wp-content/uploads/sl-uploads/custom-icons` (note the new location for custom icons as of v1.2.37).

= Custom CSS (Stylesheet) =
As of version 1.2.37, you can modify the default 'store-locator.css' and place it under `/wp-content/uploads/sl-uploads/custom-css/`. The store locator will give priority to the 'store-locator.css' in the 'custom-css/' folder over the default 'store-locator.css' in the main 'store-locator/' folder. This allows you to upgrade the main store locator plugin without worrying about losing your custom styling. 

== Changelog ==
= 1.9.2 =
* Added Philippines as a country option for one's map

= 1.9.1 =
* Update/fix for re-geocoding (thank you Seb M.)

= 1.9 =
* Tagging fixes
* CSS fixes
* Bug fixes

= 1.8.1 =
* Translator update

= 1.8 =
* Added Hindi translation (Thank you [Outshine Solutions](http://outshinesolutions.com)). Copy translation into `/wp-content/uploads/sl-uploads/languages/` to use.

= 1.7 =
* Improved tagging
* More efficient loading of admin Javascript & CSS
* Improved code for devs using 'WP_DEBUG' mode
* CSS fix

= 1.6 =
* Much improved processing image next to search button - important to update from 1.5
* Tag management improvement/fixes
* Bug fixes

= 1.5 =
* Circular loading/processing image next to search button during search to know that locator is actively performing search
* Zooms out when showing 1 location on initial load or search is zoomed in too close
* Smoother initial loading of locations by default
* Numerous CSS fixes to map interface
* Ability to determine maximum number of locations shown in search results for DB health (uses same value for number of locations loaded by default)

= 1.4.1 =
* Bug fix for 'Mangage Locations' page not showing locations if Google API Key isn't entered yet

= 1.4 =
* Functionality to bulk re-geocode ungeocoded locations on 'Manage Locations' page (button only appears if you have any ungeocoded locations)
* Small admin CSS fix
* Updated link to get Google Maps API key

= 1.3 =
* New horizontal top navigation for Store Locator admin pages
* Made 'Directions' link label on map & results list editable from Map Designer page
* Better response messages during key validation
* Cleaned up 'News & Upgrades' page; updated navigation links of 'Manage Locations'
* Google API Key submission/important message for new users, instead of restricting view of other pages 

= 1.2.43 =
* Bug fixes

= 1.2.42.1 =
* Added new translators to readme

= 1.2.42 =
* Added Russian translation (Thank you Victor Ukhimenko)
* Added Turkish translation (Thank you [Rene](http://wpwebshop.com))
* Updated Norwegian translation to proper abbreviation (no_NO -> nb_NO). Copy translations into `/wp-content/uploads/sl-uploads/languages/` to use.
* Several CSS fixes, noticeable only for certain themes

= 1.2.41 =
* Added Portuguese translation (Thank you [Marcelo V. Araujo](http://www.mgerais.net))

= 1.2.40 =
* Added updated French translation (Thank you [Reno](http://www.creaprime.fr))
* Added Norwegian translation (Thank you [Alf Vidar Snaeland](http://www.fastfrilans.no))
* Added Simplified Chinese translation (Thank you [Laifeilim](http://www.fileem.com)). Copy translations into `/wp-content/uploads/sl-uploads/languages/` to use
* Small fix for export link path
* Small fix for navigation links when viewing locations and clicking 'Next' or 'Previous'
* Added translation wrappers to labels 'Update Central' ('News & Upgrades' page) and 'Additional Information' ('Add Locations' page)

= 1.2.39.3 =
* Added Dutch translation (Thank you [Willem-Jan](http://www.ezhome.nl/)). Place translation in `/wp-content/uploads/sl-uploads/languages/` to use.
* Added translation wrappers to text currently without them

= 1.2.39.2 =
* Small fix of XML issue when displaying locations by default on map load if ampersand (&) is used in a location's URL

= 1.2.39.1 =
* Updated the Czech translation (Thanks to [Josef](http://pepa.rudice.eu/))
* Small fix to make URLs of icons point to correct directory on first use

= 1.2.39 =
* 'NOT NULL' changed to 'NULL' when creating database table fields to prevent table creation error for some users
* Missing search button image bug fixed
* 'Insufficient permissions' issue fixed that's occuring for some users when viewing past the first page of locations on 'Manage Locations' page
* Styling of hover color, background color, other styling of individual search results div moved to 'store-locator.css' for easier customization
* Styling updates of address search form elements above the map being mis-aligned by some themes
* ReadMe in admin section styling update for better readibility
* Minor admin dashboard rss widget improvements (bugfix/styling)

= 1.2.38 =
* Small fix with JS/CSS section message on non-store locator pages
* Notification message added to admin panel for those switching from 'wordpress-store-locator-location-finder' to 'store-locator' to re-select their icons on the 'Map Designer' page to avoid blank icons on map
* Higher number options for 'Locations Per Page' on 'Manage Locations' page
* For those who don't use the default WordPress plugin updater, but instead download and paste on top of an old version, it checks if addons, themes, languages, images moved to 'wp-content/uploads/sl-uploads' and copies them over if they haven't been already

= 1.2.37.1 =
* Moved more inline styles classes & ids in 'store-locator.css' for better styling of store locator map
* Updated automatic folder creation and moving of addons, themes, languages, images, etc. in the 'uploads/sl-uploads' folder.  
* Very important -- make sure to update from version 1.2.37 to avoid any map issues

= 1.2.37 =
* Updated default database, server, & connection character set and collation.  Should complete international language support.
* A few XHTML Transitional 1.0 validation fixes
* Different url encoding for map directions
* Directory structure update: Upgrades (addons, themes), icons, languages, images, custom css moved to 'wp-content/uploads/sl-uploads' directory (moved automatically).  
* WordPress default one-click updater is now active again.  (Custom quick updater introduced in version 1.2.21 is no longer needed)
* Moved inline styles to stylesheet classes for search result text and columns, and for text in info bubble on map.  Fully customizable from 'store-locator.css' now.
* NOTE: As a result of the updated directory structure, you no longer need to worry about losing any of your customizations (CSS, addons, themes, icons, images, languages)! Place any customizations that you make into the corresponding folder in the 'wp-content/uploads/sl-uploads' directory and they will be safe during upgrades to newer, better versions (For example: if place 'store-locator.css' in the 'wp-content/uploads/sl-uploads/custom-css' folder, the plugin will use those styles instead of the styles of any 'store-locator.css' in the main `store-locator` directory.  So, when an update is performed --- you don't lose your style customizations!)

= 1.2.36 =
* Added option to select character encoding set on 'Localization & Google API Key' page. Should help with supporting characters in many different languages.

= 1.2.35.1 =
* Removed non-working Google Map Country Domains (Hungary, Kenya, Malaysia, South Africa, Thailand -- seems they have map domains, but can't be embedded on websites yet)

= 1.2.35 =
* Improved restricted loading of JS, CSS to pages & posts on which store locator shortcode has been placed (and the archive pages only if shortcode is placed into any posts, and the home and search pages)
* Added input field on 'Map Designer' page for editing message to website visitors shown below map
* Modified custom upgrade link on plugins page to be one-click, similar to other plugins
* Few other admin styling changes for buttons
* Fixed bug causing search results to not show all locations for a given radius when distance unit is set to 'km'
* Improved geocoding on locations for each Google Map Country Domain. Added param that should make geocoding more accurate depending on which country you've selected

= 1.2.34 =
* Fixed 50+ XHTML validation issues (HTML generated by plugin should now validate as XHTML 1.0 Transitional)
* Updated 'Localization & Google API Key' page layout
* Added new Google Maps country domains
* Multiple minor interface improvements across admin pages

= 1.2.33.1 =
* Small XHTML validation fix
* Removed restriction of loading javascript & CSS to only pages with store locator shortcode for time-being

= 1.2.33 =
* Fixed gray / blank map issue due to CSS from certain themes affecting map tile images
* Cleaned up header javascript, CSS appearance
* Fixed 'store-locator-js.php' issue causing gray / blank map for some users due to their servers
* Restricted loading of javascript, CSS to only pages on which store locator shortcode has been placed

= 1.2.32 =
* Fixed directions link by better handling of '#' (and other symbols) in addresses

= 1.2.31 =
* Fixed small bug with display of URL on "View Locations" page for each location
* Beautified the update form for individual locations on the "View Locations" page

= 1.2.30 =
* Improved handling of URLs for each location. Now, URL will still show up even if you omit the "http://" at the beginning
* Beautified the default input form on the "Add Locations" page

= 1.2.29 =
* Fix for some maps having issues showing results in certain browsers

= 1.2.28.4 =
* Minor fix to prevent duplicate of the same city from showing up in the city dropdown options

= 1.2.28.3 =
* Fixes the "The Google Maps API rejected your request ..." error on the "Add Locations" page.  Good catch by forum user 'Israel' of http://earthsoutlet.com .

= 1.2.28.2 =
* Incorporated fix for "Warning: Cannot modify header information – headers already sent ..." error occuring for those that have updated to WordPress Version 2.8.1.  Fix provided by forum user 'mikeycnp' here: http://rosile.com/2009/07/wp-store-locator-fix/ --- thank you mikeyncp.  Users, please make sure to leave thank you comment on http://rosile.com .

= 1.2.28.1 =
* Fixed "You do not have sufficient permissions to access this page." issue occuring for those that have updated to WordPress Version 2.8.1
* Added this Changelog

== Frequently Asked Questions ==

Make sure to check http://docs.viadat.com for the most updated information

= Do I need a Google Account to use this store locator? =

Yes, you will need a Google account in order to retrieve an API for your maps to work properly

1. To sign up for a Google Account, visit: https://www.google.com/accounts/
2. To sign up for a Google Maps API Key, visit: http://code.google.com/apis/maps/signup.html

= How Do I use a Translation? =

1. Place .po & .mo translation files into the `/wp-content/plugins/store-locator/languages` folder, and then change the `WPLANG` constant to the corresponding language abbreviation in the `wp-config.php` file in the root wordpress directory
2. Example: to use French, make sure `lol-fr_FR.po` & `lol-fr_FR.mo` are in the `languages` folder, then make sure to update the code in `wp-config.php` to read `define('WPLANG', 'fr_FR')`, and Voila, Il sera en francais (It will be in French).

= Which countries is this compatible with? =

This plugin is compatible with all countries that have Google Map domains. This includes:

* Austria (updated as of v1.2.28)
* Australia
* Belgium
* Brazil
* Canada
* Switzerland
* Czech Republic
* Germany
* Denmark
* Spain
* Finland
* France
* Italy
* Japan (updated as of v1.2.28)
* Netherlands
* Norway
* New Zealand
* Poland
* Russia
* Sweden
* Taiwan (updated as of v1.2.28)
* United Kingdom
* United States

Added (as of v1.2.28):

* China
* India
* Hong Kong
* Liechtenstein
* South Korea

Removed (inactive domain or domain can't be used to embed a map on a website yet):

* Bosnia and Herzegovina (as of v1.2.28)
* Hungary (as of v1.2.35.1)
* Kenya (as of v1.2.35.1)
* Malaysia (as of v1.2.35.1)
* South Africa (as of v1.2.35.1)
* Thailand (as of v1.2.35.1)

Added (as of v1.2.34):

* Argentina
* Chile
* Mexico
* Portugal
* Singapore