Documentación · Guía del Frontend

Ubicación y horarios de apertura

Este documento cubre la función de ubicación y horarios de apertura del plugin ADP Car Market Hub WordPress: cómo se muestran las ubicaciones de los concesionarios en las páginas de detalles del vehículo, cómo los shortcodes pueden incrustar datos de ubicación en otros lugares y cómo se configura esta función.

Cuándo usar este documento

Lea este documento si está configurando ubicaciones por primera vez, agregando horarios de apertura a la página de detalles del vehículo o utilizando los shortcodes de ubicación y horarios en otras páginas.

Descripción general

El plugin incluye una función de ubicaciones que almacena los datos de ubicación del concesionario o sucursal (dirección, teléfono, ubicación en Google Maps y horarios de apertura) junto con uno o más seller IDs de AutoScout24. Cuando el seller ID de un vehículo coincide con una ubicación configurada, el plugin muestra automáticamente el cuadro de dirección de ubicación correspondiente y el cuadro de horarios de apertura después del formulario de contacto en la página de detalles del vehículo.

La misma información también se puede representar en cualquier página de WordPress utilizando shortcodes dedicados.

Requisitos o prerrequisitos

Se debe configurar al menos una ubicación en la administración del plugin (ajustes del plugin → pestaña Ubicaciones).
Cada ubicación debe tener al menos un seller ID asociado que coincida con el valor de post meta _as24ci_seller_id almacenado en las publicaciones de los vehículos.
Para que la ubicación y los horarios aparezcan automáticamente en las páginas de detalles del vehículo, el plugin debe estar activo y el seller ID del vehículo debe estar establecido.

Instrucciones paso a paso

Configurar una ubicación

En la administración de WordPress, abra los ajustes del plugin y navegue hasta la pestaña Ubicaciones.
Haga clic en Añadir ubicación o edite una existente.
Complete los detalles de la ubicación: - Nombre: El nombre del concesionario o de la sucursal. - Calle: Dirección de la calle. - Código postal: Código postal. - Ciudad: Nombre de la ciudad. - Teléfono: Número de teléfono de contacto. - Ubicación en Google Maps: URL opcional de Google Maps para un botón "Planificar ruta". Se genera automáticamente a partir del nombre de la ubicación y la dirección cuando está vacío. También puede pegar una URL personalizada de Google Maps. - Seller IDs: Uno o más seller IDs de AutoScout24 que están asociados con esta ubicación. - Horarios de apertura: Una o más categorías, cada una con filas de pares de rangos de días y rangos de horas.
Guarde la ubicación.

Una vez guardada, la dirección y los horarios de la ubicación aparecerán automáticamente en la página de detalles de cualquier vehículo cuyo seller ID coincida con uno de los seller IDs configurados para esa ubicación.

Incrustar información de ubicación en cualquier página usando shortcodes

Abra la página o publicación de WordPress donde desea mostrar la información de ubicación.
Agregue uno de los siguientes shortcodes en el editor de contenido:

Cuadro de ubicación (dirección, teléfono, botón de planificar ruta):
```
[as24ci_location_box post_id="123"]
```
Cuadro de horarios de apertura:
```
[as24ci_hours_box post_id="123"]
```

Reemplace 123 con el ID de publicación de WordPress del vehículo cuya ubicación asociada desea mostrar.

Si omite el atributo post_id, el shortcode utiliza el ID de la publicación actual en el bucle. Esto es útil cuando se coloca el shortcode dentro de una plantilla de publicación de vehículo.

Referencia de configuración

Campos de ubicación

Cada ubicación se almacena como una entrada en la opción de ubicaciones del plugin (as24ci_locations). Se admiten los siguientes campos:

Campo	Descripción
`name`	Nombre de la ubicación o del concesionario (se muestra como el encabezado en el cuadro de ubicación)
`street`	Dirección de la calle
`zip`	Código postal
`city`	Nombre de la ciudad
`phone`	Número de teléfono (se muestra en negrita en el cuadro de ubicación)
`url`	URL opcional de ubicación en Google Maps utilizada para el botón "Planificar ruta". Cuando está vacía, se genera automáticamente una URL de búsqueda de Google Maps a partir del nombre de la ubicación y la dirección.
`seller_ids`	Matriz de cadenas de seller ID de AutoScout24 asociadas con esta ubicación
`hours`	Matriz de categorías de horarios de apertura (ver más abajo)

