DataFirefly Opiniones Verificadas: documentación
Opiniones de clientes verificadas para PrestaShop 1.7.8, 8 y 9: solicitudes de opinión por correo electrónico con valoración en un clic, fotos de clientes, respuestas del comerciante, panel de moderación, fragmentos enriquecidos de Google, importación desde Product Comments y resúmenes con IA opcionales.
Requisitos e instalación
DataFirefly Opiniones verificadas 2.0.0 funciona en PrestaShop 1.7.8, 8.x y 9.x, con PHP 7.4 a 8.5. Se ha probado en PrestaShop 9.1.5 (tema Hummingbird), 8.2.1 y 1.7.8.11 (tema Classic). Un único ZIP sirve para todas estas versiones.
- En el back office, abre Módulos → Gestor de módulos y haz clic en Subir un módulo.
- Arrastra el archivo
dfreviews-2.0.0.zipque has descargado desde tu cuenta de DataFirefly. - Haz clic en Configurar cuando termine la instalación.
La instalación crea ocho tablas propias y añade la entrada Catálogo → Opiniones de clientes. Una barra de navegación común enlaza las cuatro pantallas del módulo: Opiniones, Solicitudes de opinión, Importar / exportar y Ajustes.
El módulo se entrega traducido al francés, inglés, español, alemán, italiano, polaco, neerlandés y portugués: back office, tienda y correos electrónicos.
Panel y moderación
La pantalla Catálogo → Opiniones de clientes se abre con un panel: valoración media, opiniones pendientes y con avisos, tasa de respuesta (con el número de opiniones de 3 estrellas o menos que siguen sin respuesta), nuevas opiniones en 30 días y su tendencia, porcentaje de solicitudes que han recibido una opinión en 90 días, porcentaje de compras verificadas, gráfico de las últimas 12 semanas, desglose de valoraciones y productos con más opiniones.
La zona Por moderar muestra las opiniones pendientes y con avisos, primero las escritas en tu idioma. Para cada una: Publicar, Rechazar (o Despublicar), Responder enviando un correo al cliente y Sugerir una respuesta si el asistente de IA está configurado. Todo sin salir de la página.
Debajo del panel, la lista completa se puede filtrar por producto, valoración, estado (pendiente, publicada, con avisos), respuesta, fotos, idioma y fecha. Las acciones en bloque permiten publicar, despublicar, borrar los avisos o eliminar varias opiniones a la vez.
La ficha de una opinión reúne la valoración, el título, el texto, las fotos (que puedes eliminar una a una), los motivos de los avisos, los estados «publicada» y «compra verificada», así como la respuesta pública. Hay enlaces directos al cliente, al pedido y al producto.
Modifica el texto de una opinión solo para eliminar datos personales o expresiones ofensivas: los visitantes deben poder confiar en que las opiniones publicadas aparecen tal y como se escribieron.
Solicitudes de opinión por correo electrónico
En Ajustes → Solicitudes de opinión por correo electrónico, elige el estado o los estados de pedido que inician la cuenta atrás (normalmente Enviado o Entregado) y el plazo de envío (7 días por defecto). Solo se puede enviar un recordatorio, y únicamente si quedan productos por valorar. Los enlaces caducan tras el número de días que elijas, y puedes excluir grupos de clientes (B2B, personal…).
La pantalla Solicitudes de opinión muestra las solicitudes programadas, las que esperan una opinión, las respondidas y las bajas. Puedes enviar una solicitud o un recordatorio inmediatamente, cancelarlos e invitar a los clientes de los pedidos de los últimos N días.
El correo presenta cada producto del pedido con cinco estrellas en las que se puede hacer clic: un clic abre el formulario con la valoración ya seleccionada. Se envía en el idioma del pedido e incluye un enlace para darse de baja.
La página que se abre desde el correo no requiere iniciar sesión: el enlace demuestra la compra. Muestra todos los productos del pedido con una barra de progreso; el formulario de cada producto se abre al hacer clic en una estrella. Las opiniones enviadas desde esta página llevan la mención «Compra verificada».
Configurar el programador
Las solicitudes y los recordatorios los envía el programador. Programa uno de estos dos comandos para que se ejecute cada hora en tu alojamiento; aparecen, listos para copiar, en la parte superior de la página Ajustes:
php /ruta/a/prestashop/modules/dfreviews/cli/cron.php
curl -s "URL_DEL_PROGRAMADOR_MOSTRADA_EN_EL_MODULO"Se recomienda el comando PHP por línea de comandos, ya que no depende de una llamada HTTP. La fecha de la última ejecución se muestra en los ajustes y en la pantalla de solicitudes. El botón Ejecutar el programador ahora permite hacer una prueba inmediata.
La URL contiene un token secreto. No la publiques; si tienes dudas, haz clic en Generar un nuevo token y actualiza después tu tarea cron.
Visualización en la tienda
La valoración en estrellas y el número de opiniones se muestran debajo del precio en la página de producto (Classic, Hummingbird y temas hijo); al hacer clic, el visitante va al bloque de opiniones.
El bloque de opiniones presenta la valoración media, el histograma de valoraciones (en el que se puede hacer clic), el porcentaje de valoraciones de 4 y 5 estrellas, las fotos de los clientes y, a continuación, la lista con filtros (con fotos, compras verificadas, por valoración) y ordenación (más recientes, más útiles, valoración más alta, valoración más baja, primero con fotos, más antiguas). Cada opinión muestra su insignia «Compra verificada», la respuesta del comerciante, los votos de «útil» y un botón para informar sobre ella indicando el motivo.
Las fotos de los clientes se abren en un visor que se puede usar con el teclado (flechas, Esc).
Las estrellas también se muestran en los listados de productos (categorías, búsqueda, página de inicio), con el número de opiniones de forma opcional.
Formulario y fotos de clientes
El formulario es accesible con el teclado y con lectores de pantalla: estrellas como botones de opción y errores indicados campo por campo. El cliente puede añadir fotos arrastrándolas y soltándolas, verlas en vista previa y quitar alguna antes del envío. Una casilla le pide certificar que la opinión refleja su propia experiencia.
Las fotos (JPEG, PNG o WebP) se recodifican y redimensionan a 1600 px; se eliminan los datos de ubicación (EXIF). Se guardan en modules/dfreviews/uploads/, una carpeta que debes incluir en tus copias de seguridad.
Protección antispam integrada: token CSRF, campo trampa invisible, tiempo mínimo de escritura y límites por conexión.
«Mis opiniones» en la cuenta del cliente
El cliente encuentra las opiniones que ha escrito, su estado (publicada o en revisión), las respuestas de la tienda, su cupón de agradecimiento si lo hay y los pedidos que todavía esperan su opinión.
Responder a las opiniones
Tu respuesta se muestra públicamente debajo de la opinión. Marca Enviar un correo al cliente para avisarle: recibirá un correo en el idioma de su opinión, con un enlace a la página del producto.
Ajustes de visualización
La sección Visualización define la ubicación del bloque (sección a ancho completo debajo del producto, o pestaña en Classic / acordeón en Hummingbird), el número de opiniones por página, el color de las estrellas y el color de acento, las estrellas en los listados y la opción «Mostrar solo las opiniones escritas en el idioma del visitante»: en ese caso, la media y los fragmentos enriquecidos se calculan sobre esas mismas opiniones.
Si el módulo nativo Product Comments sigue activo, la opción Ocultar los widgets del módulo nativo Product Comments evita mostrar dos sistemas de opiniones en la misma página, sin modificar el módulo nativo.
Importación, exportación y resúmenes con IA
La pantalla Importar / exportar ofrece:
- Importar desde Product Comments: copia las opiniones del módulo nativo (valoración, título, texto, autor, fecha, estado de aprobación, votos de utilidad). El módulo nativo y sus datos no se modifican; las opiniones ya importadas se omiten, así que puedes volver a ejecutar la importación.
- Importación CSV: mismas columnas que la exportación; solo
ratingeid_product(oproduct_reference) son obligatorias. Las fechas se conservan. - Exportar a CSV: archivo UTF-8 que se abre en Excel, LibreOffice o Google Sheets, filtrable por estado y por valoración.
- Resúmenes con IA y Recalcular valoraciones.
El asistente de IA es opcional. Introduce una clave y, si hace falta, la URL de un servicio compatible con OpenAI (OpenAI, Mistral, proxy de Azure, modelo local…). Resume lo que dicen los clientes sobre los productos que tienen al menos 3 opiniones publicadas, en cada idioma activo, y propone respuestas. Solo se envían al proveedor los textos y las valoraciones de las opiniones, nunca nombres ni direcciones de correo electrónico.
Fragmentos enriquecidos de Google
En modo automático, si tu tema ya publica un objeto Product (Classic, Hummingbird), el módulo le añade la valoración media y el número de opiniones: la página conserva un único objeto Product. Si no, publica un objeto Product completo con las últimas opiniones. También puedes forzar uno de los dos modos o desactivar los datos estructurados. Tras activarlo, comprueba una página de producto con la prueba de resultados enriquecidos de Google.
Google acepta las opiniones de producto en una página de producto; el módulo nunca utiliza el marcado LocalBusiness u Organization, para el que Google rechaza las opiniones publicadas por la propia empresa.
Transparencia y cumplimiento normativo
La regla de publicación nunca depende de la valoración: las opiniones negativas y positivas se tratan de la misma forma. El bloque «¿Cómo se recopilan y verifican las opiniones?» se genera a partir de tus ajustes (moderación, compra verificada, cupón de agradecimiento, orden por defecto), conforme a la directiva europea Omnibus.
Datos personales: el nombre público se limita al nombre de pila y a la inicial del apellido; las direcciones IP se almacenan con hash; al eliminar un cliente, sus opiniones se anonimizan; se admiten las solicitudes de exportación y supresión del módulo oficial de RGPD (psgdpr).
Cupón de agradecimiento
Opcional: se puede ofrecer un cupón (porcentaje o importe, pedido mínimo, periodo de validez) después de una opinión, sea cual sea su valoración. Por defecto, está reservado a las compras verificadas, con un cupón por pedido. El cliente lo ve en pantalla y en «Mis opiniones», y el bloque de opiniones informa a los visitantes de que algunos autores han recibido un cupón.
Multitienda y multilingüe
Las opiniones, las solicitudes y las estadísticas son propias de cada tienda, y los ajustes se leen por tienda. Cada opinión conserva su idioma; una opinión escrita en otro idioma se indica al visitante, salvo que filtres por idioma.
Actualización desde la versión 1.x
Instala el ZIP 2.0.0 sobre la versión existente: PrestaShop ejecuta la migración automáticamente. Se conservan las opiniones, fotos, votos y solicitudes; tus ajustes de la 1.x (opiniones de invitados, aprobación automática, estado desencadenante, fragmentos enriquecidos) se convierten. Para que nada cambie en tu página de producto, el bloque se mantiene en la pestaña como en la 1.x; puedes pasar a la sección a ancho completo en los ajustes.
Desinstalación
Activa Conservar los datos al desinstalar para mantener las opiniones, fotos y solicitudes en la base de datos y recuperarlas tras reinstalar. Si no, la desinstalación elimina las tablas, los ajustes, las pestañas y las fotos.
Solución de problemas
No se envía ningún correo de solicitud. Comprueba la fecha de la última ejecución del programador y haz clic en Ejecutar el programador ahora en la pantalla de solicitudes. Revisa los estados desencadenantes y la configuración del correo electrónico de la tienda.
Se muestran dos bloques de opiniones. El módulo nativo Product Comments está activo: activa la opción que oculta sus widgets o desactívalo después de importar sus opiniones.
Las estrellas no aparecen. Debe haber al menos una opinión publicada. Si usas un tema a medida, comprueba que están presentes los hooks displayProductPriceBlock, displayFooterProduct (o displayProductExtraContent) y displayProductListReviews.
La media mostrada parece incorrecta tras una modificación directa en la base de datos. Usa Importar / exportar → Recalcular valoraciones.