Jump to Content

Objective HTML

Google Maps for ExpressionEngine

The complete geolocation and mapping toolkit



  • (Feature) Added no_div tag to prevent the init tag from generating the map div.
  • (Feature) Added ability to redirect a user when they click on a region
  • (Bug Fix) Fixed an issue with infobox windows not appearing correctly for regions when open_windows is used.
  • (Bug Fix) Fixed an issue with the FT throwing an error in 2.9
  • (Bug Fix) Fixed an issue with the PHP errors being thrown for some versions of EE
  • (Bug Fix) Fixed an issue with the required setting not working in Channel Forms
  • (Bug Fix) Fixed an issue with the zoom_field setting not working properly
  • (Bug Fix) Added a row_index to the available variables when parsing objects in the fieldtype
  • (Bug Fix) Fixed an issue with the page_url method in the addon_helper
  • (Bug Fix) Fixed an issue with the pixel offset not working properly when opening windows for regions


  • (Feature) Added option to override statuses in the import schema for existing entries. Previously there was no way to force the statuses to be updated
  • (Bug Fix) Fixed an issue with the event tag not respecting the correct map id
  • (Bug Fix) Fixed an issue with the window_trigger not working
  • (Bug Fix) Fixed an issue with the installer lib
  • (Bug Fix) Fixed an issue with the cron importer
  • (Bug Fix) Fixed an issue with Zoo Visitor forms causing the FT to break on the front-end
  • (Bug Fix) Fixed an issue with the entry_id not being passed to the region objects
  • (Bug Fix) Fixed an issue with the importer not importing the record that was being imported when the OVER_QUERY_LIMIT error is thrown. This resulted in a small percentage of entries imported with no locations


  • (Feature) Added new config option to set the default language for the geocoder
  • (Feature) Added ability to override the config options globally with things like Master Config
  • (Bug Fix) Prevent PHP errors from occurring in a rare instance when using the search
  • (Bug Fix) Fixed an issue when using the :total_markers tag that would cause PHP errors if no map data was present.
  • (Bug Fix) Fixed an issue when importing data with UTF8 characters
  • (Bug Fix) Fixed issue with the FT not populated custom fields in 2.8. This was caused when the id="field_id_x" param was removed from the markup.
  • (Bug Fix) Fixed and issue with PHP errors appearing for the address_component tag if no location was entered
  • (Bug Fix) Fixed an issue with the field not properly being required if the settings was set
  • (Bug Fix) Fixed a critical issue when people are geocoding multiple fields, the geolocation would fail
  • (Bug Fix) Fixed an issue causing the import pool to not clear
  • (Bug Fix) Fixed an issue that would cause static maps to not appear if the file was missing but value exists in the cache.


  • (Feature) Added support for "Marker Spidering" (https://github.com/jawj/OverlappingMarkerSpiderfier)
  • (Bug Fix) Fixed an issue with the _min and _max operators not working
  • (Bug Fix) Fixed another issue with MSM
  • (Bug Fix) Fixed an issue with the get_channel_by_name method not returning channel in proper site
  • (Bug Fix) Fixed an issue with the maxWidth property not working for infowindows
  • (Bug Fix) Fixed a JS issues that would cause errors on IE when using Photo Frame
  • (Bug Fix) Change the algorithm used for distance searches . If search coordinates match db coordinates exactly, the results were not returned.
  • (Bug Fix) Updated Base Form to latest
  • (Bug Fix) Fixed an issue with the clear_cache tag not working.


  • (Feature) Added new parameter to the exp:gmap:streetview tag that will decouple the streetview from the parent map.
  • (API) Made the geocode parameter by default set to "false" instead of "true". If the address param is set, it auto sets the geocode param to true for backwards compatibility
  • (Bug Fix) Fixed issue with Google Maps marker offset.
  • (Bug Fix) Fixed issues with Safecracker in 2.5.5
  • (Bug Fix) Removed code causing errors on some servers
  • (Bug Fix) Fixed the way some settings were displayed that caused some confusion
  • (Bug Fix) Fixed an issue with Channel Search compatibility
  • (Bug Fix) Fixed an issue with the default region not being set to "us". User outside the US can update this setting in the gmap_config.php
  • (Bug Fix) Fixed compatibility issue for EE versions prior to 2.7
  • (Bug Fix) Fixed an issue that could cause PHP errors to display in the exp:gmap:results tag
  • (Bug Fix) Fixed an issue with Gmap.safecracker not working in 2.7. Updated that and added Gmap.channel_form in addition to the legacy property.


  • (Bug Fix) Fixed issue with the back button triggering an XID error in the search


  • (Feature) Added the ability to search with OR modifiers in the exp:gmap:search tag by delimiting your values with a bar (|) character.
  • (Feature) Added offsetX and offsetY to the regular info windows to offset their position
  • (Bug Fix) Added new ee() method to make add-on consistent with EE 2.6
  • (Bug Fix) Updated Photo Frame geolocation pack for latest Photo Frame API updates
  • (Bug Fix) Fixed issue with Photo Frame compatibility (JS errors)
  • (Bug Fix) Fixed an issue that would cause a memory leak with certain MSM sites
  • (Bug Fix) Fixed an issue that would cause PHP errors if searching categories (in some cases)
  • (Bug Fix) Fixed issue with url helper not being loaded automatically
  • (Bug Fix) Removed lingering PHP short tags
  • (Bug Fix) Fixed the way categories were search is using the match_categories_exact parameter.
  • (Bug Fix) Fixed an issue with the orange dot in the Regions not appearing when plotting new shapes.
  • (Bug Fix) Fixed issue with search on some versions of PHP
  • (Bug Fix) Fixed a bug with 2.7 that was caused by a missing XID parameter
  • (Bug Fix) Fixed an issue with Google Maps last_post not saving with native cookie method. Replace with native PHP method and works fine.
  • (Bug Fix) Fixed a PHP error that was triggered when :formatted_address was called when no locations exist
  • (Bug Fix) Trimmed content variable before outputting
  • (Bug Fix) Fixed EE 2.7 issues
  • (Bug Fix) Fixed an issue with window content not getting prepped before output which would cause JS errors.
  • (Bug Fix) Fixed an issue with editing region names and name not reseting for new regions.
  • (Bug Fix) Fixed issue with adding zoom parameter to the current location tag.
  • (Bug Fix) Removed deprecated EE functions from CP



  • (Bug Fix) Fixed compatibility issue with Photo Frame
  • (Bug Fix) Fixed an issue with Low Variables
  • (Bug Fix) Fixed an issue when searching categories that would cause a PHP issue to appear.


  • (Feature) Added a new fieldtype tag, :address_component to return a single address component from the results loop.
  • (Feature) Added Matrix support
  • (Feature) Added Low Variables support
  • (Feature) Added support for new UI updates introduced at Google IO13
  • (Feature) Added 3 new parameters to control the zoom for the current location tag.
  • (Feature) Added 2 super secret new features that will bring some really powerful stuff in the near future. :)
  • (Bug Fix) Fixed a typo, made an alias parameter called location_delimiter. The old param still works too.


  • (Bug Fix) Fixed issue with FT not honoring exact coordinates.
  • (Bug Fix) Fixed issues with the importer introduced in EE 2.6.0


  • (Bug Fix) Fixed all known 2.6.0 compatibility issues. Please report any 2.6.0 issues as you see them.


  • (Bug Fix) Fixed a bug that could cause a 500 error when updated EE.
  • (API) Updated api.gmap.php file with the build_response() method. This method was added for Geocoder (the add-on) specifically.
  • (Bug Fixed) Fixed a couple issues with the Yahoo geocoder service and importer.
  • (Bug Fix) Updated BaseClass
  • (Bug Fix) Fixed a bug that prevented the initial importer stats row from being created properly
  • (Bug Fix) Made it so when you delete a schema, it also deletes the related stats
  • (Bug Fix) Prevented YahooBossGeocoder.php from getting loaded everytime
  • (Bug Fix) Fixed an issue with the fieldtype that caused the map to reset the data if the defer map load setting is used.


  • (Bug Fix) Fixed an issue that caused the redirect parameter to not work properly.
  • (Bug Fix) Fixed an issue with exp:gmap:center tag that caused it to not return coordinates correctly.


  • (Bug Fix) Fixed a bug preventing the add-on from installing properly.
  • (Bug Fix) Increased version numbers.
  • (Bug Fix) Fixed a bug that caused issues when loading OAuth.php if the library has been loaded.


  • (Feature) Added a new grand_total_results to the variables getting parsed by exp:gmap:results
  • (Feature) Added new cache_post param to the exp:gmap:results tag
  • (Feature) Added a new variable to the exp:gmap:results tag called {paginate} which
  • (Feature) Add new match_categories_exact parameter that allows people to match the exact categories they have check with an OR operator.
  • (Feature) Add category_search_type parameter to control if the cat search uses AND or OR keywords
  • (Feature) Add new match_category_operator to change the operator if a match_category parameter is defined.
  • (Feature) Added a CAT_COUNT variable to the match_category parameter that will be replaced with the category count.
  • (Feature) Added a new tag: {exp:gmap:world_borders} tag
  • (Feature) Added a new tag: {exp:gmap:current_location}
  • (Feature) Added a new tag: {exp:gmap:event}
  • (Feature) Added new bulk geocoder with CRON and Yahoo BOSS commercial API support.
  • (Feature) Added the ability to duplicate a schema.
  • (Feature) Added new config var to skip rows in a dataset during import
  • (Feature) Added new marker options like animate to the field type tag. Now all Google Maps properties are supported.
  • (Bug Fix) Fixed a bug that prevented certain variables from parsing correcting when using the parse_tags="true" parameter.
  • (Bug Fix) Fixed a bug preventing some Windows servers from parsing the regex pattern.
  • (Bug Fix) Fixed a bug with deleting schemas.
  • (Bug Fix) Make the ID param always default to "map" and is not required.
  • (Bug Fix) Fixed a bug that caused path's of the marker icons in the FT to break.
  • (Bug Fix) Fixed a bug that prevented a user from overriding the form's action in the template.
  • (Bug Fix) Fixed a parsing issue in the exp:gmap:results tag
  • (Bug Fix) Fixed PHP short tag
  • (Bug Fix) Fixed the bug that caused a SQL error if no validation location was found.
  • (Bug Fix) Overall improvements and bug fixes to the entire geocoder
  • (Bug Fix) Fixed several MSM performance issues when using the search and fieldtype with large sites.
  • (Bug Fix) Fixed a bug preventing info windows from displaying when using the duplicate_markers parameter.


  • (Bug Fix) Fixed bugs preventing the FT regions from displaying
  • (Bug Fix) Fixed bugs preventing region infowindows from displaying
  • (Feature) Added a new settings in the FT that allows users to specify a minimum number of points.


  • (Bug Fix) Fixed a Theme Loader bug causing an alert to appear saying the sensor parameter was not set when loading Google Maps library
  • (Bug Fix) Fixed a bug causing an incorrect file path when selecting icons in the fieldtype


  • (Feature) Added new template tags to the marker parsing(index, count, limit, offset, entry_id).
  • (Feature) Appended the marker index and entry id (if set) to the marker object in the FT and exp:gmap:marker methods.
  • (Feature) Added the count and index variables to the results array (in the exp:gmap:results tag).
  • (Feature) Implemented MarkerClusterer v3. Use the clustering="true" parameter in the fieldtype or exp:gmap:marker tag.
  • (Feature) Improved region plotting.
  • (Feature) Added a plethora of category tags to the exp:gmap:results tag (inside the results loop) without adding any additional queries.
  • (Feature) Added a categories parameter to the marker and fieldtype tag that will append categories to the marker object.
  • (Feature) Added a category_ids variable to the channel entries loop
  • (Feature) Added a new duplicate_markers parameter that prevents duplicate markers from being added to the map. Set duplicate_markers="false" on the fieldtype and/or exp:gmap:markers tag to remove duplicate markers. By default, duplicate markers will appear on the map.
  • (Feature) Added new .csv importer that geocodes entries from a .csv
  • (Feature) Added new .csv importer that geocodes markers into a single entry via the field type.
  • (Feature) Added compatibility to related channel field options in the exp:gmap:search method.
  • (Feature) Added new clear_cache() method that clears the search cache.
  • (Feature) Added parse_tag parameter to exp:gmap:results which makes it a looping tag that runs the FT parses instead of replace the tags with the raw data.
  • (Feature) Added better pagination to the exp:gmap:results tag.
  • (Feature) Added new _day suffix to the search data types.
  • (Feature) Added a window_trigger parameter to the fieldtype and exp:gmap:marker tag that allows developers to change the trigger that opens info windows.
  • (Feature) Added ability to search for markers relative to multiple locations, like origins and destinations opposed to only a single location.
  • (Feature) Added new alternative fieldtype tag to product a static map instead an interactive map. Use the following syntax:

    {field_name:static_map} {field_name:static_map zoom="5"}

  • (Bug Fix) Added alternative cluster parameters that aren't camel cased.

  • (Bug Fix) Fixed localization search bug
  • (Bug Fix) Fixed a couple issues preventing points from being added if clicking on an existing region, or the new region itself.
  • (Bug Fix) Fixed an issue when updating a custom field, the selector would be just a '#'.
  • (Bug Fix) Fixed PHP 5.4 compatibility
  • (Bug Fix) Added the missing title property to the marker object on the front-end.
  • (Bug Fix) Fixed bug fix for PHP 5.2 that prevent FT from displaying in Safecracker.
  • (Bug Fix) Fixed issue that caused all fields to get pulled, instead of only those assigned to the parent channel
  • (Bug Fix) Fixed a bug that prevent marker content from displaying in the FT tag.
  • (Bug Fix) Added compatibility with the parse="inward" parameter
  • (Bug Fix) Fixed update bug that prevented the action_id's from being updated properly.
  • (Bug Fix) Fixed an rgba issue with IE.
  • (Bug Fix) Fixed an issue with the fieldtype not passing the redirect variable correctly.
  • (Bug Fix) Fixed an issue that caused users to always get redirected when a marker is clicked.
  • (Bug Fix) Fixed a bug that prevented users from search in multiple channels.
  • (Bug Fix) Added a new error message if a user tries to search an invalid channel.
  • (Bug Fix) Fixed an bug that caused a PHP notice to display if no path was set.
  • (Bug Fix) Fixed API inconsistencies between infobox() and infowindow() methods.
  • (Bug Fix) Added a series of default parameters to increase error tolerance.
  • (Bug Fix) Fixed a compatibility issues for EE 2.5.3
  • (Bug Fix) Fixed a vulnerability that could break the code if a malformed string was injected into the hidden fieldtype form field.
  • (Bug Fix) Fixed a long time CSS issues that was loading 2 images that didn't exists which results in two 404 requests.
  • (Bug Fix) Fixed a CSS issue with safecracker that caused the max-width of images to be a 100% when used within modern CSS frameworks (Foundation, Twitter Bootstrap, etc)


  • (Feature) Added a notice to the search if you are a super admin if you are over the query limit. This is mainly for people using public IP's. This error is most likely to occur during development or during high volumes of traffic.
  • (Feature) Added native pagination to the search method. Required the cache_post parameter until search is rewritten for GET (coming in v3.1).
  • (Feature) Implemented 3 new template tags for the fieldtype, {field_name:total_markers}, {field_name:total_waypoints}, {field_name:total_regions}
  • (Maintenance) Updated the Channel Data depency.
  • (Maintenance) Updated the Base Form dependency.


  • (Feature) Added a new match_categories parameter to allow people to define a number of categories the search must meet before an entry will be meet accepted criteria.
  • (Feature) Added a new plugin to customize the infowindows, called customizeInfoWindows.js.
  • (Feature) Added ability to search by status.
  • (Bug Fix) Fixed an issue that was causing the marker.index property to be set to undefined which prevented the map markers from being edited.
  • Updated the Channel Data dependency.


  • (Bug Fix) Fixed an issue causing the exp:gmap:results tag from returning entries assigned to multiple categories correctly.
  • (Bug Fix) Fixed another issue with the search not properly returning the {title} variable inside the {results} tag pair.
  • (Bug Fix) Fixed a bug that caused region points to not get added in the precise location the user adds them.
  • (Bug Fix) Fixed an issue with editting markers causing a "cyclic value" JavaScript error.
  • (Feature) Optimized the search query thanks to @adrienneleigh. Queries are much faster now and much more manageable.


  • (Bug Fix) Fixed an issue that prevented markers from displaying correctly when using the fieldtype.
  • (Bug Fix) Fixed an issue where markers didn't get cancelled properly. For instance a user adds a new marker and edits, but doesn't hit save, rather adds a new marker (thinking it had saved), which results in those changes remaining visible on the map.


  • (Bug Fix) Fixed an issue that caused entries with multiple markers on the maps not to display the correct marker icon on the front-end. If more than marker was added, the first marker in the series would become the icon for the latter markers.
  • (Bug Fix) Fixed an issue that prevented the zoom_one_marker setting from working properly.


  • (Bug Fix) Fixed usability issue with zoom being too far zoomed in when only one marker is present.
  • (Bug Fix) Added a new "append" parameter to append a string to the "id" paramter of a Google Maps variable (within a channel entries loop). This affected people plotting data using the fieldtype tag, and wanted to add the data to a new map with each row.
  • (Bug Fix) Removed plotted data from map bounds after they are deleted.
  • (Feature) Now there is a setting to control the default zoom for a single marker.
  • (Feature) Added a new setting to override the default button text.
  • (Feature) Also started writing more in the changelog and formatting stuff in bulleted lists for your reading pleasure. ;)



