# 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:

```php
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

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

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ó:

```php
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

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.**

```php
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.**

```php
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ő

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:

```php
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:

```php
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;
}
```
