mrzxp

<p>MRZ Maps Exp is a generic, minimalist plugin to display any custom post type on a Google Map. Coordinates are read from an ACF Google Map field declared on each post. Everything is configured from the WordPress admin — no theme code required: source post type, filters, pagination, HTML templates, custom markers, responsive layout.</p>
<h4>Features</h4>
<ul>
<li>Multiple maps via a dedicated Custom Post Type — each map has its own configuration.</li>
<li>Filters by taxonomy and by ACF field, in dropdown / radio / checkbox mode, with OR / AND logic.</li>
<li>Hybrid search in a single field: Google Places address suggestions <strong>and</strong> posts whose title matches the input.</li>
<li>Optional URL filter synchronization — share a pre-filtered link.</li>
<li>Customizable markers: default icon, or per-term taxonomy icon.</li>
<li>100% custom tooltip via OverlayView (not the native InfoWindow), fully overridable in CSS.</li>
<li>Configurable HTML templates for the tooltip and the list, with ACF / taxonomy placeholders.</li>
<li>Front pagination, automatic fit bounds after filtering, recenter on the current post in single template.</li>
<li>Overlapping marker spiderfier (OverlappingMarkerSpiderfier).</li>
<li>Snazzy Maps: paste a JSON to style the map.</li>
<li>Responsive layout — filters above, left or right; detachable full-width search field; collapsible filters on mobile.</li>
<li>Shortcode with optional forced filter: <code>[mrz_maps_exp id="X" filter_taxonomy="genre" filter_term="42"]</code>.</li>
<li>Translation-ready (text-domain <code>mrz-maps-exp</code>, .pot file provided).</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>WordPress 6.3 or later, PHP 7.4 or later.</li>
<li>Advanced Custom Fields (Pro recommended) — for the Google Map field.</li>
<li>A Google Maps API key with the “Maps JavaScript”, “Places” and “Geocoding” APIs enabled. The key must be declared in the theme’s <code>functions.php</code> via the <code>mrz_maps_exp_api_key</code> filter or the <code>MRZ_MAPS_EXP_API_KEY</code> constant (the plugin deliberately does not expose an admin field for the key — it is a secret that has no place in the database).</li>
</ul>
<h4>Privacy / external calls</h4>
<p>MRZ Maps Exp loads the Google Maps JavaScript library in the end user’s browser, like any mapping plugin. No data is sent to Morez.co or any third-party service; no telemetry is collected. The Google Maps API key supplied by the site administrator is exposed on the client side (required to call Google’s JS API) — it is recommended to restrict it by HTTP referrer in the Google Cloud Console.</p>
<h4>Source code and contributions</h4>
<p>Development happens publicly on GitHub: https://github.com/m0r3z/mrz-maps-exp<br />
Issues, pull requests and forks welcome.</p>
<h3>External services</h3>
<p>This plugin relies on the Google Maps JavaScript API to display the interactive map, geocode addresses entered in the search field, and provide place autocomplete suggestions. The Google Maps API key is supplied by the site administrator (via the <code>mrz_maps_exp_api_key</code> filter or <code>MRZ_MAPS_EXP_API_KEY</code> constant in the theme); the plugin itself does not bundle any key.</p>
<h4>What is sent and when</h4>
<ul>
<li>When a page containing the <code>[mrz_maps_exp]</code> shortcode is loaded, the visitor’s browser loads the Google Maps JavaScript library from <code>https://maps.googleapis.com/maps/api/js</code>, including the <code>places</code> library. The Google Maps API key is appended as a query parameter.</li>
<li>When the visitor types in the search field, each keystroke (debounced) sends the current query string to Google’s Places Autocomplete service to retrieve address suggestions. If the visitor picks a suggestion, Google’s Places Details service is then called to obtain the coordinates for that place.</li>
<li>The visitor’s IP address is transmitted to Google as part of these HTTP requests, as it is for any third-party request initiated by their browser.</li>
<li>No data is sent to Google when the plugin is only installed or activated in the admin — only when a public page containing the shortcode is loaded.</li>
</ul>
<p>The plugin does not send any data to Morez.co or to any other third-party service. No telemetry is collected.</p>
<h4>Provider and legal links</h4>
<ul>
<li>Service: Google Maps Platform (Google LLC).</li>
<li>Terms of Service: https://cloud.google.com/maps-platform/terms</li>
<li>Privacy Policy: https://policies.google.com/privacy</li>
</ul>
<p>It is the responsibility of site administrators to obtain a valid Google Maps API key, accept Google’s Terms of Service for the project that key belongs to, and disclose the use of Google Maps in their own site’s privacy policy where required.</p>


MRZ Maps Exp

Display custom posts on a Google Map using ACF-based coordinates, with taxonomy and ACF filters, hybrid search and customizable markers.

MRZ Maps Exp vs SiteOrigin Widgets Bundle