=== Google Maps Widget - Best Google Maps Plugin ===
Contributors: WebFactory, GoogleMapsWidget, WPReset, underconstructionpage
Tags: google maps, maps, map, map markers, google map, google maps plugin, wp google maps, wp google map, map plugin, directions, google map plugin, map widget
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 4.0
Tested up to: 4.9
Stable tag: 3.95
Requires PHP: 5.2

Google Maps taking forever to load? Try Google Maps Widget. You'll have a fast Google map with a thumbnail & lightbox in minutes!

== Description ==

Tired of buggy & slow Google Maps plugins that take hours to setup? With Google Maps Widget you'll have a perfect map with a thumbnail & lightbox in minutes! **No nonsense Google maps - we know you're in a hurry!** Join 100,000+ happy Google maps users.

[youtube https://www.youtube.com/watch?v=oVrTGKepPPI]

Check out some examples on the <a href="https://www.gmapswidget.com/">Google Maps Widget site</a> or give us a shout on Twitter <a href="http://twitter.com/WebFactoryLtd">@WebFactoryLtd</a>.


**General Google Maps Widget options**

* title
* address

**Thumbnail Google map options**

Google Maps Widget thumbnail uses the Google Maps Static Maps API. It loads the entire google map in only one request compared to 20+ requests it takes other Google maps plugins to load them. This ensures your site loads as fast as possible!

* Custom google map size - map width & map height
* Choose any google map type you prefer - road map, satellite map, terrain map & hybrid map
* Plenty of google map color schemes - default, bright, gowalla, midnight, refreshed, ultra light, mapbox + 11 extra & any custom google map style in PRO
* zoom level
* pin type
* pin color
* pin size
* pin label
* custom map pin icon - any image can be used
* 1500+ map pins library in PRO
* link type - lightbox map, custom URL, replace thumbnail map with interactive google map (PRO), immediately show interactive google map (PRO) or disable link
* image format
* google map language
* text above google map
* text below google map

**Interactive Google map options**

Interactive google maps loads in a lightbox or as an in-place replacement for the thumbnail Google map if your using Google Maps Widget PRO. It has all the standard interactive google map features users are accustomed too.

* lightbox size - map width & map height (auto-adjusted on smaller screens) or fullscreen map in PRO
* map mode - place + in PRO: directions, search, view & google street view
* map type - road & satellite
* map color scheme - 15 map styles & any custom google map style in PRO
* pins clustering - PRO feature
* map zoom level
* lightbox skin - light, dark + 20 extra in PRO
* lightbox features - close on overlay click, close on esc key, close button & show map title
* map language
* header text
* footer text

**Shortcode**

* by using the _[gmw id="#"]_ shortcode you can display the google map in any page, post, or custom post type (PRO feature)

**Multiple Pins**

* full clustering and filtering support for pins on Google maps - <a href="https://www.gmapswidget.com/">demos</a> available on site
* you can add unlimited pins with custom markers and descriptions to thumbnail and interactive Google maps (PRO feature)
* every map pin has the following options: show on the map thumbnail and/or interactive map, set custom map pin image, set on-click behavior: open custom description bubble, open URL in new/same tab or do nothing


> > **PRO** version of Google Maps Widget offers more than 50 extra features and options including multiple map pins support, map pin clustering, pins library, skins, export, import and widget cloning features, Google Analytics integration and premium, USA based support. Read more about the PRO version on the <a href="https://www.gmapswidget.com/">official Google Maps Widget site</a>.


**Showcase & What others say about Google Maps Widget**

* see a live example of Google Maps Widget showing off server locations around the world on <a href="http://www.bitcatcha.com/">Bitcatcha</a>
* voted on the <a href="http://themesplugins.com/Plugin-detail/google-maps-widget-google-map-free-plugin-for-wordpress/" title="Top 100 WordPressian plugin">Top 100 List</a> by WordPressian
* made it on the <a href="http://tidyrepo.com/google-maps-widget/">Tidy Repo</a> as "well supported Google Maps plugin"
* reviewed 5/5 by <a href="http://websmush.com/google-maps-widget-plugin-review/">Web Smush</a>
* one of 3 best Google map plugins by <a href="http://torquemag.io/the-3-best-map-plugins-for-wordpress/">The Torque Mag</a>
* "an easier way to add Google maps to your site" says <a href="http://www.wpbeginner.com/wp-tutorials/how-to-add-google-maps-in-wordpress/">WP Beginner</a>
* <a href="http://designscrazed.org/wordpress-google-map-plugins/">Design Crazed</a> puts in on the top 20 Google maps list
* <a href="http://www.inkthemes.com/easily-integrate-google-map-in-your-wordpress-themes-widget-area/09/">InkThemes</a> shows how easy it is to use Google Maps Widget
* <a href="http://www.indexwp.com/google-maps-widget/">IndexWP</a> calls it a "handy google maps plugin"
* <a href="https://www.webhostingsecretrevealed.net/blog/wordpress-blog/an-easy-and-painless-guide-for-adding-google-map-in-wordpress/">A Painless Guide For Adding Google Maps In WordPress</a> by WHSR

**Google Maps Widget Translators (thank you!)**

* English - original :)
* Swedish - Sofia Asklund
* Spanish - Jesus Garica
* Croatian - Gordan from <a href="http://www.webfactoryltd.com/">Web factory Ltd</a>
* German - Karimba
* French - Karimba
* Chinese simplified  - Wyeoh
* Chinese traditional - Wyeoh
* Dutch - Arno
* Ukrainian - Victor Shutovskiy
* Serbian - Ogi Djuraskovic from <a href="http://firstsiteguide.com/">FirstSiteGuide</a>
* Russian - Ivanka


