=== Quick Maps ===
Contributors: quickmaps, rnzo, ivanharmat
Donate link: https://bit.ly/2HdTzmO
Tags: quick maps, easy maps, google maps, maps, geolocation
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 026.07.06.15
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The easiest Google Maps integration for your Wordpress website `[quick-maps]Orlando, Florida[/quick-maps]` - No Google API required.

== Description ==

**Quick Maps is the easiest way to add a Google Map to your WordPress site — with no Google Maps API key, no billing account, and no Google Cloud setup.**

Most map plugins force you to create a Google Cloud project, enable several APIs, turn on billing, and paste a secret key before you can display a single map. Quick Maps skips all of that. Install the plugin, drop a shortcode wherever you want a map, and put an address or place name inside it:

`[quick-maps]Orlando, Florida[/quick-maps]`
`[quick-maps]One Infinite Loop, Cupertino, CA 95014[/quick-maps]`
`[quick-maps height="500px"]Magic Kingdom, Florida[/quick-maps]`

That's the whole setup — a clean, responsive Google Map appears in your post, page, or widget.

Because Quick Maps renders a standard, lazy-loaded Google Maps embed (not the paid JavaScript API), your maps load fast, add no heavy scripts to your pages, and never trigger a surprise bill from Google.

= Key Features =

Each feature below links to a full how-to guide on quickmaps.io.

* **No API key required:** no Google Cloud project, no billing, no keys to manage. [Full guide](https://quickmaps.io/google-maps-without-api-key).
* **One simple shortcode:** `[quick-maps]Your address or place[/quick-maps]` is all it takes. [Full guide](https://quickmaps.io/add-google-maps-to-wordpress).
* **Map any address or place:** a street address, a business name, a landmark, or latitude/longitude coordinates. [Full guide](https://quickmaps.io/add-google-maps-to-wordpress).
* **Responsive by default:** maps fill their container (width `100%`) and adapt to any screen size. [Full guide](https://quickmaps.io/wordpress-google-map-satellite-terrain-zoom).
* **Set your own size:** control the map with the `width` and `height` attributes, e.g. `[quick-maps height="500px" width="80%"]Miami, FL[/quick-maps]`. [Full guide](https://quickmaps.io/wordpress-google-map-satellite-terrain-zoom).
* **Choose the map style:** roadmap (default), `satellite`, `hybrid`, or `terrain` with the `type` attribute, e.g. `[quick-maps type="satellite"]Grand Canyon[/quick-maps]`. [Full guide](https://quickmaps.io/wordpress-google-map-satellite-terrain-zoom).
* **Set the zoom level** with the `zoom` attribute (0 = whole world, 21 = street level), e.g. `[quick-maps zoom="16"]Times Square, NYC[/quick-maps]`. [Full guide](https://quickmaps.io/wordpress-google-map-satellite-terrain-zoom).
* **Show the map in any language** with the `lang` attribute, e.g. `[quick-maps lang="es"]Madrid[/quick-maps]`. [Full guide](https://quickmaps.io/wordpress-google-map-language).
* **Show driving directions** between two places with the `from` and `to` attributes, e.g. `[quick-maps from="Orlando, FL" to="Miami, FL"][/quick-maps]`. [Full guide](https://quickmaps.io/wordpress-google-map-directions).
* **Lazy-loaded:** the embed uses native lazy loading, so maps below the fold don't slow your initial page load. [Full guide](https://quickmaps.io/premium#lazy-loading).
* **Works everywhere shortcodes do:** posts, pages, and text/HTML widgets, including most page builders. [Full guide](https://quickmaps.io/add-google-maps-to-wordpress).
* **Lightweight and clean:** no bloat, no tracking, no account required.

= Premium Features =

Quick Maps Premium (available at [quickmaps.io](https://quickmaps.io/premium)) adds:

* [Color Schemes](https://quickmaps.io/premium#color-schemes): style maps to match your brand with dark, muted, grayscale, and sepia presets.
* [Custom Markers](https://quickmaps.io/premium#custom-markers): use your own pins, brand colors, and marker images.
* [Advanced Lazy Loading](https://quickmaps.io/premium#lazy-loading): click-to-load and scroll-to-load facades for faster pages and better visitor privacy.
* [Custom JS](https://quickmaps.io/premium#custom-css): extend map behavior with your own scripts.
* [Custom CSS](https://quickmaps.io/premium#custom-css): fine-tune the exact look of your maps.

== Installation ==

1. In your WordPress dashboard, go to **Plugins → Add New** and search for "Quick Maps", or upload the plugin ZIP under **Plugins → Add New → Upload Plugin**.
2. Click **Install Now**, then **Activate**.
3. Edit any post, page, or widget and add the shortcode with the address or place you want to show:
   `[quick-maps]Orlando, Florida[/quick-maps]`
4. Publish or update — your map is live. No API key or configuration needed.

**Requirements:** WordPress 6.0 or higher and PHP 7.4 or higher.

== Frequently Asked Questions ==

= Do I need a Google Maps API key? =

No. Quick Maps works without any API key, Google Cloud project, or billing account. Install it and use the shortcode.

= How do I add a map? =

Put the address or place name inside the shortcode and add it to any post, page, or widget:
`[quick-maps]One Infinite Loop, Cupertino, CA 95014[/quick-maps]`

= How do I change the size of the map? =

Use the `width` and `height` attributes. Width defaults to `100%` (responsive) and height to `300px`:
`[quick-maps height="500px" width="75%"]Magic Kingdom, Florida[/quick-maps]`

= Can I show my business or a specific location? =

Yes. Use your business name, a full street address, a landmark, or latitude/longitude coordinates as the shortcode content.

= Can I show a satellite or terrain map? =

Yes. Add the `type` attribute with `satellite`, `hybrid`, or `terrain`. The default is the standard road map:
`[quick-maps type="hybrid"]Golden Gate Bridge[/quick-maps]`

= Can I set the zoom level? =

Yes. Use the `zoom` attribute with a value from 0 (the whole world) to 21 (street level):
`[quick-maps zoom="17"]Willis Tower, Chicago[/quick-maps]`

= Can I show the map in another language? =

Yes. Add the `lang` attribute with a language code, e.g. `lang="es"` for Spanish or `lang="fr"` for French:
`[quick-maps lang="fr"]Paris[/quick-maps]`

= Can I show driving directions? =

Yes. Use the `from` and `to` attributes to draw a route between two places:
`[quick-maps from="Orlando, FL" to="Miami, FL"][/quick-maps]`

= Will Quick Maps slow down my website? =

No. Quick Maps outputs a single, native lazy-loaded embed with no heavy JavaScript, so maps load quickly and don't block your page.

= Can I use it inside a widget or page builder? =

Yes. Quick Maps works anywhere WordPress shortcodes run, including text/HTML widgets and most popular page builders.

= Is Quick Maps free? =

Yes, the plugin is free. The premium version at [quickmaps.io](https://quickmaps.io) adds color schemes, custom markers, custom JS/CSS, and advanced lazy-loading controls.


== Changelog ==

For the full changelog with details, see [Release History](https://quickmaps.io/changelog).

= 026.07.06.15 =

[Version 026.07.06.15 release notes](https://quickmaps.io/changelog#026.07.06.15)

= 026.06.26.21 =

[Version 026.06.26.21 release notes](https://quickmaps.io/changelog#026.06.26.21)

= 026.05.13.15 =

[Version 026.05.13.15 release notes](https://quickmaps.io/changelog#026.05.13.15)

= 026.03.27.1740 =

[Version 026.03.27.1740 release notes](https://quickmaps.io/changelog#026.03.27.1740)

= 026.02.03.19 =

[Version 026.02.03.19 release notes](https://quickmaps.io/changelog#026.02.03.19)

= 1.02.25 =

[Version 1.02.25 release notes](https://quickmaps.io/changelog#1.02.25)

= 1.0.16 =

[Version 1.0.16 release notes](https://quickmaps.io/changelog#1.0.16)

= 1.0.2 =

[Version 1.0.2 release notes](https://quickmaps.io/changelog#1.0.2)
