Hace unos días mi amigo Jesús Yesares me escribió para contarme que acababa de publicar un plugin en el repositorio oficial de WordPress. No era un widget cualquiera, ni un bloque decorativo de esos que saturan el directorio. Era una herramienta para construir mapas interactivos sin escribir (ni siquiera tocar) un solo shortcode.

Se llama CartoBlocks for Leaflet, y tras ver el vídeo de presentación y trastearlo en una instalación de prueba, me he dado cuenta de que es una de esas soluciones que no solo resuelven un problema técnico, sino que replantean la forma en que entendemos la relación entre el editor y el código.

Y eso merece una pausa. Y un post.

Los mapas como texto muerto

Llevo años gestionando WordPress. Tanto en mis propios proyectos como en los de clientes, los mapas siempre han sido esa funcionalidad que promete sencillez y acaba en sufrimiento. Quieres insertar un mapa con Leaflet, una librería ligera, libre y potente. El plugin Leaflet Map hace un trabajo admirable traduciendo esa potencia a shortcodes comprensibles. Pero ahí está el quid: shortcodes. Para un marcador necesitas coordenadas. Para una línea, una lista de puntos. Para un círculo, centro y radio. Todo en sintaxis específica, todo propenso a errores, todo invisible hasta que publicas o previsualizas la entrada.

El resultado es que, en la práctica, construir un mapa medianamente complejo en WordPress se convierte en una tarea de desarrollo, no de diseño o de contenido. El usuario final (el periodista, el comercial, el gestor de la web del centro estético) no puede simplemente «colocar un marcador». Tiene que entender qué es un shortcode, dónde va la latitud, si el separador es una coma o un espacio, y por qué el mapa no se ve igual en el editor que en la web pública.

Es el clásico divorcio entre la interfaz y el resultado. Y es agotador.

Gutenberg como promesa, y la promesa incumplida

Cuando WordPress apostó por Gutenberg, la promesa implícita fue que dejaríamos de escribir códigos cortos a ciegas. El bloque iba a devolvernos la inmediatez visual: lo que ves es lo que obtienes. En muchos ámbitos (párrafos, imágenes, columnas, botones) esa promesa se ha cumplido. Pero en el terreno de los mapas, la realidad ha sido más terca. Había bloques que envolvían iframes de Google Maps (con su correspondiente carga de scripts de terceros, cookies y adiós a la privacidad). Había otros que generaban mapas propietarios, encerrándote en sus ecosistemas. Y seguía habiendo un abismo entre la potencia de Leaflet (abierto, estándar, soberano) y la experiencia de edición visual que los usuarios merecían.

Jesús ha construido exactamente el puente que faltaba. Y lo ha hecho con una elegancia que me ha sorprendido.

Qué es CartoBlocks for Leaflet (y qué no es)

CartoBlocks no es un sustituto de Leaflet Map. Es fundamental entender esto: el plugin no dibuja mapas. Lo que hace es ofrecer una interfaz visual nativa de Gutenberg (un bloque con todas las de la ley) que, por debajo, genera los shortcodes estándar de Leaflet Map. Es decir, tú arrastras, haces clic, buscas una dirección, cambias colores… y CartoBlocks escribe el shortcode por ti. El frontend sigue siendo 100 % Leaflet Map. Si mañana desinstalas CartoBlocks, el mapa sigue ahí, intacto, porque el código que lo renderiza es el mismo de siempre.

Esta transparencia no es un detalle menor. Es una declaración de principios. En un ecosistema donde tantos plugins intentan acaparar tu contenido (bloques propietarios, datos en nubes ajenas, migraciones imposibles) CartoBlocks opting por ser un mero traductor visual es, cuanto menos, refrescante.

Editar como quien pinta

El flujo de trabajo es tan intuitivo que cuesta creer que nadie lo hubiera hecho antes así en WordPress. Añades el bloque «Map for Leaflet» y lo primero que ves es un mapa real, interactivo, dentro del editor. No una captura estática. No una maqueta. Es Leaflet funcionando dentro de un iframe, conectado bidireccionalmente al panel de controles.

¿Quieres centrar el mapa? Escribe una dirección en el buscador lateral (usa Nominatim, la API de geocodificación de OpenStreetMap) y selecciona entre los candidatos. O simplemente arrastra el mapa y haz zoom con la rueda del ratón. Los campos numéricos se actualizan solos. Y viceversa: si escribes unas coordenadas, el mapa salta allí.

¿Quieres un marcador? Arrástralo desde el panel al punto exacto. Quieres cambiar su icono? Puedes subir una imagen desde la biblioteca de medios, ajustar su tamaño con bloqueo de aspecto, decidir dónde ancla respecto al punto geográfico con una rejilla visual 3×3… o puedes activar el modo SVG y elegir colores de fondo y primer plano, o incluso asignar una clase CSS tipo FontAwesome. Todo sin salir del editor.

¿Y si necesitas dibujar una zona, un recorrido o un área de influencia? Círculos con dos clics (el primero marca el centro, el segundo el radio, con una guía visual), líneas y polígonos punto a punto directamente sobre el mapa. Cada vertice arrastrable. Cada figura con sus propios controles de color, opacidad, relleno, dash array y popup.

