Mapkeep – Privacy Store Locator

By buildingit

0+ active installationsVersion 1.2.1

Privacy-friendly store locator with OpenStreetMap. No Google Maps, no API keys, no tracking, no external scripts.

Description

Mapkeep – Privacy Store Locator shows your shops, dealers, offices or pick-up points on an interactive map with a searchable list – without sending your visitors’ data to Google or anyone else.

Why this plugin

  • No API key, no credit card. Maps come from OpenStreetMap. Install, add locations, done.
  • Privacy by design. No cookies, no tracking, no fonts or scripts from third parties. All JavaScript and CSS is served from your own site.
  • Address search that keeps visitors anonymous. When a visitor searches for a city or postcode, the request goes from your server to OpenStreetMap Nominatim – the visitor’s IP address never leaves your site. Results are cached. This is opt-in for the site owner.
  • Security hardened. Nonces, capability checks, output escaping, rate limiting, anonymised security log, and a clean uninstall that removes everything.
  • Works with any theme. Five layouts — floating panel over a full-bleed map (right or left) or classic list layouts — with wide/full alignment and fluid widths.

Features (free)

  • Unlimited locations, added manually (address, region, country, coordinates, phone, e-mail, website, opening hours, logo)
  • Locations dashboard: search, filter by country, toggle publish/draft, edit in a side panel
  • “Fetch coordinates from address” button – no more looking up latitude/longitude by hand
  • “Use my location” button – browser geolocation, only after the visitor allows it; the coordinate never leaves the browser
  • Map with marker clustering; country filter chips built automatically from your locations, or a list grouped by country and region
  • Search by name, city or postcode; optional address/distance search (“nearest locations”)
  • Direct links to a filtered map: ?country=nl or ?region=north-holland
  • Layouts: panel-right (default), panel-left, list-left, list-right, list-below; align="wide|full"
  • Gutenberg block and Elementor widget with the same options as the shortcode
  • Privacy report: one screen that shows which external services your current settings contact, and from where
  • Optional schema.org LocalBusiness markup (JSON-LD) for your locations
  • Translation-ready (English source; translations via translate.wordpress.org)
  • Privacy policy text suggestion for your Privacy Policy page

Pro (separate purchase, coming soon)

CSV import, categories & filters, multiple maps with different settings, statistics stored on your own server, white-label options, priority support.

Shortcode

[privacy_store_locator]

Attributes: layout="panel-right|panel-left|list-left|list-right|list-below", align="wide|full|content", height="600", eyebrow="Store locator", title="Find a store near you", chips="1", country="NL", search="1", geolocate="1", show_phone="1", show_email="0", pin="#8A3FFC", cluster="1", zoom="6", center="52.1,5.3".

Privacy

This plugin does not collect or send personal data by itself. Third-party services involved:

  • OpenStreetMap tiles (tile.openstreetmap.org) – loaded by the visitor’s browser. Privacy policy
  • OpenStreetMap Nominatim (nominatim.openstreetmap.org) – only when the site owner enables address search; contacted server-to-server, visitor IPs are not shared. Usage policy

Rate limiting stores request counts per hashed IP for a few minutes. The optional security log stores hashed IPs and is purged after 30 days.

Installation

  1. Upload the plugin to /wp-content/plugins/ or install it via Plugins → Add New.
  2. Activate it.
  3. Go to Locations → Add New and add your first location. Use Fetch coordinates from address to fill in latitude/longitude.
  4. Put [privacy_store_locator] on a page.
  5. Optional: Locations → Settings to enable address search, set radius, and configure privacy options.

FAQ

Do I need a Google Maps API key?

No. Maps are provided by OpenStreetMap; no key, no billing account.

What data is sent to third parties?

Map tiles are loaded by the visitor’s browser from OpenStreetMap tile servers (as with any image on the web). If you enable address search, the search text is sent from your server to OpenStreetMap Nominatim; visitor IP addresses are never shared. Nothing else leaves your site. See the plugin’s suggested privacy policy text under Settings → Privacy → Policy Guide.

Does it set cookies or track visitors?

No. Optionally it can push events (search, click) to an analytics tool you already run on your site (dataLayer/gtag). This is a setting, off by default, and does not load any script.

Can I import locations from a CSV file?

CSV import is part of the Pro version.

Can visitors search by postcode or city?

Yes. Search first matches your own locations (name, city, postcode). If you enable address search in the settings, unknown places are geocoded and the nearest locations within your chosen radius are shown with distances.

How do I link to a filtered map from my menu?

Add ?country=de or ?region=bavaria to the URL of the page containing the shortcode. Region matches the “Region” field of your locations.

Which map style is used?

The standard OpenStreetMap style, rendered in greyscale so your pins stand out. Developers can change this via CSS.

Does it work with page builders?

Yes. There is a block for the block editor (“Store Locator”) and a widget for Elementor; both have the same options as the shortcode. The shortcode works in any other builder. If your builder renders the shortcode outside the post content, use the psloc_enqueue_assets filter to force-load the assets.

My site is behind Cloudflare or a load balancer. Do I need to change anything?

The rate limiter uses the address of the direct connection. Behind Cloudflare, a proxy or a load balancer that is the address of that service, so choose the matching option under Locations → Settings → Privacy & data → Visitor address for rate limiting.

What happens when I delete the plugin?

By default all locations, settings, logs and caches are removed. You can switch this off in the settings before deleting.

Screenshots

Changelog

1.2.1

  • The free version and Pro can no longer be active at the same time: the plugin switches the second copy off with a notice instead of failing.
  • Deleting one copy of the plugin while another copy is active keeps your locations and settings.

1.2.0

  • New: Gutenberg block “Store Locator” and Elementor widget, with the same options as the shortcode.
  • New: Privacy report (Locations → Privacy report) shows which external services your current settings contact.
  • New: setting for schema.org LocalBusiness markup (JSON-LD), off by default.
  • Privacy: the optional analytics events (dataLayer/gtag) are now off by default. Site owners can turn them on in the settings.
  • Security: the rate limiter no longer trusts forwarding headers sent by the visitor. Sites behind Cloudflare or a proxy can select that under Settings → Privacy & data.
  • Security: site-wide limit on outgoing address lookups, in line with the Nominatim usage policy.
  • Security: phone numbers stay hidden when a request does not carry the signed map settings.
  • Security: users without publishing rights (Contributors) submit locations for review instead of publishing them.
  • Security: public REST requests no longer write rows to the security log.
  • Fix: rate-limit window now ends 60 seconds after its first request.
  • Fix: remaining untranslatable texts in the map, the dashboard and the security log are now translatable.

1.1.0

  • New default layout “panel-right”: full-bleed map with a floating panel (heading, search, country filter chips, card list, primary “Use my location” button with privacy note). Layouts “panel-left” and the classic list layouts remain available via the layout attribute.
  • Country filter chips, built automatically from your locations (shown when locations span two or more countries).
  • Round dot map markers; new eyebrow/title shortcode attributes.

1.0.0

  • Initial release.