**License info**

* <a href="https://select2.github.io/">Select2 v4</a>, licensed under MIT
* <a href="http://www.jacklmoore.com/colorbox">Colorbox 1.6</a>, licensed under MIT


== Installation ==

**Follow the usual routine to install Google Maps Widget**

1. Open WordPress admin, go to Plugins, click Add New
2. Enter "Google Maps Widget" in search and hit Enter
3. Plugin will show up as the first on the list, click "Install Now"
4. Activate & go to Appearance - Widgets to configure Google Maps Widget

**Or if needed, upload manually**

1. Download the plugin.
2. Unzip it and upload to _wp-content/plugin/_
3. Open WordPress admin - Plugins and click "Activate" next to the Google Maps Widget plugin
4. Configure the Google Maps Widget under Appearance - Widgets


== Frequently Asked Questions ==

= Who is this plugin for? =

For anyone who needs a map on their site in 5 seconds.

= Google Map shows the wrong location =

Write the address differently, or more precisely. Make sure you enter the street, town and country name. If necessary enter lat/lng coordinates instead of the address. Use the numeric notation, eg: "40.7127, 74.0059"

= How to generate the API key =

We understand that creating a Google Maps API key is frustrating but it takes less than a minute and it's something Google requires.
Follow <a href="https://console.developers.google.com/flows/enableapi?apiid=maps_embed_backend&keyType=CLIENT_SIDE&reusekey=true" target="_blank">wizard step #1</a> - login with any Gmail account, click next/confirm a few times with the default settings &amp; copy the Google Maps API key you see on the screen; it's the key you need. Then use <a href="https://console.developers.google.com/flows/enableapi?apiid=static_maps_backend&keyType=CLIENT_SIDE&reusekey=true" target="_blank">wizard step #2</a>, select the same "My Project" project from the list and that's it. Save the key in Google Maps Widget settings.
If you want to protect your API key by using the "Accept requests from these HTTP referrers (web sites)" option in Google Console make sure to add your domain in these two formats: `*.mydomain.com/*` and `mydomain.com/*` and wait a few minutes until Google makes the necessary changes.
If that didn't help read our detailed guide on <a href="https://www.gmapswidget.com/documentation/generate-google-maps-api-key/">how to create a Google Maps API key</a>.

= Google map thumbnail works but lightbox won't open on click =

You probably have Fancybox JS and CSS files included twice; once by the theme and second time by Google Maps Widget plugin. Remove one instance of files. If that's not the case then you have a fatal JS error that's preventing execution of other JS code. Hit F12 in Firefox or Chrome and have a look at the debug console. If there are any red lines - it's a fatal error.
Open a new thread in the <a href="http://wordpress.org/support/plugin/google-maps-widget">support forums</a> but please bear in mind that support is community based and we do this in our spare time.

= The Google map is not working!!! Arrrrrrrrr =

= How do I get WP Google Maps Pro? =
Simply visit http://www.wpgmaps.com and purchase the WP Google Maps Professional Edition for $39.99 once off. Free updates and support included forever.

= I've installed the plugin, now what? =
Once installed and activated, a link should appear in your left navigation panel within your WP-ADMIN section. Click on the "WP Google Maps" link and follow the on screen instructions.

