Bundles, add-ons and "frequently bought together"

Tres módulos de venta: paquetes (bundles), complementos de producto (add-ons) y “comprados juntos habitualmente” (FBT). Cada uno funciona de forma independiente.

Paquetes de productos

El módulo de paquetes permite crear conjuntos de productos configurables con un descuento compartido. El cliente compra un paquete como un único producto, y los componentes individuales se ven en los detalles del pedido.

La composición por producto está en la pestaña Polski Pro del editor de productos, consulte Per-product settings.

Configuración

Active Paquetes de productos en Polski > Módulos (identificador de módulo product_bundles).

Ajuste	Valor predeterminado	Descripción
Activar paquetes	No	Activa la funcionalidad de paquetes
Tipo de descuento	Porcentaje	`percent` (porcentual) o `fixed` (importe fijo)
Descuento predeterminado	10%	Descuento aplicado a los paquetes nuevos
Mostrar ahorro	Sí	Muestra al cliente el importe del ahorro

Crear un paquete

Vaya a Productos > Añadir nuevo
En la sección Datos del producto, seleccione el tipo “Paquete Polski PRO”
En la pestaña Componentes del paquete, añada productos
Establezca la cantidad de cada componente
Configure el descuento (sobrescribe el predeterminado)

Cálculo del descuento

El precio del paquete se calcula automáticamente:

Cena pakietu = Suma cen składników - Rabat

Przykład (rabat 15%):
Produkt A: 100 zł x 1 = 100 zł
Produkt B:  50 zł x 2 = 100 zł
Suma:                    200 zł
Rabat (15%):              30 zł
Cena pakietu:            170 zł

Si un componente del paquete está en oferta, en los cálculos se utiliza el precio de oferta.

Shortcode del paquete

[polski_bundle product_id="456" show_savings="yes" layout="grid"]

Parámetro	Obligatorio	Descripción
`product_id`	Sí	ID del producto-paquete
`show_savings`	No	Mostrar el importe del ahorro (`yes`/`no`)
`layout`	No	Disposición: `grid`, `list`, `compact`

Hooks de paquetes

/**
 * Filtruje obliczoną cenę pakietu.
 *
 * @param float $bundle_price Obliczona cena pakietu
 * @param array $items        Składniki pakietu z cenami
 * @param float $discount     Wartość rabatu
 */
apply_filters('polski_pro/bundles/price', float $bundle_price, array $items, float $discount): float;

Ejemplo - precio mínimo del paquete:

add_filter('polski_pro/bundles/price', function (float $bundle_price, array $items, float $discount): float {
    $minimum_price = 49.99;
    return max($bundle_price, $minimum_price);
}, 10, 3);

/**
 * Akcja wywoływana po dodaniu pakietu do koszyka.
 *
 * @param string $cart_item_key Klucz pozycji w koszyku
 * @param int    $bundle_id    ID produktu-pakietu
 * @param array  $items        Składniki pakietu
 */
do_action('polski_pro/bundles/added_to_cart', string $cart_item_key, int $bundle_id, array $items);

Complementos de producto

El módulo de complementos permite mostrar productos opcionales de upsell directamente en la página del producto. El cliente puede seleccionar productos adicionales y comprarlos con un solo clic junto al producto principal.

Configuración

Los complementos no necesitan activarse. El servicio arranca con Polski PRO y los complementos se configuran por producto.

Ajuste	Valor predeterminado	Descripción
Activar complementos	No	Activa la funcionalidad de complementos
Posición de visualización	Después del botón de carrito	Dónde mostrar la sección de complementos
Encabezado de la sección	“Dodaj do zamówienia”	Texto del encabezado sobre la lista de complementos
Cantidad máxima	5	Límite de complementos mostrados por producto

Asignar complementos

Los complementos se configuran en el editor de producto, en la pestaña Complementos Polski PRO:

Haga clic en “Añadir complemento”
Seleccione un producto del catálogo
Establezca el precio del complemento (por defecto, el precio del producto)
Opcionalmente, establezca un precio promocional del complemento
Establezca el orden de visualización

Los complementos pueden tener un precio distinto al del producto de origen - esto permite ofrecer precios especiales “con producto”.

Validación de la selección

El módulo valida:

Disponibilidad en stock de cada complemento seleccionado
Corrección de los precios (si no se modificaron en el lado del cliente)
Límites de cantidad

Hooks de complementos

