=== Pronamic Google Maps ===
Contributors: pronamic, remcotolsma
Tags: pronamic, google maps, geo, geocode
Donate link: http://pronamic.eu/donate/?for=wp-plugin-pronamic-google-maps&source=wp-plugin-readme-txt
Requires at least: 3.0
Tested up to: 6.8
Stable tag: 2.4.2
License: GPLv2 or later
This plugin makes it easy to add Google Maps to your WordPress post, pages or other custom post types.
== Description ==
= Intro =
With this plugin a user can easily add location (latitude, longitude) meta data to a page, post or a
custom post type. This plugin adds a meta box with an Google Map to the post editor. Users can easily
drag and drop a marker on the map to save location meta data for a post.
There are quite a few Google Maps plugins available in the WordPress Plugin Directory. Why should you
use the Pronamic Google Maps plugin:
* **Google Maps API version 3**
Most of the available plugins still use the Google Maps version 2 API. To use the Google Maps v2 API you
have to require an API key and include this in the plugin configuration. The Pronamic Google Maps plugin
uses the Google Maps version 3 API. Wich no longer requires an API key, so you don't have
to configure this plugin.
* **Shortcode**
Easily integrate a Google Maps in your post content:
[googlemaps]
[googlemaps static=true]
[googlemaps static=true label=M]
[googlemaps width=200 height=200]
[googlemaps new_design=true]
Also easily integrate an Google Maps mashup in your post content:
[googlemapsmashup query="post_type=company&nopaging=true" map_type_id="satellite"]
* **No extra tables**
Some plugin create additional tables in your WordPress database to store additional data. In many
cases this is not necessary, it's only pollutes your database. WordPress offers enough [functions to
store additional data](http://codex.wordpress.org/Custom_Fields).
* **Custom Post Types**
A lot of the WordPress plugins are developed before WordPress 3 was launched. These plugins not
always use the new features of WordPress 3. Many plugins only focus on posts and pages, but not
on other custom post types. This plugin does!
* **Mashup**
Easily create an Google Maps mashup to show all your posts on Google Maps. You can use an very powerfull
pronamic_google_maps_mashup() function or the shortcode. Both methods allow you to pass [custom
WordPress query parameters](http://codex.wordpress.org/Function_Reference/WP_Query#Parameters).
* **No notices or warning**
Pronamic is one of the few companies that develop all WordPress plugins in debug mode. This results
in high quality plugins with no errors, warnings or notices.
= Custom Post Types =
The nice thing about this plugin that developers can configure on what post type the meta box should be visible.
Developers can activate the meta box for every custom post type they registered with the
[register\_post\_type function](http://codex.wordpress.org/Function_Reference/register_post_type).
For example: if a developer registers a custom post type for *real estate* it is very easy to activate and
manage location data for that post type. It comes in handy for all kind of custom post types!
* Projects
* Real estate
* Restaurants
* Accommodations
* Hotels
* Ships
* Ports
= Microformats =
The plugin uses the latest [GEO microformat standards](http://microformats.org/wiki/geo).
N 37° 24.491
W 122° 08.313
= Support Development =
If you like this plugin we hope that you will help support our continued development.
The two best ways to offer your support is to send us a donation. Even $1 helps encourage
us to do more. If you can't donate, please help us reach our 5-star rating by rating this
plugin.
= Donate =
[Donate today!](http://pronamic.eu/donate/?for=wp-plugin-pronamic-google-maps&source=wp-plugin-readme-txt)
= Rate Us =
Please [rate us](http://wordpress.org/extend/plugins/pronamic-google-maps/)!
Give us a chance to address your concerns
if we didn't earn 5 stars.
= Special Requests =
We do accept feature requests for all of our plugins, free ones included. The most requested features
will make it into the next version.
If you need a special feature NOW, contact us!
We offer expedited feature development. Most features can be implemented in less than a week for $200!
== Installation ==
Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your
WordPress installation and then activate the Plugin from Plugins page.
You should add some code to you templates to add the Google Map.
**Dynamic Google Maps**
290,
'height' => 200
) );
}
?>
**Static Google Maps**
290,
'height' => 200,
'static' => true,
'color' => '0xFFD800',
'label' => 'M'
) );
}
?>
**Filter the_content()**
500,
'height' => 500,
'echo' => false
) );
return $content;
}
add_filter( 'the_content', 'custom_pronamic_google_maps_the_content', 9 );
}
?>
**Google Maps Mashup**
'post'
),
array(
'width' => 300,
'height' => 200,
'nopaging' => true,
'map_type_id' => 'satellite',
'marker_options' => array(
'icon' => 'http://google-maps-icons.googlecode.com/files/photo.png'
)
)
);
}
?>
**Microformat**
If you want to display the [GEO microformat](http://microformats.org/wiki/geo) with the
latitude and longitude information you should call the following function in your template:
Or througt an filter
500 ,
'height' => 500 ,
'echo' => false
) );
$content .= pronamic_google_maps_geo_microformat( array(
'echo' => false
) );
return $content;
}
add_filter( 'the_content', 'custom_pronamic_google_maps_the_content', 9 );
== Frequently Asked Questions ==
1. Have a question? Make a thread in the support forum and we will get back to you.
== Screenshots ==
1. The Google Maps widget.
2. Meta box where you can easily manage the Google Maps / GEO data.
3. Configuration panel of the Pronamic Google Maps plugin. Within this panel you can easily activate the Google Maps functionality for the registered post types.
4. The geocoder can be used to geocode multiple posts at once.
== Changelog ==
= todo =
* Add options for different dimension types pixels, percentages, etc.
* $("#pronamic-google-maps-meta-box-hide").change(function() { google.maps.event.trigger(map, "resize"); });
* $("#pronamic-google-maps-meta-box .handlediv").change(function() { google.maps.event.trigger(map, "resize"); });
* http://wordpress.org/support/topic/plugin-pronamic-google-maps-need-routes-too?replies=1#post-2741427
* http://wordpress.org/support/topic/plugin-pronamic-google-maps-is-it-possible-to-set-the-default-location-etc-for-post-edit-map?replies=4#post-2811858
= Unreleased - 2015-08-21 =
### [2.4.2] - 2025-08-25
#### Commits
- No longer use hidden HTML input for JSON ([b71e6f6](https://github.com/pronamic/wp-pronamic-google-maps/commit/b71e6f6a8fc61ac1065a0a2789490cb058b1bffe))
Full set of changes: [`2.4.1...2.4.2`][2.4.2]
[2.4.2]: https://github.com/pronamic/wp-pronamic-google-maps/compare/v2.4.1...v2.4.2
### [2.4.1] - 2025-07-09
#### Changed
- Use file hash as script version number. ([d8db811](https://github.com/pronamic/wp-pronamic-google-maps/commit/d8db8118e2792419374e8c8d88e335c797e5de0f))
Full set of changes: [`2.4.0...2.4.1`][2.4.1]
[2.4.1]: https://github.com/pronamic/wp-pronamic-google-maps/compare/v2.4.0...v2.4.1
### [2.4.0] - 2025-06-27
#### Changed
- Load Google Maps asynchronously.
- Updated admin menu page icon. ([5b9afe4](https://github.com/pronamic/wp-pronamic-google-maps/commit/5b9afe4c162f15c4c860d7821b454b3a7d03f1d9))
- Tested up to: 6.8. ([45e990a](https://github.com/pronamic/wp-pronamic-google-maps/commit/45e990aa13c80a8b108e66370addba3b5d11b6c6))
#### Fixed
- Fixed using deprecated event listeners. ([cf670fc](https://github.com/pronamic/wp-pronamic-google-maps/commit/cf670fc26373c7fb3b372ddd1fdeba297813bb4e))
- Fixed "jQuery.parseJSON is deprecated; use JSON.parse". ([633fb8d](https://github.com/pronamic/wp-pronamic-google-maps/commit/633fb8da316b4b18caa1bc8fb28a61e5c58b4013))
#### Removed
- Removed visual refresh setting. ([555b9db](https://github.com/pronamic/wp-pronamic-google-maps/commit/555b9db872888ed13ff78fac5cd3585452e76ac3))
- Removed unused style. ([69d1d32](https://github.com/pronamic/wp-pronamic-google-maps/commit/69d1d324c72587d4d9b02acc1a269c3da34145a4))
- Removed unused scripts. ([7f2e919](https://github.com/pronamic/wp-pronamic-google-maps/commit/7f2e919257c135719a56903d3a83c6bd70cee79a))
- Removed unused images. ([0503062](https://github.com/pronamic/wp-pronamic-google-maps/commit/05030627f9eec376af186095239371b3bf757c03))
- Removed WordPress < 3.3 compatibility. ([282d959](https://github.com/pronamic/wp-pronamic-google-maps/commit/282d959ae06230061c90dd8bc1d59c7fcda730c7))
Full set of changes: [`2.3.3...2.4.0`][2.4.0]
[2.4.0]: https://github.com/pronamic/wp-pronamic-google-maps/compare/v2.3.3...v2.4.0
### [2.3.3] - 2024-11-27
#### Commits
- Use `esc_textarea` instead of `esc_attr` in `