woosmap

<p>The Woosmap Store Locator Widget Block for WordPress allows you to add a store locator to your WordPress site using the<br />
Gutenberg editor. This plugin leverages<br />
the <a href="https://developers.woosmap.com/products/widgets/store-locator-widget/quick-start/" rel="nofollow ugc">Woosmap Store Locator Widget JS</a><br />
to provide a rich and interactive experience for users looking for your store locations.<br />
With easy customization and setup, you can enhance your site’s user experience in minutes.</p>
<p>To use this plugin, you will need a Woosmap account and an API key. The Woosmap Store Locator Widget connects to the<br />
Woosmap API to fetch and display store locations on your site. Note that Woosmap offers various pricing plans, including<br />
a free tier with limited usage and paid plans for higher usage and additional features. For detailed pricing<br />
information, please refer to the <a href="https://www.woosmap.com/pricing/" rel="nofollow ugc">Woosmap pricing page</a>.</p>
<p>The widget supports a broad array of languages, including French, English, Spanish, German, and many more, catering to a<br />
global audience and is designed for fast and advanced display capabilities, ensuring a seamless user experience.</p>
<p><a href="https://developers.woosmap.com/products/widgets/store-locator-widget/quick-start/" rel="nofollow ugc">Check official documentation</a> for<br />
more details.</p>
<h3>Key Features</h3>
<ul>
<li><strong>Multilingual Support</strong>: Available in over 15 languages, such as English, Chinese, and French, catering to<br />
international brands.</li>
<li><strong>Customizable Display</strong>: Users can set a primary color that applies to labels and backgrounds, aligning the<br />
locator’s<br />
appearance with their brand identity.</li>
<li><strong>Flexible Search</strong>: Adapt the search features to include autocomplete worldwide or for specific countries and<br />
specific types (address, postal code, etc.), ensuring the functionality best fits your needs.</li>
<li><strong>Advanced Display Options</strong>: Offers simplified and markers views for displaying assets, allowing for a clean view or<br />
detailed markers based on zoom level.</li>
<li><strong>Configurable Search Parameters</strong>: Set the number of assets fetched from a user search and bound searches within a<br />
set radius to accommodate store density.</li>
</ul>
<h3>Display Customization</h3>
<ul>
<li><strong>Simplified View</strong>: Ideal for rendering a large number of assets or high store density, displaying assets as colored<br />
dots for faster map loading and a cleaner view.</li>
<li><strong>Markers View</strong>: Displays assets as pictograms with customizable images, sizes, and hotspots, suitable for detailed<br />
branding after a specified zoom level.</li>
</ul>
<h3>Integration and Customization</h3>
<p>The widget’s properties offer versatile customization options: use Form controls for swift adjustments of attributes<br />
like theme color, or dive into an editable JSON Configuration for granular control over the store locator’s<br />
functionality and appearance. This adaptability guarantees seamless integration into any website, equipping businesses<br />
with a robust tool to enhance their online presence and engage customers more effectively.</p>
<h3>External Dependencies</h3>
<p>This plugin will load the Woosmap Store Locator Widget JavaScript asynchronously, which will then load the<br />
<a href="https://developers.woosmap.com/products/map-api/get-started/" rel="nofollow ugc">Woosmap Map JavaScript</a> asynchronously and execute<br />
requests to Woosmap services for various functionalities:</p>
<ul>
<li><strong>Searching for Stores</strong>: The widget will query the Woosmap API to fetch store locations, ensuring accurate and<br />
up-to-date results.</li>
<li><strong>Autocompleting Addresses</strong>: The widget will use Woosmap’s autocomplete service to suggest addresses as users type,<br />
enhancing the user experience with quick and relevant suggestions.</li>
<li><strong>Displaying Maps</strong>: The widget will render maps using Woosmap’s mapping service to visually display store locations<br />
and other relevant data, providing an interactive and user-friendly interface.</li>
</ul>
<p>The URLs involved are:<br />
– <a href="https://webapp.woosmap.com/webapp.js" rel="nofollow ugc">https://webapp.woosmap.com/webapp.js</a><br />
– <a href="https://sdk.woosmap.com/map.js" rel="nofollow ugc">https://sdk.woosmap.com/map.js</a><br />
– <a href="https://api.woosmap.com/*" rel="nofollow ugc">https://api.woosmap.com/*</a></p>
<h3>Source Code</h3>
<p>This plugin’s source code is accessible in the <code>src</code> directory of our <a href="https://github.com/woosmap/store-locator-widget-block" rel="nofollow ugc">GitHub repository</a>.</p>
<h3>Configuration</h3>
<p>To begin using the Woosmap Store Locator Widget Block, follow these steps to configure your environment and gain access<br />
to the Woosmap API<br />
for enhancing your site with location services.</p>
<h3>Woosmap Account Requirements</h3>
<ol>
<li>If you haven’t already, <a href="https://www.woosmap.com/sign_up/" rel="nofollow ugc">sign up for a Woosmap account</a> as it’s necessary to access<br />
the Woosmap Console and API keys.</li>
<li><a href="https://console.woosmap.com/" rel="nofollow ugc">Log in to the Woosmap Console</a>. If you’re new to Woosmap, you might need to<br />
create a project to generate API keys.</li>
<li>Navigate to the API keys section and generate a new Public API key for your project. This key will be used to<br />
authenticate your requests to the Woosmap services.</li>
</ol>
<h3>Configure the Woosmap Store Locator Widget Block</h3>
<p>When you create a new Woosmap block, the initial settings screen prompts you to enter the public API Key. If an API Key<br />
has already been configured, this field will be pre-populated with the existing key stored in the Woosmap settings.<br />
After validation, proceed to the Map View to access various editor settings, or edit the JSON Configuration as desired.</p>


