Hooks pro výpočet slev

Tento obsah zatím není dostupný ve vašem jazyce.

Filtry pro úpravu výpočtu slev a zaokrouhlování cen.

Základ výpočtu slevy (Calculation Base Mode)

Každé pravidlo může mít nastavení calculation_base_mode, které určuje, z jaké ceny se sleva počítá:

Hodnota	Konstanta	Popis
`current_price`	`CalculationBaseModes::CURRENT_PRICE`	Sleva z aktuální ceny (po předchozích slevách) - výchozí
`original_price`	`CalculationBaseModes::ORIGINAL_PRICE`	Sleva vždy z běžné ceny (regular_price)

Příklad chování

Produkt: regular_price = 100 Kč
Pravidlo 1 (Product): -20% → cena = 80 Kč
Pravidlo 2 (BOGO): -50%

S calculation_base_mode = 'current_price':
  → 50% z 80 = 40 Kč (slevy se sčítají)

S calculation_base_mode = 'original_price':
  → 50% z 100 = 50 Kč (sleva z původní ceny)

Přístup k nastavení v kódu

use WpifyWooDiscountRule\Services\Rules;
use WpifyWooDiscountRule\Enums\CalculationBaseModes;

// V rámci pravidla
$calc_base_mode = $rule[ Rules::CALCULATION_BASE_MODE ] ?? CalculationBaseModes::CURRENT_PRICE;

if ( CalculationBaseModes::ORIGINAL_PRICE === $calc_base_mode ) {
    // Použít regular_price
    $base = $product->get_regular_price();
} else {
    // Použít aktuální cenu (může zahrnovat jiné slevy)
    $base = $product->get_price();
}

Úprava dat před výpočtem slevy

Filtr umožňuje upravit data před samotným výpočtem slevy.

apply_filters( 'wpify_woo_discounts_calculate_data', $data, $product, $rule, $range );

Parametry filtru

Parametr	Typ	Popis
`$data`	array	Data pro výpočet slevy (`original_price`, `calculation_base`, `discount_type`, `discount_value`)
`$product`	WC_Product	Produkt, na který se sleva aplikuje
`$rule`	array	Nastavení pravidla (včetně `calculation_base_mode`)
`$range`	array	Aktuální range/tier slevy

Příklady použití

Úprava slevy pro konkrétní kategorii

/**
 * Zvýšit slevu pro produkty v kategorii "akce"
 *
 * @param array      $data    Data pro výpočet
 * @param WC_Product $product Produkt
 * @param array      $rule    Pravidlo
 * @param array      $range   Range slevy
 *
 * @return array
 */
function boost_discount_for_sale_category( $data, $product, $rule, $range ): array {
    if ( has_term( 'akce', 'product_cat', $product->get_id() ) ) {
        // Zvýšit procentuální slevu o 5%
        if ( $data['discount_type'] === 'percentage' && isset( $data['discount_value'] ) ) {
            $data['discount_value'] += 5;
        }
    }
    return $data;
}
add_filter( 'wpify_woo_discounts_calculate_data', 'boost_discount_for_sale_category', 10, 4 );

Nastavení minimální slevy

/**
 * Zajistit minimální slevu 10%
 *
 * @param array      $data    Data pro výpočet
 * @param WC_Product $product Produkt
 * @param array      $rule    Pravidlo
 * @param array      $range   Range slevy
 *
 * @return array
 */
function ensure_minimum_discount( $data, $product, $rule, $range ): array {
    if ( $data['discount_type'] === 'percentage' ) {
        $data['discount_value'] = max( 10, $data['discount_value'] ?? 0 );
    }
    return $data;
}
add_filter( 'wpify_woo_discounts_calculate_data', 'ensure_minimum_discount', 10, 4 );

Úprava výsledku výpočtu slevy

Filtr umožňuje upravit výsledek po výpočtu slevy.

apply_filters( 'wpify_woo_discounts_calculate_product_discount', $result, $product, $rule, $range );

Parametry filtru

Parametr	Typ	Popis
`$result`	array	Výsledek výpočtu (`discounted_price`, `discount_amount`, `discount_percentage`)
`$product`	WC_Product	Produkt
`$rule`	array	Nastavení pravidla
`$range`	array	Range slevy

Příklady použití

Logování výpočtů slev

/**
 * Logovat všechny výpočty slev
 *
 * @param array      $result  Výsledek výpočtu
 * @param WC_Product $product Produkt
 * @param array      $rule    Pravidlo
 * @param array      $range   Range slevy
 *
 * @return array
 */
function log_discount_calculation( $result, $product, $rule, $range ): array {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( sprintf(
            'Discount calculated: Product #%d, Original: %s, Discounted: %s',
            $product->get_id(),
            $result['original_price'] ?? 'N/A',
            $result['discounted_price'] ?? 'N/A'
        ) );
    }
    return $result;
}
add_filter( 'wpify_woo_discounts_calculate_product_discount', 'log_discount_calculation', 10, 4 );

Úprava zaokrouhlování cen

Filtr umožňuje upravit logiku zaokrouhlování výsledné ceny po slevě.

apply_filters( 'wpify_woo_discounts_round_price', $rounded_price, $original_price, $rounding_mode, $rule );

Parametry filtru

Parametr	Typ	Popis
`$rounded_price`	float	Cena po zaokrouhlení (podle nastaveného režimu)
`$original_price`	float	Cena před zaokrouhlením (po slevě)
`$rounding_mode`	string	Režim: `whole`, `ending_99`, `ending_90`, `ending_9`
`$rule`	array	Kompletní data pravidla

Příklady použití

Vlastní zaokrouhlování pro VIP zákazníky

/**
 * Pro VIP zákazníky vždy zaokrouhlit dolů
 *
 * @param float  $rounded_price  Zaokrouhlená cena
 * @param float  $original_price Cena před zaokrouhlením
 * @param string $rounding_mode  Režim zaokrouhlování
 * @param array  $rule           Pravidlo
 *
 * @return float
 */
function vip_rounding( $rounded_price, $original_price, $rounding_mode, $rule ): float {
    if ( current_user_can( 'vip_member' ) ) {
        return floor( $original_price );
    }
    return $rounded_price;
}
add_filter( 'wpify_woo_discounts_round_price', 'vip_rounding', 10, 4 );

Zaokrouhlení na násobky 10

/**
 * Zaokrouhlit cenu na násobky 10
 *
 * @param float  $rounded_price  Zaokrouhlená cena
 * @param float  $original_price Cena před zaokrouhlením
 * @param string $rounding_mode  Režim zaokrouhlování
 * @param array  $rule           Pravidlo
 *
 * @return float
 */
function round_to_tens( $rounded_price, $original_price, $rounding_mode, $rule ): float {
    return round( $original_price / 10 ) * 10;
}
add_filter( 'wpify_woo_discounts_round_price', 'round_to_tens', 10, 4 );

Kontrola aplikace slevy (Subscriptions)

Filtr pro kontrolu, zda má být sleva aplikována. Používá se zejména pro WooCommerce Subscriptions.

apply_filters( 'wpify_woo_discounts_should_apply_discount', $should_apply, $rule );

Parametry filtru

Parametr	Typ	Popis
`$should_apply`	bool	Výchozí hodnota (true)
`$rule`	array	Rule data včetně `renewal_behavior`

Příklady použití

Zakázat bulk slevy na renewals

/**
 * Nikdy neaplikovat bulk slevy na renewal objednávky
 *
 * @param bool  $should_apply Výchozí hodnota
 * @param array $rule         Pravidlo
 *
 * @return bool
 */
function no_bulk_on_renewals( $should_apply, $rule ): bool {
    if ( function_exists( 'wcs_cart_contains_renewal' ) && wcs_cart_contains_renewal() ) {
        if ( ( $rule['rule_type'] ?? '' ) === 'bulk' ) {
            return false;
        }
    }
    return $should_apply;
}
add_filter( 'wpify_woo_discounts_should_apply_discount', 'no_bulk_on_renewals', 10, 2 );

Dostupné renewal behavior hodnoty:

