Pro vývojáře

Shortcody

Notifikace dopravy zdarma

[wpify_woo_free_shipping_notice]

Zobrazí kompletní notifikaci včetně progress baru a textu.

Pouze zbývající částka

[wpify_woo_amount_for_free_shipping]

Zobrazí pouze formátovanou zbývající částku (např. 500 Kč).

Filtry

wpify_woo_free_shipping_render_notice

Umožňuje podmíněně skrýt notifikaci.

apply_filters( 'wpify_woo_free_shipping_render_notice', bool $render );

Parametry

Parametr	Typ	Popis
$render	bool	Zobrazit notifikaci (výchozí: true)

Příklad: Skrýt pro přihlášené uživatele

add_filter( 'wpify_woo_free_shipping_render_notice', function( $render ) {
    if ( is_user_logged_in() ) {
        return false;
    }
    return $render;
} );

---

wpify_woo_free_shipping_amount

Upraví hodnotu limitu pro dopravu zdarma.

apply_filters( 'wpify_woo_free_shipping_amount', float $amount, object $module );

Parametry

Parametr	Typ	Popis
$amount	float	Částka pro dopravu zdarma
$module	object	Instance modulu FreeShippingNoticeModule

Příklad: Různé limity podle země

add_filter( 'wpify_woo_free_shipping_amount', function( $amount, $module ) {
    $country = WC()->customer->get_shipping_country()
               ?? WC()->customer->get_billing_country();

    if ( $country === 'SK' ) {
        return 50; // 50 EUR pro Slovensko
    }

    return $amount; // Výchozí pro ostatní země
}, 10, 2 );

---

wpify_woo_free_shipping_amount_for_free_shipping

Upraví zbývající částku do dopravy zdarma.

apply_filters( 'wpify_woo_free_shipping_amount_for_free_shipping', float $remaining );

Parametry

Parametr	Typ	Popis
$remaining	float	Zbývající částka (může být záporná)

---

wpify_woo_free_shipping_is_free

Určí, zda je doprava zdarma.

apply_filters( 'wpify_woo_free_shipping_is_free', bool $is_free );

Parametry

Parametr	Typ	Popis
$is_free	bool	Doprava je zdarma (výchozí: $remaining <= 0)

Příklad: Doprava zdarma pro VIP zákazníky

add_filter( 'wpify_woo_free_shipping_is_free', function( $is_free ) {
    $user = wp_get_current_user();
    if ( in_array( 'vip_customer', $user->roles ) ) {
        return true;
    }
    return $is_free;
} );

CSS třídy

Třída	Element
.wpify-woo-free-shipping-notice__wrapper	Vnější wrapper (používá se pro AJAX fragmenty)
.wpify-woo-free-shipping-notice	Hlavní kontejner notifikace
.progress	Kontejner progress baru
.progress-value	Vyplněná část progress baru

Příklad vlastního stylování

.wpify-woo-free-shipping-notice {
    border-radius: 8px;
    margin-bottom: 20px;
}

.wpify-woo-free-shipping-notice .progress {
    height: 15px;
    margin-top: 10px;
}

.wpify-woo-free-shipping-notice .progress-value {
    background: linear-gradient(90deg, #4CAF50, #8BC34A);
}

AJAX aktualizace

Notifikace se automaticky aktualizuje při:

• Přidání produktu do košíku
• Změně množství v košíku
• Odebrání produktu z košíku
• Aktualizaci pokladny

Modul používá WooCommerce fragmenty (woocommerce_add_to_cart_fragments a woocommerce_update_order_review_fragments).

Kompatibilita

Woo Currency Switcher

Modul je kompatibilní s pluginem Woo Currency Switcher. Limit pro dopravu zdarma se automaticky přepočítává pomocí filtru woocs_exchange_value.

Kam vložit kód

Vlastní funkce můžete vložit do:

• Souboru functions.php v child tématu
• Pluginu Code Snippets