Store Locator Widget Block

Easily integrate the Woosmap Store Locator Widget into your WordPress site with this Gutenberg block plugin.

modernmaps

<p><strong>Modern Maps Lite is the easiest way to add beautiful, customizable maps to your WordPress site.</strong> No API keys. No Google Cloud Console. No complicated setup. Just add a block, search for your location, and publish — your map looks good from the start.</p>
<p>Built from the ground up for the WordPress block editor, Modern Maps Lite uses MapLibre GL to render smooth, modern vector maps that match your site’s design. It’s the map block WordPress should have shipped with.</p>
<h4>Why Modern Maps Lite?</h4>
<ul>
<li><strong>Works instantly</strong> — no API key, no Google Cloud account, no billing setup</li>
<li><strong>Native Gutenberg block</strong> — not a shortcode, not a widget, not a retrofitted legacy plugin</li>
<li><strong>Curated style presets</strong> — White, Black, and Standard themes designed for modern web design</li>
<li><strong>Theme color matching</strong> — pick a color and your entire map palette updates</li>
<li><strong>Vector tiles</strong> — smooth, fast, and crisp at every zoom level</li>
</ul>
<h4>Features</h4>
<ul>
<li>Add maps to any page or post using the block editor</li>
<li>Search for any address or place name directly in the editor</li>
<li>Unlimited markers per map</li>
<li>Rich marker popups — add text, images, or any WordPress block inside a popup</li>
<li>3 style presets: White (clean, minimal), Black (dark mode), Standard (classic)</li>
<li>Theme color picker to match your map to your brand</li>
<li>Auto-fit viewport to show all markers, or set a fixed center and zoom</li>
<li>Adjustable map height with CSS unit support (px, vh, em)</li>
<li>Wide and full-width alignment options</li>
<li>Border, border-radius, and shadow controls via the block editor</li>
<li>Responsive and mobile-friendly</li>
<li>Lightweight — no jQuery, no legacy admin panels</li>
<li>Works with any properly coded WordPress theme</li>
<li>GDPR-friendly — all external service connections fully disclosed</li>
<li>No coding required</li>
</ul>
<h4>Want More? Try Modern Maps Pro</h4>
<p><a href="https://modernmapswp.com" rel="nofollow ugc">Modern Maps Pro</a> adds powerful customization for designers and agencies:</p>
<ul>
<li>Advanced LCH color space controls — fine-tune every color on your map</li>
<li>Additional style presets</li>
<li>Priority email support</li>
<li>Multi-site licensing (5 or 25 sites)</li>
</ul>
<h4>Perfect For</h4>
<ul>
<li>Small businesses showing their storefront location</li>
<li>Restaurants, cafes, and bars with a contact page</li>
<li>Real estate agents displaying property locations</li>
<li>Travel bloggers mapping their adventures</li>
<li>Churches, gyms, and community organizations</li>
<li>Nonprofits mapping their service areas</li>
<li>Freelancers and agencies building client sites</li>
<li>Anyone who wants a map on their WordPress site without the API key hassle</li>
</ul>
<h4>How It Works</h4>
<ol>
<li><strong>Install</strong> — Find Modern Maps Lite in the WordPress plugin directory and activate it. No account creation. No API key setup.</li>
<li><strong>Add a map</strong> — Open any page or post, add the Modern Maps block, and search for your location.</li>
<li><strong>Make it yours</strong> — Choose a style preset or match your theme color. Publish and you’re done.</li>
</ol>
<h4>Links</h4>
<ul>
<li><a href="https://wordpress.org/support/plugin/modernmaps-lite/" rel="ugc">Support</a></li>
</ul>
<h4>Source Code</h4>
<p>The full unminified source code for all JavaScript and CSS is included in the <code>src/</code> directory of this plugin. The compiled versions used at runtime are in the <code>build/</code> directory.</p>
<h3>External Services</h3>
<p>This plugin relies on the following third-party external services to provide its core functionality. Each service is documented below in a consistent format showing what it is used for, when it is contacted, and what data is sent.</p>
<h4>Modern Maps Tile Proxy</h4>
<ul>
<li><strong>Used for:</strong> Delivering vector map tiles, fonts (glyphs), and sprite assets to the visitor’s browser so the map can render.</li>
<li><strong>When:</strong> Whenever a map block is rendered, both on the public front end and inside the WordPress block editor.</li>
<li><strong>Data sent:</strong> Standard HTTP request data from the visitor’s browser (this is true of any web request). The proxy itself samples sites — not individual requests — using a deterministic hash of the site’s hostname: approximately one in ten sites are included, and for those sites every request is logged (for the rest, no requests are logged). For included sites, the proxy records the calling site’s domain (taken from the standard Origin or Referer header the browser already sends), the asset type requested (tile, font, or sprite), and the HTTP response status. Records are retained for 90 days. <strong>No visitor IP addresses, user agents, request paths, query strings, cookies, or other personal data are stored.</strong></li>
<li><strong>Service URL:</strong> https://tiles.modernmapswp.com</li>
<li><strong>Provider:</strong> Modern Maps (modernmapswp.com)</li>
<li><strong>Terms of Use:</strong> <a href="https://modernmapswp.com/terms" rel="nofollow ugc">https://modernmapswp.com/terms</a></li>
<li><strong>Privacy Policy:</strong> <a href="https://modernmapswp.com/privacy" rel="nofollow ugc">https://modernmapswp.com/privacy</a></li>
</ul>
<h4>MapTiler</h4>
<ul>
<li><strong>Used for:</strong> Source of the underlying vector tiles and font glyphs served by the tile proxy above.</li>
<li><strong>When:</strong> Indirectly, whenever the tile proxy is contacted. The visitor’s browser does not communicate with MapTiler directly — all requests are routed through the proxy.</li>
<li><strong>Data sent:</strong> Server-to-server requests from the tile proxy. No data flows from the visitor’s browser to MapTiler.</li>
<li><strong>Service URL:</strong> https://api.maptiler.com</li>
<li><strong>Terms of Use:</strong> <a href="https://www.maptiler.com/terms-of-use/" rel="nofollow ugc">https://www.maptiler.com/terms-of-use/</a></li>
<li><strong>Privacy Policy:</strong> <a href="https://www.maptiler.com/privacy-policy/" rel="nofollow ugc">https://www.maptiler.com/privacy-policy/</a></li>
</ul>
<h4>Komoot Photon Geocoding API</h4>
<ul>
<li><strong>Used for:</strong> Converting a typed address or place name into latitude and longitude coordinates.</li>
<li><strong>When:</strong> Only when an admin types into the location search field inside the block editor. Never contacted on the public front end.</li>
<li><strong>Data sent:</strong> The search query text and standard HTTP request headers from the admin’s browser.</li>
<li><strong>Service URL:</strong> https://photon.komoot.io</li>
<li><strong>Terms of Use:</strong> <a href="https://photon.komoot.io/" rel="nofollow ugc">https://photon.komoot.io/</a> (Photon is an open-source geocoding API built on OpenStreetMap data and does not publish a separate privacy policy.)</li>
</ul>
<h4>Protomaps Basemap Assets</h4>
<ul>
<li><strong>Used for:</strong> Sprite images and font glyphs used by the “Standard” map style.</li>
<li><strong>When:</strong> Whenever a map using the Standard theme is rendered, in the editor or on the public front end.</li>
<li><strong>Data sent:</strong> Standard HTTP request data (IP address, user agent) from the visitor’s browser to GitHub Pages.</li>
<li><strong>Service URL:</strong> https://protomaps.github.io/basemaps-assets/</li>
<li><strong>Provider:</strong> Protomaps</li>
<li><strong>Project Page:</strong> <a href="https://protomaps.com/" rel="nofollow ugc">https://protomaps.com/</a></li>
<li><strong>GitHub Privacy Statement:</strong> <a href="https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement" rel="nofollow ugc">https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement</a></li>
</ul>


Modern Maps Lite

Add beautiful, customizable maps to any page in seconds. No API key required. Built for Gutenberg.

Store Locator Widget Block vs Modern Maps Lite