Pronamic Google Maps Plugin

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.

• 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.

• 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.

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.

<div class="geo"> <abbr class="latitude" title="37.408183">N 37° 24.491</abbr> <abbr class="longitude" title="-122.13855">W 122° 08.313</abbr> </div> 

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!

Rate Us

Please rate us!
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!

Translations

• pl_PL by Marcin Modestowicz

Pronamic

• Pronamic
• Twitter
• Facebook
• LinkedIN

Links

• google-maps-utility-library-v3
• Geocode with Google Maps API v3
• WordPress event locations
• JavaScript Regular Expression
• Remco Tolsma
• Markdown’s Syntax Documentation

Plugin in the wild

• Metz Ameland
• Earthcircuit
• Comando Lechuga
• Professionele Fotografie
• Bouwwereld
• Architectuur
• Longboard.no
• Professionele Fotografie
• Emonta

Pronamic plugins

• Pronamic Google Maps
• Gravity Forms (nl)
• Pronamic Page Widget
• Pronamic Page Teasers
• Maildit
• Pronamic Framework
• Pronamic iDEAL

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

<?php if ( function_exists( 'pronamic_google_maps' ) ) { pronamic_google_maps( array( 'width' => 290, 'height' => 200 ) ); } ?> 

Static Google Maps

<?php if ( function_exists( 'pronamic_google_maps' ) ) { pronamic_google_maps( array( 'width' => 290, 'height' => 200, 'static' => true, 'color' => '0xFFD800', 'label' => 'M' ) ); } ?> 

Filter the_content()

<?php if ( function_exists( 'pronamic_google_maps' ) ) { function custom_pronamic_google_maps_the_content( $content ) { $content .= pronamic_google_maps( array( 'width' => 500, 'height' => 500, 'echo' => false ) ); return $content; } add_filter( 'the_content', 'custom_pronamic_google_maps_the_content', 9 ); } ?> 

Google Maps Mashup

