DataFirefly Opiniones Verificadas: documentación
Instalar, configurar y explotar el módulo de opiniones verificadas: solicitudes automáticas, CRON, resumen IA, rich snippets, moderación e importación CSV.
Requisitos e instalación
DataFirefly Opiniones Verificadas funciona en PrestaShop 8.0 a 9.0 con PHP 8.0 a 8.4. Desde la versión 1.1.0, un único ZIP cubre las dos ramas: no hay que elegir entre una versión PS 8 y una versión PS 9 al descargar.
- En su back-office, abra Módulos → Gestor de módulos y haga clic en Subir un módulo.
- Suelte el archivo
dfreviews.zipdescargado desde su cuenta DataFirefly. - Haga clic en Configurar cuando termine la instalación.
La instalación crea seis tablas dedicadas (opiniones, medios, solicitudes, votos útiles, resúmenes IA, estadísticas) y añade una pestaña Opiniones Verificadas en el menú Catálogo. Desde esa pestaña se moderan las opiniones; la pantalla de configuración sigue accesible desde el gestor de módulos.
Si un primer intento de instalación falló, basta con relanzarlo: desde la 1.1.0 la pestaña de administración se crea de forma idempotente y no se duplica.
Configurar el disparador de las solicitudes de opinión
Es el corazón del módulo. Dos ajustes, en la sección Parámetros generales:
- Disparar tras el estado: Enviado (por defecto) o Entregado. Elija el que, en su flujo real, indica que el cliente ya tiene el producto.
- Plazo antes del envío: 3 días por defecto. Cuente el tiempo de entrega más unos días de uso. Para un producto que se juzga con el uso (cosmética, colchones), suba a 10 o 15 días.
Cuando un pedido alcanza el estado elegido, se encola una solicitud con su fecha de envío calculada. No se envía de inmediato: de eso se encarga el CRON.
Poner el CRON en marcha
Sin CRON no sale ningún correo. La URL que hay que llamar aparece en la parte superior de la pantalla de configuración del módulo; contiene un token único generado durante la instalación. Prográmela cada hora en su alojamiento:
0 * * * * wget -q -O /dev/null "URL_CRON_MOSTRADA_EN_EL_MODULO"En cada pasada, el CRON ejecuta tres tareas y devuelve un resumen JSON del trabajo realizado:
- envío de las solicitudes vencidas, en lotes de 50;
- envío de recordatorios para las solicitudes sin respuesta;
- caducidad de las solicitudes de más de 60 días.
El token del CRON es un secreto: no lo publique ni lo envíe en claro. Toda petición sin el token correcto recibe una respuesta 403.
Recordatorios y cupón de recompensa
La sección Recordatorio activa un segundo correo si la opinión no se ha publicado tras un plazo configurable (5 días por defecto, contados desde el primer envío). Solo se envía un recordatorio por solicitud.
La sección Cupón incentivo genera un vale de descuento en cuanto un cliente identificado publica una opinión. Usted define el porcentaje (10 % por defecto) y la duración de validez (30 días). El código creado es una regla de carrito nativa de PrestaShop, nominativa y de un solo uso, así que lo encontrará en Catálogo → Descuentos.
El código solo se genera para un cliente conectado o identificado mediante un pedido. Una opinión de invitado no genera ninguna recompensa.
Activar el resumen IA
Introduzca su clave API de OpenAI en la sección Inteligencia Artificial y elija un modelo. gpt-4o-mini es el predeterminado: es el más económico, del orden de medio céntimo por resumen.
El resumen se activa a partir de tres opiniones publicadas sobre un producto. El módulo envía hasta 100 opiniones a OpenAI y recupera tres elementos estructurados: puntos fuertes, puntos débiles y síntesis global. El resultado se guarda en caché por producto, por tienda y por idioma, y se muestra en la parte superior de la zona de opiniones de la ficha de producto.
Puede desactivar la visualización sin eliminar la clave mediante la opción Mostrar el resumen IA en la página de producto.
Rich snippets y visualización en el front-office
Cuando la opción Rich Snippets está activa, el módulo inyecta datos estructurados Schema.org (AggregateRating, Review, Offer, Brand) en cada ficha de producto que alcanza el número mínimo de opiniones configurado. Compruebe el resultado con la herramienta de prueba de resultados enriquecidos de Google tras el paso del robot.
En cuanto a la visualización, el módulo se engancha a los hooks nativos del tema:
displayProductAdditionalInfo: las estrellas y la nota media bajo el título del producto;displayProductExtraContent: la pestaña «Opiniones de clientes» con la lista, los filtros y el formulario;displayProductListReviews: las estrellas en los listados de categoría;displayCustomerAccount: el enlace «Mis opiniones» en la cuenta del cliente.
Estos hooks existen en los temas Classic y Hummingbird. En un tema a medida que los haya eliminado, hay que restablecerlos en las plantillas correspondientes; de lo contrario las opiniones no se mostrarán en ningún sitio.
Moderar las opiniones
La pantalla Catálogo → Opiniones Verificadas muestra un panel de control (total, publicadas, pendientes, denunciadas, nota media, solicitudes en cola) seguido de la lista completa de opiniones.
Por defecto, cada opinión espera su validación. Active Aprobación automática si prefiere la publicación inmediata. Desde la lista puede aprobar o rechazar en masa, y abrir una opinión para editarla o responderla.
La respuesta del comerciante se muestra públicamente bajo la opinión. Si hay una clave OpenAI configurada, un botón Sugerencia IA de respuesta propone un borrador adaptado al tono de la opinión, para releer y ajustar antes de guardar, nunca para publicar tal cual.
Fotos de clientes
Los clientes pueden adjuntar hasta N fotos por opinión (3 por defecto). Formatos aceptados: JPEG, PNG y WebP, 5 MB máximo por archivo. El tipo real del archivo se verifica en la recepción, con independencia de su nombre.
Las imágenes se almacenan en modules/dfreviews/uploads/. Incluya esa carpeta en sus copias de seguridad: eliminar una opinión elimina también sus archivos.
Importar y exportar opiniones
Desde la pantalla Opiniones Verificadas, el botón Exportar CSV produce un archivo UTF-8 separado por puntos y coma, legible directamente en Excel. El bloque de importación, justo debajo, permite cargar un archivo con el mismo formato.
Dos columnas son obligatorias: id_product y rating (de 1 a 5). Las demás son opcionales: customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply y date_add. Las líneas cuyo producto no existe se ignoran y se señalan. Marque Aprobar automáticamente para publicar directamente las opiniones importadas.
Lo más sencillo para preparar una migración desde Trustpilot o un módulo antiguo: exportar primero un archivo desde el módulo para recuperar la cabecera exacta y volcar después sus datos.
Multitienda y multiidioma
Toda la configuración es independiente por subtienda: clave OpenAI, estado disparador, plazos, colores, incentivo. Las opiniones están aisladas por id_shop, de modo que un mismo producto presente en varias tiendas puede mostrar conjuntos de opiniones distintos según el contexto.
Las opiniones y los resúmenes IA se almacenan con su id_lang. Un resumen se genera para el idioma en el que se solicita.
Pasar de PrestaShop 8 a PrestaShop 9
No se necesita ninguna migración de datos: el esquema es idéntico en las dos ramas. Sustituya el módulo por la versión 1.1.0 antes o después de su actualización de PrestaShop, en el orden que prefiera.
Si actualiza desde una 1.0.x en una tienda ya migrada a PS 9, dos puntos a tener en cuenta: las versiones anteriores a la 1.1.0 no se instalan en PS 9 (el registro de hooks sin método correspondiente se rechaza) y la configuración existente se conserva íntegramente durante la actualización.
Resolución de problemas
No se envía ningún correo de solicitud. Compruebe primero que el CRON se ejecuta realmente llamando su URL a mano: la respuesta JSON indica el número de envíos. Revise después el estado disparador configurado y los ajustes de correo de la tienda en Parámetros avanzados → E-mail.
Las estrellas no aparecen en la ficha de producto. Es probable que el tema no llame a los hooks listados arriba. Compruebe también que hay al menos una opinión publicada: sin opinión activa no se muestra nada.
El resumen IA no se genera. Hacen falta tres opiniones publicadas como mínimo y una clave OpenAI válida y con saldo. Los errores de llamada a la API se registran en Parámetros avanzados → Logs.
Las estrellas no aparecen en Google. La indexación tarda de unos días a unas semanas. Verifique el marcado con la herramienta de prueba de resultados enriquecidos y compruebe que otro módulo SEO no inyecta un segundo bloque Product en competencia en la misma página.
La importación CSV no hace nada. Era un defecto de las versiones 1.0.x, corregido en la 1.1.0.