Mentora Maps

Description

Mentora Maps puts your shops, restaurants, clinics or partners on a map, with a list beside it that
stays in step: click a marker, the list follows; click an entry, the map goes there.

It runs on OpenStreetMap through Leaflet. That means no API key to get, no credit card to leave, no
quota to watch
, and nothing to re-do the day a provider changes its prices.

What an activity holds

  • Name, description, address with postcode, town, province and country
  • Coordinates, found from the address or set by dragging the marker
  • Phone, mobile with WhatsApp, email, website
  • Opening hours, with today’s “open now” worked out in the reader’s browser
  • Photos, videos and documents, and social profiles: as many as you need
  • Links and documents: menu, bookings, a price list, a PDF — each one to an address or to a file
  • A category with its own icon and colour

On the page

  • Map and list side by side, the map on the left or on the right, or the map on its own
  • Markers grouped when there are many, single when there are few
  • Light, standard and dark views of the map
  • Detail in a popup on the map, in a panel over the list, or as a sheet that rises from the bottom on
    phones, with three heights
  • A page of its own for every activity, if you want one
  • Search and filters above the list: by name, address, category, town, country, and “open now”
  • Colours, corners, shadows and motion, from a panel with a live preview
  • Shortcodes and a Gutenberg block

It stays yours

  • No limits on what is here: activities, photos, videos, documents, links and social profiles
  • Uninstalling leaves your activities alone unless you say otherwise
  • No account, no key, no call home

What Mentora Maps Pro adds

The free plugin is a whole map, not a demo, and what is in it has no limits. Pro is a separate
plugin that adds things this one does not do:

  • Import from CSV, WP Go Maps and Google Business, export to CSV and JSON, and scheduled sync
  • “Where I am”, with the distances, the distance filter and sorting by distance
  • The whole card: the full week of opening hours, reviews with stars, custom fields of your own
  • Accounts for your readers: saved places, reviews, notifications
  • Heatmap, satellite, map styles, the scale bar, and routes with distance and time
  • Backgrounds, typefaces and a size for every element, and all the layouts
  • The activity’s name written on the cover, instead of where your theme puts it
  • Statistics of your own, and the badge removed

The comparison, line by line, is inside the plugin under Activities Pro.

What it talks to

One thing only, and it waits for consent: the map images come from OpenStreetMap. Everything else —
sharing a place on WhatsApp or Telegram, opening directions in Apple or Google Maps — happens when
your reader clicks, not before. The External services section below says exactly what is sent,
to whom, and when.

What this plugin does not do

It does not phone home, does not collect statistics, and never asks your readers where they are —
there is no “where I am” button in this version, so the question is never put. It does not send
anything about them anywhere.

External services

This plugin connects to the services below. Two of them are contacted on their own — the map tiles,
by your reader’s browser, and the address lookup, by your site while you fill in an activity. All
the others are links: nothing is requested until somebody clicks one, and what travels is what
is written in the link.

OpenStreetMap tiles (tile.openstreetmap.org) — the map images themselves. Requested by the
browser of whoever is looking at a page with a map on it, which means their IP address and the area
of the map they are looking at reach the tile servers. This is the only service a reader’s browser
contacts by itself, and for that reason the map waits for cookie consent where a consent banner
is installed (Complianz and iubenda are recognised): before consent it shows a notice instead of
loading anything.
Terms: https://operations.osmfoundation.org/policies/tiles/
Privacy: https://osmfoundation.org/wiki/Privacy_Policy

Nominatim (nominatim.openstreetmap.org) — turns an address into coordinates, and coordinates
back into an address. Called by your site, from the administration only, while you are filling in
an activity or moving its pin: the address you typed, or the coordinates of the pin, are what gets
sent. Never called for your readers, and never on a public page.
Terms: https://operations.osmfoundation.org/policies/nominatim/
Privacy: https://osmfoundation.org/wiki/Privacy_Policy

WhatsApp (api.whatsapp.com, wa.me) — two links, and only if you turn them on. «Share» opens
WhatsApp with the name and the address of the page already written in the message; «WhatsApp» next
to a phone number opens a chat with that number. Nothing is sent until your reader clicks, and
nothing about your reader is added to the link.
Terms: https://www.whatsapp.com/legal/terms-of-service
Privacy: https://www.whatsapp.com/legal/privacy-policy

Telegram (t.me) — the same two cases: «Share» opens Telegram with the address of the page and
the name of the activity, and the contact link opens the chat of the username the activity has.
On click only.
Terms: https://telegram.org/tos
Privacy: https://telegram.org/privacy

Apple Maps (maps.apple.com) — the «Directions» link, when the reader’s device is an Apple one.
It carries the coordinates of the activity and its name, and it opens when clicked.
Terms: https://www.apple.com/legal/internet-services/maps/terms-en.html
Privacy: https://www.apple.com/legal/privacy/

Google Maps (www.google.com/maps) — the same «Directions» link on everything else, with the
same coordinates and name. On click only.
Terms: https://www.google.com/intl/en/help/terms_maps/
Privacy: https://policies.google.com/privacy

The social buttons of an activity — Facebook, Instagram, X, LinkedIn and the others — are plain
links to the addresses you typed in that activity. This plugin writes nothing into them and
contacts nothing: they are listed here only so that the picture is complete.

Services Mentora Maps Pro can reach

