El plugin Open User Map proporciona varios Shortcodes para mostrar ubicaciones, filtrar contenido y personalizar la apariencia y funcionalidad del mapa.
👉 Puede encontrar una lista de los Shortcodes disponibles actualmente y sus atributos para su versión del plugin en la configuración del plugin ( Open User Map > Configuración > Ayuda y Primeros pasos ).
Esta guía describe los Shortcodes disponibles y sus atributos.
Shortcode básico para mostrar el mapa
Para mostrar el mapa con todas las ubicaciones, utilice el siguiente shortcode:
[open-user-map]Si se integra en un archivo de tema, utilice:
<?php echo do_shortcode('[open-user-map]'); ?>Esto mostrará el mapa por defecto configurado en los ajustes del plugin.
Atributos del código corto
Posición y vista del mapa
Personaliza la posición inicial del mapa y el nivel de zoom:
| Atributo | Ejemplo | Descripción |
|---|---|---|
| lat | lat="51.50665" | Establece la latitud para la posición inicial del mapa. |
| largo | long="-0.12752" | Establece la longitud para la posición inicial del mapa. |
| zoom | zoom="13" | Define el nivel de zoom inicial. |
| región | region="Europe" | Preseleccionar una región (debe estar activado en los ajustes). |
Filtrado de contenidos
Filtre las ubicaciones mostradas en función de categorías, usuarios o ID específicos:
| Atributo | Ejemplo | Descripción |
|---|---|---|
| tipos | types="food"types="food|drinks|hotel" | Filtre las ubicaciones por tipos (Categorías de marcadores). Separe varios tipos con el símbolo |. |
| tipos-relación | types-relation="AND" | Todos los tipos deben coincidir (AND). Por defecto, cualquier tipo puede coincidir (OR). |
| ids | ids="123"ids="123|456|789" | Filtre las ubicaciones por ID de puesto. Separe varios ID con el símbolo |. |
| filtro de fecha | date-filter="after:2025-10-03"date-filter="before:2025-11-03"date-filter="2025-11-03"date-filter="after:2025-10-03;before:2025-11-03" | Filtra por fecha utilizando palabras clave. Utilice after:AAAA-MM-DD para más reciente que, before:AAAA-MM-DD para más antiguo que, a bare AAAA-MM-DD para un día exacto, o combine con punto y coma para un rango. Utiliza la fecha de modificación o de creación en función de su configuración. |
| usuario (PRO) | user="current"user="123"user="role:subscriber" | Filtrar ubicaciones por usuario. Utilice "actual" para mostrar sólo las ubicaciones del usuario conectado en ese momento, un ID de usuario específico o "rol:rolename" para mostrar las ubicaciones de usuarios con un rol específico. |
| filtro de campos personalizados | custom-fields-filter="Color:Red|Blue:OR; Size:M"custom-fields-filter="Website:https\://example.com" | Filtrar ubicaciones por valores de campo personalizados. Formato: ETIQUETA:VALOR1|VALOR2:RELACIÓN. Múltiples filtros separados por punto y coma. RELATION es por defecto OR. Para incluir dos puntos en un valor (por ejemplo, URL), escápelos con una barra invertida, por ejemplo https\://example.com. |
| custom-fields-filter-relation | custom-fields-filter-relation="AND"custom-fields-filter-relation="OR" | Relación entre varios grupos de filtros de campos personalizados. Por defecto es AND (todos los grupos deben coincidir). Establezca OR si cualquier grupo puede coincidir. |
Presentación y aspecto
Personaliza el tamaño y el diseño del mapa:
| Atributo | Ejemplo | Descripción |
|---|---|---|
| talla | size="default"size="fullwidth" | Establece un tamaño de mapa personalizado para el escritorio. |
| tamaño_móvil | size_mobile="square"size_mobile="landscape" | Establezca un tamaño personalizado para la vista móvil. |
| altura | height="400px" | Defina una altura personalizada para el escritorio (incluya unidades como px). |
| altura_móvil | height_mobile="300px" | Definir una altura personalizada para móviles. |
| tipo_mapa | map_type="interactive"map_type="simple" | Activa o desactiva el botón "Añadir ubicación". |
| estilo_mapa | map_style="Esri.WorldStreetMap" | Anula el estilo de mapa por defecto. |
Características y controles
Activar o desactivar funciones específicas del mapa:
| Atributo | Ejemplo | Descripción |
|---|---|---|
| disable_regions | disable_regions="true"disable_regions="false" | Activar o desactivar Regiones. |
| enable_cluster | enable_cluster="true"enable_cluster="false" | Activar o desactivar la agrupación de marcadores. |
| enable_searchbar | enable_searchbar="true"enable_searchbar="false" | Activar o desactivar la barra de búsqueda. |
| enable_searchaddress_button | enable_searchaddress_button="true"enable_searchaddress_button="false" | Activar o desactivar el botón "Buscar dirección (Geosearch)". |
| enable_searchmarkers_button | enable_searchmarkers_button="true"enable_searchmarkers_button="false" | Activar o desactivar el botón "Buscar marcadores". |
| ocultar_filtro | hide_filterbox="true"hide_filterbox="false" | Ocultar el cuadro de filtro Categorías de marcadores. |
| enable_advanced_filter | enable_advanced_filter="true"enable_advanced_filter="false" | Anula la activación de la interfaz de filtro avanzado para este shortcode, independientemente de la configuración global. |
| diseño_filtro_avanzado | advanced_filter_layout="left"advanced_filter_layout="right"advanced_filter_layout="button"advanced_filter_layout="panel" | Forzar un diseño específico de Filtro Avanzado (barra lateral, botón o panel) sólo para este shortcode. |
| enable_currentlocation | enable_currentlocation="true"enable_currentlocation="false" | Activa o desactiva el botón "Muéstrame dónde estoy". |
| enable_fullscreen | enable_fullscreen="true"enable_fullscreen="false" | Activa o desactiva el modo de pantalla completa. |
Ejemplos completos
Ejemplo 1: Mapa de Londres con sólo locales de comida
[open-user-map lat="51.50665" long="-0.12752" zoom="13" types="food" size="fullwidth" height="500px"]Ejemplo 2: Mapa sencillo que muestra sólo las ubicaciones del usuario actual (PRO)
[open-user-map map_type="simple" user="current" enable_fullscreen="true" enable_searchbar="false"]Ejemplo 3: Mapa interactivo para una región específica con apariencia personalizada
[open-user-map region="Europe" map_type="interactive" height="600px" enable_cluster="false" enable_currentlocation="true"]Códigos cortos adicionales
Sólo la forma
Mostrar el formulario “Añadir ubicación” en línea en lugar de dentro de una ventana emergente. El formulario se mostrará directamente en la página sin el mapa.
[open-user-map-form]Mostrar datos de localización específicos
En [open-user-map-location] le permite mostrar detalles de una ubicación específica.
Utilización
[open-user-map-location value="title" post_id="12345"]Valores disponibles
titleimageaudiovideotype (Marker Categories)mapsubtitle (replaces the former "address" label)latlngroutetextvotesnotificationauthor_nameauthor_emailwp_author_id- Campos personalizados (Utilice la etiqueta del campo)
Si post_id se omite, se utilizará el puesto actual.
Añadir un format="object" para devolver datos JSON sin div envolvente. Perfecto para incrustar en atributos HTML o JavaScript personalizado. Si se proporciona el atributo “value”, devuelve ese único valor como un objeto. Si no se proporciona el atributo “value”, devuelve todos los datos de localización como un objeto.
Mostrar una galería de imágenes de la ubicación
En [open-user-map-gallery] genera una galería de imágenes de localización.
Atributos disponibles
| Atributo | Ejemplo | Descripción |
|---|---|---|
| url | url="https://mysite.com/" | Enlaza las imágenes a otra página. |
| número | number="10" | Limita el número de imágenes mostradas. |
| usuario | user="current"user="123"user="role:subscriber" | Filtrar imágenes por usuario. Acepta "current", un ID de usuario o "role:rolename". |
Ejemplo de uso
[open-user-map-gallery number="10" user="current"]Mostrar una lista de ubicaciones
En [open-user-map-list] genera una lista paginada de ubicaciones.
Atributos disponibles
| Atributo | Ejemplo | Descripción |
|---|---|---|
| usuario | user="current" | Filtra las ubicaciones por usuario. Acepta "current", un ID de usuario o "role:rolename". |
| tipos | types="food|drinks" | Filtrar por categorías de marcadores. Separe varios tipos con el símbolo |. |
| tipos-relación | types-relation="AND" | Todos los tipos deben coincidir (AND). Por defecto, cualquier tipo puede coincidir (OR). |
| ids | ids="123|456" | Filtrar por ID de ubicación. Separe varios ID con el símbolo |. |
| filtro de fecha | date-filter="after:2025-10-03" | Filtre por fecha utilizando palabras clave. Utilice after:YYYY-MM-DD para más reciente que, before:YYYY-MM-DD para más antiguo que, a bare YYYY-MM-DD para un día exacto, o combine con “;” para rangos. Utiliza la fecha de modificación o creación en función de la configuración. |
| filtro de campos personalizados | custom-fields-filter="Color:Red|Blue:OR;Size:M" | Filtrar por valores de campos personalizados. Formato: ETIQUETA:VALOR1|VALOR2:RELACIÓN. Múltiples filtros separados por punto y coma. RELATION es por defecto OR. Para incluir dos puntos en un valor (por ejemplo, URL), escápelos con una barra invertida como Website:https\://example.com |
| custom-fields-filter-relation | custom-fields-filter-relation="AND" | Relación entre varios filtros de campos personalizados. Por defecto es AND. Establecer a OR si cualquier grupo de filtros debe coincidir. |
| ordenar | sort="Title:DESC" | Ordenar la vista de lista por título, fecha o etiqueta de campo personalizada. Formato: FIELD:ORDER (ASC o DESC), por ejemplo. sort="Date:ASC" o sort="Custom Field Label:DESC". |
Ejemplo de uso
[open-user-map-list user="current" types="food|drinks"]Resumen
El plugin Open User Map proporciona shortcodes flexibles para mostrar y filtrar mapas, personalizar diseños y añadir funciones adicionales como galerías y listas de ubicaciones. Utilice los atributos descritos anteriormente para adaptar el resultado a sus necesidades.
Para una personalización adicional, explora los ajustes del plugin en Open User Map > Ajustes en tu panel de WordPress. 🚀