¿Capas de datos? Pega la URL de un GeoJSON, GPX o KML y configuras el estilo y los popups con plantillas que interpolan propiedades entre corchetes ([nombre], {descripción}). Incluso soporta WMS para quien trabaje con infraestructuras de datos geoespaciales profesionales, y tiene un modo «imagen plana» para usar planos de edificios o diagramas como si fueran mapas (L.CRS.Simple).

El botón <>: la honestidad hecha interfaz

De todo lo que tiene CartoBlocks, hay una funcionalidad que me ha enamorado en lo personal: el botón <> en la barra de herramientas del bloque. Al hacer clic, se abre un visor que muestra el shortcode exacto que CartoBlocks ha generado. Puedes copiarlo con un botón. Puedes estudiarlo. Puedes llevártelo a otro sitio que no use siquiera Gutenberg.

Esto es raro. La mayoría de plugins visuales quieren que olvides que debajo hay código. Quieren que dependas de su interfaz para siempre. CartoBlocks hace exactamente lo contrario: te enseña sus cartas. Te dice «mira, esto no es magia negra, es un shortcode estándar de Leaflet Map». Y eso, en mi libro, es señal de madurez técnica y de respeto por el usuario.

Requisitos y dependencias (las buenas)

CartoBlocks no es un plugin monolítico que intenta hacerlo todo. Declara abiertamente su dependencia de Leaflet Map, y desde WordPress 6.5+ el propio núcleo gestiona esa dependencia: si intentas activar CartoBlocks sin tener Leaflet Map, WordPress te guía para instalarlo primero. No hay quebras de cabeza.

Los requisitos son razonables:

• WordPress 6.8 o superior (probado hasta 7.0.2).
• PHP 7.4 o superior.

Sobre las capas de datos: si planeas subir archivos GeoJSON, GPX o KML a la biblioteca de medios, probablemente necesites un plugin adicional que permita esos MIME types, porque WordPress los bloquea por defecto. Es una limitación del core, no de CartoBlocks, y el plugin lo documenta. De hecho, el readme incluye una sección de «Known Limitations» explicando que los archivos GPX servidos con Content-Type: text/plain pueden no renderizar por una cuestión del parser upstream de Leaflet Map. Me encanta que no se oculte esto bajo la alfombra.

Privacidad y soberanía

Como alguien que gestiona cientos de sitios WordPress y que cada vez está más obsesionado con la soberanía digital, aprecio profundamente las decisiones arquitectónicas de este plugin.

La única conexión externa que realiza CartoBlocks es a Nominatim, el servicio de geocodificación de la Fundación OpenStreetMap. Y solo ocurre en el editor, solo cuando tú pulsas el botón de búsqueda. No hay tracking en el frontend. No hay llamadas automáticas. No hay mapas de Google ni de Bing ni de Apple. Solo tú, tu WordPress, y los datos abiertos de OpenStreetMap. Incluso el User-Agent que se envía a Nominatim incluye la URL de tu sitio y un email de contacto, siguiendo las directrices de uso ético de la API. No hay sorpresas.

Además, el código es abierto y está en GitHub. Puedes auditarlo, compilarlo desde las fuentes (JSX y SCSS) o simplemente leer cómo funciona. En tiempos de incertidumbre sobre qué hacen los plugins que instalamos, esto debería ser la norma, no la excepción.

Para quién es esto

Creo que CartoBlocks brilla en tres escenarios.

El primero es el usuario final no técnico que necesita un mapa en su web y quiere olvidarse de shortcodes. El segundo es el desarrollador o mantenedor de sitios (hola) que quiere entregar a sus clientes una herramienta visual robusta sin renunciar a la estabilidad y estandarización de Leaflet Map. Y el tercero, quizás el más interesante, es el creador de contenido que trabaja con datos geográficos a menudo: periodistas medioambientales, críticos de arquitectura, guías de viaje, asociaciones vecinales… gente para la que un mapa no es un gadget, es el lenguaje mismo de su relato.

La interfaz como cortesía

Hay una idea que me ronda desde que probé CartoBlocks: que las buenas herramientas no son las que más características tienen, sino las que mejor ocultan su complejidad sin ocultar su funcionamiento. Jesús ha logrado exactamente eso. Ha tomado algo potente pero hostil (los shortcodes de Leaflet Map) y ha tejido una interfaz que invita a jugar, a probar, a diseccionar. Y al mismo tiempo, te deja mirar bajo el capó si así lo deseas.

En un WordPress que a veces parece divergir hacia experiencias cada vez más cerradas y propietarias (bienvenidos sean los hosts sponsors, pero cuidado con las cadenas doradas), un plugin así es un recordatorio de que el software libre también puede ser elegante, usable y honesto.

Así que si tienes un proyecto WordPress que necesite mapas, date una vuelta por CartoBlocks for Leaflet. Echa un ojo al vídeo. Y si lo usas, deja una reseña en el repositorio. Los plugins independientes (los que no vienen respaldados por megacorporaciones) dependen de esos gestos para seguir existiendo.

Y Jesús: enhorabuena. Esto es trabajo bien hecho.

Últimas entradas