Sales Revolution: configuración y ayuda

1. Sube e instala mprsalesrevolution.zip mediante Módulos > "Module Manager".
2. Haz clic en "Configure". Llegarás a Sales Revolution > Panel de control.
3. Selecciona el contexto de tienda previsto y abre Sales Revolution > Configuración.
4. Revisa los ajustes de recomendaciones, campañas, VAT y numeración antes de usar la tienda.
5. Empieza con un par de productos y prueba una ubicación del tema que use pares, como el bloque de recomendaciones del carrito/ventana modal.
6. Configura el ejecutor cron antes de depender de la automatización de campañas.
7. Verifica los productos mostrados, los precios reales del carrito y los análisis con una sesión de cliente de prueba.

El módulo ofrece las páginas Panel de control, Pares de productos, Reglas de recomendación, Ofertas bundle, Campañas, Descuentos dinámicos, Programador de campañas, Analítica, Configuración y Verificación del sistema. También proporciona las páginas Licencia, Soporte y Actualizar.

Algunos ajustes de estas pantallas se guardan pero no tienen efecto en la versión actual; las tablas siguientes indican cuáles.

Abre Sales Revolution > Configuración. Haz clic en Guardar después de cambiar los campos.

Funciones y visualización

Encontrarás estos ajustes en las pestañas Características, Visualización, Filtrado y Algoritmo. Que exista un ajuste no significa que todas las ubicaciones lo utilicen.

Campos guardados sin efecto

Los siguientes campos se guardan en el formulario de configuración, pero no cambian las recomendaciones, la visualización ni el seguimiento. Conserva sus valores predeterminados salvo que tu propia integración los utilice.

El motor real de recomendaciones puede usar pares manuales, compras conjuntas, reglas, productos similares, datos de vistas conjuntas y tendencias. Cada ubicación proporciona listas de algoritmos distintas. La venta cruzada del pie de producto usa resultados similares/de tendencias y una alternativa, por lo que añadir un par manual no obliga a esa sección concreta a mostrarlo.

Pares de productos

Abre Sales Revolution > Pares de productos y añade un registro. Selecciona Producto de origen y Producto objetivo. Elige Tipo de par: venta cruzada, venta de una opción superior, accesorio o pack. El modelo usa por defecto venta cruzada, Bidireccional desactivado, Prioridad 0 y Activo activado.

Activa Bidireccional para crear la relación en ambas direcciones. Los pares con mayor prioridad se seleccionan primero en la ruta de pares. Guarda y prueba una ubicación que utilice pares manuales. Un tipo de par pack es una relación de recomendación, no una prueba de descuento de pack al finalizar la compra.

Reglas de recomendación

Abre Reglas de recomendación. Establece Nombre, Descripción opcional, Tipo de regla, Prioridad, Límite de productos y Activo. Usa Condiciones del producto para elegir productos, categorías o fabricantes de origen, con Precio mín. y Precio máx. opcionales. Usa Filtros de recomendación para elegir el conjunto sugerido y su rango de precios.

Por ejemplo, selecciona las categorías de origen 12 y 18, con precios de 50 a 200, y recomienda productos del fabricante 4. El JSON guardado mantiene los filtros de origen en conditions, los de destino en recommendations y los límites de precio en _price_min y _price_max.

Las reglas afectan a las rutas de recomendación que incluyen el algoritmo de reglas. No sustituyen al algoritmo similar/de tendencias seleccionado explícitamente en cada sección de producto.

Ofertas de packs

Abre Ofertas bundle para gestionar Nombre, Activo, Productos en pack, Tipo de descuento, Valor del descuento, Cantidad mínima, Usos totales máx., Usos máx. por cliente, Fecha de inicio y Fecha de fin. El modelo usa por defecto un descuento porcentual, valor 0, y proporciona cálculos de precio/uso de packs.

La versión actual guarda los packs y muestra una vista previa en el back office, pero no los vende en la tienda: no aparece ningún botón de pack y no se aplica ningún descuento de pack en el carrito. No anuncies un descuento de pack solo porque haya un pack guardado.

Abre Sales Revolution > Campañas. Introduce Nombre de la campaña y elige Tipo de campaña, Tipo de descuento, Valor del descuento, Prioridad, Activo, Acumulable, Productos objetivo, Fecha de inicio y Fecha de fin.

Los tipos de campaña compatibles son venta flash, programada, recurrente, cuenta atrás, compra anticipada, última oportunidad y oferta limitada. Los tipos de descuento son porcentaje, importe y precio fijo. El modelo usa por defecto programada, porcentaje, descuento 0, prioridad 0, activa sí y acumulable no.

Selecciona explícitamente productos, categorías o fabricantes de destino. Las campañas utilizan los elementos incluidos seleccionados; no se aplican las exclusiones ni las selecciones de todos los elementos.

Guardar una campaña manual conserva su registro, alcance y datos de visualización de la oferta, pero no cambia los precios de los productos. Los descuentos reales del catálogo (precios específicos nativos) solo los crean Descuentos dinámicos y Programador de campañas. Comprueba el precio del producto y del carrito antes de publicar una promoción.

Campos de ofertas limitadas

Para una oferta limitada, configura:

Por ejemplo, crea una oferta limitada con un descuento del 15 por ciento, un límite positivo de cantidad 100, fechas válidas y activa Páginas de producto y Página de inicio. Confirma por separado el precio real y ambos widgets.

Velocidad simulada

Velocidad simulada está desactivada por defecto en los formularios de campañas manuales. Guarda las unidades fantasma separadas de las unidades realmente vendidas. Los controles disponibles incluyen Modo velocidad (predeterminado steady), Unidades fantasma (0), Duración de drenaje (24 horas), Intervalo mín. (300 segundos), Intervalo máx. (3600 segundos) y Factor de aceleración (0.80).

Si configuras unidades fantasma, el progreso no es únicamente un recuento de unidades compradas. Revisa esa presentación de forma consciente. El ejemplo de 10 unidades fantasma durante 24 horas es una configuración de progreso simulado, no un historial real de ventas.

En Configuración > Ofertas limitadas:

En Configuración > Banner de cuenta atrás:

La pestaña de configuración Campañas también muestra Mostrar cuenta atrás, Mostrar insignia, Mostrar precio original y Mostrar ahorros, todos activados por defecto; "Countdown Style" tiene como predeterminado simple; Color de la insignia es #ff0000; "Badge Text Color" es #ffffff; "Price Display" tiene como predeterminado replace; "Combine Discounts" y "Priority Over Specific Prices" están desactivados por defecto.

Estos campos globales de campaña se guardan pero no tienen efecto en la versión actual. Las opciones de visualización vienen de cada campaña y del programador, y las reglas nativas de PrestaShop deciden cómo se acumulan los descuentos, así que "Combine Discounts" y "Priority Over Specific Prices" no cambian la acumulación.

Descuentos dinámicos

Abre Sales Revolution > Descuentos dinámicos para el rotador automático de promociones. Los nuevos rotadores están inactivos. Establece Nombre del rotador, Nombre de la promoción opcional, conjunto de destino, límites de descuento, cantidad y duración antes de activarlo.

Los valores predeterminados del formulario son descuento porcentual, Descuento mín. 10, Descuento máx. 50, Límite de cantidad 3, Duración (horas) 24, Drenaje automático (unidades fantasma) activado, Tasa de drenaje (horas por unidad) 8, Modo velocidad constante, Tiempo de espera (horas) 72, Máx. ofertas simultáneas 1, Período de enfriamiento del producto (días) 14 y Precio mín./Precio máx. 0.

Revisa explícitamente el drenaje automático antes de activarlo. Un nuevo rotador puede simular unidades presentadas como adquiridas. Configura su desencadenante y conjunto de productos, y verifica después la campaña generada y los precios específicos nativos.

Programador de campañas

Abre Programador de campañas. Configura Nombre, Activo, Modo bucle, Número de bucles o Repetir hasta y Plantilla de nombre de campaña. Los nuevos registros del programador están inactivos y pendientes; el modo de bucle predeterminado es infinito.

Construye la Secuencia de fases con una categoría, selección de subcategoría, número de productos, tipo/valor de descuento, duración, umbral de ventas opcional y reglas de nueva selección aleatoria para cada fase. Revisa Configuración de visualización y Estado e historial. Inicia solo después de comprobar las fases y el ejecutor cron. El programador crea campañas reales y sincroniza los precios nativos.

Ejecuta el programador

El módulo proporciona un punto de entrada autenticado mediante token. Usa el token cron del módulo desde el panel cron del back-office:

php modules/mprsalesrevolution/cron.php --token=YOUR_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

https://example.com/modules/mprsalesrevolution/cron.php?token=YOUR_TOKEN&max-tasks=20&max-seconds=55&context=cron

Los metadatos de las tareas compartidas incluyen:

Comprueba el resultado de cada tarea por separado: el éxito general de la respuesta HTTP no significa que todas las tareas hayan terminado. Desactivar "Activar las campañas" detiene nuevas campañas y rotaciones, pero no elimina los descuentos ya creados en los productos, así que revisa sus precios específicos.

VAT / impuestos B2B

Prueba el guardado de direcciones y el cálculo real de impuestos con la configuración de tu tienda antes de usar estos valores predeterminados. La disponibilidad de VIES y el paquete compartido de validación afectan al resultado.

Numeración de pedidos y facturas

Las familias de tokens compatibles incluyen partes de fecha {YYYY}, {YY}, {MM}, {DD}; contador principal {N} con relleno como {NNNNNN}; contadores globales y de cliente como {GLOBAL_N} y {CUSTOMER_N}; y valores contextuales como {CUSTOMER_REF}, {PRODUCT_REF}, {SHOP_ID}, {SHOP_NAME}, {CART_ID} y {COUNTRY} cuando estén disponibles en ese contexto de generación. {DOC_TYPE} es para formatos de documentos, no para referencias de pedido. La generación de pedidos también rechaza {ORDER_ID}, {INVOICE_ID} y {PAYMENT}.

Conserva un contador y suficiente información de alcance/fecha para el modo de reinicio seleccionado. El validador de ajustes puede rechazar formatos que provoquen colisiones. Prueba un pedido y una factura nuevos antes de un uso más amplio.

Tu tema debe llamar al hook. Las recomendaciones no se muestran en el resumen de compra ni en la confirmación de pedido y las ofertas no se insertan en las cuadrículas de categoría o búsqueda. El carrusel del pie muestra recomendaciones en lugar de ofertas limitadas.

Los títulos ingleses predeterminados incluyen More From This Category, Complete your cart, Works Great Together y Recommended Products. Los títulos predeterminados están disponibles en francés, alemán, español, italiano y polaco. El formulario de configuración no ofrece campos para editar estos cuatro títulos.

Usa "Theme styles" para actualizar los valores detectados, borrar valores personalizados y editar los controles de estilo compartidos. Para el CSS del tema, las clases existentes incluyen .mpr-product-crosssell, .mpr-product-crosssell__grid, .mpr-cart-recommendations, .mpr-cart-recommendations__slide, .mpr-deal-widget, .mpr-deal-progress, .mpr-countdown-bar y .mpr-countdown-bar__discount.

Comprueba Panel de control y Analítica después de hacer clic en una recomendación y realizar un pedido de prueba. Una conversión solo se registra cuando el pedido sigue a un clic en una recomendación. Los resultados de comprados juntos frecuentemente requieren suficiente historial de pedidos. Los fragmentos en caché reducen el trabajo repetido en las siguientes visitas a la página.

Si falta un bloque, comprueba su interruptor de función efectivo, el hook del tema, productos aptos, imágenes, reglas de existencias/acceso y fechas de campaña pertinentes. No esperes pares manuales en una ubicación que solo utiliza resultados similares/de tendencias.

Si aparece un widget de campaña pero los precios no cambian, mira los precios específicos del producto. Una campaña guardada manualmente no los crea; solo lo hacen Descuentos dinámicos y Programador de campañas. Comprueba los resultados de las tareas cron si hay programaciones detenidas. Con promociones superpuestas, prueba el precio en el carrito; los ajustes globales de acumulación no lo controlan.

Si falla el guardado de direcciones VAT durante una interrupción de VIES, comprueba "Bloquear cuando VIES no esté disponible". Si se rechazan los ajustes de numeración, corrige el contador requerido, el discriminador de reinicio o el token no compatible antes de guardar. Usa Verificación del sistema para las tablas del módulo y la infraestructura.

Antes de desinstalar, detén los rotadores/programadores, finaliza las promociones y verifica que se hayan limpiado los precios específicos nativos generados mientras el módulo siga disponible. Desactivar solo el renderizado de campañas no elimina las filas nativas de descuento. Haz una copia de los datos del módulo y los registros de numeración que necesites conservar.

Desactiva el módulo en Module Manager para detener sus hooks. La desinstalación elimina las tablas del módulo, el registro cron, el menú y la integración del tema. Los descuentos de catálogo generados permanecen tras eliminar sus vínculos con el módulo, así que revisa los precios del catálogo después. La desinstalación no revierte pedidos ni referencias de documentos ya emitidas.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.