# Guías de compra PrestaShop 8 y 9: documentación > Presentación El módulo crea páginas de guía de compra a partir de tu catálogo. Cada guía responde a una pregunta del cliente, por ejemplo «¿Qué robot aspirador elegir para un… - Página: - Idioma: es - Actualizado el: 2026-09-24 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/buying-guide-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/buying-guide-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/buying-guide-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/buying-guide-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/buying-guide-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/buying-guide-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/buying-guide-prestashop/index.md) - Índice: ## Presentación El módulo crea páginas de guía de compra a partir de tu catálogo. Cada guía responde a una pregunta del cliente, por ejemplo «¿Qué robot aspirador elegir para un piso con mascotas?». Eliges los productos comparados y los criterios, el módulo calcula una puntuación sobre 100 para cada producto, designa tres selecciones y genera la clasificación, la tabla comparativa, las estadísticas y la FAQ. La clasificación se recalcula cuando cambia el catálogo. ## Instalación 1. En **Módulos > Gestor de módulos**, haz clic en **Subir un módulo** y selecciona `dfbuyingguide-1.1.0.zip`. 2. La instalación crea la pestaña **Catálogo > Guías de compra**, las tablas del módulo y la carpeta `img/dfbuyingguide/` para las imágenes de portada. 3. El botón **Configurar** del módulo abre directamente esa pestaña. Desde la versión 1.0.0, basta con subir el ZIP 1.1.0: el script de actualización añade las columnas y las tablas de estadísticas sin tocar tus guías. ## Ajustes generales El panel **Ajustes**, bajo la lista de guías, contiene: - **Prefijo de URL**: `guides` por defecto. Las guías se sirven en `/guides/url-de-la-guia` y el índice de todas las guías en `/guides`. - **Antigüedad máxima de una clasificación**: 12 horas por defecto. Pasado ese plazo, la clasificación se recalcula en la siguiente visita aunque el catálogo no haya cambiado, lo que sigue las promociones programadas. - **Productos analizados por guía**: 300 por defecto. Los productos más vendidos del alcance se analizan primero. Súbelo para categorías grandes, hasta 5.000. - **Mostrar la insignia de la guía en las fichas de producto**: los productos con una selección o un puesto en el top 3 muestran un enlace a la guía. - **Mostrar las guías en las páginas de categoría**: un bloque al final de las categorías lista las guías cuyo alcance contiene la categoría. - **Medir audiencia y ventas**: activa las estadísticas y la cookie de atribución `dfbg_attr` (ver más abajo). ## Crear una guía Haz clic en **Añadir una guía de compra**. Los campos principales: - **Título**: escríbelo como la pregunta del cliente. Una guía solo se publica en los idiomas en los que tiene título. - **URL amigable**: se genera a partir del título si queda vacía. - **Imagen de portada**: se muestra en la parte superior de la guía, en la página de guías y al compartir en redes. Formato horizontal, al menos 1.200 px de ancho. Se redimensiona a 1.600 px de ancho como máximo. - **Autor** y **Cargo del autor**: se muestran bajo el título y se incluyen en los datos estructurados. - **Introducción**: a quién va dirigida la guía y qué importa para ese uso. - **Productos comparados**: las categorías del alcance. Ninguna categoría marcada significa todo el catálogo. **Incluir subcategorías** está activo por defecto. - **Precio mínimo** y **Precio máximo**: 0 significa sin límite. El precio es el que ven los visitantes, en la moneda por defecto. Útil para una guía como «los mejores modelos por menos de 300 €». - **Solo productos en stock**: descarta los productos agotados cuando la gestión de stock está activa. - **Productos en la clasificación**: de 1 a 20, 5 por defecto. Las selecciones se muestran siempre, aunque queden fuera de esa clasificación. - **Umbral de la selección presupuesto reducido**: 50 % por defecto (ver «Las tres selecciones»). - **Permitir a los visitantes adaptar la clasificación**, **Mostrar la tabla comparativa**, **Mostrar las preguntas frecuentes**. - **Preguntas adicionales**: una pregunta por línea, con el formato `Pregunta | Respuesta`. Se añaden después de las preguntas generadas. - **Conclusión**, **Meta título** y **Meta descripción**: el título y el inicio de la introducción sirven de valor por defecto. - **Publicada**: una guía no publicada puede previsualizarse desde el back office. Haz clic en **Guardar y permanecer**: los paneles de criterios, clasificación actual, audiencia e historial aparecen bajo el formulario. ## Los criterios Sin criterios, los productos se clasifican por ventas. Haz clic en **Añadir un criterio** y elige un tipo. ### Tipos de criterios - **Característica: valores preferidos**: das de 0 a 100 puntos a cada valor de una característica, por ejemplo Material: acero inoxidable 100, aluminio 70, plástico 30. Tras el primer guardado, el formulario muestra todos los valores de la característica con un deslizador y botones para rellenar todos los valores a la vez. Un producto con varios valores conserva el mejor. - **Característica: valor numérico**: el módulo lee el número del valor («90 min», «1.200 W», «2,5 kg») y compara los productos. Elige en **Valores preferidos** si es mejor el más alto o el más bajo. **Valor mínimo** y **Valor máximo** excluyen los productos fuera de rango o sin valor. **Unidad** se añade a las cifras de las estadísticas. - **Precio (más bajo es mejor)**. - **Ventas (popularidad)**: basado en las cantidades vendidas. - **Productos recientes**: basado en la fecha de alta del producto. ### Peso, obligación y textos - **Peso**: de 0 a 10. El peso 0 muestra el criterio en la tabla comparativa sin usarlo en la puntuación. - **Obligatorio** (criterios de característica): los productos sin esa característica, o cuyo valor tiene 0 puntos, quedan fuera de la guía. - **Etiqueta mostrada a los visitantes**: si queda vacía se usa el nombre de la característica. - **Consejo de compra**: explica por qué importa el criterio. Aparece en la sección «Cómo elegir», encima de las estadísticas del catálogo. Las flechas de la lista de criterios cambian su orden de visualización en la tabla comparativa y en la sección «Cómo elegir». ## Cálculo de la puntuación Para cada criterio, los valores de los productos se llevan a una escala de 0 a 100: el mejor producto del alcance obtiene 100 y el peor 0 en los criterios numéricos, precio, ventas y novedad, y en los criterios de valores se aplican los puntos que has dado. La puntuación global es la media de las puntuaciones ponderada por el peso de los criterios. Los precios se comparan en la moneda por defecto. El panel **Clasificación actual** muestra los 20 primeros productos con su puntuación global, su precio, su selección y una columna de puntuación por criterio. Úsalo para ajustar los pesos antes de publicar. ## Las tres selecciones - **Mejor opción global**: el producto clasificado primero. - **Mejor relación calidad-precio**: entre los productos más baratos que la mejor opción cuya puntuación alcanza al menos el 60 % de la suya, el que tiene la mejor relación entre puntuación y precio. - **Mejor con presupuesto reducido**: el producto más barato que alcanza el porcentaje fijado en **Umbral de la selección presupuesto reducido** de la puntuación de la mejor opción, si es más barato que las otras dos selecciones. Una selección solo aparece si un producto cumple la condición. Los puntos fuertes de un producto son sus criterios con 70 o más (3 como máximo), los puntos a tener en cuenta los que tienen 30 o menos (2 como máximo). ## Actualización de las clasificaciones La modificación de un producto, un precio específico, un valor de característica o una categoría marca las clasificaciones para recalcular. Un cambio de stock solo marca las guías configuradas con «Solo productos en stock». El recálculo se hace: - en la siguiente visita de la guía; - con la tarea cron, si la programas; - con el botón **Recalcular ahora** de una guía o **Recalcular todas las clasificaciones ahora** de la lista. ### Tarea cron La URL cron aparece encima de la lista de guías. Llámala cada hora para que los visitantes nunca esperen un recálculo. Añade `&force=1` para recalcular todas las guías. El botón **Nuevo token** sustituye el token y la URL anterior deja de funcionar. Ejemplo: ``` 0 * * * * curl -s "https://tu-tienda.es/index.php?fc=module&module=dfbuyingguide&controller=cron&token=TU_TOKEN" > /dev/null ``` ### Fecha mostrada e historial La fecha «Clasificación actualizada el» que ven los visitantes solo cambia si cambian los primeros puestos o las selecciones. El panel **Historial de recomendaciones** lista esos cambios con los 5 primeros productos en cada fecha. Los hooks de un módulo no se ejecutan para un empleado cuyo perfil no tiene el permiso «Ver» sobre el módulo. Si tu equipo modifica el catálogo con un perfil así, la tarea cron y la antigüedad máxima de las clasificaciones actúan como red de seguridad. ## La página de la guía En orden: título, autor, número de productos comparados y fecha de actualización, imagen de portada, introducción, índice, las selecciones, la clasificación, la tabla comparativa, la sección «Cómo elegir», la conclusión, la FAQ, una nota de método y las guías relacionadas (guías publicadas que comparten una categoría). ### Adaptar la clasificación Si la opción está activa y la guía tiene al menos 2 criterios con peso, un panel encima de la clasificación ofrece un deslizador de importancia por criterio y un deslizador de presupuesto máximo. La clasificación se recalcula en el navegador entre los 20 mejores productos, sin recargar, y un enlace vuelve a la clasificación de la guía. Sin JavaScript, el panel permanece oculto. Los buscadores ven siempre la clasificación de la guía. ### Añadir al carrito Los productos que se añaden directamente al carrito, sin combinación que elegir, muestran un botón **Añadir al carrito** que usa el añadido al carrito del tema. Los demás muestran **Ver el producto**. En modo catálogo no se muestra ningún botón de carrito. ### Vista previa de una guía no publicada El botón **Vista previa de la guía** abre la página con un aviso de vista previa. El enlace lleva un token propio de la guía, la página está en `noindex` y las estadísticas no se cuentan. ### Personalizar los colores Los colores se definen con variables CSS que tu tema puede sobrescribir: `--dfbg-accent`, `--dfbg-accent-soft`, `--dfbg-muted`, `--dfbg-line`, `--dfbg-surface`, `--dfbg-low` y `--dfbg-radius`. Las fuentes son las del tema. ## Ubicaciones y SEO - **Índice de guías**: `/guides`, con la imagen de portada o el producto clasificado primero de cada guía. - **Páginas de categoría**: hook `displayFooterCategory`. - **Fichas de producto**: hook `displayProductAdditionalInfo`, insignia de selección o «Puesto n.º X» con enlace a la guía. - **Ubicación libre**: `{hook h='displayDfBuyingGuides' id_category=12}` en una plantilla del tema. Sin `id_category` se listan todas las guías. - **Sitemap**: si el módulo nativo gsitemap está instalado, el índice y las guías se añaden con la fecha de su último cambio de recomendación. - **Datos estructurados**: Article (con autor e imagen), ItemList de la clasificación y FAQPage. Las etiquetas Open Graph se añaden en la cabecera. - **Multiidioma**: canonical, hreflang hacia cada idioma en el que la guía tiene título, y redirección 301 cuando se abre una URL en otro idioma. ## Audiencia y ventas La lista de guías muestra las visitas y los ingresos de los últimos 30 días, y cuatro indicadores globales arriba. Cada guía tiene un panel **Audiencia y ventas** para 30 días y desde el inicio: - **Visitas**: una por visitante, por guía y por día, sin robots. - **Clics en productos** y tasa de clics respecto a las visitas. - **Clics de añadir al carrito** desde la clasificación. - **Visitantes que adaptaron la clasificación**. - **Pedidos** y tasa de conversión respecto a las visitas. - **Ingresos sin impuestos**: importe sin impuestos de los productos que vienen de la guía, convertido a la moneda por defecto. ### Atribución de las ventas Cuando un visitante pulsa un producto desde una guía, la cookie propia `dfbg_attr` recuerda el producto y la guía durante 30 días. Cuando el producto entra en el carrito, la atribución se copia al carrito. Al validarse el pedido, también mediante un webhook de pago, el pedido y el importe sin impuestos de ese producto se atribuyen a la guía. Solo se cuentan los pedidos validados (estado pagado o equivalente). La cookie `dfbg_attr` se crea al hacer clic sin pasar por tu gestor de consentimiento. Indícala en tu política de cookies o desactiva la opción **Medir audiencia y ventas**. ## Duplicar una guía La acción **Duplicar** de la lista copia la guía con sus criterios, sus puntos por valor, sus tiendas y su imagen. La copia se crea sin publicar, con una URL con sufijo, y se abre directamente para editarla. ## Multitienda Cada guía se asigna a las tiendas elegidas en su formulario. Las clasificaciones, el historial y las estadísticas se calculan tienda por tienda. ## Solución de problemas - **«Ningún producto corresponde a esta guía»**: revisa las categorías, el rango de precios, la opción de stock y los criterios obligatorios o con umbrales. - **Falta un producto esperado**: debe estar activo, visible en el catálogo y entre los productos analizados. Sube «Productos analizados por guía» para categorías grandes. - **La guía devuelve un error 404**: no está publicada, no tiene título en ese idioma o no está asignada a esa tienda. - **La clasificación no refleja un cambio**: haz clic en «Recalcular ahora» y programa la tarea cron. - **Se rechaza la imagen de portada**: comprueba que la carpeta `img/dfbuyingguide/` tiene permisos de escritura.