= How do I put a Google map on my page/post? =
In order to show your custom Google map on your page or post, simply copy the shortcode supplied and paste it into your page or post. WP Google Maps will automatically configure the map to the settings you selected in the map edit page.

= How do I add a map widget to my widget area? =
To add your map to your widgets area, simply go to Appearance->Widgets and drag the "WP Google Maps" Map Widget to your sidebar. You then edit the map widget to reflect the correct map.

= I want to use this but I dont have WordPress =
Try [Nifty Maps](http://www.niftymaps.co) - Comprehensive Map Builder for all websites

Read the <a href="http://wordpress.org/support/plugin/google-maps-widget">support forum</a> rules (no seriously, read them) and then if needed open new a thread.

== Screenshots ==

1. Google Maps - Simple & fast - you'll have a great google map working in under a minute
2. Google Maps - Thumbnail map is shown as a widget and since it's just one image it loads super-fast (1 request, about 20KB)
3. Google Maps - Larger map with all interactive features is available in the lightbox
4. Google Maps - Widget options - Thumbnail map
5. Google Maps - Widget options - Interactive map
6. Google Maps - Widget options - Shortcode
7. Google Maps - Thumbnail map - light color scheme

== Changelog ==

= 3.95 =
* yearly prices test; $19 -> $18.99
* integrated GR popup in admin
* removed /lang/ folder
* added Neon color scheme
* removed test API keys - all maps now need a valid API key

= 3.90 =
* added Midnight thumbnail map color scheme
* new prices for lifetime license
* we're at 1,550,000 downloads

= 3.85 =
* added Bright thumbnail map color scheme

= 3.83 =
* pushing strong on translations!
* added Gowalla thumbnail map color scheme

= 3.80 =
* translations are going great thanks to our helpful users!
* problems with API keys continue due to users who refuse to create their own keys :(

= 3.75 =
* added Mapbox thumbnail map color scheme
* lower agency price from 08/01/2017

= 3.60 =
* minor improvements
* new pricing table

= 3.50 =
* lower Google Maps Widget PRO prices

= 3.47 =
* API improvements

= 3.40 =
* changes in prices for Google Maps Widget PRO

= 3.39 =
* fix for google maps API "over quota limit" error some users were getting

= 3.35 =
* new static map color scheme
* big cleanup - plugin footprint reduced by half

= 3.30 =
* WP v4.5 updates

= 3.20 =
* new map pins

= 3.15 =
* map widgets can now be cloned

= 3.10 =
* security enhancements

= 3.05 =
* added google maps API key tester

= 3.04 =
* added more detailed instructions on how to generate the API key

= 3.0 =
* huge upgrade - numerous google map functions added
* switched to new Google Maps API

= 2.90 =
* added option for donating
* checked WP v4.4 compatibility

= 2.85 =
* enhancements in PHP

= 2.80 =
* fixed a big bug in JS (widget admin UI init)

= 2.75 =
* minor JS tweaks and bug fixes

= 2.70 =
* fixed a nasty bug with shortcode rendering (thanks Hey You!)
* JS and CSS fixes for widget UI in the theme customizer

= 2.66 =
* we'll be soon removing all PO files from the plugin since the strings were merged into the official WP translate project

= 2.60 =
* added data validation on input fields
* minor CSS tweaks

= 2.51 =
* updated PHP4 style class constructor to PHP5 one
* lowered cron for tracking to once every 14 days
* did some prep work for the upcoming 4.3 version of WP

= 2.45 =
* fixed a bug on notice dismiss action
* added Russian translation - thanks Ivanka!

= 2.40 =
* admin JS completely rebuilt
* fixed PO file
* we broke 90,000 installations ;)

= 2.35 =
* WP v4.2 compatibility checked
* remove_query_arg() security issue fixed
* we broke 500,000 downloads for Google Maps Widget ;)

= 2.30 =
* JS rewrites

= 2.25 =
* a few visual enhancements
* new screenshots
* shortcode name availability is checked before registering it
* visual builder compatibility fix

= 2.20 =
* added shortcode support

