Map Widget
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Map Widget

  • Dark
    Light
  • PDF

Article Summary

Map Widget on the Configurable Dashboard

The Map Widget allows you to see where your events are happening based on your user permissions. In this document, we’ll be talking about building out this specific widget. If you’re wanting to learn about building the dashboard, read here.

Widget Configuration

Unlike some of the more intricate widgets, the setup for the Map Widget is going to be pretty straightforward, but if there’s one point of continuity between all the widgets, it’s that the first step is always entering the name. Then you can decide if you want to have the name display and if you want the widget to have a border around it by clicking either (or both) of the following two checkboxes.

Next, if you want to, you can choose to adjust the height settings on the widget. The default will be Enforce exact height. Your other options are: Dynamically expand and reduce height, dynamically expand only, and dynamically reduce only.

What does any of this mean? Let’s define some terms.

  • Enforce Exact Size
    • The default and recommended option. This option uses the template defined height and will not vary from that. If the data field is larger than possible to display at one time (unlikely in a bar chart but a possibility in others), scrolling will be required to view the data.
  • Dynamically Expand and Reduce Height
    • The most flexible option wherein the widget will grow or shrink as necessary to display all data at one time with no scrolling required. This option may change the layout of the dashboard as the widget will not be a fixed size.
  • Dynamically Expand Only
    • This will allow the widget to expand as needed to display all data but the widget will not shrink beyond the defined size set for the template.
  • Dynamically Reduce Only
    • The widget may get smaller based on display needs but will not expand beyond the set size on the template.

For our example, we’re going to keep it at the default Enforce Exact Size.

And that’s it for the basic setup. If you want to, you can click Save changes at the bottom of the modal and go on with the rest of your day. If you need your map to be more specific, read on to learn about filtering.

Widget Filters

If you want your map to display only events from a specific program, event type, or a range of other options without having to filter the entire dashboard, you can do so with widget-level filtering. At the top of the widget builder, click Widget Filters.

If you’ve already added piece-level filtering, this won’t be a big stretch for you, but if you haven’t, we’re going to go through all the steps so don’t worry about missing out on something. The next step is clicking Add Filter.  

This will open the Filter Builder. Your first step here is entering the Name of the filter. Then you need to select your Filter Type. For Filter Type, your options are: Venue Markets, Event Types, Recap Definitions, Programs, Date Range (full date), Date Range (Month and Year), Venue States, Integration Custom Fields, Scheduling Custom Fields, Recap Custom Fields, and Venue Custom Fields.

  • Venue Markets
    • Narrow your widget data to specific markets
    • Select the market(s) from the dropdown menu. Markets will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Event Types
    • Narrow your results to certain event types.
    • Select the event type(s) from the dropdown menu. Event types will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Recap Definitions
    • Pull data only from events with specific recap assignments
    • Select the recap(s) from the dropdown menu. Recap definitions will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Programs
    • Display data based on the event’s program assignment
    • Select the program(s) from the dropdown menu. Programs will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Date Range (full date)
    • Select a date range for dd/mm/yy
  • Date Range (Month and Year)
    • Select a date range for mm/yy
  • Venue States
    • Pull data based on the state the venue is in
    • Select the state(s) from the dropdown menu. States will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Integration Custom Fields
    • Use Integration Fields to determine what data is pulled into your chart
    • Select the field(s) from the dropdown menu. Fields will need to be added individually. If none are selected, the dashboard will default to including all in the filter.
  • Scheduling Custom Fields
    • Pull data based on Scheduling Fields on the event
    • Select the field(s) from the dropdown menu. Fields will need to be added individually. If none are selected, the default will include all in the filter.
  • Recap Custom Fields
    • Use specific Recap Fields to determine what event’s pull into your chart
    • Select the field(s) from the dropdown menu. Fields will need to be added individually. If none are selected, the default will include all in the filter.
  • Venue Custom Fields
    • Use responses from Venue Fields to populate the widget
    • Select the field(s) from the dropdown menu. Fields will need to be added individually. If none are selected, the default will include all in the filter.

Build out additional filters as needed by repeating the above steps.

When you’ve made all your edits, click Save Changes at the bottom of the modal.


What's Next