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.

Requisitos

Polski PRO requiere: Polski (gratis) v1.3.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+

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.

Configuración

Vaya a WooCommerce > Ajustes > Polski PRO > Paquetes y active el módulo (opción polski_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

1. Vaya a Productos > Añadir nuevo
2. En la sección Datos del producto, seleccione el tipo “Paquete Polski PRO”
3. En la pestaña Componentes del paquete, añada productos
4. Establezca la cantidad de cada componente
5. 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

Vaya a WooCommerce > Ajustes > Polski PRO > Complementos y active el módulo (opción polski_addons).

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:

1. Haga clic en “Añadir complemento”
2. Seleccione un producto del catálogo
3. Establezca el precio del complemento (por defecto, el precio del producto)
4. Opcionalmente, establezca un precio promocional del complemento
5. 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

Vaya a WooCommerce > Ajustes > Polski PRO > Comprados juntos habitualmente y active el módulo (opción polski_fbt).

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:

1. Busque y añada productos relacionados
2. Establezca el orden de visualización
3. 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.