PS PrestaShop Intermedio

Box Builder (Mix & Match): guía completa

Instalar, configurar y explotar Box Builder en PrestaShop 8 y 9: cajas por número de artículos o por peso, huecos en pasos, 5 modelos de precio con el precio por peso, opciones de regalo, disponibilidad, visualización en el catálogo, modificación desde el carrito, stock y estadísticas.

Actualizado Versión del módulo 1.4.0

Presentación

Box Builder (Mix & Match) (dfboxbuilder) añade una página donde tus clientes componen su propia caja con los productos que tú seleccionas. Eligen los artículos en una cuadrícula, siguen una barra de progreso, ven cómo se actualizan el precio de la caja y el ahorro, y añaden la caja al carrito. La caja se llena por número de artículos o por peso. Cada caja es una línea del carrito con su propio precio; su composición se puede leer en el carrito, en el pedido y en la factura.

Crea tantas cajas como necesites, cada una con sus productos, sus reglas, su modelo de precio y su periodo de venta. Un mismo catálogo puede alimentar cajas muy distintas (caja de aperitivo, caja de Navidad, caja de bombones por peso, pack descubrimiento…).

Compatibilidad

  • PrestaShop 8.x y 9.x
  • PHP 7.4 a 8.x
  • Tienda única y multitienda
  • Interfaz en 5 idiomas: FR, EN, ES, DE, IT
  • Tema Classic, Hummingbird y temas personalizados (configurador en JavaScript nativo, sin jQuery)
  • Sin dependencias (ni Composer ni framework)

Instalación y actualización

  1. En el back office, abre Módulos > Gestor de módulos.
  2. Haz clic en Subir un módulo y selecciona dfboxbuilder.zip.
  3. Abre la pestaña Box Builder añadida al menú para crear tu primera caja.

Para actualizar, sube el nuevo ZIP de la misma manera: los scripts de actualización se ejecutan automáticamente (nuevas columnas, nuevos hooks, URL amigables generadas a partir de los nombres de las cajas). Las cajas existentes siguen llenándose por número de artículos.

Al guardar una caja por primera vez, el módulo crea un producto técnico que lleva la caja en el carrito. Está oculto por defecto; puedes mostrarlo en tus categorías (ver Visualización en el catálogo). Su ficha de producto siempre redirige al configurador. Al eliminar una caja se elimina también este producto.

Ajustes del módulo

