Description
Cartaveo Maps embeds a map collection from the Cartaveo service into any post
or page, via a Gutenberg block or the [cartaveo collection="your-slug"]
shortcode. On collections with open contribution, your readers can submit
new places — submissions are captcha-protected and held for your
moderation on Cartaveo. Beneath the map, the plugin renders a crawlable list of the collection’s
entries — each one a link to its page, with its category and a description
snippet — plus schema.org ItemList/Place structured data. The embedded
map itself is served noindex, so this list is what search engines actually
read about your map.
The block and the shortcode both accept theme (light, dark or auto,
which follows each reader’s own setting) and accent (a hex colour that
tints the map’s links and its selected pin), so the map can be made to sit
with your theme rather than against it. An accent that would be unreadable
on the map’s background is ignored for text and kept only for the pin.
This plugin relies on the Cartaveo service to work — see the “External
services” section below for exactly what is sent, when, and under which
terms.
External services
This plugin connects to Cartaveo (https://cartaveo.com), the collaborative
mapping service the embedded collections live on. It is needed to render the
map itself and to fetch the collection’s entries for the crawlable list
under it. If you run your own Cartaveo instance, the plugin talks to your
configured base URL instead; everything below then applies to your instance
rather than the hosted service.
What is sent, and when:
- When a post containing the block or shortcode is rendered, your web
server requests the collection’s public entries from the Cartaveo API to
build the entry list. Only the collection’s identifier is sent, and the
response is cached for an hour, so this is not a per-visit request. - In your visitors’ browsers, the embed loader script and the map iframe
load from Cartaveo. Those requests include your site’s hostname and the
plugin’s version, which Cartaveo uses for aggregate embed-usage
statistics; as with any web request, Cartaveo’s server also sees the
visitor’s IP address and user agent. - The plugin sends no visitor personal data, no account data and no
cookies. If a visitor chooses to submit a place on an open collection,
they do so inside the map iframe, directly with Cartaveo.
This service is provided by Cartaveo:
terms of use (https://cartaveo.com/terms),
privacy policy (https://cartaveo.com/privacy).
Screenshots
Blocks
This plugin provides 1 block.
- Cartaveo Map Embed a collaborative Cartaveo map collection.
Installation
- Install and activate the plugin.
- Create a collection on Cartaveo and copy its slug.
- Add the “Cartaveo Map” block (or the
[cartaveo]shortcode) to a post and paste the slug.
FAQ
-
Does it cost anything, or do I need an API key?
-
No. The plugin is free and GPL-licensed, and creating and moderating
collections on Cartaveo is free too. There’s no API key to configure — just
a collection slug. -
Do readers need a Cartaveo account to add a place?
-
No. If you’ve set the collection’s contribution to open, anyone can submit a
new place with a quick captcha check. Nothing shows up on your map until you
approve it on Cartaveo. -
How does moderation work?
-
You choose how open a collection is on Cartaveo: closed, invite-only, or
open to anyone. On a moderated collection, submissions sit in your
moderation queue there until you approve or reject them — nothing a reader
submits appears on your site automatically. -
Who owns the map data?
-
You do. The collection lives on your own Cartaveo account, the same as any
collection you create there. The plugin only embeds it. -
Can the map match my theme?
-
Yes. Both the block and the
[cartaveo]shortcode take a colour scheme
(light, dark, or auto, which follows each reader’s own light/dark setting)
and an accent colour that tints the map’s links and its selected pin. An
accent that would be unreadable against the map’s background is dropped for
text and kept only on the pin, so a bad hex value can’t make the map hard to
read. -
Will it slow down my site?
-
The map itself loads lazily in an iframe, and the entry list under it is
cached for an hour, so there’s no heavy JavaScript added to your theme and
no per-visit round trip to Cartaveo’s API. -
How do I install it?
-
The usual way: search for “Cartaveo Maps” under Plugins Add New, or
upload the zip, then activate it. There’s nothing to configure to get
started — create a collection on Cartaveo, copy its slug, and add the
Cartaveo Map block or the[cartaveo]shortcode to a post.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Cartaveo Maps” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Cartaveo 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.5.4
- The embed loader script is now registered and enqueued through
WordPress’s script API instead of being printed as a raw script tag, and
is loaded once per page however many maps a post embeds. - The readme now carries a full “External services” section: what is sent
to Cartaveo, when, and links to the service’s terms and privacy policy.
0.5.3
- Internal only: corrected a code-standards ignore comment’s placement so
WordPress.org’s automated Plugin Check tool actually reads it.
0.5.2
- Removed the Update URI header added in 0.4.0 — WordPress.org’s Plugin
Check flags it as a hard rejection reason for hosted plugins, since their
own listing is meant to be the sole update authority.
0.5.1
- The accent colour help text now says to click a pin in the preview to see
it — its only visible effect is on a clicked pin, which wasn’t obvious.
0.5.0
- Added a corner radius setting (block and shortcode) that rounds the map’s
frame and the “Add a place” button to match your theme. - Added a “show place list” toggle — off collapses it behind a “Show places”
disclosure instead of removing it, so it still reaches search engines. - The block now supports wide and full alignment.
- Fixed the map not filling its full column width in the block editor.
- Fixed the accent colour setting never being visible to preview in the
block editor.
0.4.0
- Hardened outgoing requests to the configured Cartaveo base URL so they can
no longer be pointed at an internal or loopback address on your server. - Added an Update URI to the plugin header so self-hosted installs only ever
check cartaveo.com for updates, never a same-named WordPress.org listing. - Deleting the plugin now also removes its stored settings and cached entry
lists, rather than leaving them behind in the database.
0.3.0
- The entry list now links each place to its page on Cartaveo and carries its
category and description. Previously it printed bare, unlinked names. - Added schema.org
ItemList/Placestructured data, with coordinates. - Added the plugin’s own stylesheet, so the entry list no longer inherits the
host theme’s list bullets and indents. - Lists longer than ten places put the remainder behind a disclosure; every
place stays in the HTML source. - The block editor now looks the collection up as you type, tells you when a
slug doesn’t resolve, and shows a live preview of the map before you
publish. - New
themeandaccentattributes on both the block and the shortcode.
0.2.0
- Renamed the block and shortcode attribute
datasettocollection, matching
Cartaveo’s own wording. The old name still works, so existing embeds keep
rendering. - Fixed the settings page link to Cartaveo’s “create a collection” page.
0.1.0
- Initial release: block, shortcode, crawlable entry list, settings page.