Gallery3:Modules:tagsmap - Gallery Codex
Personal tools


From Gallery Codex

TagsMap Module

Allows tags to be displayed on top of a map.


TagsMap is a module for Gallery 3 which will allow a Gallery administrator to assign GPS coordinates to tags. Those tags can then be viewed by visitors on a google map, accessible from the sidebar.


  • Allows Gallery administrators to assign GPS coordinates and custom descriptions to tags.
  • Map out tags that correspond to physical locations.
  • Support for the Google Earth web browser plugin as well as Google Maps.

Screen shots



This module may be downloaded from the Gallery forums here.

To install, extract the "tagsmap" folder from the zip file into your Gallery 3 modules folder. Afterwards log into your Gallery web site as an administrator and activate the module in the Admin -> Modules menu. Once activated, you will have and Admin -> Content -> TagsMap Settings option. Visit this screen to configure the module and to assign GPS coordinates to tags.


Once the tagsmap module is installed and active, select the Admin -> Content -> TagsMap Settings menu to configure everything.

First, you will need to enter in your Google Maps API key. If you don't already have an API key, you can sign up for free here.

Next, you will need tell the module how you want the map to initially appear. The "Starting Latitude" and "Starting Longitude" fields are used to tell the module a GPS coordinate to center the map on. "Default Zoom Level" tells the module how far zoomed in/out the map should start out at over those coordinates. A value of "0" will zoom the map out all the way, and a value of "17" will zoom the map in all the way. Finally, the "Default Map Type" field will tell the module what type of map to display when the map is first loaded. Your choices are G_NORMAL_MAP (a normal map), G_SATELLITE_MAP (a satellite map), G_HYBRID_MAP (a satellite map with the normal map overlaid on top of it), G_PHYSICAL_MAP (a terrain map), and G_SATELLITE_3D_MAP (the Google Earth browser plugin).

Once the map is configured, you will need to then assign GPS coordinates to some of your tags. The next area of the admin screen will list all of the tags currently in gallery with an "Edit GPS" link next to each one. Click on this link to enter in the Latitude and Longitude you wish this tag to be displayed at along with an (optional) short description to be displayed along with the tag. Once you've done this, press "Save" and you'll be sent back to the main admin screen for the module. You will now find that this tag has a "Delete GPS" link next to the edit link. You may use this link to remove the GPS data for the corresponding tag.

The final section of the tagsmap admin screen is called "Remove Orphaned GPS Data". In the event that you delete a tag from gallery after assigning GPS coordinates to it, you may use this link to remove the GPS data as well. Clicking on this link will cause the module to automatically search for any GPS data that no longer corresponds with a tag. That data will then be automatically deleted, and a message telling you how may entries it found/deleted will be displayed.