El panel de ajustes, encima de la lista de cajas, tiene tres opciones:

  • Mostrar las cajas en la página de inicio: bloque en el hook displayHome.
  • Color de acento: color de la barra de progreso, de las pestañas de paso y de los elementos destacados. Indica el color principal de tu tema (por ejemplo #8a5a2b); déjalo vacío para el azul por defecto. El color del texto encima se elige automáticamente para que sea legible.
  • Después de añadir una caja al carrito: ir a la página del carrito (por defecto) o quedarse en el configurador. Si se queda, el bloque del carrito del tema se actualiza y abre su ventana de confirmación; luego el cliente puede componer otra caja.

En la lista de cajas, el menú de cada línea ofrece Abrir la página del configurador y Duplicar. La copia conserva precios, tarifas decrecientes, huecos, fuentes, plantillas, restricciones y grupos; se crea inactiva. Para una caja por peso, las columnas Mín. y Máx. muestran los pesos.

Crear una caja

El formulario de una caja tiene seis pestañas.

General

  • Nombre, descripción, texto del botón: por idioma.
  • URL amigable: por idioma, generada a partir del nombre si la dejas vacía. Con las URL amigables de PrestaShop activadas, la página de la caja tiene la dirección /box/ID-url-amigable.
  • Llenar la caja por: Número de artículos (por defecto) o Peso (ver Cajas por peso).
  • Artículos mín. / máx. (llenado por número de artículos): límites de la composición (0 = sin máximo).
  • Peso mínimo / máximo (llenado por peso): en la unidad de peso de la tienda; 0 = sin máximo, el mismo valor para un peso exacto.
  • Permitir el mismo artículo varias veces y unidades máximas por artículo.
  • Ocultar los productos sin stock: si no, siguen visibles pero no se pueden añadir.
  • Activar «Sorpréndeme», activar guardar y compartir, activa.

Disponibilidad

  • Disponible desde / hasta: periodo de venta. Antes de la fecha de inicio, la página de la caja muestra «Esta caja estará disponible a partir del …»; después de la fecha de fin, la caja se retira de los carritos que aún la contienen.
  • Stock limitado (cajas): número máximo de cajas vendidas, sumando todas las tiendas, sin contar los pedidos cancelados (0 = ilimitado). El formulario muestra las vendidas y las que quedan; la página de la caja muestra «Edición limitada: quedan N».
  • Mostrar en el catálogo: en ningún sitio (por defecto), categorías y búsqueda, solo categorías o solo búsqueda, con las categorías donde colocar la caja.
  • Grupos de clientes: ningún grupo marcado = todo el mundo. Si no, solo los grupos marcados ven y piden la caja.
  • Sugerir la caja en las fichas de producto: añade «Compón una caja con este producto» en la ficha de cada producto que contiene la caja.

Precio

Todos los precios se introducen sin impuestos, en la moneda por defecto. La caja tiene su propia regla de impuestos, aplicada en el carrito según la dirección del cliente.

  • Precio fijo: un precio único, sea cual sea el contenido.
  • Tramos por volumen: el precio depende del número de artículos (p. ej. desde 3 artículos: 25 €, desde 6: 45 €). El cliente ve «Añade 2 artículo(s) más y tu caja baja a …».
  • Suma de productos con descuento: suma de los precios de los artículos menos un porcentaje. Los precios de los artículos se muestran entonces en la cuadrícula.
  • Precio por hueco: cada hueco tiene un precio por artículo (requiere huecos).
  • Precio por peso: peso total de los artículos por un precio por unidad de peso (por kg si la tienda usa kg). Las tarifas decrecientes opcionales cambian ese precio a partir de un peso de caja, y toda la caja pasa a la nueva tarifa: con 30 € el kg y 26 € el kg desde 1 kg, una caja de 1,05 kg cuesta 27,30 €. El cliente ve el precio por kilo actual y «Añade 100 g más y el precio baja a 26,00 € / kg». Este modelo también funciona con cajas llenadas por número de artículos.

Mostrar el ahorro compara el precio de la caja con el de los artículos comprados por separado, a los precios actuales de tu catálogo: «En lugar de 34,00 €: ahorras 5,20 € (-15 %)».

Recompensas al completar la caja: producto de regalo y/o envío gratis, concedidos por una regla de carrito con código secreto, de un solo uso, válida solo mientras la caja está en el carrito. El texto de la recompensa se muestra en el configurador.

Opciones de regalo:

  • Mensaje de regalo con una longitud máxima (1 a 500 caracteres). El mensaje aparece en el pedido en el back office y en la factura.
  • Envoltorio de regalo con su precio sin impuestos (0 = gratis), añadido al precio de la caja.

Composición

Los productos elegibles provienen de productos añadidos uno a uno (búsqueda por nombre, referencia o ID) o de categorías completas. Cada combinación de un producto es un artículo seleccionable, con su propio stock, precio y peso.

Usar huecos estructura la caja, por ejemplo «2 salados + 1 dulce». Cada hueco tiene un nombre por idioma, un mínimo, un máximo, un precio por artículo (modelo por hueco) y sus propias fuentes. En la tienda, los huecos se convierten en pasos numerados.

Plantillas

Cajas precompuestas que el cliente aplica con un clic y luego ajusta. Los productos de una plantilla también deben ser elegibles en la caja.

Restricciones

Pares de productos que no pueden estar en la misma caja. El configurador impide la combinación y el servidor la rechaza.

Cajas por peso

Para una caja de bombones, un surtido de tés o una caja a granel, el cliente llena la caja hasta un peso en lugar de contar artículos.

  1. Pestaña General: Llenar la caja por = Peso y después un peso mínimo y/o máximo. Ejemplo: 1 y 1,2 para una caja de 1 a 1,2 kg; 1 y 1 para exactamente 1 kg. Al menos uno de los dos es obligatorio.
  2. Pestaña Precio: funcionan todos los modelos de precio. Precio por peso cobra la caja por kilo, con tarifas decrecientes si hace falta; un precio fijo sirve para una caja vendida a 35 € sea cual sea el surtido.
  3. Comprueba el peso de los productos: ficha de producto, pestaña Transporte, e impacto en el peso de cada combinación.
  • Peso de un artículo: peso del producto + impacto de la combinación, el mismo valor que PrestaShop usa para el envío.
  • Productos sin peso: no se ofrecen en una caja por peso ni en una caja con precio por peso, y el bloque de las fichas de producto no sugiere la caja en su página. El formulario de la caja muestra cuántos productos elegibles están afectados.
  • Configurador: peso en cada tarjeta, en el resumen y en la vista rápida; contador y barra de progreso en g / kg («800 g / 1,2 kg», mínimo marcado); un artículo que superaría el máximo se desactiva con «Supera el peso restante»; mientras no se alcanza el mínimo, el cliente ve «Añada 200 g más para completar su caja».
  • Reglas de artículos: en modo peso, los artículos mín. / máx. de la caja no se aplican; los huecos, los duplicados, las unidades máximas por artículo y las incompatibilidades siguen activos.
  • Sorpréndeme llena la caja dentro del rango de peso.
  • Carrito, pedido y factura: el peso total se muestra con la composición.
  • Visualización de los pesos: en gramos por debajo de 1 kg y en kilos por encima, con el separador decimal del idioma del visitante.

En la tienda

El configurador

  • Pasos: con huecos, unas pestañas numeradas muestran el avance («Salado 2/3»). Cuando un paso está lleno, el configurador pasa al siguiente; un botón «Siguiente» aparece en cuanto un paso está completo.
  • Cuadrícula: a partir de 8 productos aparecen un buscador (sin tener en cuenta los acentos), un filtro por categoría y un orden por nombre o precio. Un clic en la imagen o el nombre abre la vista rápida (imagen, descripción, enlace a la ficha, botón Añadir). Los artículos elegidos tienen un botón «-«.
  • Resumen: contador con la regla (mín. 5, máx. 6, o en peso para una caja por peso), barra de progreso con el mínimo marcado, vista previa de la caja (una casilla por artículo), precio, ahorro, recompensa por desbloquear y opciones de regalo. Lo que aún falta se indica en azul («Añade 2 artículo(s) más…»); el rojo se reserva para los bloqueos reales.
  • Móvil: cuadrícula de dos columnas, plantillas y pasos con desplazamiento horizontal, barra fija con el número de artículos (o el peso) y el precio, que pasa a «Añadir al carrito» cuando la caja es válida.
  • Sorpréndeme llena la caja al azar respetando las reglas; Guardar y compartir genera un enlace que vuelve a cargar la composición.

El servidor siempre recalcula el precio a partir de tu catálogo; una composición enviada por el navegador se verifica de nuevo (productos, combinaciones, huecos, peso, stock) antes de añadirla al carrito.

Modificar una caja desde el carrito

En el carrito y en el proceso de pedido, la composición de la caja va seguida de un enlace Modificar esta caja. Vuelve a abrir el configurador con la composición y las opciones de regalo; el botón pasa a «Actualizar mi caja». Al confirmar, la caja se sustituye en el mismo lugar, con la misma cantidad. En el tema Classic, la composición y el enlace están en la ventana de personalización de la línea del carrito.

Visualización y captación

  • Página de la caja: enlace «Abrir la página del configurador» en el formulario y en la lista. Dirección /box/ID-url-amigable con URL amigables, etiqueta canónica y selector de idioma que apunta a la URL del idioma elegido.
  • Página de inicio: bloque con las cajas disponibles (ajuste del módulo).
  • Widget: el bloque se puede colocar en cualquier hook de visualización (Diseño > Posiciones) o en una plantilla: {widget name='dfboxbuilder'}, {widget name='dfboxbuilder' id_dfbox=3} o {widget name='dfboxbuilder' title='Nuestras cajas'}.
  • Fichas de producto: bloque «Compón una caja con este producto» (hasta 3 cajas), que abre el configurador con el producto ya añadido.
  • Catálogo: con «Mostrar en el catálogo», la caja aparece en las categorías elegidas y/o en la búsqueda. El precio mostrado es el precio «desde» (composición válida más barata, con impuestos y descuento de grupo; para una caja por peso, al peso mínimo o en la tarifa decreciente más ventajosa); una caja de precio fijo muestra su precio. El enlace lleva al configurador y no hay botón de añadir al carrito.

El filtro de precio de la navegación por facetas y el orden por precio usan el precio guardado del producto técnico, que es 0: una caja visible aparece primero al ordenar por precio ascendente.

En los bloques solo aparecen las cajas activas, dentro de su periodo de venta, no agotadas y permitidas para el grupo del visitante. Al desactivar una caja se desactiva también su producto técnico, que desaparece de los listados.

Carrito, pedidos y stock

  • Precio por línea: el precio de la caja se guarda en su línea del carrito; dos cajas con composiciones distintas conservan cada una su precio. Se aplican los descuentos de grupo de clientes; las reglas de precio del catálogo y los descuentos por cantidad no se aplican a las cajas.
  • Stock de los componentes: se comprueba al añadir, en todo el carrito (otras cajas y productos comprados sueltos). Si el cliente sube la cantidad de una caja por encima del stock, se reduce al máximo posible en la página del carrito, con un mensaje.
  • Pedidos: el stock de cada componente se descuenta al validar el pedido, se devuelve si el pedido pasa a cancelado o error de pago, y se vuelve a descontar si se reactiva. Un pedido creado directamente en error no descuenta stock.
  • Cajas no disponibles: una caja eliminada, desactivada, terminada, aún no iniciada o reservada a otro grupo se retira del carrito en las páginas de carrito y pedido, también después de «Volver a pedir».
  • Back office y factura: la composición (por hueco), el envoltorio, el mensaje de regalo y, para una caja por peso, el peso total se muestran en el pedido y en la factura.

Estadísticas

El botón de estadísticas de la lista abre un panel con selector de periodo (7, 30, 90 o 365 días):

  • cajas pedidas, facturación sin impuestos, media de artículos por caja, conversión (pedidos / visitas);
  • por caja: visitas al configurador, añadidas al carrito, pedidos, cajas, tasa de añadido, conversión, facturación y precio medio;
  • artículos más elegidos y combinaciones más pedidas.

Las visitas y los añadidos se cuentan desde la versión 1.2.0, sin robots; los pedidos cancelados se excluyen.

Seguimiento con Google Analytics 4

Tras añadir una caja, el configurador envía un evento add_to_cart a window.dataLayer (si Google Tag Manager o gtag.js están presentes) con currency, value y el artículo dfbox-ID. También se lanza un evento dfbox:added en document con los mismos datos, para otras herramientas.

Preguntas frecuentes y solución de problemas

Los botones no hacen nada o la página queda vacía

Vacía la caché de PrestaShop (Parámetros avanzados > Rendimiento) y, durante las pruebas, desactiva la combinación de archivos JS/CSS. Comprueba que la caja está activa, asociada a la tienda y tiene al menos una fuente de productos.

La cuadrícula está vacía

Las fuentes deben contener productos activos y disponibles para pedir en la tienda actual. Si está activada la opción de ocultar los productos sin stock, estos no aparecen. En una caja por peso o con precio por peso, tampoco aparecen los productos sin peso.

Un producto no aparece en una caja por peso

No tiene peso. Indícalo en la ficha de producto, pestaña Transporte, o en el impacto en el peso de sus combinaciones. El aviso en la parte superior del formulario de la caja indica cuántos productos elegibles están afectados.

Una caja visible en una categoría muestra 0,00 €

Actualiza el módulo a la versión 1.2.1 o posterior: los listados muestran entonces el precio «desde».

La caja no aparece para un cliente

Revisa las fechas de venta, el stock limitado y los grupos de clientes en la pestaña Disponibilidad.

El enlace «Modificar esta caja» no aparece

Solo se muestra en el carrito y en el proceso de pedido, para una caja que sigue disponible. En el tema Classic, abre la ventana de personalización de la línea.

El stock de los componentes no baja

Se descuenta al validar el pedido, no al añadir al carrito, y solo si la gestión de stock está activada. Un pedido cancelado devuelve el stock.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte