web_map_feed Shortcode
El shortcode web_map_feed muestra las Ubicaciones actuales como tarjetas legibles con imagen, título, dirección y descripción. Sus acciones operables por teclado se conectan a un web_gmap o a un Mapa de Gutenberg coincidente. Sigue renderizándose con el editor Legacy Page Builder desactivado.
Los atributos siguientes coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis en bruto únicamente para contenido revisado que no pueda mantenerse mediante los controles visuales.
Uso
[web_map_feed map_id="locations-map" action_label="Show location"]
Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
source |
current |
current, post |
La entrada actual u otra entrada publicada y accesible. |
post_id |
0 |
ID de entrada positivo | Obligatorio cuando source="post". Los orígenes ausentes o no disponibles no renderizan nada. |
map_id |
Vacío | ID HTML del mapa, sin # |
Destino explícito opcional; obligatorio si varios mapas comparten las ubicaciones. |
action_label |
Abrir ventana de información y centrar | Texto simple | Etiqueta visible del botón; el nombre accesible también identifica la ubicación. |
device_visibility |
Vacío | web-hide-on-xs, web-hide-on-sm, web-hide-on-md y web-hide-on-lg separados por espacios |
Oculta el feed en los rangos de dispositivo seleccionados. |
el_id |
— | ID HTML único válido | Introduce el ID de la sección (Nota: asegúrate de que sea único y válido según la especificación w3c). |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas dar estilo a un elemento de contenido concreto de forma diferente, usa este campo para añadir un nombre de clase y luego haz referencia a él en tu archivo css. |
Comportamiento del origen y del mapa
Rellena los campos de Ubicaciones de la entrada de origen. Se leen todas las filas actuales, con comprobaciones de publicación, contraseña y permisos. El bloque nativo Map Feed tiene un límite independiente de 200 ubicaciones. Los IDs de miniaturas de la biblioteca y las URLs reconocidas de la biblioteca actual usan metadatos de imagen en vivo. No se copia ningún dato de ubicación en el shortcode.
Las ubicaciones guardadas mediante versiones anteriores siguen disponibles sin necesidad de editar ni volver a guardar la entrada de origen. Una vez que el campo actual de Ubicaciones se ha guardado, su valor tiene prioridad, incluida una lista intencionadamente vacía.
Usa una Ruta Dinámica del Mapa o web_gmap_dynamic_route que contenga el mismo origen. Las acciones coinciden con la identidad de la ubicación, no con su título. Un mapa explícito ausente nunca recurre a un mapa diferente. Sin un destino, una ubicación debe pertenecer exactamente a un mapa. El mapa debe estar visible y listo antes de que sus botones estén disponibles.
El feed en sí no tiene dependencias adicionales de CSS ni de JavaScript. El Mapa es el propietario del cargador de Google y del tiempo de ejecución compartidos. Configura Google Maps en Settings → POM Theme → Integrations → Google Maps solo cuando se necesiten mapas interactivos. Las tarjetas siguen siendo legibles sin un mapa o una conexión con el proveedor; las acciones no disponibles se desactivan. La Vista Previa ordinaria de WordPress sigue siendo pasiva.
Verificación
Prueba web_map_feed con conjuntos de resultados llenos, vacíos y largos, y verifica que el origen seleccionado pertenezca al sitio actual.
Comprueba el mapa de destino, la visibilidad por dispositivo y la activación por teclado. Los cambios en el origen y en las imágenes de la biblioteca aparecen en renderizados posteriores sin caché. Consulta la guía de Map Feed para conocer los controles equivalentes del bloque y la resolución de problemas.