first_order_only - Sleva jen na první objednávku
renewals_only - Sleva jen na renewal objednávky
both - Sleva na obojí (výchozí)

Úprava cílových produktů

Filtr umožňuje upravit seznam cílových produktů po jejich přípravě.

apply_filters( 'wpify_woo_discounts_targets_prepared', $targets, $rule );

Parametry filtru

Parametr	Typ	Popis
`$targets`	array	Pole cílových produktů
`$rule`	array	Nastavení pravidla

Příklad použití

/**
 * Vyloučit produkty s nízkou marží z cílů slevy
 *
 * @param array $targets Cílové produkty
 * @param array $rule    Pravidlo
 *
 * @return array
 */
function exclude_low_margin_products( $targets, $rule ): array {
    return array_filter( $targets, function( $target ) {
        $product_id = $target['product_id'] ?? 0;
        $margin = get_post_meta( $product_id, '_profit_margin', true );
        return $margin > 10; // Vyloučit produkty s marží pod 10%
    } );
}
add_filter( 'wpify_woo_discounts_targets_prepared', 'exclude_low_margin_products', 10, 2 );

Úprava metadata subrulů

Filtr umožňuje přidat vlastní metadata do subrulů (stupňů slevy).

apply_filters( 'wpify_woo_discounts_subrule_metadata', $metadata, $subrule, $rule );

Parametry filtru

Parametr	Typ	Popis
`$metadata`	array	Metadata subrulu
`$subrule`	array	Data subrulu
`$rule`	array	Nastavení pravidla

Příklad použití

/**
 * Přidat vlastní metadata pro tracking
 *
 * @param array $metadata Metadata
 * @param array $subrule  Subrule
 * @param array $rule     Pravidlo
 *
 * @return array
 */
function add_tracking_metadata( $metadata, $subrule, $rule ): array {
    $metadata['campaign_id'] = $rule['campaign_id'] ?? '';
    $metadata['applied_at'] = current_time( 'mysql' );
    return $metadata;
}
add_filter( 'wpify_woo_discounts_subrule_metadata', 'add_tracking_metadata', 10, 3 );

Úprava limitu množství

Filtr umožňuje upravit maximální množství pro slevu.

apply_filters( 'wpify_woo_discounts_quantity_limit', $limit, $product, $rule );

Parametry filtru

Parametr	Typ	Popis
`$limit`	int	Limit množství
`$product`	WC_Product	Produkt
`$rule`	array	Nastavení pravidla

Příklad použití

/**
 * Omezit množství pro velkoobchodníky
 *
 * @param int        $limit   Limit
 * @param WC_Product $product Produkt
 * @param array      $rule    Pravidlo
 *
 * @return int
 */
function limit_wholesale_quantity( $limit, $product, $rule ): int {
    if ( current_user_can( 'wholesale_customer' ) ) {
        return min( $limit, 100 ); // Max 100 ks pro velkoobchod
    }
    return $limit;
}
add_filter( 'wpify_woo_discounts_quantity_limit', 'limit_wholesale_quantity', 10, 3 );

Typ aplikace fee

Filtr umožňuje upravit typ aplikace poplatku/slevy v košíku.

apply_filters( 'wpify_woo_discounts_fee_application_type', $type, $rule );

Parametry filtru

Parametr	Typ	Popis
`$type`	string	Typ aplikace (`fixed`, `percent`)
`$rule`	array	Nastavení pravidla

Příklad použití

/**
 * Změnit typ aplikace pro konkrétní pravidla
 *
 * @param string $type Typ aplikace
 * @param array  $rule Pravidlo
 *
 * @return string
 */
function change_fee_application_type( $type, $rule ): string {
    // Pro pravidla s high_value tagem použít procenta
    if ( in_array( 'high_value', $rule['tags'] ?? [], true ) ) {
        return 'percent';
    }
    return $type;
}
add_filter( 'wpify_woo_discounts_fee_application_type', 'change_fee_application_type', 10, 2 );

Kde umístit kód

Vlastní funkci můžete vložit buď do tzv. child šablony (functions.php) nebo pomocí pluginu Code Snippets.