Documentation

Mashup Map Shortcode

Last modified: March 2, 2025

Introduction

The Gravity Forms Mashup Map feature in Gravity Geolocation enables you to display multiple form submissions as location markers on an interactive map. The feature pulls geolocation data from Geocoder Fields within your Gravity Forms, making it easy to visually showcase user-generated locations.

Whether you're mapping customer locations, event registrations, or business service areas, the [gfgeo_mashup_map] shortcode allows you to create an engaging and dynamic location-based display.

Mashup Map settings in Gravity Geolocation
Configuration options for the Mashup Map.

Configuring the Mashup Map for Gravity Forms

The following shortcode attributes allow you to customize how the Mashup Map appears and behaves:

1. form_id

Specify the ID of the Gravity Forms form whose submissions should appear on the map.

Example: form_id="1"


2. include_entries

Display only specific Gravity Forms entries by listing their entry IDs. By default, all entries are included. Note: This attribute cannot be used alongside exclude_entries.

Example: include_entries="101,102,103"


3. exclude_entries

Remove certain form submissions from appearing on the Mashup Map ( all entries will be included by default ).

Example: exclude_entries="5,6,7"


4. geocoders_id

Specify the Geocoder field IDs to include in the map, separated by commas. By default, all Geocoder fields from the form will be included.

Example: geocoder_id="1,2,3"


5. map_height

Set the height of the map display (e.g., 200px, 100%).

Example: map_height="400px"


6. map_width

Set the width of the map display (e.g., 200px, 100%).

Example: map_width="100%"


7. map_type

Choose the type of map displayed.

Available options: roadmap, satellite, hybrid, terrain

Example: map_type="satellite"


8. entries_count

Set the maximum number of entries to display on the map. The default value is 500.

Example: entries_count="200"


9. scrollwheel_zoom

Enable or disable zooming using the mouse scroll wheel. Set to 1 to allow scroll-wheel zooming or 0 to disable it.

Example: scrollwheel_zoom="1"


10. map_markers

Set a custom map marker for each Geocoder Field by specifying the Geocoder ID and the marker URL, separated by a vertical bar (|). You can assign multiple custom markers by providing a comma-separated list of Geocoder IDs and their corresponding URLs. By default, the plugin will use the marker defined in the Geocoder Field options if no custom marker is provided.

Example: map_markers="1|URL,2|URL,3|URL"


Shortcode Examples

Basic shortcode usage to display all submissions from Gravity Forms form ID 1:

[gfgeo_mashup_map form_id="1"]

Display only submissions with IDs 101, 102, and 103:

[gfgeo_mashup_map form_id="1" include_entries="101,102,103"]

Exclude submissions with IDs 5, 6, and 7 from the map:

[gfgeo_mashup_map form_id="1" exclude_entries="5,6,7"]

Customize map height and width:

[gfgeo_mashup_map form_id="1" map_height="500px" map_width="80%"]

Setting Up and Using the Mashup Map in Gravity Forms

Follow these steps to configure the Mashup Map:

  1. Insert the Shortcode: Add the [gfgeo_mashup_map] shortcode to your page or post.
  2. Use Shortcode Attributes: Adjust the attributes such as form_id, map_type, and map_height as needed.
  3. Test and Optimize: Preview the page to ensure the map displays the correct entries.
menu-circle