Documentación · Manual del usuario
Flujo de trabajo de uso en el frontend
Este documento describe cómo interactúan los visitantes con el inventario de vehículos en la parte pública (frontend) de un sitio WordPress impulsado por el plugin ADP Car Market Hub. Cubre la página de archivo de vehículos, las páginas de detalles, los controles de filtrado, Favoritos, Comparar, los formularios de contacto y de prueba de conducción, la calculadora de financiación, la opción de compartir en redes sociales, la ficha técnica en PDF y las Alertas de búsqueda.
Cuándo utilizar este documento
Lea este documento si:
- Desea comprender qué ven los visitantes y qué acciones pueden realizar en el frontend.
- Está configurando o probando funciones del frontend (filtros, favoritos, comparar, formularios, etc.).
- Necesita verificar que el frontend muestra el inventario correctamente después de una importación.
- Está integrando shortcodes en páginas de WordPress.
Para la configuración de estas funciones por parte del administrador, consulte el Manual del administrador.
Descripción general
El plugin renderiza el inventario de vehículos en el frontend de WordPress utilizando un tipo de contenido personalizado dedicado (as24ci_car) y un conjunto de plantillas integradas. Las áreas principales del frontend son:
- Página de archivo de vehículos: una cuadrícula paginada de todas las tarjetas de vehículos publicados.
- Página de detalles del vehículo: la información completa de un solo vehículo.
- Página de comparación: comparación lado a lado de los vehículos seleccionados.
- Página de favoritos: una lista de los vehículos que el visitante ha guardado.
Estas páginas se pueden servir a través de la URL de archivo del CPT de WordPress, URLs de archivo de taxonomías nativas o páginas de WordPress que contengan shortcodes del plugin.
Requisitos o prerrequisitos
- Se debe importar y publicar al menos un vehículo (estado de la entrada:
publish) antes de que aparezca algo en el frontend. - Las páginas de archivo de vehículos y de comparación/favoritos deben ser páginas de WordPress publicadas que contengan los shortcodes adecuados, o el archivo del CPT de WordPress debe ser accesible a través de su estructura de enlaces permanentes.
- Las funciones como Favoritos, Comparar, Calculadora de financiación, Prueba de conducción, Compartir en redes sociales y Alertas de búsqueda deben estar habilitadas antes de que aparezcan en el frontend. Los selectores de Favoritos y Comparar se encuentran en la pestaña Settings (y en el Asistente de configuración); Compartir en redes sociales se configura en Design & Styles; las Alertas de búsqueda se gestionan en la pestaña dedicada Search Alerts; la reserva de Prueba de conducción y la Calculadora de financiación se configuran en la pestaña Leads y en la sección de ajustes de financiación respectivamente. Verifique la ubicación actual en la versión instalada del plugin, ya que el diseño del administrador puede evolucionar entre versiones.
- Para la función de Prueba de conducción, se deben configurar los días laborables disponibles, la franja horaria, la duración del turno y (opcionalmente) las fechas de exclusión en la pestaña Leads.
Página de archivo de vehículos
Visualización
La página de archivo muestra los vehículos publicados como una cuadrícula basada en tarjetas. Cada tarjeta muestra:
- Imagen del vehículo (miniatura).
- Etiqueta de estado (Nuevo, Usado, Oferta o Súper oferta; configurable en Design & Styles).
- Título del vehículo (marca, modelo, variante).
- Especificaciones clave (año, kilometraje, tipo de combustible, potencia).
- Precio.
- Botón de corazón de Favoritos (si la función Favoritos está habilitada).
- Botón de Comparar (si la función Comparar está habilitada).
- Enlace a la página de detalles del vehículo.
El número de vehículos por página es configurable (12, 24, 48, 72 o todos) y se puede cambiar a través del selector de elementos por página en la barra lateral de filtros o en la barra de herramientas.
Shortcode
El archivo se puede incrustar en cualquier página de WordPress utilizando:
[as24ci_archive]El shortcode admite atributos opcionales para anular filtros, por ejemplo:
[as24ci_archive make="BMW" per_page="12"]Ordenación
Cuando el filtro de ordenación está habilitado, los visitantes pueden ordenar los vehículos por:
- Los más nuevos primero (por defecto: por fecha de importación/publicación, descendente)
- Precio: de menor a mayor
- Precio: de mayor a menor
- Kilometraje: de menor a mayor
- Año: los más nuevos primero
- Año: los más antiguos primero
Verifique las opciones de ordenación exactas disponibles en su versión del plugin.
Filtros de archivo
La barra lateral de filtros en la página de archivo permite a los visitantes acotar la lista de vehículos. Cada filtro se puede habilitar o deshabilitar individualmente en ADP Car Market Hub → Layout Manager.
Filtros estándar
| Filtro | Descripción |
|---|---|
| Marca | Marca/fabricante (utiliza la taxonomía as24ci_brand) |
| Modelo | Nombre del modelo (utiliza la taxonomía as24ci_model) |
| Tipo de carrocería | Tipo de carrocería (utiliza la taxonomía as24ci_body_type) |
| Tipo de combustible | Tipo de combustible (utiliza la taxonomía as24ci_fuel_type) |
| Transmisión | Tipo de caja de cambios (utiliza la taxonomía as24ci_transmission) |
| Tipo de tracción | Transmisión/tracción (utiliza la taxonomía as24ci_drive) |
| Estado | Nuevo / Usado / Otro (utiliza la taxonomía as24ci_condition) |
| Color exterior | Color de la pintura exterior (utiliza la taxonomía as24ci_ext_color) |
| Rango de precios | Precio mínimo y máximo (rango numérico) |
| Kilometraje | Kilometraje mínimo y máximo (rango numérico) |
| Año | Año mínimo y máximo de primera matriculación |
| Búsqueda por palabra clave | Búsqueda de texto en el título y la descripción del vehículo |
Filtros avanzados
| Filtro | Descripción |
|---|---|
| Color interior | Color del interior (utiliza la taxonomía as24ci_int_color) |
| Etiqueta energética | Etiqueta de eficiencia energética A–G (utiliza la taxonomía as24ci_energy_label) |
| Cilindrada del motor | Rango de capacidad cúbica en cc |
| Puertas | Número mínimo y máximo de puertas |
| Asientos | Número mínimo y máximo de asientos |
| Ubicación | Filtro de ubicación del concesionario |
Aplicación de filtros
Los filtros se aplican mediante parámetros de consulta en la URL. Al seleccionar una opción de filtro, se vuelve a cargar o se actualiza el archivo con los resultados filtrados. Se pueden combinar múltiples filtros. Al limpiar un filtro, este se elimina de la consulta.
Página de detalles del vehículo
La página de detalles del vehículo es la vista de un solo vehículo que muestra la información completa del anuncio.
Secciones de contenido
| Sección | Descripción |
|---|---|
| Galería de imágenes | Diseño de cuadrícula o carrusel (configurable). Admite lightbox cuando está habilitado. |
| Migas de pan | Ruta de navegación que muestra el camino desde el archivo |
| Título y precio del vehículo | Se muestran de forma destacada; formato de moneda según la configuración regional |
| Etiqueta de estado | Muestra Nuevo / Usado / Oferta / Súper oferta |
| Tabla de especificaciones | Todos los atributos mapeados del vehículo: kilometraje, matriculación, motor, potencia, transmisión, combustible, tipo de carrocería, color, puertas, asientos, emisiones y más |
| Lista de equipamiento | Equipamiento y características extraídos del anuncio de AutoScout24 |
| Descripción | Texto de descripción del vehículo (importado de la API o generado por el AI Assistant) |
| Tarjeta de contacto / vendedor | El contacto de ventas del concesionario resuelto para este vehículo (nombre, foto, correo electrónico y teléfono), que se muestra cuando se configura un contacto de CMH Team. Consulte CMH Team a continuación. |
| Formulario de contacto | Formulario de consulta integrado (consulte Formulario de contacto a continuación) |
| Calculadora de financiación | Estimador de pago mensual (si está habilitado) |
| Formulario de prueba de conducción | Formulario de reserva de prueba de conducción (si está habilitado) |
| Botones para compartir en redes sociales | Enlaces para compartir en WhatsApp, Facebook, Instagram, X/Twitter, correo electrónico y copiar enlace (si está habilitado) |
| Botón de ficha técnica en PDF | Enlace para abrir una ficha técnica del vehículo optimizada para impresión |
| Botón de favoritos | Añadir/eliminar el vehículo de la lista de favoritos del visitante |
| Botón de comparar | Añadir/eliminar el vehículo de la selección de comparación |
Los campos específicos que se muestran en la tabla de especificaciones se controlan mediante los ajustes de la pestaña Mapping, donde cada campo se puede mostrar u ocultar y su etiqueta se puede personalizar.
Formulario de contacto
El formulario de contacto integrado se muestra en cada página de detalles del vehículo y permite a los visitantes enviar una consulta sobre el mismo.
Campos
- Nombre: obligatorio.
- Correo electrónico: obligatorio. Debe ser una dirección de correo electrónico válida.
- Teléfono: opcional (se habilita/deshabilita en los ajustes de Leads).
- Mensaje: opcional (se habilita/deshabilita en los ajustes de Leads).
- Casilla de consentimiento: opcional (se habilita y configura en los ajustes de Leads). Cuando está habilitada, el visitante debe marcar la casilla antes de realizar el envío.
Spam y limitación de frecuencia
- Honeypot: se incluye un campo oculto en el formulario. Los bots automatizados suelen rellenarlo; cuando se rellena, el envío se rechaza silenciosamente sin crear un lead ni enviar un correo electrónico.
- Limitación de frecuencia: se aceptan hasta 5 envíos por dirección IP cada 5 minutos. Los envíos que superen este umbral reciben una respuesta de error.
Tras el envío
- El visitante es redirigido de nuevo al ancla
#as24ci-contacten la página del vehículo con un indicador de éxito o error. - Un mensaje de éxito confirma que se ha recibido la consulta.
- Se muestra un mensaje de error si el envío ha fallado (por ejemplo, si falta un campo obligatorio o se ha superado el límite de frecuencia).
Los mensajes de éxito y error se pueden configurar en los ajustes de Leads.
Tarjeta de contacto de CMH Team
Cuando se configura un contacto de ventas del concesionario en CMH Team, la página de detalles del vehículo muestra a esa persona como el contacto para el anuncio.
- La tarjeta muestra el nombre del contacto y (si se proporcionan) su foto, dirección de correo electrónico y número de teléfono, con enlaces para hacer clic y enviar un correo o hacer una llamada.
- El contacto que se muestra es el resuelto para el vehículo específico: un contacto asignado directamente al coche tiene prioridad, luego el contacto establecido para la ubicación del coche y, por último, el contacto global por defecto.
- Si no se aplica ningún contacto de CMH Team, la página recurre a los detalles del perfil de vendedor del autor del vehículo.
- El mismo contacto resuelto se utiliza también como el destinatario preferente para las consultas enviadas a través del formulario de contacto (consulte el Flujo de trabajo de gestión de leads).
Los administradores gestionan estos contactos en el menú CMH Team; consulte el Manual del administrador.
Reserva de prueba de conducción
Cuando la función de Prueba de conducción está habilitada, hay disponible un formulario de reserva de prueba de conducción en cada página de detalles del vehículo (a menudo renderizado como una pestaña junto al formulario de contacto).
Cómo funciona
- El visitante selecciona una fecha de un selector de fechas. Las fechas pasadas y las fechas que caen en un día no configurado como disponible no se pueden seleccionar.
- En función de la fecha seleccionada, las franjas horarias disponibles se cargan dinámicamente. Las franjas se generan a partir de la hora de inicio, la hora de finalización y la duración del turno configuradas (por ejemplo, de 09:00 a 17:00 en intervalos de 30 minutos).
- El visitante selecciona una franja horaria y rellena su nombre, correo electrónico y número de teléfono opcional.
- Al enviar, se crea una solicitud de prueba de conducción como un lead con
is_test_drive = 1y el campoappointment_dateestablecido. - Se envían las notificaciones por correo electrónico estándar (con "Solicitud de prueba de conducción" indicado en el asunto y en el cuerpo).
Configuración (para administradores)
- Días laborables disponibles: qué días de la semana permiten pruebas de conducción (de lunes a domingo).
- Hora de inicio / Hora de finalización: la franja horaria diaria para los turnos (por ejemplo, de 08:00 a 18:00).
- Duración del turno: duración de cada franja horaria en minutos (mínimo 5 minutos).
- Fechas de exclusión: fechas específicas (introducidas como
YYYY-MM-DD, una por línea) en las que no hay pruebas de conducción disponibles, independientemente de la configuración del día de la semana.
Calculadora de financiación
Cuando la función de Calculadora de financiación está habilitada, se muestra un estimador interactivo de pago mensual en las páginas de detalles del vehículo.
La calculadora utiliza:
- El precio del vehículo del anuncio importado.
- El tipo de interés: valor por defecto configurable (pestaña Loans en la configuración de Features).
- El plazo del préstamo: valor por defecto configurable en meses (12, 24, 36, 48, 60, 72 u 84 meses).
- La entrada: valor por defecto configurable como un porcentaje del precio del vehículo.
Los visitantes pueden ajustar el tipo de interés, el plazo y la entrada para ver diferentes estimaciones de pago. El resultado es una cifra calculada de la cuota mensual que se muestra en la página. Esta calculadora tiene únicamente fines ilustrativos; las condiciones reales de financiación dependen del proveedor financiero del cliente.
Favoritos (Lista de deseos)
Cuando la función de Favoritos está activada, los visitantes pueden guardar vehículos en una lista de deseos personal.
Cómo funciona
- Aparece un botón con un icono de corazón en cada tarjeta de vehículo en el archivo y en la página de detalles del vehículo.
- Al hacer clic en el corazón, el vehículo se añade a los favoritos del visitante. Al hacer clic de nuevo, se elimina.
- Los favoritos se almacenan en el navegador del visitante (
localStorage). No se requiere inicio de sesión ni cuenta. - Los favoritos son específicos del dispositivo y del navegador; no se sincronizan entre diferentes dispositivos o navegadores, y se borran si el visitante limpia el almacenamiento de su navegador.
- Se puede almacenar un máximo de 50 vehículos en favoritos a la vez.
Página de favoritos
Incruste la página de favoritos en cualquier página de WordPress utilizando el shortcode:
[as24ci_favorites]La página obtiene los datos de los vehículos para los ID almacenados a través de un endpoint de la REST API y renderiza una lista con los campos configurados. Los campos visibles se pueden configurar en el Layout Manager (zona de Favoritos).
Comparador de vehículos
Cuando la función de Comparar está activada, los visitantes pueden seleccionar varios vehículos para compararlos en paralelo.
Cómo funciona
- Aparece un botón Comparar en las tarjetas del archivo y en la barra de acciones flotante de la página individual del vehículo.
- Al hacer clic en el botón, se alterna la inclusión o exclusión del vehículo en la selección de comparación.
- Los vehículos seleccionados se almacenan en
localStorage. No se requiere inicio de sesión. - El número máximo de vehículos que se pueden comparar a la vez es configurable (por defecto: 4). Cuando se alcanza el máximo, se informa al visitante mediante un mensaje.
- Una barra flotante o indicador suele mostrar cuántos vehículos están seleccionados y proporciona un enlace a la página de comparación.
Página de comparación
La página de comparación se renderiza mediante el shortcode:
[as24ci_compare]Esta página muestra los vehículos seleccionados en una tabla comparativa en paralelo para facilitar la comparación de especificaciones. Si no hay vehículos seleccionados, se muestra un mensaje de instrucciones.
Compartir en redes sociales
Cuando la función de Compartir en redes sociales está activada, aparece una fila de botones para compartir en las páginas de detalles del vehículo. No se cargan SDK de JavaScript externos; todos los botones son enlaces estándar basados en URL.
Redes compatibles
- WhatsApp — abre el diálogo de compartir de WhatsApp.
- Facebook — abre el diálogo de compartir de Facebook.
- Instagram — Instagram no admite el uso compartido web directo basado en URL; el comportamiento del botón para Instagram puede variar. Verifíquelo en la versión actual del plugin.
- X (anteriormente Twitter) — abre la ventana de redacción de X/Twitter con la URL del vehículo precargada.
- Correo electrónico — abre el cliente de correo electrónico predeterminado del visitante con un asunto y cuerpo predefinidos.
- Copiar enlace — copia la URL del vehículo en el portapapeles del visitante.
Las redes individuales se pueden activar o desactivar en los ajustes de Features. La ubicación (por ejemplo, encima o debajo de la descripción) también es configurable.
PDF datasheet
Cuando la función de PDF datasheet está activada, los visitantes pueden abrir una página HTML optimizada para impresión de cualquier vehículo y, a continuación, utilizar la función Imprimir → Guardar como PDF de su navegador para crear un documento PDF.
Se accede a la página de la ficha técnica añadiendo el parámetro de consulta ?as24ci_pdf={post_id} a la URL del vehículo. Normalmente se incluye un botón o enlace para activar esto en la página de detalles del vehículo cuando la función está activada.
Campos configurables
Los siguientes campos se pueden incluir o excluir en la ficha técnica (configurable por los administradores):
Título del vehículo, precio, kilometraje, primera matriculación, tipo de combustible, transmisión, potencia, tipo de carrocería, color exterior, puertas, plazas, clase de emisión, valores de CO2, consumo de energía, lista de equipamiento, descripción, ubicación e información de contacto.
Alertas de búsqueda (Smart Stock Alerts)
Cuando la función de Alertas de búsqueda está activada, los visitantes pueden suscribirse a una búsqueda guardada y recibir una notificación por correo electrónico cuando se importe un vehículo que coincida.
Cómo funciona para los visitantes
- En la página de archivo, después de aplicar uno o más filtros, se muestra un formulario de Guardar búsqueda / Suscribirse a alertas.
- El visitante introduce su dirección de correo electrónico y envía el formulario.
- Se envía un correo electrónico de confirmación con Doble Opt-In que cumple con el RGPD. La suscripción permanece en estado Pendiente hasta que el visitante hace clic en el enlace de confirmación del correo electrónico.
- Tras la confirmación, la suscripción pasa a estar Activa. A partir de este momento, el visitante recibe una notificación por correo electrónico cada vez que se importa un vehículo que coincide con los criterios de filtro guardados.
- Cada correo electrónico de notificación incluye un enlace para darse de baja. Al hacer clic en él, la suscripción pasa a estar Inactiva (dado de baja).
Activador de notificaciones
Las notificaciones se envían automáticamente en el hook de acción as24ci_vehicle_imported, que se ejecuta cada vez que se crea o actualiza un vehículo durante una ejecución de importación. El plugin comprueba todas las suscripciones activas y envía correos electrónicos a los suscriptores que coincidan.
Vista del administrador
Las suscripciones activas, pendientes, pausadas y dadas de baja se enumeran en la pestaña de administración Search Alerts. Los administradores pueden filtrar, ver y eliminar suscripciones.
Notas de funcionamiento
- Los filtros se implementan como parámetros de consulta de URL. Los visitantes pueden guardar en marcadores las vistas filtradas o compartir URL con los filtros aplicados.
- Favoritos y Comparar utilizan el localStorage del navegador. Al borrar el almacenamiento del navegador o utilizar un dispositivo/navegador diferente se pierde la selección guardada.
- El formulario de contacto envía los datos de vuelta a la página actual con un parámetro de consulta de éxito o error. No se requiere JavaScript para el envío del formulario; el formulario funciona con un POST HTML estándar.
- La calculadora de financiación es solo ilustrativa. Los resultados se calculan en el navegador a partir de los valores predeterminados configurados. No representan una oferta de crédito vinculante.
- La disponibilidad de la prueba de conducción se evalúa en el servidor. Las fechas y franjas horarias disponibles se derivan de los ajustes configurados en el momento en que se carga la página.
- Los enlaces para compartir en redes sociales son puros enlaces HTML. No se cargan cookies de seguimiento ni scripts de terceros. El seguimiento de clics no está integrado.
- El PDF datasheet es una página de impresión renderizada por el navegador, no un archivo PDF generado por el servidor. La calidad de impresión y el diseño dependen del navegador y del sistema operativo del visitante.
- Los correos electrónicos de alerta de búsqueda se envían a través de WordPress
wp_mail(), que utiliza la configuración de correo electrónico del servidor. Si la entrega de correo electrónico no es fiable, considere configurar SMTP.
Resolución de problemas
| Síntoma | Causa probable | Comprobación |
|---|---|---|
| No aparecen vehículos en la página de archivo | No hay vehículos publicados, o la página de archivo no está configurada | Ejecute una importación; compruebe el estado de publicación predeterminado en Ajustes; verifique que la página de archivo existe y utiliza el shortcode o la URL de archivo del CPT |
| Los filtros no muestran resultados tras la selección | El valor seleccionado no coincide con ningún término de taxonomía de vehículo importado | Compruebe que se han importado vehículos con el atributo seleccionado; verifique los slugs de los términos de taxonomía |
| La página de favoritos está vacía | No hay favoritos guardados en el navegador del visitante, o la página utiliza el shortcode incorrecto | Compruebe que [as24ci_favorites] está en el contenido de la página; verifique que la función de Favoritos está activada |
| La página de comparación muestra "no se han seleccionado vehículos" | No hay vehículos en la selección de comparación | Vaya al archivo y haga clic primero en Comparar en los vehículos |
| El formulario de contacto muestra un error tras el envío | Falta un campo obligatorio, se ha superado el límite de frecuencia o se ha activado el honeypot | Compruebe que el nombre y el correo electrónico están completados; espere 5 minutos e inténtelo de nuevo |
| Las franjas de prueba de conducción están vacías para la fecha seleccionada | La fecha cae en un día de la semana no disponible o es una fecha excluida | Compruebe la configuración de la Prueba de conducción en la pestaña Leads |
| La calculadora de financiación muestra 0 o ningún precio | El vehículo no tiene precio en los datos importados | Verifique que el vehículo tiene un precio en el anuncio de AutoScout24; compruebe la importación |
| Los botones de compartir en redes sociales no son visibles | La función de Compartir en redes sociales está desactivada | Active Compartir en redes sociales en Features; configure las redes deseadas |
| No se recibe el correo electrónico de confirmación de alerta de búsqueda | Problema de entrega de correo electrónico, o el correo fue a la carpeta de spam | Compruebe la entrega de correo electrónico de WordPress; revise la carpeta de spam; considere un plugin de SMTP |