/**
 * Filtruje listę dodatków dla produktu.
 *
 * @param array       $addons  Tablica dodatków z cenami
 * @param \WC_Product $product Produkt główny
 */
apply_filters('polski_pro/addons/items', array $addons, \WC_Product $product): array;

Ejemplo - filtrar complementos según el rol del usuario:

add_filter('polski_pro/addons/items', function (array $addons, \WC_Product $product): array {
    if (current_user_can('wholesale_customer')) {
        foreach ($addons as &$addon) {
            $addon['price'] = $addon['price'] * 0.8; // 20% rabatu hurtowego
        }
    }
    return $addons;
}, 10, 2);

Comprados juntos habitualmente

El módulo de recomendaciones muestra los productos que se compran con más frecuencia junto al producto visualizado, con la posibilidad de añadir varios productos al carrito con un solo clic.

Configuración

Active Comprados juntos habitualmente en Polski > Módulos (identificador de módulo frequently_bought_together).

Ajuste	Valor predeterminado	Descripción
Activar módulo	No	Activa las recomendaciones
Origen de datos	Manual	`manual` o `auto` (según el historial de pedidos)
Límite de productos	3	Número máximo de productos recomendados
Encabezado de la sección	“Często kupowane razem”	Texto del encabezado de la sección
Posición	Debajo de la descripción corta	Dónde mostrar la sección

Asignación manual

En el editor de producto, pestaña Comprados juntos habitualmente:

Busque y añada productos relacionados
Establezca el orden de visualización
Opcionalmente, establezca un descuento por la compra conjunta

Recomendaciones automáticas

Cuando el origen de datos se establece en auto, el módulo analiza el historial de pedidos e identifica los productos que se compran con más frecuencia juntos. El análisis se ejecuta una vez al día mediante WP-Cron.

Añadir al carrito

La sección “Comprados juntos habitualmente” muestra:

Casillas de verificación junto a cada producto recomendado
Miniaturas y nombres de los productos
Precios individuales de los productos
Precio total de los productos seleccionados
Botón “Añadir todos al carrito”

El cliente marca los productos deseados y los añade con un solo clic. Todos los productos se añaden al carrito como artículos independientes.

Shortcode

[polski_fbt product_id="789" limit="4" show_prices="yes"]

Parámetro	Obligatorio	Descripción
`product_id`	No	ID del producto principal (por defecto, el actual)
`limit`	No	Número máximo de recomendaciones
`show_prices`	No	Mostrar precios (`yes`/`no`)

Hooks de FBT

/**
 * Filtruje listę rekomendowanych produktów.
 *
 * @param array $product_ids Tablica ID rekomendowanych produktów
 * @param int   $product_id  ID produktu głównego
 * @param string $source     Źródło: 'manual' lub 'auto'
 */
apply_filters('polski_pro/fbt/products', array $product_ids, int $product_id, string $source): array;

Ejemplo - excluir productos de una categoría concreta:

add_filter('polski_pro/fbt/products', function (array $product_ids, int $product_id, string $source): array {
    $excluded_category_id = 42;
    return array_filter($product_ids, function (int $id) use ($excluded_category_id): bool {
        return ! has_term($excluded_category_id, 'product_cat', $id);
    });
}, 10, 3);

Interacción de los módulos

Los tres módulos pueden funcionar simultáneamente en el mismo producto:

Un paquete con complementos asignados y una sección de comprados juntos habitualmente
Los componentes del paquete pueden tener sus propios complementos
Las recomendaciones de FBT pueden apuntar a paquetes

El orden de visualización en la página del producto se configura mediante las prioridades de los hooks de WooCommerce.

Resolución de problemas

El precio del paquete no se actualiza tras cambiar los precios de los componentes El precio del paquete se calcula dinámicamente. Vacíe el Object Cache y los transients de WooCommerce.

Los complementos no se muestran en la página del producto Compruebe si el tema es compatible con el hook woocommerce_after_add_to_cart_button. Algunos temas personalizados omiten los hooks estándar de WooCommerce.

Las recomendaciones automáticas están vacías El módulo necesita datos históricos - las recomendaciones automáticas aparecen tras acumular un número suficiente de pedidos. Compruebe si la tarea de WP-Cron polski_pro_fbt_analyze está programada.

Siguientes pasos

Informar de problemas: GitHub Issues
Módulos relacionados: Prepedidos, Modo catálogo

Esta página tiene únicamente carácter informativo y no constituye asesoramiento legal. Consulte a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.