Fixed a bug that prevented pagination from working properly when parsing the fieldtype data. Also made route an alias for waypoints for convenience when parsing data. Prefix is still 'waypoint:'.



Fixed an issue with the theme URL not initialling properly if the thmes was outside of the root. Also fixed an issue with the Geocoder button not labelled properly. It not reads, "Plot Location" which seems more appropriate.



Fixed bug that causes coordinates to plot incorrectly if they return no results from the geocoder in fieldtype and on the front-end. Added new parsing of the fieldtype data use the "parse" attribute, documentation coming soon. More stability and general bug fixes. Fixed an issue with the Matrix sync plugin from not properly deleted rows.



More bug fixes. Added ability to search by expiration data, entry data, title, and author_id. Added a default post value of null to all channel field's even if they haven't been posted. Before it required {if post:var}{post:var}{/if}. Also added limit and offset to the fieldset to have better control of plotting markers.



Deleted .DS_Store files



Bug fixes and added a new event, gmapSaveMarker.



Added the index parameter to the gmapAddMarker and gmapMarkerDragEnd API events that allowed better control over the markers that were added to the map. Also created a matrix sync plugin using the new API changes.



Implemented the new proxy for shared IP's. You can now host your own proxy or use the provided one at objectivehtml.com. Enable the proxy by defining a URL in the gmap_config.php file.



Added ability to execute common features client side without relying on cURL (for shared IP's). Currently on the init and streetview tags are compatible with the new client_side="true" parameter. Perhaps more will come in the future if people request it.



Added "client_side" parameter to the init and streetview tags for better compatibility with shared or busy IP's. This param deferes requests to client rather than server-side API.



Fixed a bug that prevents the add-on from installing properly due to an improperly defined constant. Somehow this error didn't trigger before.