Estructura de los horarios de apertura

Los horarios de apertura se organizan como una lista de categorías. Cada categoría tiene una etiqueta y una o más filas:

Campo	Descripción
`category`	Etiqueta de la categoría (por ejemplo, "Ventas", "Taller", "Recambios")
`rows`	Matriz de entradas de `{ days, time }` (por ejemplo, `Mon–Fri`, `08:00–18:00`)

Estructura de ejemplo para una sola categoría:

Category: Sales
  Row 1: Mon–Fri / 08:00–18:00
  Row 2: Sat / 09:00–16:00

Ambos campos days y time son cadenas de texto libre. El plugin no valida ni analiza su contenido.

Shortcodes

Shortcode	Descripción
`[as24ci_location_box post_id="…"]`	Representa el cuadro de dirección para la ubicación del vehículo
`[as24ci_hours_box post_id="…"]`	Representa el cuadro de horarios de apertura para la ubicación del vehículo

Ambos shortcodes aceptan un atributo post_id. Si se omite, se utiliza el ID de la publicación actual en el bucle. Si no se encuentra ninguna ubicación coincidente para el seller ID del vehículo, el shortcode devuelve una salida vacía.

Notas operativas

La búsqueda de ubicación se realiza haciendo coincidir el valor de post meta _as24ci_seller_id del vehículo con la matriz seller_ids de cada ubicación configurada. Se utiliza la primera ubicación que coincida.
Los cuadros de ubicación y horarios se representan después de la sección del formulario de contacto a través del gancho de acción as24ci_after_contact_form. Ambos cuadros están envueltos en un div contenedor (as24ci-location-hours-wrapper). Si ninguno tiene contenido, no se representa nada.
El cuadro de horarios de apertura solo se representa cuando la ubicación coincidente tiene al menos una categoría de horarios que no esté vacía.
Los datos de ubicación se almacenan como una matriz serializada en la tabla de opciones de WordPress con la carga automática (autoload) desactivada. Solo se cargan en las páginas de detalles del vehículo y en la administración del plugin, no en cada solicitud de página.
El cuadro de ubicación incluye un botón "Planificar ruta" siempre que haya una URL de Google Maps disponible, ya sea porque el campo url está establecido o porque se puede generar automáticamente a partir del nombre de la ubicación y la dirección. No se realizan llamadas a API externas; la URL generada automáticamente utiliza el formato simple https://www.google.com/maps/search/?api=1&query=….
Si un vehículo no tiene un valor meta _as24ci_seller_id, no se representará ni el cuadro de ubicación ni el de horarios.

Resolución de problemas

El cuadro de ubicación no aparece en la página de detalles de un vehículo.

Verifique que el vehículo tenga un valor meta _as24ci_seller_id. Esto se establece durante la importación. Abra el vehículo en la administración de WordPress y verifique los campos meta del vehículo.
Confirme que se ha configurado una ubicación en los ajustes del plugin con un seller ID coincidente.
Compruebe que el formulario de contacto sea visible en la página. Los cuadros de ubicación y horarios se representan después de la sección del formulario de contacto a través de un gancho en as24ci_after_contact_form. Si el bloque del formulario de contacto está desactivado en el Layout Manager, es posible que el gancho no se ejecute.

El cuadro de horarios de apertura no aparece a pesar de que hay una ubicación configurada.

Confirme que la ubicación tenga al menos una categoría de horarios de apertura con al menos una fila.
Si la categoría y las filas están presentes pero el cuadro sigue sin aparecer, verifique que los datos se estén guardando correctamente en la pestaña de administración de Ubicaciones.

El shortcode devuelve una salida vacía.

Verifique que el atributo post_id apunte a un vehículo publicado con un _as24ci_seller_id válido.
Confirme que haya una ubicación en los ajustes del plugin con un seller ID coincidente.
El shortcode devuelve una salida vacía cuando no se encuentra ninguna ubicación coincidente o cuando el vehículo no tiene un seller ID. Este es el comportamiento esperado.

El botón "Planificar ruta" no aparece.

El botón se representa siempre que la ubicación tenga una URL de Google Maps o suficientes datos de dirección (nombre, calle, código postal, ciudad) para generar una automáticamente. Si no dispone de ninguno de ellos, complete el campo Ubicación en Google Maps o los campos de dirección en la pestaña de administración de Ubicaciones.