Title: Cartaveo Maps
Author: Cartaveo
Published: <strong>Ọwẹ́wẹ̀  2, 2026</strong>
Last modified: Ọwẹ́wẹ̀  16, 2026

---

Ṣàwárí àwọn plugin

![](https://ps.w.org/cartaveo-maps/assets/banner-772x250.png?rev=3678147)

![](https://ps.w.org/cartaveo-maps/assets/icon-256x256.png?rev=3678147)

# Cartaveo Maps

 Láti ọwọ́ [Cartaveo](https://profiles.wordpress.org/cartaveo/)

[Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/cartaveo-maps.0.6.1.zip)

[Àkọ́kọ́wò Láaye](https://yor.wordpress.org/plugins/cartaveo-maps/?preview=1)

 * [Àwọn àlàyé](https://yor.wordpress.org/plugins/cartaveo-maps/#description)
 * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/cartaveo-maps/#reviews)
 *  [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/cartaveo-maps/#installation)
 * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/cartaveo-maps/#developers)

 [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/cartaveo-maps/)

## Àpèjúwe

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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s own setting), `basemap` (`minimal`, `streets`,
midnight or `tinted` — the map drawn under the pins) and `accent` (a hex colour 
that tints the mapÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s public entries from the Cartaveo API to build
   the entry list. Only the collectionÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s hostname and
   the pluginÌtumọ̀ Yorùbá: ’s version, which Cartaveo uses for aggregate embed-
   usage statistics; as with any web request, CartaveoÌtumọ̀ Yorùbá: ’s server also
   sees the visitorÌtumọ̀ Yorùbá: ’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).

The map inside the iframe draws its basemap tiles from OpenFreeMap
 (https://openfreemap.
org), a free tile service run by Hyperknot Software Kft. Cartaveo does not proxy
them, so your visitors’ browsers request the map style and its tiles from OpenFreeMap
directly as they pan and zoom. Those requests carry the visitorÌtumọ̀ Yorùbá: ’s
IP address and user agent, as any web request does, and the referring page. OpenFreeMap
needs no API key and states that it keeps no user accounts, sets no cookies and 
does not store IP addresses in its regular logs.

This service is provided by Hyperknot Software Kft.:
 terms of service (https://
openfreemap.org/tos/), privacy policy (https://openfreemap.org/privacy/).

## Àwọn àwòrán ìbòjú

[⌊The block editor: paste a collection's slug and it looks the collection up
as 
you type, then shows a live map preview before you publish.⌉⌊The block editor: paste
a collection's slug and it looks the collection up
as you type, then shows a live
map preview before you publish.⌉[

The block editor: paste a collectionÌtumọ̀ Yorùbá: ’s slug and it looks the collection
up as you type, then shows a live map preview before you publish.

[⌊The block's Appearance panel: colour scheme (light, dark or auto) and an
accent
colour that tints the map's links and selected pin.⌉⌊The block's Appearance panel:
colour scheme (light, dark or auto) and an
accent colour that tints the map's links
and selected pin.⌉[

The blockÌtumọ̀ Yorùbá: ’s Appearance panel: colour scheme (light, dark or auto)
and an accent colour that tints the mapÌtumọ̀ Yorùbá: ’s links and selected pin.

[⌊A published post: the embedded map with the crawlable entry list — each
place 
linked, with its category and a description snippet — rendered
underneath it.⌉⌊A
published post: the embedded map with the crawlable entry list — each
place linked,
with its category and a description snippet — rendered
underneath it.⌉[

A published post: the embedded map with the crawlable entry list — each place linked,
with its category and a description snippet — rendered underneath it.

[⌊The plugin's settings page, where you point it at your Cartaveo base URL.⌉⌊The
plugin's settings page, where you point it at your Cartaveo base URL.⌉[

The pluginÌtumọ̀ Yorùbá: ’s settings page, where you point it at your Cartaveo base
URL.

## Àwọn ìdí

Plugin yìí pèsè 1 ìdí.

 *   Cartaveo Map Embed a collaborative Cartaveo map collection.

## Ìgbéwọlẹ̀

 1. Install and activate the plugin.
 2. Create a collection on Cartaveo and copy its slug.
 3. 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Ìtumọ̀ Yorùbá: ’s no API key to configure — just a
collection slug.

### Do readers need a Cartaveo account to add a place?

No. If youÌtumọ̀ Yorùbá: ’ve set the collectionÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s own light/dark setting)
and an accent colour that tints the mapÌtumọ̀ Yorùbá: ’s links and its selected 
pin. An accent that would be unreadable against the mapÌtumọ̀ Yorùbá: ’s background
is dropped for text and kept only on the pin, so a bad hex value canÌtumọ̀ Yorùbá:’
t make the map hard to read.

### Can I change the map itself, not just the colours around it?

Yes, with the Basemap setting. Minimal is the default: a pale grey map, or
 a slate
one under a dark colour scheme, so the pins carry the colour. Streets is a full-
colour map — green parks, blue water, named roads. Midnight is near-black whichever
colour scheme you picked, with white pins to suit it. Tinted is the default map 
recoloured to your accent colour — every shade of it pushed onto your hue, with 
the mapÌtumọ̀ Yorùbá: ’s own light and dark left where they were, so it stays as
readable as the grey one. The colour scheme dresses the frame around the map; the
basemap is the map, and the two are set independently.

### 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Ìtumọ̀ Yorùbá: ’s no heavy JavaScript added to your theme and
no per-visit round trip to CartaveoÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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.

## Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

## Àwọn Olùkópa & Olùgbéejáde

“Cartaveo Maps” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa
sí plugin yìí.

Àwọn Olùkópa

 *   [ Cartaveo ](https://profiles.wordpress.org/cartaveo/)
 *   [ yazzine013 ](https://profiles.wordpress.org/yazzine013/)

[Túmọ̀ “Cartaveo Maps” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/cartaveo-maps)

### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

[Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/cartaveo-maps/), ṣàyẹ̀wò
[ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/cartaveo-maps/), tàbí ṣe àgbékalẹ̀
sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/cartaveo-maps/) 
nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/cartaveo-maps/?limit=100&mode=stop_on_copy&format=rss).

## Àkọsílẹ̀ àwọn àyípadà

#### 0.6.1

 * Readme only, no code change: the “External services” section now also
    declares
   OpenFreeMap, which serves the mapÌtumọ̀ Yorùbá: ’s basemap tiles straight to 
   your visitors’ browsers. It was missing, and the section is meant to name every
   service the plugin causes a visitor to contact.

#### 0.6.0

 * New Basemap setting (block and shortcode): Minimal, the pale default;
    Streets,
   a full-colour map with parks, water and named roads; Midnight, near-black under
   either colour scheme; or Tinted, the default map recoloured to your accent colour.
 * The map pins now take their light or dark treatment from the map they sit
    on
   rather than from the colour scheme, so a dark basemap inside a light page still
   shows its pins.

#### 0.5.4

 * The embed loader script is now registered and enqueued through
    WordPressÌtumọ̀
   Yorùbá: ’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Ìtumọ̀ Yorùbá: ’s terms and privacy policy.

#### 0.5.3

 * Internal only: corrected a code-standards ignore commentÌtumọ̀ Yorùbá: ’s placement
   so
    WordPress.orgÌtumọ̀ Yorùbá: ’s automated Plugin Check tool actually reads
   it.

#### 0.5.2

 * Removed the Update URI header added in 0.4.0 — WordPress.orgÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’t obvious.

#### 0.5.0

 * Added a corner radius setting (block and shortcode) that rounds the mapÌtumọ̀
   Yorùbá: ’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`/`Place` structured data, with coordinates.
 * Added the pluginÌtumọ̀ Yorùbá: ’s own stylesheet, so the entry list no longer
   inherits the
    host themeÌtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’t resolve, and shows a live preview of the map before you
   publish.
 * New `theme` and `accent` attributes on both the block and the shortcode.

#### 0.2.0

 * Renamed the block and shortcode attribute `dataset` to `collection`, matching
   
   CartaveoÌtumọ̀ Yorùbá: ’s own wording. The old name still works, so existing 
   embeds keep rendering.
 * Fixed the settings page link to CartaveoÌtumọ̀ Yorùbá: ’s “create a collection”
   page.

#### 0.1.0

 * Initial release: block, shortcode, crawlable entry list, settings page.

## Àkójọpọ̀ Meta

 *  Ẹ̀yà **0.6.1**
 *  Ìgbàgbọ́hùn tó kẹ́yìn **wákàtí 9 sẹ́yìn**
 *  Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **Tó kéré sí 10**
 *  Ẹ̀yà WordPress ** 6.5 tàbí ju bẹ́ẹ̀ lọ **
 *  Dánwò dé **7.1**
 *  Ẹ̀yà PHP ** 7.4 tàbí ju bẹ́ẹ̀ lọ **
 *  Èdè
 * [English (US)](https://wordpress.org/plugins/cartaveo-maps/)
 * Àwọn àmì
 * [community map](https://yor.wordpress.org/plugins/tags/community-map/)[embed](https://yor.wordpress.org/plugins/tags/embed/)
   [geo](https://yor.wordpress.org/plugins/tags/geo/)[map](https://yor.wordpress.org/plugins/tags/map/)
 *  [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/cartaveo-maps/advanced/)

## Àwọn ìbò

Kò sí ìwádìí tí a tíì fi ránṣẹ́.

[Your review](https://wordpress.org/support/plugin/cartaveo-maps/reviews/#new-post)

[Wo gbogbo àwọn àgbéyẹ̀wò](https://wordpress.org/support/plugin/cartaveo-maps/reviews/)

## Àwọn Olùkópa

 *   [ Cartaveo ](https://profiles.wordpress.org/cartaveo/)
 *   [ yazzine013 ](https://profiles.wordpress.org/yazzine013/)

## Ìrànlọ́wọ́

Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́?

 [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/cartaveo-maps/)