<?php if ( function_exists( 'pronamic_google_maps_mashup' ) ) { pronamic_google_maps_mashup( array( 'post_type' => '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 with the
latitude and longitude information you should call the following function in your template:

<?php pronamic_google_maps_geo_microformat(); ?> 

Or througt an filter

<?php function custom_pronamic_google_maps_the_content( $content ) { $content .= pronamic_google_maps( array( 'width' => 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 ); 

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.

1. Have a question? Make a thread in the support forum and we will get back to you.

Installation Instructions

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

<?php if ( function_exists( 'pronamic_google_maps' ) ) { pronamic_google_maps( array( 'width' => 290, 'height' => 200 ) ); } ?> 

Static Google Maps

<?php if ( function_exists( 'pronamic_google_maps' ) ) { pronamic_google_maps( array( 'width' => 290, 'height' => 200, 'static' => true, 'color' => '0xFFD800', 'label' => 'M' ) ); } ?> 

Filter the_content()

<?php if ( function_exists( 'pronamic_google_maps' ) ) { function custom_pronamic_google_maps_the_content( $content ) { $content .= pronamic_google_maps( array( 'width' => 500, 'height' => 500, 'echo' => false ) ); return $content; } add_filter( 'the_content', 'custom_pronamic_google_maps_the_content', 9 ); } ?> 

Google Maps Mashup

<?php if ( function_exists( 'pronamic_google_maps_mashup' ) ) { pronamic_google_maps_mashup( array( 'post_type' => '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 with the
latitude and longitude information you should call the following function in your template:

<?php pronamic_google_maps_geo_microformat(); ?> 

Or througt an filter

<?php function custom_pronamic_google_maps_the_content( $content ) { $content .= pronamic_google_maps( array( 'width' => 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 ); 

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”); });
• https://wordpress.org/support/topic/plugin-pronamic-google-maps-need-routes-too?replies=1#post-2741427
• https://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.3.2 – 2016-09-15

• Fixed issue with the geocoded.
• Added an delay of 10 seconds for Google Maps API Usage Limit.
• Fixed name of arguments variable for widget.
• Added example map with link to directions.
• Fixed JavaScript error “fromDivPixelToLatLng: Point.x and Point.y must be of type number”.
• Fixed ‘Deprecated: Methods with the same name as their class will not be constructors in a future version of PHP’.
• Use bower package markerclustererplus instead of google-maps-marker-clusterer-plus to fix incorrect MarkerClusterer.IMAGE_PATH.
• Fixed loading map while editing widget.
• Updated MarkerClustererPlus library to version 2.1.1.

2.3.1 – 2015-10-09

• Load the new text domain ‘pronamic-google-maps’.

2.3.0 – 2015-10-09

• All serverside Google Maps API request now run via https://.
• Improved documentation in README.md file.
• Improved support for marker cluster options in shortcodes.
• WordPress Coding Standards optimizations.
• Removed deprecated screen_icon() function calls.
• Deprecated Pronamic_Google_Maps_Post::META_KEY_* constants.
• Deprecated Pronamic_Google_Maps_Filters::FILTER_* constants.
• Changed text domain from ‘pronamic_google_maps’ to ‘pronamic-google-maps’.

2.2.9 – 2014-05-15

• WordPress Coding Standards optimizations and tested up to version 3.9.1.

2.2.8 – 2014-02-21

• Added a tag around the fallback static map.

2.2.7 – 2013-11-15

• Fixed error on saving Pronamic Google Maps options.
• Improved support for percentage dimensions on singular maps.

2.2.6 – 2013-11-13

• Improved support for Shopp products post type.

2.2.5 – 2013-08-23

• Added support for new Google Maps Visual Refresh setting
• Improved post meta data saving, only save meta data if needed
• Mashup width and height can now be in percents (for responsive designs)

2.2.4 – 2013-02-13

• Changed the directory structure of the PHP classes files
• Added support for https:// (SSL)
• Added API client for backend geocode
• Fixed notice on saving an post (visible in debug mode)

2.2.3 – 2012-07-02

• Added WordPress query parameters ‘pronamic_latitude’ and ‘pronamic_longitude’
• Register the default Google Maps script in addition to the Google API loader script

2.2.2 – 2012-06-22

• Allow other units (percent, em, etc.) for the width and height attributes in the Google Maps mashup

2.2.1 – 2012-06-11

• Added Portuguese Brazil translation by Ruan Mer
• Apply html_entity_decode() to the query attribute in the mashup shortcode

2.2 – 2012-05-08

• Added support for some google-maps-utility-library-v3 libraries
• Added support for MarkerClustererPlus
• Added support for MarkerManager
• Fixed bug with an fixed zoom level wich was not set in the pronamic_google_maps_mashup() function
• If you disbale the ‘fit_bounds’ option in the mashup the mashup will no longer center the client location
• Added extra option ‘center_client_location’ to center the mashup center to the client location, default false
• Added ‘geo’ shortcode wich will display the latitude and longitude in the microformat of the post in wich it is placed
• Apply the ‘pronamic_google_maps_item_description’ filter not in admin
• Added shortcode ‘googlemapsmashup’ for an Google Maps mashup
• Changed shortcode ‘google-maps’ to ‘googlemaps’
• Deprecated the ‘google-maps’ shortcode, changed it to ‘googlemaps’, hyphen use can cause collisions
• Changed the text domain from ‘pronamic-google-maps’ to ‘pronamic_google_maps’
• Replaced all references to class constant TEXT_DOMAIN to an string
• Improved the way we enqueue te frontend script becease the way wp_enqueue_script() works is changed since WordPress 3.3

2.1.6 – 2011-12-14

• Fixed notice undefined property in the Pronamic_Google_Maps class related to zoom and map type ID values

2.1.5 – 2011-11-23

• Added the map options argument to the mashup and did some improvements on the mashup functions
• Fixed a small bug with determing the zoom level, thanks to Sascha Paukner

2.1.4 – 2011-09-26

• Added Polish translation by Marcin Modestowicz
• Improved the use of the ‘pronamic_google_maps_item_description’ filter

2.1.3 – 2011-09-16

• Fixed some notices caused by the new ‘map_options’ settings key
• Improved the Pronamic Google Maps widget

2.1.2 – 2011-09-15

• Added JavaScript to WordPress widget admin page for the Pronamic Google Maps widget
• Added the ‘pronamic_google_maps_marker_options_$key’ filter for dynamic icons on the Google Maps mashup
• Added the ‘pronamic_google_maps_post_meta’ filter for manipulating the Google Maps post meta
• Adjusted the Google Maps mashup JavaScripts, now each post can have it’s own custom marker icon
• It’s now possible to define all the Google Maps map options within the pronamic_google_maps() function

2.1.1 – 2011-08-29

• Added a short description to the meta box, thanks to andrewhouse
• Removed some PHP 5.3+ namespace slashes that were causing warnings on lower versions of PHP (unexpected character in input: ‘\’ (ASCII=92))

2.1 – 2011-08-04

• Mashup map is now also rendered if there are no posts found
• First parameter of the pronamic_google_maps_mashup() function now also be an WP_Query object
• Fixed issue with the Google Maps shortcode, in most cases it was not returning the output from the shortcode function
• Added an uninstall form so you can easily delete options and meta data

2.0 – 2011-07-18

• Fixed Notice: Undefined index: fit_founds
• Removed wp_register_script(‘google-maps’, …), we now only use the Google JavaScript load API
• Fix issue with the JavaScript variabel google.loader.ClientLocation wich can be null
• Added default zoom and map type values in the constants: Pronamic_Google_Maps::MAP_ZOOM_DEFAULT and Pronamic_Google_Maps::MAP_TYPE_DEFAULT
• If there is no meta information about the zoom level and the map type the default values will be set
• Replaced all the require once statements for the classes with an SPL autoload function
• Changed the default width and height values, now based on the output of the wp_embed_defaults() function
• Added shortcode [google-maps] functionality
• Added JavaScript event trigger “pronamic-google-maps-ready”
• Fixed the rendering of the mashup, if there are no posts found the empty ul element will not be added
• Added ‘marker_options’ as argument for the pronamic_google_maps() function
• Added the new Google Maps favicon to the WordPress admin menu

1.9 – 2011-06-20

• Replaced the normal Google Maps v3 JavaScripts with the Google JavaScript API loader scripts
• Thanks to the Google JavaScript API loader we can now use the “google.loader.ClientLocation” JavaScript variable
• Replaced some “jQuery” JavaScript variables to the shorter notation “$”
• Added all required map options (center, mapTypeId and zoom) to the creation of mashup maps
• Added ‘fit_bounds’ option for the pronamic_google_maps_mashup($query, $arguments) function
• Combined the JavaScript file widget.js into admin.js and did some improvements
• Browser check after changing some core JavaScripts:
  • Mozilla Firefox 3.6.17
  • Google Chrome 12.0.742.100
  • Opera 11.11
  • Safari 5.0.5
  • Internet Explorer 9.0.8112.16421
  • Internet Explorer 8.0.6001.19088
  • Intenret Explorer 7.0.5730.11

1.8 – 2011-06-16

• Changed jQuery selectors [property=value] to [property=”value”], jQuery 1.5.0 no longer allows these selectors
• Added extra meta data field for address information
• Added address field
• Added geocode and reverse geocode buttons
• Removed search field and button
• Combined the latitude and longitude fields into one form table row
• Replaced the add_options_page() with an add_menu_page() call
• Combined the class Pronamic_Google_Maps_OptionPage into the Pronamic_Google_Maps_Admin class
• Replaced the HTML buttons in the options pages with the function submit_button()
• Added geocoder page to bulk geocode posts
• Changed the way the JavaScript are loaded, we use a solution from Scribu: “How to load JavaScript like a WordPress Master“

1.7.1 – 2011-05-25

• Added an wp_reset_postdata() call after the custom query in the mashup class in request of ezlxq73

1.7 – 2011-05-25

• Changed ‘WP_query’ to the ‘WP_Query’ class name
• Improved the way the frontend JavaScripts are enqueued, on singular pages only when Google Maps is active. If your Google Maps mashup is not working anymore you probably have to call wp_enqueue_script(‘pronamic-google-maps-site’) in your mashup template. We adjusted this in request of MrVictor

1.6.3 – 2011-04-07

• Made it possible to use HTML in the title and description field (uses function wp_kses_post()), request of Paul Craig and bigchiefrandomchaos.

1.6.2 – 2011-04-04

• Changed the scope of some JavaScript functions in site.js and admin.js
• Changed some JavaScripts so the Google Maps object is binded to some DOM elements (http://api.jquery.com/data/)

1.6.1.2 – 2011-03-18

• Removed some unnecessary JavaScript, in response to problems in IE6 and 7.

1.6.1.1 – 2011-03-02

• Fixed the static map the image source attribute was empty since version 1.6.1.
• Fixed a bug in Internet Explorer 8, we now use the window load event instead of the ready event. If we use the read event the markers will not show up on the map (thanks to SweetManiac).

1.6.1 – 2011-02-28

• Added ‘echo’ argument in the pronamic_google_maps() and pronamic_google_maps_mashup() functions
• Fixed the ‘pronamic_google_maps_geo_microformat()’ function, if Google Maps is not active for the current post or post type don’t render the microformat

1.6 – 2011-02-28

• Share a single info window on the mashup map (Demo: Single Info Windows)
• The marker options of the mashup map can now be configured.

1.5.1.1 – 2011-02-21

• Fixed a typo in the GEO micrformat render function.

1.5.1 – 2011-02-10

• Fixed bug in version 1.5, function get_the_ID() was not working in all cases, now back to global $post; and $post->ID;
• Updated the screenschots

1.5 – 2011-02-09

• Replaced all hidden HTML fields with one hidden field with JSON data
• Removed “Like this plugin?” from options page
• Removed “Donate $10, $20 or $50!” from options page
• Removed “Latest news from Pronamic” from options page
• Removed “Found a bug?” from options page
• Added a search field above the Google Map in the admin
• Added the pronamic_google_maps_is_active() function
• Added the pronamic_google_maps_title() function and the “pronamic_google_maps_item_title” filter
• Added the pronamic_google_maps_description() function and the “pronamic_google_maps_item_description” filter
• Added mashup function: pronamic_google_maps_mashup($query, $arguments)
• Added the ‘pronamic_google_maps_mashup_item’ filter
• Added ‘nl_NL’ translations

1.4.1 – 2010-12-15

• Fixed marker on frontend should not be draggable (thanks to Pim Vellinga)
• Added function pronamic_google_maps_location() for custom directions forms.

1.4 – 2010-10-28

• Fixed bug dynamic map fixed width and height (thanks to Joost Baaij)
• Added Google Maps widget
• Add JavaScripts with the wp_enqueue_script function
• GEO microformat added. You should add the folowing CSS code to your stylesheet if you don’t want to display the GEO microformat.

1.3 – 2010-10-07

• Fixed a bug dynamic maps didn’t show up (thanks to ThomasBuxo)
• Made the latitude and longitude fields visibile again (request from ThomasBuxo)
• Added change and keyup events to latitude and longitude fields
• Mozilla Firefox 3.6.10 browser check
• Google Chrome 6.0.472.63 browser check
• Safari 5.0.2 browser check
• Opera 10.62 browser check
• Internet Explorer 8 browser check
• Internet Explorer 7 browser check

1.2 – 2010-10-06

• Fixed bug with fixed zoom value of 12 on static Google Maps
• Added translation options (Dutch language added)
• Changed the latitude and longitude fields from text to hidden

1.1 – 2010-10-06

• Added static and dynamic Google Maps support

1.0 – 2010-10-05

• Initial release