This package does not contain the code that talks to any of them. Satellite imagery, street
routing, Adobe Fonts, Google Fonts and the FontAwesome Kit live in the Mentora Maps Pro add-on,
which is not distributed here, and each is named in full in that plugin’s own readme. Installing
this one gives your readers’ browsers exactly one destination outside your site: OpenStreetMap, for
the map images, after they have accepted cookies.

Screenshots

Installation

  1. Upload the plugin through Plugins Add new Upload, or copy the folder into wp-content/plugins.
  2. Activate it.
  3. Go to Activities Add activity, write an address and press the button that looks it up.
  4. Put [mentora_map] in a page, or use the Activities map block.

That is the whole setup. There is no account to create and no key to paste.

FAQ

It says my site needs PHP 8.2. Why?

Because PHP 8.1 and everything before it stopped getting security fixes, and in October 2026 PHP had
two flaws that let somebody run code on a server without signing in at all. They were fixed from 8.2
onwards; older versions were left as they were, and they will stay that way. This plugin holds the
names, phone numbers and email addresses of real businesses, so it does not tell WordPress it is fine
on a version of PHP with a known hole and no patch. Your host can usually move you to a newer PHP
from the control panel, and it costs nothing — most of them have done it already.

Do I need a Google Maps key?

No. The map is OpenStreetMap through Leaflet, and neither needs a key or a card.

Will the map work with my cookie banner?

Yes. Complianz and iubenda are recognised: until the reader accepts, the map shows a notice and loads
nothing at all — not a single tile. Which consent it waits for is up to you: Settings Map and list
“Waits for consent to” holds the category your banner files map tiles under, because banners do not
agree on that one — many sites count a map as a necessary service and put it among the functional ones,
where consent is granted to everybody. Check a page the way a visitor sees it, not the preview in here:
in the admin there is no banner, so the map always draws. With no banner at all the map loads straight
away, and the mentora_maps_consent_category filter still overrides the setting.

Where do the coordinates come from?

From the address, looked up with Nominatim while you are editing. You can also drag the marker, and the
address fields follow it.

How many activities can the free version publish?

As many as you like. There is no limit here, and there is none on photos, videos, documents or social
profiles either: what this plugin does, it does all the way. Up to version 0.28.0 it published twenty
and saved the rest as drafts; that limit is gone, and anything it had paused comes back online by
itself when you update.

Can I bring in what I have in another plugin?

If it exports a CSV, yes, with Mentora Maps Pro. The import shows you the first rows of your file,
lets you say which column is what, and runs a dry run before writing anything, and there are
ready-made column profiles for WP Go Maps and Google Business. None of that code is in this free
plugin: the «Get Pro» page tells you what it does, and the add-on brings it with it.

Does each activity get its own page?

Only if you turn it on, and it is off by default: a site full of pages with two lines inside does more
harm than good. The settings tell you how many of your activities have enough inside to deserve one.

Does it work with my theme?

It should, including block themes. The activity page is not a template of ours fighting yours: it goes
inside your theme’s content, with your header, your footer and your widths.

There is a small badge on my map. Can I remove it?

Yes, and the plugin tells you about it the moment you activate it, with a button that removes the link
right there. The badge sits in a corner of the map, next to the OpenStreetMap credit: in the free
version it carries our name and a link to our site, which is how the plugin gets found. You can keep the
name without the link at any time in Settings Map and list Our badge. Removing the badge
altogether is part of Pro.

Is it translated?

The plugin is written in English and ships with an Italian translation.

Does it work with a multilingual site?

Yes. Your activities are an ordinary custom post type and the categories an ordinary taxonomy, so
WPML, Polylang and TranslatePress all see them once you switch them on in their own settings. The
plugin ships a wpml-config.xml, which WPML and Polylang read, so they already know what to do with
each field: the address, the town and the labels of your links are copied when a translation is
created and are then yours to change, while the coordinates, the phone numbers, the opening hours
and the photos stay identical in every language. Ratings and statistics are left alone, so one
language never overwrites another’s.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Mentora Maps” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Mentora Maps” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.32.0

  • The badge on your maps. This plugin offers two choices — the name with a link, or the name
    alone — and the code that removed it altogether is no longer part of it. If you have Mentora Maps
    Pro and had chosen to remove the badge, update Pro to 0.23.0 first: that choice now lives
    there. Until you do, your maps show the name alone.
  • Cropper.js updated to 2.3.1 and pdf.js to 6.5.438, the current stable releases of both. The
    crop window for the profile and cover images works as before — pick the frame, rotate a quarter
    turn, save — and the cropping itself still happens on your server, on a copy, leaving the original
    in your media library. Leaflet 1.9.4 and MarkerCluster 1.5.3 were already current and are
    unchanged.
  • Field values are cleaned by this plugin before any extension refines them, and whatever an
    extension hands back is checked again before it is saved.

0.31.1

  • The plugin header, the licence and the translation template now carry the current company name,
    Mentora Labs. Nothing else changed: same files, same behaviour.

0.31.0

  • The Pro page under Activities is now two plain lists — what this plugin does, and what the
    separate Pro plugin adds — instead of a three-column table with a red cross on every line this
    plugin does not do. Same information, and the half that was missing is now written down: what you
    already have, with no limits.

Older versions are listed in changelog.txt, next to this file.