b-ods-display es el plugin de visualización frontend más rico del ecosistema ODSLocal. Ofrece 11 shortcodes para construir dashboards completos con tarjetas ODS oficiales, comparativas, buscadores, mapas y embed generator.
Reescrito desde cero sobre la arquitectura ODSLocal pero conservando el lenguaje visual del plugin histórico b-ods-display.
2. Instalación
Requiere ODSLocal Municipios activo con territorios y mediciones poblados.
Copia b-ods-display/ a wp-content/plugins/.
Actívalo. Sin ajustes obligatorios.
Pega los shortcodes donde necesites.
ℹ Assets condicionales
El plugin sólo carga CSS/JS en las páginas que contienen un shortcode suyo (filtro bdw_display_load_assets). No penaliza el resto del sitio.
3. Los 11 shortcodes
Shortcode
Propósito
Por favor, especifica un municipio.
Ficha completa de un municipio.
Comparación de Municipios
Año de referencia: 2026
Cargando datos de comparación...
Comparativa entre municipios para un indicador.
Cargando datos…
Mapa temático de un ODS.
ODS 0
ODS 0
…
Tarjeta oficial de un ODS para un municipio y año.
España
country
Mostrando el dato más reciente disponible para cada indicador.
Cumplimiento de Metas
Top 3 - Mejor Desempeño
Top 3 - Atención Necesaria
Evolución del Cumplimiento
Nombre
% Cumplimiento
Verde
Amarillo
Rojo
Sin datos
Cargando ranking...
Selecciona primero un grupo ODS para habilitar esta lista.
BuenoMedioAlertaSin dato
Cargando datos…
Dashboard agregado país/CCAA/provincia/municipio.
Comparador Avanzado de Municipios
Compara indicadores entre múltiples municipios
Selección de Municipios
Añade hasta ocho municipios para comparar su desempeño en un indicador o seguir su evolución temporal.
Máximo 8 municipios
Configuración
→
Selecciona municipios y un indicador para comparar.
UI interactiva de comparación (selector dinámico).
Indicador no encontrado.
Indicador único con histórico y desglose.
Debes iniciar sesión para cargar datos.
Portal de entrada tipo hero con CTAs.
Buscar en la plataforma ODS
Encuentra municipios, indicadores y objetivos ODS.
🔍
Escribe al menos 2 caracteres para buscar.
Buscador global (municipio + indicador + ODS).
Alertas y Notificaciones
Seguimiento visual de cambios relevantes en indicadores ODS.
!
Centro de alertas preparado
La interfaz ya está lista para mostrar avisos de mediciones pendientes, cambios de estado y variaciones relevantes cuando se active el motor de alertas.
Indicadores sin datos recientes.
ODS con cambios significativos respecto al año anterior.
Avisos de revisión para equipos municipales.
Panel de alertas y umbrales de un municipio.
Generador de Widget Embed
Crea un widget embebible para tu sitio web
Vista previa
Selecciona un municipio para ver la vista previa.
Código para copiar
Generador de iframe embebible para terceros.
Atributos comunes
Atributo
Dónde aplica
location_id
ID interno del territorio.
code_ine
Alternativa: código INE. Si ambos presentes, gana location_id.
year
Año de las mediciones. Por defecto el actual.
level
Dashboard: country / ccaa / province / municipality.
Este porcentaje se calcula sobre el total de indicadores disponibles para cada ODS. Los indicadores sin dato se contabilizan como 0 % (no cumplimiento).
Para cada indicador con dato, se compara el valor del municipio con los umbrales establecidos y se asigna una puntuación:
Cumplimiento — mejor que el umbral verde (100 puntos)
Incumplimiento leve — entre el umbral verde y el medio (60 puntos)
Incumplimiento grave — entre el umbral medio y el rojo (40 puntos)
Incumplimiento muy grave — peor que el umbral rojo (20 puntos)
Sin dato — 0 puntos (penaliza el cumplimiento)
El porcentaje de cada ODS es la media de las puntuaciones de TODOS sus indicadores disponibles (los indicadores sin dato cuentan como 0). El cumplimiento global es la media de los 17 ODS.
Ejemplo: si un ODS tiene 10 indicadores y solo 3 están rellenados y en verde, el cumplimiento es (100×3)/10 = 30 %. Cargar más datos hace subir el porcentaje.
Resumen por ODS
Indicadores
Cargando...
Información demográfica
Población total
294.489 hab.
Año 2025
Población mujeres
155.787 hab.
Año 2025
Población hombres
138.702 hab.
Año 2025
Edad media de la población (años)
46,5 años
Año 2023
Población menor de 18 años (%)
14,4 %
Año 2023
Población de 65 y más años (%)
24,3 %
Año 2023
Renta neta media por hogar (€)
38.846 €
Año 2023
Renta media por persona (€)
15.359 €
Año 2023
Tamaño medio del hogar (personas)
2,5 personas
Año 2023
Hogares unipersonales (%)
28,9 %
Año 2023
Renta media neta anual por habitante (€)
15.359
Año 2023
Tasa de pobreza extrema (% bajo 40% mediana)
7,9
Año 2023
Evolución Demográfica
Cargando datos demográficos…
Comparador de municipios
Tipo de dato
Añade hasta 8 municipios para compararlos.
Ranking de municipios
Tipo de dato
Selecciona un indicador para ver el ranking.
<!-- Tarjeta ODS3 para Madrid -->
ODS 3
Salud y bienestar
…
<!-- Dashboard país -->
España
country
Mostrando el dato más reciente disponible para cada indicador.
Cumplimiento de Metas
Top 3 - Mejor Desempeño
Top 3 - Atención Necesaria
Evolución del Cumplimiento
Nombre
% Cumplimiento
Verde
Amarillo
Rojo
Sin datos
Cargando ranking...
Selecciona primero un grupo ODS para habilitar esta lista.
BuenoMedioAlertaSin dato
Cargando datos…
<!-- Comparativa entre 3 municipios -->
Comparación de Municipios
Año de referencia: 2023
Cargando datos de comparación...
4. Ficha de municipio
Por favor, especifica un municipio.
renderiza una ficha completa con:
Header con nombre, CCAA, provincia, coordenadas.
Grid de 17 ODS + 4 retos con la tarjeta oficial (color y icono de la ONU).
Cada tarjeta muestra valor actual, tendencia vs año anterior, umbrales.
Click en tarjeta → drawer con desglose de indicadores de ese ODS.
Botones: Imprimir, Compartir, Descargar datos (si plugin Data Export activo).
5. Dashboard por nivel
España
country
Mostrando el dato más reciente disponible para cada indicador.
Cumplimiento de Metas
Top 3 - Mejor Desempeño
Top 3 - Atención Necesaria
Evolución del Cumplimiento
Nombre
% Cumplimiento
Verde
Amarillo
Rojo
Sin datos
Cargando ranking...
Selecciona primero un grupo ODS para habilitar esta lista.
BuenoMedioAlertaSin dato
Cargando datos…
: vista agregada con selector level.
level="country" — agregados nacionales.
level="ccaa" location_id="X" — por comunidad autónoma.
level="province" — por provincia.
level="municipality" — equivale a la ficha de municipio.
Los agregados superiores calculan medias ponderadas por población cuando la métrica lo admite.
6. Comparativa
Dos shortcodes complementarios:
Comparación de Municipios
Año de referencia: 2026
Cargando datos de comparación...
— vista estática de una comparación predefinida. Ideal para reportajes.
Comparador Avanzado de Municipios
Compara indicadores entre múltiples municipios
Selección de Municipios
Añade hasta ocho municipios para comparar su desempeño en un indicador o seguir su evolución temporal.
Máximo 8 municipios
Configuración
→
Selecciona municipios y un indicador para comparar.
— UI dinámica donde el usuario añade/quita municipios y cambia el indicador.
7. Mapa
Cargando datos…
— mapa coroplético de un ODS. Complementa (no duplica) a odslocal-geo-display: este mapa es para ODS agregados, el otro para indicadores individuales.
8. Buscador global
Buscar en la plataforma ODS
Encuentra municipios, indicadores y objetivos ODS.
🔍
Escribe al menos 2 caracteres para buscar.
— buscador unificado:
Busca por nombre de municipio, código INE, nombre de indicador o número de ODS.
Resultados agrupados por tipo con iconos.
Atajos de teclado: / enfoca la caja, Esc cierra.
Histórico de últimas búsquedas en localStorage.
9. Generador de embed
Generador de Widget Embed
Crea un widget embebible para tu sitio web
Vista previa
Selecciona un municipio para ver la vista previa.
Código para copiar
— herramienta para que medios de comunicación y webs externas embedeen tarjetas ODS o comparativas en su propio sitio:
El usuario elige tipo (tarjeta ODS, comparativa, mapa), parámetros.
El generador produce un <iframe> responsive con sandbox.
El embed incluye atribución automática («Fuente: ODSLocal España — CC BY 4.0»).
10. Alertas y umbrales
Alertas y Notificaciones
Seguimiento visual de cambios relevantes en indicadores ODS.
!
Centro de alertas preparado
La interfaz ya está lista para mostrar avisos de mediciones pendientes, cambios de estado y variaciones relevantes cuando se active el motor de alertas.
Indicadores sin datos recientes.
ODS con cambios significativos respecto al año anterior.
Avisos de revisión para equipos municipales.
— panel con los indicadores fuera de umbral en un municipio:
🔴 Crítico — muy por debajo de la meta.
🟡 Advertencia — cerca del umbral inferior.
🟢 En meta.
Los umbrales son por indicador, definidos en el catálogo class-indicators.php del plugin núcleo.
11. Paleta de colores ODS
El plugin expone BDW_Display_REST::$goal_colors, un array [goal_id => color hex] con los colores oficiales ONU:
Otros plugins (odslocal-geo-display, ODSLocal News) leen esta paleta si está disponible.
12. REST API interna
Namespace /wp-json/b-ods-display/v1. Pensado para el propio JS del plugin (no documentado como API pública), pero puedes consumirlo:
GET /municipality/{id}/summary
GET /municipality/{id}/goals?year=YYYY
GET /indicator/{id}/history?location_id=X
GET /compare?locations=&indicator=&year=
GET /search?q=...
… (total 13 rutas)
13. Vista imprimible
Cualquier shortcode admite el parámetro de URL ?bdw_print=1: aplica CSS específico para impresión (oculta elementos interactivos, amplía espacio, garantiza contraste).
14. Traducciones
Text domain: b-ods-display.
Strings visibles en los shortcodes pasan por __().
Para añadir idioma: POT estándar en languages/.
15. Solución de problemas
Los shortcodes muestran «Por favor, especifica un municipio»
Pasa code_ine o location_id. Si no, el shortcode intenta leer ?loc= de la URL.
Los colores ODS se ven mal en mi theme
Tu theme está forzando colores. Añade reglas CSS más específicas o usa !important en el CSS del theme hijo.
El generador de embed no carga
Algunos cortafuegos bloquean iframes cross-origin. Añade el dominio de destino a la cabecera Content-Security-Policy: frame-ancestors o desactiva CSP en la URL de origen.
Dashboard país sin datos
Necesitas mediciones approved en todos los niveles (país, CCAA, provincias). Si solo tienes municipios, el agregado país se calcula con lo disponible; puede quedar parcial.
