Búsquedas Guardadas y Alertas de Nuevos Productos — Documentación
Instalar, configurar y programar el módulo dfsavedsearch: búsquedas guardadas, alertas por email de nuevos productos, cron y conformidad RGPD.
Descripción general
El módulo Búsquedas Guardadas y Alertas (dfsavedsearch) permite a tus clientes guardar una combinación de criterios de búsqueda — palabras clave, categoría, fabricante, rango de precio, disponibilidad — y recibir un email automático en cuanto se publica un nuevo producto que coincide en tu tienda.
Cada búsqueda guardada se convierte en un canal de reactivación: el cliente vuelve por sí mismo el día en que publicas un producto que le interesa. Un registro anti-duplicados garantiza que solo reciba avisos de productos publicados después de guardar su búsqueda, y nunca dos veces por el mismo producto.
En resumen: búsqueda guardada con un clic desde la página de resultados, alerta por email de consentimiento explícito, resumen diario o semanal enviado por una tarea cron autoalojada, conformidad RGPD nativa.
Instalación
- En tu back-office, abre Módulos > Gestor de módulos y haz clic en Subir un módulo.
- Selecciona el archivo
dfsavedsearch.zipy confirma. - Al instalarse, el módulo crea sus dos tablas SQL, su pestaña de administración y su configuración predeterminada. Se genera automáticamente un token de cron de 32 caracteres.
- El módulo está activo de inmediato. No se requiere ninguna dependencia externa (ni Composer ni framework).
El módulo es compatible con PrestaShop 8.0 a 9.x, en tienda única o multitienda, y en los cinco idiomas del catálogo (FR, EN, ES, DE, IT).
Configuración (back-office)
Ve a la página de configuración del módulo (Módulos > Gestor de módulos > dfsavedsearch > Configurar). Los ajustes disponibles son:
- Activar el módulo — activa o suspende la visualización del botón y el envío de alertas.
- Productos por resumen — número máximo de productos listados en un mismo email de alerta (12 por defecto).
- Búsquedas por cliente — número máximo de búsquedas que un cliente puede guardar (20 por defecto).
- Frecuencia por defecto — diaria o semanal, aplicada a las nuevas búsquedas.
- Token de cron — mostrado en claro, con un botón de regeneración. La URL completa del cron y la fecha del último paso se recuerdan en un panel dedicado.
Los valores se almacenan en las variables de configuración DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_CRON_TOKEN y DFSAVEDSEARCH_LAST_CRON.
Uso por parte del cliente
En la página de resultados de búsqueda, se inserta automáticamente un botón « Guardar esta búsqueda ». Al pulsarlo, el cliente abre una ventana donde puede:
- dar un nombre a su búsqueda;
- precisar o ajustar sus criterios: palabras clave, categoría (subcategorías incluidas), fabricante, precio mínimo y máximo, solo productos en stock;
- activar, si lo desea, la alerta por email y elegir su frecuencia.
La alerta por email se basa en una casilla de consentimiento explícito, desmarcada por defecto, acompañada de un texto de consentimiento claro. A un visitante no conectado se le invita a iniciar sesión antes de guardar una búsqueda.
El área « Mis búsquedas »
Se añade una entrada « Mis búsquedas » en la cuenta del cliente. Allí el cliente encuentra todas sus búsquedas guardadas y puede, para cada una:
- activar o desactivar la alerta por email;
- cambiar la frecuencia (diaria / semanal);
- eliminar la búsqueda.
Los criterios de cada búsqueda se resumen en forma de etiquetas legibles (categoría, fabricante, rango de precio, etc.).
Programación del cron (envío de alertas)
El envío de emails lo gestiona una tarea cron protegida por token. Configura el planificador de tareas de tu servidor (o un servicio de cron) para llamar a la siguiente URL:
https://tu-tienda.com/index.php?fc=module&module=dfsavedsearch&controller=cron&token=TU_TOKENReemplaza TU_TOKEN por el token mostrado en la configuración del módulo.
Frecuencia recomendada: llama a la URL cada hora. El módulo respeta luego la frecuencia propia de cada búsqueda (diaria o semanal): la fecha del último envío solo se actualiza cuando un email se ha enviado realmente.
El procesamiento se realiza por lotes (200 búsquedas por paso) para mantenerse ligero. La salida del cron indica el número de búsquedas procesadas, emails enviados y posibles errores, registrados en los logs de PrestaShop.
Mantén tu token de cron confidencial. En caso de fuga, regenéralo con un clic desde la configuración: la URL antigua deja entonces de funcionar.
Conformidad RGPD
- Consentimiento explícito: la alerta por email nunca se activa sin una acción voluntaria del cliente (casilla desmarcada por defecto).
- Baja con un clic: cada email contiene un enlace de baja firmado que desactiva la alerta sin iniciar sesión.
- Exportación y eliminación: el módulo se integra con los hooks RGPD de PrestaShop (psgdpr) para la exportación y eliminación de datos personales.
- Purga automática: al eliminar una cuenta de cliente, se eliminan todas sus búsquedas guardadas.
Compatibilidad y convenciones técnicas
- PrestaShop 8.0 a 9.x, multitienda, 5 idiomas.
- Hooks utilizados:
displayCustomerAccount,actionFrontControllerSetMedia,displayFooter,actionObjectCustomerDeleteAfter,actionDeleteGDPRCustomer,actionExportGDPRData. - Pestaña de administración
AdminDfSavedSearchbajo el menú Clientes. - Sin dependencias: autoloader PSR-4 manual, JS vanilla, ningún servicio externo.
Resolución de problemas
- No se envía ningún email — comprueba que el cron se llama realmente (fecha del último paso en la configuración), que el módulo está activado y que la configuración de email de PrestaShop funciona.
- El botón no aparece — solo se muestra en la página de resultados de búsqueda; asegúrate de que el módulo está activado y vacía la caché de PrestaShop.
- Un cliente no recibe alertas — asegúrate de que la alerta está activa para esa búsqueda y de que se han publicado nuevos productos correspondientes después de guardarla.