= 2.15 =
* fixed a _plugin_deactivate_ bug nobody noticed for 2 years :(
* all JS texts are now loaded via wp_localize_script()

= 2.10 =
* auto-adjust map size on smaller screens - thanks bruzm!
* marked each widget with core version for future updates

= 2.06 =
* language file updated
* preparing for JS rewrite

= 2.05 =
* code rewriting

= 2.01 =
* somehow one JS file got renamed :(

= 2.0 =
* lots of rewrites
* additional features can now be activated by subscribing to our newsletter

= 1.93 =
* we can no longer offer discounts for our Envato products in Google Maps Widget
* so no changes to the plugin, just some messages edited

= 1.92 =
* minor bug fixes
* preparations for admin JS rewrite

= 1.90 =
* added Serbian translation; thanks Ogi!

= 1.86 =
* updated POT file
* updated Croatian translation

= 1.85 =
* added custom pin image option for thumbnail map - thanks Rudloff!

= 1.75 =
* lightbox skins are back; light and dark for now, more coming soon
* updated lightbox jS

= 1.70 =
* fixed a small bug on thumbnail map
* finished up a todo

= 1.65 =
* finished up a few todos

= 1.60 =
* update for WordPress v3.9, widget edit GUI now works in theme customizer
* if you run into any issues please report them in the support forums

= 1.55 =
* fixed shortcode handling in map's header & footer
* added Ukrainian translation - thank you Victor Shutovskiy!

= 1.50 =
* 2014/03/25
* minor bug fixes
* new Spanish translation - thank you Jesus!
* still working on those lightbox skins, sorry :(

= 1.47 =
* working on those google map lightbox skins :)

= 1.45 =
* switched to <a href="http://www.jacklmoore.com/colorbox/">Colorbox</a> lightbox script
* lightbox skin is still temporarily unavailable

= 1.40 =
* due to licensing issues switched to FancyBox v1.3.4
* lightbox skin is temporarily unavailable
* minor bug fix related to activate/upgrade hook calls

= 1.35 =
* added optional plugin usage tracking (<a href="https://www.gmapswidget.com/plugin-tracking-info/">detailed info</a>)

= 1.31 =
* WP v3.8.1 compatibility check

= 1.30 =
* added Dutch translation; thank you Arno!

= 1.25 =
* preparations for opt-in plugin usage tracking
* Spanish translation updated; thanks Jesus!

= 1.20 =
* WP v3.8 update
* language files update

= 1.15 =
* added option for thumbnail map to link to a custom URL which disables the lightbox; you can link to a lightbox, a custom link or remove the link all together

= 1.10 =
* added option for thumbnail map to use the new look/color scheme

= 1.05 =
* added Chinese traditional translation; thanks Wyeoh

= 1.0 =
* WP 3.7 compatibility check
* added Chinese simplified translation; thanks Wyeoh

= 0.95 =
* added French translation; thanks Karimba

= 0.90 =
* added German translation; thanks Karimba
* we reached 100k downloads ;)

= 0.86 =
* fixed a few strict standards errors; thanks Jay!

= 0.85 =
* added Croatian translation; thank you Gordan

= 0.80 =
* minor translation fixes
* added Spanish translation; thank you Jesus!

= 0.75 =
* map language is autodetected based on user's browser language (HTTP_ACCEPT_LANGUAGE header)
* added Swedish translation; thank you Sofia!
* German and Croatian translations will be up next

= 0.71 =
* few more preparations for translation
* Swedish translation coming in a few days

= 0.70 =
* prepared everything for translation, POT file is available and all strings are wrapped in <i>__()</i>
* protocols should now match http/https for both thumbnail map and ligtbox map
* <a href="https://www.gmapswidget.com/">www.gmapswidget.com</a> is up and running

= 0.65 =
* updated JS for WP v3.6

= 0.60 =
* fixed zoom bug in lightbox

= 0.55 =
* added 2 new options - text above and below thumbnail map
* updated fancyBox JS to the latest version

= 0.50 =
* small WP 3.5 compatibility fixes

= 0.4 =
* fixed non UTF-8 address bug

= 0.37 =
* fixed bug to use google.com instead of google.co.uk

= 0.35 =
* added 4 skins for lightbox

= 0.31 =
* fix for bad themes which don't respect proper sidebar markup

= 0.3 =
* lightbox script changed from jQuery UI Dialog to <a href="http://fancyapps.com/fancybox/">fancyBox2</a>
* added "show map title on lightbox" option
* significant speed improvements
* preparations for google map lightbox skins

= 0.22 =
* Fixed small JS related GUI bug

= 0.2 =
* Complete GUI rewrite
* Added header text option
* Added address bubble visibility option
* Fixed thumbnail map scaling bug
* Fixed lightbox map size bug

= 0.13 =
* Added pin size for thumbnail map

= 0.12 =
* Added pin color for thumbnail map
* Fixed a few minor bugs

= 0.11 =
* Fixed a few minor bugs

= 0.1 =
* Initial release of Google Maps Widget