Showcase Revolution: configuración y ayuda

Sube e instala mprshowcaserevolution en Módulos > "Module Manager". Haz clic en "Configure" para abrir el panel. Usa "Improve" > Showcase Revolution para acceder a "Widgets", Colecciones y Ajustes > Configuración. El submenú Ajustes también contiene Integridad, Licencia, Soporte y Actualizar.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.

Para una primera prueba, abre "Widgets", añade un widget, introduce un Título y elige Tipo de widget: "New Products", Hook (ubicación): "Homepage (displayHome)", Diseño: "Grid", Número de productos: 8 y Activo: Sí. Introduce 4 productos por fila de escritorio y 2 por fila de móvil. Guarda y abre la página de inicio.

Funciones

Usa el estado de activación del módulo en "Module Manager", o el ajuste Activo de un widget, para controlar la visualización real. El campo de configuración independiente "Enable module" no sustituye a estos controles.

Valores predeterminados de widgets

Estas son preferencias globales guardadas. Los widgets existentes tienen sus propios campos. Configura cada widget nuevo de forma explícita; no supongas que cambiar una preferencia global actualiza los valores de los widgets guardados o rellena todos los campos del editor.

Tendencias

Usa el control de recálculo manual de tendencias del panel después de recopilar vistas. Las puntuaciones combinan las vistas registradas y las ventas de pedidos válidos. Las vistas de productos se registran mediante actionObjectProductViewAfter; confirma que tu tienda o integración emite ese hook. El registro de reposiciones usa actionUpdateQuantity y compara la cantidad visible en los datos almacenados con la nueva cantidad del hook. Verifica esta transición con tu proceso de actualización de stock.

Rendimiento

El HTML que contiene precios o controles para añadir al carrito se excluye de la caché HTML compartida de los widgets. También se excluyen las fuentes personales. Los carruseles compatibles con Warehouse tienen una caché adicional de selección y fichas ligeras; los datos personalizados de los productos de la primera fila se renderizan en el contexto del visitante.

Estilos del tema

Los valores predeterminados proceden del sistema compartido de estilos del tema. El módulo registra --mpr-sc-primary, --mpr-sc-accent, --mpr-sc-filter-bg, --mpr-sc-radius, --mpr-sc-shadow-hover y --mpr-sc-transition. "Card gap" tiene el valor predeterminado 16px y proporciona --mpr-sc-gap. Cambia los controles de estilo compartidos cuando necesites ajustar la paleta detectada o el espaciado. Las correspondencias de primary-hover y sombra normal no están disponibles.

El editor tiene las pestañas Configuración, Visualización y Avanzado. Los valores siguientes describen los valores predeterminados del esquema; introduce valores explícitos cuando un formulario nuevo esté vacío.

Configuración

Las fuentes son "Best Sellers", "New Products", "On Sale", "Featured Products", "Trending Now", "Curated Collection", "Back in Stock", "Recently Viewed" y "Cart Recommendations". "Recently Viewed" aparece en la lista, pero no devuelve productos; no la selecciones para un bloque que deba funcionar.

"Cart Recommendations" necesita un módulo MPR Sales Revolution activado, un carrito cargado y productos en él. Las otras fuentes funcionan independientemente de esa integración. "Featured Products" usa Ámbito de categoría o la categoría configurada de productos destacados. No todas las fuentes aplican Ámbito de categoría, incluidas las rutas de colecciones y recomendaciones del carrito.

Visualización

"Grid", "Slider" y "Carousel" suelen usar la miniatura de producto nativa del tema en las versiones modernas de PrestaShop. PrestaShop 1.6 tiene una plantilla antigua del módulo. "List" y "Compact" usan plantillas más pequeñas del módulo. Los puntos y la reproducción automática se pasan al renderizador actual del carrusel.

Avanzado

Ordenar por se guarda, pero las fuentes automáticas mantienen su propio orden de consulta. Clase CSS está vacío de forma predeterminada y añade una clase al contenedor. CSS personalizado está vacío de forma predeterminada y genera un bloque de estilos. Posición tiene el valor predeterminado 0 y ordena los widgets dentro de un hook.

CSS personalizado no se limita automáticamente al widget. Incluye Clase CSS en tus selectores:

.homepage-staff-picks .mpr-showcase-widget__title {
  text-transform: uppercase;
}

La base de datos también guarda sort_dir con el valor predeterminado DESC y show_manufacturer con el valor predeterminado 0; estos no son controles del formulario actual del widget.

Crea una colección con Nombre, una Descripción opcional de texto enriquecido, Tipo, Fecha de inicio, Fecha de fin, Activo y Posición. El nombre y la descripción están vacíos de forma predeterminada, Tipo es curated, las fechas están vacías, Activo es Sí y Posición es 0. Los tipos incluyen curated, staff_picks, seasonal y spotlight.

Añade los productos seleccionados, reordénalos y guarda un widget con Tipo de widget: "Curated Collection" y la Colección correspondiente. Los productos usan su posición guardada en la colección.

Las fechas y Activo afectan a las consultas de colecciones que solicitan una selección solo de elementos activos. La búsqueda directa de productos de la colección del widget no comprueba esos campos de programación. Controla un widget de colección con su propio interruptor Activo; no dependas de las fechas de la colección para ocultar un widget ya asignado.

Por ejemplo, crea una colección llamada Summer Picks y configura:

Title: Summer Picks
Widget Type: Curated Collection
Collection: your saved collection
Hook (Placement): displayHome
Layout: Grid
Products Count: 8
Active: Yes

Los hooks compatibles son:

displayHome
displayFooterCategory
displayLeftColumn
displayRightColumn
displayFooterBefore
displayFooterProduct
displayProductAdditionalInfo
displayOrderConfirmation2
displayCrossSellingShoppingCart
displayNotFound

El tema debe llamar al hook seleccionado. Para un pie de producto personalizado:

{hook h='displayFooterProduct'}

No hay ningún renderizador de shortcodes CMS. Usa un hook compatible.

Las rutas de sobrescritura del tema incluyen:

themes/your_theme/modules/mprshowcaserevolution/views/templates/front/widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/_product-miniature-widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/list-item.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/compact-item.tpl

Los selectores útiles incluyen .mpr-showcase-widget, sus modificadores --grid, --slider, --carousel, --list y --compact, .mpr-showcase-widget__title, .mpr-showcase-widget__subtitle, .mpr-showcase-widget__link, .mpr-showcase-slider__nav, .mpr-list-item y .mpr-compact-item.

1. Confirma que tu primer widget "Grid" muestra productos en el hook seleccionado.
2. Cámbialo a "Slider" y prueba las flechas, los puntos y la reproducción automática en escritorio y móvil.
3. Comprueba los controles de precios y de añadir al carrito en tu tema real.
4. Haz clic en un producto del widget e inspecciona la solicitud trackClick si te interesa registrar los clics.
5. Prueba por separado una fuente de colección y de recomendaciones del carrito antes de reutilizarlas en otros lugares.

No se genera ningún contenedor si una fuente no devuelve productos que puedan mostrarse. Comprueba el estado activo, la asociación con la tienda actual, el hook exacto, los requisitos de la fuente, la categoría, las imágenes de portada y la cantidad de productos. "Best Sellers" necesita ventas y "Trending Now" necesita vistas registradas y un recálculo. "Back in Stock" necesita transiciones de stock registradas. "Recently Viewed" no devuelve productos en esta versión.

Si los cambios tardan en aparecer, ten en cuenta las cachés fijas de 30 minutos y la caché de tu tienda/tema. Si parece que se ignora la programación de las colecciones, usa el control Activo del propio widget. Si un tema ignora los indicadores de precio o de botón, revisa su plantilla de miniaturas.

Exporta o anota los widgets y las colecciones antes de desinstalar. La desinstalación elimina el menú de administración, el registro de gestión de columnas, el registro del tema y las tablas del esquema que pertenecen al módulo, incluidos los widgets, las colecciones, las tendencias y los datos de seguimiento. La desinstalación estándar elimina los registros de hooks. Si falla la limpieza del tema, el método se detiene antes de eliminar el resto de la configuración. Elimina todas las llamadas manuales a hooks del tema y las sobrescrituras que hayas añadido.