Pronamic Google Maps

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