Primary responsibility

Renders a geographic map with markers. Markers come from:

• A configured WP post type (post category)
• A GeoDirectory post type (when mam-geodirectory is active)
• Any sibling plugin contributing markers via mam_get_phone_data_before_send at the right priority

Settings

The Map content class is a thin shell — it declares no app_settings() of its own and get_data_for_app() passes the category through unchanged. Map behavior is driven by global app settings owned by the app-settings registry (and by the markers sibling plugins contribute). The relevant global settings include:

JSON shape (marker)

{
  "id": "123",
  "title": "Venue name",
  "lat": "40.7128",
  "lon": "-74.0060",
  "marker_icon": "https://...",
  "snippet": "Short description"
}

lat/lon are strings (frozen — older mobile parsers reject numeric coordinates).

Hooks involved

The Map content class doesn’t fire dedicated hooks. Markers are usually contributed by sibling plugins:

• mam-geodirectory: mam_geodirectory_explcit_listings, mam_geodirectory_final_listings, mam_gd_events_exclude_from_map
• mam-special-offers: mam_specials_get_post_lat, mam_specials_get_post_lon, mam_specials_get_post_radius
• mam-geofilters: contributes per-region marker subsets

The map center falls back to the tsl-setting-geofilter_default_lat / tsl-setting-geofilter_default_lon global settings, and the search radius comes from the request (see the radius gotcha below).

Gotchas

• lat/lon are strings. Don’t emit numeric values — older mobile parsers fail.
• Default coords are global, not per-button. All maps in the app share the tsl-setting-geofilter_default_lat / tsl-setting-geofilter_default_lon global settings.
• Search radius comes from the request. The app passes ?radius= on the phone-data request; mam-main persists it to the _geofilter_radius usermeta key. A couple of legacy normalizations apply: radius=0 is coerced to 50, and radius=500 is coerced to 5000.
• Map rendering is the mobile client’s job. mam-main provides the markers; the app uses a native map view (Apple Maps / Google Maps depending on platform and config).

Related articles

• Content classes overview
• Hook: mam_get_phone_data_before_send
• Mobile JSON shape

Metadata