Hooky a filtry

Plugin WPify Woo Podmínky dopravy a platby poskytuje filtry pro přizpůsobení výpočtů, pravidel a chování podmíněné dopravy a platby.

Filtry výpočtu košíku

wpify_woo_conditional_shipping_cart_amount_include_tax

Ovládání, zda podmínky mezisoučtu košíku zahrnují nebo vylučují DPH.

apply_filters( 'wpify_woo_conditional_shipping_cart_amount_include_tax', bool $include_tax );

Výchozí: true (mezisoučet košíku zahrnuje DPH)

Příklad — počítat mezisoučet bez DPH:

/**
 * Počítat mezisoučet košíku bez DPH pro podmínky dopravy
 */
add_filter( 'wpify_woo_conditional_shipping_cart_amount_include_tax', '__return_false' );

wpify_woo_conditional_shipping_cart_total_include_tax

Ovládání, zda podmínky celkové hodnoty košíku zahrnují nebo vylučují DPH.

apply_filters( 'wpify_woo_conditional_shipping_cart_total_include_tax', bool $include_tax );

Výchozí: true (celková hodnota košíku zahrnuje DPH)

Příklad — počítat celkovou hodnotu bez DPH:

/**
 * Počítat celkovou hodnotu košíku bez DPH pro podmínky dopravy
 */
add_filter( 'wpify_woo_conditional_shipping_cart_total_include_tax', '__return_false' );

Filtry pravidel

wpify_woo_conditional_shipping_shipping_adjusted_price

Filtrování upravené ceny dopravy před jejím aplikováním.

apply_filters( 'wpify_woo_conditional_shipping_shipping_adjusted_price', $value, array $action, array $rule, array $passed_rules );

Parametry:

Parametr	Typ	Popis
`$value`	`float`	Upravená cena dopravy
`$action`	`array`	Konfigurace akce
`$rule`	`array`	Skupina pravidel, která odpovídala
`$passed_rules`	`array`	Všechna pravidla, která prošla podmínkami

Příklad — minimální cena dopravy:

/**
 * Nastavení minimální ceny dopravy na 29 Kč
 *
 * @param float $value        Upravená cena
 * @param array $action       Akce
 * @param array $rule         Pravidlo
 * @param array $passed_rules Všechna pravidla
 * @return float
 */
function my_minimum_shipping_price( $value, $action, $rule, $passed_rules ) {
    return max( $value, 29 );
}
add_filter( 'wpify_woo_conditional_shipping_shipping_adjusted_price', 'my_minimum_shipping_price', 10, 4 );

wpify_woo_conditional_shipping_passed_rules

Filtrování pravidel, která prošla všemi podmínkami, před aplikováním akcí.

apply_filters( 'wpify_woo_conditional_shipping_passed_rules', array $rules, string $rules_id );

Parametry:

Parametr	Typ	Popis
`$rules`	`array`	Pole pravidel, která prošla všemi podmínkami
`$rules_id`	`string`	Identifikátor sady pravidel (`rules` nebo `payment_rules`)

Příklad — logování pravidel pro debugging:

/**
 * Logování pravidel, která prošla podmínkami
 *
 * @param array  $rules    Pravidla
 * @param string $rules_id Identifikátor sady pravidel
 * @return array
 */
function my_log_passed_rules( $rules, $rules_id ) {
    $logger = wc_get_logger();
    $logger->debug( sprintf(
        'Pravidla %s: %d pravidel prošlo podmínkami',
        $rules_id,
        count( $rules )
    ), [ 'source' => 'conditional-shipping-debug' ] );

    return $rules;
}
add_filter( 'wpify_woo_conditional_shipping_passed_rules', 'my_log_passed_rules', 10, 2 );

wpify_conditional_shipping_rules_priority

Nastavení priority filtru woocommerce_package_rates.

apply_filters( 'wpify_conditional_shipping_rules_priority', int $priority );

Výchozí: 1000

Příklad — spustit pravidla dříve:

/**
 * Spustit pravidla dopravy dříve (nižší číslo = vyšší priorita)
 *
 * @param int $priority Priorita
 * @return int
 */
function my_shipping_rules_priority( $priority ) {
    return 100;
}
add_filter( 'wpify_conditional_shipping_rules_priority', 'my_shipping_rules_priority' );

Filtry oprav

wpify_woo_conditional_shipping_enable_negative_fee_fix

Povolení nebo zakázání opravy výpočtu DPH pro záporné poplatky (slevy).

apply_filters( 'wpify_woo_conditional_shipping_enable_negative_fee_fix', bool $enable );

Výchozí: true

Příklad — zakázat opravu DPH:

/**
 * Zakázat opravu DPH záporných poplatků
 */
add_filter( 'wpify_woo_conditional_shipping_enable_negative_fee_fix', '__return_false' );

Filtry nastavení

wpify_woo_conditional_shipping_rules

Filtrování definic polí pravidel dopravy. Umožňuje přidání vlastních typů podmínek nebo úpravu existujících.

apply_filters( 'wpify_woo_conditional_shipping_rules', array $shipping_rules );

wpify_woo_conditional_shipping_payment_rules

Filtrování definic polí pravidel platby.

apply_filters( 'wpify_woo_conditional_shipping_payment_rules', array $payment_rules );

Kde umístit kód

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