Documentación · Guía del Frontend
Favoritos
Este documento cubre la función de favoritos (lista de deseos) del plugin ADP Car Market Hub WordPress: cómo guardan los vehículos los visitantes, cómo funciona la página de favoritos, qué datos se muestran y qué limitaciones se aplican.
Cuándo utilizar este documento
Lea este documento si está configurando la función de favoritos por primera vez, configurando qué detalles del vehículo aparecen en la página de favoritos o ayudando a un visitante a comprender cómo guardar y volver a consultar los vehículos.
Descripción general
La función de favoritos permite a los visitantes guardar los vehículos en los que están interesados y verlos más tarde en una página de favoritos dedicada. Los ID de los vehículos guardados se almacenan en el localStorage del navegador. No se requiere cuenta ni inicio de sesión.
Cuando un visitante abre la página de favoritos, el plugin recupera los datos actuales del vehículo para todos los ID guardados desde un endpoint de la REST API y renderiza la lista de forma dinámica. Esto significa que la página de favoritos siempre refleja el estado actual del listado de vehículos, incluyendo cualquier cambio de precio o vehículos que hayan sido eliminados desde que se guardaron.
Requisitos o prerrequisitos
- La función de favoritos debe estar habilitada en los ajustes del plugin (está habilitada por defecto).
- Debe existir una página de favoritos en WordPress con el shortcode
[as24ci_favorites]en su contenido. - La REST API de WordPress debe ser accesible públicamente para que la página de favoritos cargue los datos del vehículo.
Instrucciones paso a paso
Configurar la página de favoritos
- En la administración de WordPress, vaya a Páginas → Añadir nueva.
- Asigne a la página un título como "Mis favoritos" o "Vehículos guardados".
- En el contenido de la página, añada el shortcode
[as24ci_favorites]. - Publique la página.
La página de favoritos renderiza un contenedor que se rellena mediante JavaScript al cargar la página. No se requiere ninguna configuración adicional del shortcode.
Guardar un vehículo como visitante
- En el archivo de vehículos, localice una tarjeta de vehículo. Aparece un botón de favoritos (icono de corazón) en la tarjeta cuando la función de favoritos y el elemento
favorite_btnestán habilitados. - Haga clic en el botón del corazón para añadir el vehículo a sus favoritos. El botón cambia de estado para indicar que el vehículo está guardado.
- Haga clic en el botón de nuevo para eliminar el vehículo de sus favoritos.
El mismo botón de favoritos está disponible en las páginas de detalles de vehículos individuales en la barra de acción flotante fija.
Ver los favoritos guardados
- Navegue a la página de favoritos.
- La página se carga y llama al endpoint REST del plugin para recuperar los datos actuales de todos los ID de vehículos guardados.
- Cada vehículo guardado se muestra como una tarjeta con su imagen, título, precio y los campos de especificación configurados.
- Haga clic en "Más detalles" en una tarjeta para abrir la página de detalles completa del vehículo.
Si no hay vehículos guardados, la página muestra "Aún no tienes favoritos guardados."
Referencia de configuración
Ajustes de favoritos
| Ajuste | Ubicación | Descripción |
|---|---|---|
| Enable favorites | Ajustes del plugin → Ajustes (o Asistente de configuración) | Habilita o deshabilita toda la función de favoritos |
| Favorites fields | Layout Manager → Favorites | Qué campos del vehículo se muestran en cada tarjeta de favoritos |
Campos de la página de favoritos
Los campos del vehículo que se muestran en cada tarjeta de favoritos se controlan mediante la zona Layout Manager → Favorites. Se admiten los siguientes campos, que se pueden habilitar o deshabilitar individualmente:
| ID del campo | Descripción |
|---|---|
price | Precio de venta (formateado con moneda) |
mileage | Kilometraje en km |
firstRegistrationYear | Año de matriculación |
fuelType | Tipo de combustible |
transmissionType | Transmisión |
bodyType | Tipo de carrocería |
conditionType | Estado (nuevo o usado) |
horsePower | Potencia en CV |
bodyColorText | Color exterior |
doors | Número de puertas |
seats | Número de asientos |
driveType | Tipo de tracción |
co2Emission | Emisiones de CO₂ en g/km |
consumptionCombined | Consumo de combustible combinado en l/100 km |
energyLabel | Etiqueta energética |
firstRegistrationDate | Fecha de primera matriculación (formateada) |
warrantyType | Tipo de garantía |
Los campos sin valor para un vehículo, o los campos numéricos con un valor de cero, se omiten de la tarjeta de ese vehículo. El orden de los campos sigue la configuración de la zona.
Botón de favoritos en la tarjeta de archivo
El botón de favoritos aparece en las tarjetas de archivo de vehículos cuando:
- La función de favoritos está habilitada en los ajustes del plugin (
FEATURE_FAVORITES). - El elemento
favorite_btnestá habilitado en la zona Layout Manager → Archive Cards.
El botón muestra un icono de corazón y alterna el estado guardado al hacer clic.
Notas de funcionamiento
- Los ID de los vehículos se almacenan en el
localStoragedel navegador. Los favoritos persisten a través de la navegación por las páginas y sobreviven a las recargas de página dentro del mismo navegador. Al borrar los datos del navegador (cookies y almacenamiento local) se eliminan todos los favoritos guardados. - Los favoritos no se comparten entre dispositivos o navegadores. No hay almacenamiento de cuentas en el lado del servidor para los favoritos.
- La página de favoritos obtiene los datos del vehículo desde el endpoint REST
POST /wp-json/as24ci/v1/favoritesen cada carga de página. El cuerpo de la solicitud contiene un array de ID de publicaciones. - El endpoint REST impone un máximo de 50 vehículos por solicitud. Si se almacenan más de 50 vehículos en
localStorage, solo se recuperan los primeros 50. - El endpoint REST solo devuelve vehículos publicados del tipo de publicación correcto. Los vehículos que se hayan despublicado o eliminado desde que se guardaron se excluyen silenciosamente de la respuesta.
- El año de matriculación se resuelve utilizando una cadena de prioridad: primero a partir de la meta key mapeada para
firstRegistrationYear, luego a partir de la meta key heredada_as24ci_yeary, finalmente, desde el Vehicle Field Resolver que comprueba la tabla personalizada y las columnas de datos sin procesar. - Las fechas (fecha de primera matriculación) se formatean utilizando el ajuste de formato de fecha del sitio de WordPress.
- Los campos numéricos como la potencia y el consumo de combustible se omiten si su valor es cero o está vacío, para que la tarjeta no muestre "0 CV" o "0.0 l/100 km".
- El recurso JavaScript de favoritos se pone en cola en las páginas de archivo de vehículos, en las páginas de vehículos individuales y en las páginas que contienen el shortcode
[as24ci_favorites]o[as24ci_archive]. - El CSS de favoritos y cualquier estilo en línea de diseño configurado se ponen en cola junto con el JavaScript.
Resolución de problemas
El botón de favoritos no aparece en las tarjetas de vehículos.
- Verifique que la función de favoritos esté habilitada en los ajustes del plugin.
- Compruebe la zona Layout Manager → Archive Cards y confirme que
favorite_btnestá habilitado.
La página de favoritos muestra "Cargando favoritos..." y no se actualiza.
- Compruebe que la REST API de WordPress sea accesible. Muchos plugins de seguridad o configuraciones de servidor bloquean el acceso a la REST API para usuarios que no han iniciado sesión.
- Abra la consola de desarrollador del navegador y compruebe si hay errores de JavaScript o solicitudes de red fallidas.
- Confirme que la página contiene el shortcode
[as24ci_favorites].
La página de favoritos muestra "No se pudieron cargar los favoritos."
- La solicitud REST a
/wp-json/as24ci/v1/favoritesfalló o devolvió un error. Compruebe que la REST API funciona correctamente. - Verifique que los ajustes de enlaces permanentes del sitio permitan resolver las URL de la REST API.
Los vehículos guardados desaparecen después de reiniciar el navegador.
localStoragepersiste tras reiniciar el navegador en todos los navegadores modernos. Si los favoritos desaparecen, es posible que el navegador esté configurado para borrar el almacenamiento al cerrarse, o que se esté utilizando un modo de privacidad (ventana de incógnito/privada).
Un vehículo que estaba guardado ya no se muestra en la página de favoritos.
- Es posible que el vehículo se haya despublicado o eliminado de la administración de WordPress después de haber sido guardado. El endpoint REST solo devuelve vehículos publicados.
La página de favoritos muestra solo un subconjunto de los vehículos guardados.
- El endpoint REST devuelve un máximo de 50 vehículos. Si se guardan más de 50 vehículos en
localStorage, solo se recuperan los primeros 50.