Kosárdíjak és ismétlődő díjak
Hogyan viselkednek a kosárhoz adott díjak előfizetéses kosárban, és hogyan lehet őket csak a kezdő rendelésre vagy csak az ismétlődő fizetésekre alkalmazni.
Ez a fejezet azoknak a fejlesztőknek szól, akik díjat adnának a WooCommerce kosárhoz, és tudni akarják, hogyan hat ez az előfizetésekre. Megmutatja, mit tesz alapból a bővítmény, és hogyan állítható be, hogy a díj csak a kezdő rendelésre vagy csak az ismétlődő rendelésekre vonatkozzon.
A kosárdíjak a kosártételekkel ellentétben nem maradandók: a díjat hozzáadó bővítménynek minden összegszámításnál újra hozzá kell adnia a díjat. A WooCommerce erre a woocommerce_cart_calculate_fees horgot adja. Például egy 10 forintos gravírozási díj így adható a kosárhoz:
add_filter( 'woocommerce_cart_calculate_fees', 'add_engraving_fees', 10, 1 );
function add_engraving_fees( $cart ) { $cart->add_fee( 'Gravírozás', '10' );}A díj a kosár oldal összesítésében jelenik meg.
Alapértelmezett viselkedés
Szekció neve “Alapértelmezett viselkedés”Az előfizetések ismétlődő kosarai ugyanazt az összegszámítást használják, ezért a fenti kódrészlet a díjat az ismétlődő kosarakra is alkalmazza. Alapból tehát minden, a woocommerce_cart_calculate_fees horoggal hozzáadott kosárdíj érvényes mind a kezdő rendelésre, mind az ebben a tranzakcióban létrejött előfizetésekre, és a későbbi megújításokra is. Az előfizetést vásárló ugyanazt a díjat a kosár Ismétlődő összesen részében is látja.
Díj csak az ismétlődő fizetésekre
Szekció neve “Díj csak az ismétlődő fizetésekre”Ha a díjat csak az előfizetések folyamatos fizetéseire akarod alkalmazni, a visszahívásban ellenőrizd, hogy a kapott kosár ismétlődő kosár-e, vagy a szokásos WooCommerce kosár. Az ismétlődő kosaraknak van recurring_cart_key tulajdonságuk, ennek alapján megállapítható:
add_filter( 'woocommerce_cart_calculate_fees', 'add_recurring_postage_fees', 10, 1 );
function add_recurring_postage_fees( $cart ) { if ( ! empty( $cart->recurring_cart_key ) ) { $cart->add_fee( 'Postaköltség', 5 ); }}A díj ilyenkor csak az ismétlődő összesítésben jelenik meg.
A WooCommerce 3.2-ben volt egy hiba: ilyenkor a díj a kezdő kosár összesítésében is látszott, pedig a rendelés végösszegében nem volt benne. A WooCommerce 3.3 javította, ha találkozol vele, frissítsd a WooCommerce-et.
Díj csak a kezdő rendelésre
Szekció neve “Díj csak a kezdő rendelésre”Ha a díjat csak a feliratkozáskor, a kezdő rendelésre kell felszámítani, két mód van.
1. módszer: az ismétlődő kosár ellenőrzésének megfordítása.
add_filter( 'woocommerce_cart_calculate_fees', 'add_administration_fees', 10, 1 );
function add_administration_fees( $cart ) { if ( empty( $cart->recurring_cart_key ) ) { $cart->add_fee( 'Ügyintézési díj', 2.5 ); }}Itt a logika fordított az előzőhöz képest: a díj csak a kezdő vásárlás kosarára vonatkozik.
2. módszer: a díj a globális kosárra.
add_filter( 'woocommerce_cart_calculate_fees', 'add_administration_fees', 10 );
function add_administration_fees() { WC()->cart->add_fee( 'Ügyintézési díj', 2.5 );}Itt a díjat a globális WooCommerce kosárobjektumhoz adod, ami az alapértelmezett kosár, így csak a kezdő vásárlásra vonatkozik.
A WooCommerce 3.2-ben itt is volt hiba: a díj a kezdő és az ismétlődő rendelésekre is érvényes lett. A WooCommerce 3.3 javította, frissítsd, ha találkozol vele.
A woocommerce_subscriptions_is_recurring_fee szűrő
Szekció neve “A woocommerce_subscriptions_is_recurring_fee szűrő”Ez a szűrő azoknak a fejlesztőknek való, akik a díjat a kezdő kosárhoz adták, de ismétlődő kosarakra is alkalmaznák. Alapértéke false, azaz a WC()->cart objektummal hozzáadott díjak alapból nem ismétlődők.
Ha minden díj ismétlődő legyen:
add_filter( 'woocommerce_subscriptions_is_recurring_fee', '__return_true' );
add_filter( 'woocommerce_cart_calculate_fees', 'add_fees', 10 );
function add_fees() { WC()->cart->add_fee( 'Díj', '10' );}Ha csak bizonyos díjak ismétlődők, vagy összetettebb feltételek kellenek, használd a szűrő $fee és $cart argumentumait:
add_filter( 'woocommerce_cart_calculate_fees', 'add_fees', 10 );
function add_fees() { WC()->cart->add_fee( 'Személyes gravírozás', 10 ); WC()->cart->add_fee( 'Postaköltség', 5 );}
add_filter( 'woocommerce_subscriptions_is_recurring_fee', 'apply_recurring_fees', 10, 3 );
function apply_recurring_fees( $is_recurring, $fee, $cart ) {
// A személyes gravírozás díja ismétlődő. if ( 'szemelyes-gravirozas' === $fee->id ) { $is_recurring = true; // A 30 alatti ismétlődő részösszegű előfizetéseknél a postaköltség is ismétlődő. } elseif ( 'postakoltseg' === $fee->id && 30 > $cart->get_subtotal() ) { $is_recurring = true; }
return $is_recurring;}Készült: