Distintivos para paquetes de productos: configuración y ayuda

En tu Back Office, abre Módulos > "Module Manager", elige "Upload a module" y sube el ZIP del módulo. Instálalo y haz clic en "Configure". En versiones anteriores de PrestaShop, utiliza la página de módulos correspondiente.

Abre Ajustes de productos pack y deja Activar insignias de pack activado. Su valor predeterminado es Sí. Este es el único ajuste del comportamiento de los packs. Controla la decoración de los listados, el marcador antes del precio, los productos incluidos y la utilidad de URL para rutas compuestas únicamente por una reescritura.

Requiere PrestaShop 1.7 o posterior y PHP 7.1 o posterior.

Modifica la referencia de cada producto correspondiente para que empiece por mpr-pack-, por ejemplo mpr-pack-starter, mpr-pack-seo-tools o mpr-pack-bathroom-kit. Guarda el producto y abre un listado que lo contenga. El estado de pack nativo de PrestaShop por sí solo no es la regla de detección de este módulo.

La etiqueta Pack se proporciona mediante actionProductFlagsModifier cuando está disponible, para que el tema pueda mostrarla con sus indicadores nativos. Se conserva cualquier indicador de pack nativo existente. JavaScript añade un .product-flag.pack de estilo nativo a la lista de indicadores del tema cuando es necesario. Solo las tarjetas sin esa lista utilizan la superposición de respaldo .mpr-pack-badge del módulo.

El hook displayProductListReviews muestra el indicador de pack con el texto "Bundle: Save Big". Ese texto es una etiqueta de visualización; el módulo no calcula ahorros ni crea descuentos. No añade una clase especial de borde o sombra a las tarjetas de packs. Los estilos del tema siguen determinando el aspecto de las tarjetas.

La configuración del módulo no tiene editor de contenido. Pide a tu administrador de bases de datos que añada la asociación entre pack y producto a la tabla mpr_pack_content con el prefijo. Sustituye ps_ por el prefijo real de tus tablas y utiliza identificadores de productos reales:

INSERT INTO ps_mpr_pack_content (id_pack, id_product, position) VALUES
(100, 12, 0),
(100, 34, 1),
(100, 56, 2);

La tabla instalada tiene las columnas sin signo id_pack, id_product y position. La posición predeterminada es 0. La clave primaria es (id_pack, id_product), con un índice en id_pack.

En un producto con el prefijo de referencia requerido, displayProductExtraContent añade "What's Included (N modules)" cuando se pueden cargar productos activos coincidentes. Los productos se ordenan por position. Las tarjetas contienen un enlace, un nombre, una imagen o el texto de sustitución Sin imagen, y un precio o "FREE" si el precio almacenado es cero o negativo. El renderizador lee el precio base de la tabla de productos y le da formato en la moneda actual. No lo utilices como prueba del precio de venta final específico del cliente, con impuestos incluidos o convertido.

Esta asociación sirve para la visualización. No crea un pack nativo de PrestaShop, no gestiona las existencias de sus componentes ni cambia lo que se entrega mediante el proceso de compra. La consulta utiliza las filas de idioma de los productos para el idioma y la tienda actuales; no exige por completo la activación de los productos incluidos en la tienda mediante product_shop.

Tu listado de productos debe exponer la referencia del producto a los hooks. Una tarjeta compatible puede contener:

<article class="product-miniature js-product-miniature">
  <div class="thumbnail-container">
    {* product image here *}
  </div>
  {hook h='displayProductPriceBlock' product=$product type='before_price'}
  {hook h='displayProductListReviews' product=$product}
</article>

El marcador oculto antes del precio no es una insignia visible por sí solo. Las superposiciones de respaldo buscan .product-miniature__top, .thumbnail-container o .product-image-container. JavaScript observa el contenido insertado bajo #js-product-list y decora los nuevos indicadores de pack tras las actualizaciones AJAX del listado. Prueba tu tema si sustituye todo el contenedor observado.

Ajusta la superposición de respaldo en la hoja de estilos de tu tema cuando sea necesario:

.mpr-pack-badge {
  top: .5rem;
  right: .5rem;
  background-color: #3BAF5C;
}

Puedes sobrescribir desde la hoja de estilos de tu tema las variables que utilizan la insignia de respaldo, el indicador de ahorro y las tarjetas de productos incluidos:

:root {
  --mprpackproducts-success: #3BAF5C;
  --mprpackproducts-bg: #fff;
  --mprpackproducts-bg-secondary: #D8F0E0;
  --mprpackproducts-border: rgba(59, 175, 92, 0.2);
  --mprpackproducts-radius: 0.375rem;
  --mprpackproducts-shadow-hover: 0 8px 24px rgba(0, 0, 0, 0.1);
}

El módulo integra las variables de ThemeDetector bajo --mprpackproducts-*. Edita solo las variables que utilizan tus hojas de estilos instaladas. El estilo nativo de .product-flag.pack procede del tema. No hay controles en el Back Office para el texto, la forma o el color de las etiquetas ni para diseños por pack.

El módulo activado también contiene una utilidad para resolver rutas ambiguas de productos/categorías/CMS/fabricantes compuestas únicamente por una reescritura. No es una pantalla general de configuración de URL amigables. Prueba las URL limpias existentes después de cambiar el interruptor principal.

1. Confirma que una referencia empieza por el prefijo exacto mpr-pack-.
2. Abre un listado de categoría y de búsqueda que contenga ese producto activo. Comprueba el indicador Pack/pack nativo y el indicador del listado.
3. Cambia un filtro por facetas o provoca una actualización AJAX y confirma que la nueva tarjeta conserva su indicador.
4. Si falta el indicador, comprueba Activar insignias de pack, los datos de referencia del producto, la ubicación de los hooks y el marcado de la tarjeta. Un indicador de pack nativo existente puede sustituir la etiqueta Pack del módulo.
5. Si falta la pestaña, comprueba las filas de asociación, los datos de activación/idioma de los productos incluidos y la compatibilidad del tema con el contenido adicional del producto.
6. Utiliza "Integrity" si faltan tablas o hooks obligatorios. En versiones anteriores de PrestaShop, comprueba la disponibilidad de la API de configuración regional si la pestaña de contenido provoca un error.

Desactiva Activar insignias de pack para detener la función temporalmente. Desinstala mediante "Module Manager" para eliminar la configuración y la tabla mpr_pack_content. Haz antes una copia de seguridad de las asociaciones. La desinstalación también limpia el registro de ThemeDetector; si esa limpieza falla, la desinstalación se detiene para que puedas corregir el problema y volver a intentarlo. Las referencias de los productos no se revierten.

Requiere PrestaShop 1.7 o posterior y PHP 7.1 o posterior.