Documentación · Guía del Frontend
Alertas de búsqueda en el frontend
Este documento cubre la función de Agente de Búsqueda (Smart Stock Alerts) del plugin ADP Car Market Hub WordPress: cómo se suscriben los visitantes para recibir notificaciones, cómo funciona la confirmación de doble opt-in y cómo funciona la baja del servicio.
Cuándo usar este documento
Lea este documento si está configurando la función de alertas de búsqueda por primera vez, si está ayudando a un visitante a comprender cómo suscribirse y gestionar sus alertas, o si está solucionando problemas de suscripción y notificación.
Descripción general
La función de Agente de Búsqueda permite a los visitantes guardar un conjunto de criterios de búsqueda y recibir una notificación por correo electrónico cada vez que se importe al sistema un nuevo vehículo que coincida con dichos criterios. Esta función utiliza un flujo de trabajo de doble opt-in que cumple con el RGPD: el visitante debe hacer clic en un enlace de confirmación en su correo electrónico antes de que se activen las notificaciones.
Los visitantes pueden darse de baja en cualquier momento haciendo clic en el enlace de baja incluido en cada correo electrónico de notificación. No se requiere cuenta ni inicio de sesión.
Requisitos o prerrequisitos
- La función de Agente de Búsqueda debe estar habilitada en los ajustes del plugin (está habilitada por defecto, controlada por
FEATURE_SEARCH_AGENT). - El sitio de WordPress debe poder enviar correos electrónicos. Si el correo transaccional no está configurado en su hosting, considere usar un plugin de SMTP. Sin un envío de correo electrónico que funcione, no se enviarán los correos de confirmación ni de notificación.
- El formulario de suscripción del agente de búsqueda debe estar visible en la página de archivo. El plugin renderiza el formulario como parte de la plantilla de archivo cuando la función está habilitada.
Instrucciones paso a paso
Visitante: suscribirse a las alertas de búsqueda
- Abra la página de archivo de vehículos.
- Localice el formulario del Agente de Búsqueda debajo o al lado de los filtros de búsqueda.
- Complete al menos un criterio de búsqueda (como marca, modelo, rango de precios o kilometraje máximo).
- Introduzca una dirección de correo electrónico en el campo de suscripción.
- Envíe el formulario.
- Aparecerá un mensaje de éxito: "¡Casi listo! Por favor, revise su bandeja de entrada y confirme su dirección de correo electrónico."
- Abra el correo electrónico de confirmación y haga clic en el enlace de confirmación.
- Se mostrará un mensaje de confirmación en el sitio. La suscripción ya está activa.
A partir de este momento, el visitante recibirá una notificación por correo electrónico cada vez que se importe un nuevo vehículo que coincida con sus criterios guardados.
Visitante: darse de baja de las alertas
- Abra cualquier correo electrónico de notificación recibido del sistema de alertas de búsqueda.
- Haga clic en el enlace de darse de baja en la parte inferior del correo electrónico.
- Se mostrará una página de confirmación. La suscripción se desactiva inmediatamente.
La acción de darse de baja es irreversible desde el lado del visitante; el visitante tendría que suscribirse de nuevo para recibir futuras alertas.
Referencia de configuración
Criterios del agente de búsqueda
El formulario de suscripción captura los siguientes criterios. El visitante debe proporcionar al menos uno para que se acepte la suscripción:
| Criterio | Descripción |
|---|---|
make | Marca del vehículo |
model | Modelo del vehículo |
body_type | Tipo de carrocería |
drive_type | Configuración de tracción |
condition | Estado: nuevo o de ocasión |
color | Color exterior |
min_price | Precio mínimo |
max_price | Precio máximo |
mileage_max | Kilometraje máximo |
status | Filtro de estado (nuevo, de ocasión o todos) |
Todos los criterios utilizan la lógica AND: un vehículo debe coincidir con cada criterio especificado para activar una notificación. Los criterios vacíos se ignoran.
Estados de suscripción
Cada suscripción se almacena en la tabla personalizada {prefix}as24ci_search_agents del plugin y tiene uno de los siguientes estados:
| Estado | Significado |
|---|---|
pending | Correo de doble opt-in enviado; el visitante aún no ha confirmado |
active | Confirmado; se envían notificaciones para los vehículos que coinciden |
inactive | Dado de baja por el visitante |
paused | Pausado manualmente por un administrador en la administración del plugin |
Plantillas de correo electrónico
El plugin envía automáticamente dos tipos de correo electrónico:
Correo electrónico de confirmación (enviado al suscribirse):
- Asunto: "Por favor, confirme su agente de búsqueda"
- Contiene los criterios guardados del visitante y el enlace de confirmación.
Correo electrónico de notificación de coincidencia (enviado cuando se importa un nuevo vehículo que coincide):
- Asunto: "Nueva coincidencia de vehículo: [título del vehículo]"
- Contiene el título del vehículo, un enlace a la página de detalles del vehículo, los criterios guardados y un enlace para darse de baja.
Ambos correos electrónicos se envían como texto plano utilizando la dirección de correo electrónico configurada en el sitio como remitente. El contenido del correo electrónico no se puede configurar actualmente desde la interfaz de administración; la personalización requiere intervención a nivel de código a través de los filtros de WordPress.
Interruptor de la función
| Ajuste | Clave de opción | Por defecto | Descripción |
|---|---|---|---|
| Activar Agente de Búsqueda | as24ci_feature_search_agent | On | Interruptor principal para la función de alertas de búsqueda |
Notas de funcionamiento
- El plugin solo envía notificaciones para vehículos recién importados. Los vehículos que ya estaban en el sistema cuando un visitante se suscribió no activan ninguna notificación. Los vehículos que se actualizan (se vuelven a importar) tampoco activan notificaciones.
- El formulario de suscripción incluye un campo honeypot para reducir los envíos de bots. Si se completa el campo oculto, el envío se acepta silenciosamente pero no se crea ninguna suscripción.
- Las suscripciones se almacenan en una tabla de base de datos personalizada dedicada. La tabla se crea automáticamente durante la activación del plugin y se actualiza según sea necesario al cargar el plugin.
- El token utilizado para los enlaces de confirmación y de baja es una cadena hexadecimal de 64 caracteres criptográficamente segura. El token se incrusta en las URL de confirmación y de baja como un parámetro GET.
- Los enlaces de confirmación tienen el formato:
/?as24ci_sa_action=confirm&token=[token] - Los enlaces para darse de baja tienen el formato:
/?as24ci_sa_action=unsubscribe&token=[token] - Tras una confirmación exitosa, el visitante es redirigido a la página de inicio con
?as24ci_sa_msg=confirmed. - Tras darse de baja, el visitante es redirigido a la página de inicio con
?as24ci_sa_msg=unsubscribed. - Los administradores pueden ver, editar, pausar y eliminar suscripciones desde el panel de administración del plugin.
Resolución de problemas
El formulario de suscripción no aparece en la página de archivo.
- Verifique que la función de Agente de Búsqueda esté habilitada en los ajustes del plugin.
- Compruebe que se esté utilizando el shortcode
[as24ci_archive]o el archivo nativo del CPT. El formulario del agente de búsqueda forma parte de la plantilla de archivo. - Si el formulario se renderiza pero no es visible, compruebe si hay anulaciones de CSS del tema o configuraciones del Layout Manager que puedan estar ocultando el widget.
El visitante no recibió el correo electrónico de confirmación.
- Verifique que WordPress pueda enviar correos electrónicos. Utilice un plugin como WP Mail SMTP para probar la entrega de correo electrónico.
- Revise la carpeta de correo no deseado del sitio; los correos de confirmación de WordPress a veces pueden marcarse como spam.
- Confirme que la dirección de correo electrónico del visitante sea válida y se haya introducido correctamente.
El enlace de confirmación no funciona.
- Asegúrese de que el enlace se esté abriendo en un navegador y no esté recortado por un cliente de correo electrónico.
- Verifique que los ajustes de enlaces permanentes del sitio permitan procesar parámetros de consulta.
- Si se hizo clic en el enlace más de una vez, el segundo clic no actualizará el estado (la fila solo se actualiza de
pendingaactiveuna vez).
No se envían correos electrónicos de notificación cuando se importan vehículos.
- Compruebe que al menos una suscripción tenga el estado
active. - Confirme que los vehículos importados eran nuevos (no actualizaciones de vehículos existentes). El plugin no envía notificaciones para vehículos reimportados o actualizados.
- Verifique que el vehículo cumpla con los criterios del suscriptor: todos los criterios utilizan la lógica AND, por lo que un vehículo debe coincidir con cada campo especificado.