# Kódrészletek és kiegészítő bővítmények

> Kész kódrészletek és kis segédbővítmények az Előfizetések megjelenésének és működésének testreszabásához.

Ezekkel a kódrészletekkel és mini-bővítményekkel testreszabhatod az előfizetések megjelenését és működését. A kódot külön kódrészlet-bővítménybe (snippet plugin) érdemes tenni, nem a sablon fájljaiba vagy a `functions.php`-ba. A testreszabásokra nincs támogatás, ha módosítanod kell egy részletet, fordulj fejlesztőhöz.

## Vásárlói oldal (Fiókom)

**Kész segédbővítmények** (GitHubról tölthetők le):

- **Fizetés gomb a függő fizetésű előfizetésnél:** a **Fiókom → Előfizetés megtekintése** oldalon közvetlenül az előfizetés mellett jelenik meg a **Fizetés** gomb, így nem kell lejjebb keresni a rendelést.
- **Egyszeri megerősítés lemondáskor:** megerősítő ablakot ad, mielőtt az ügyfél lemondja az előfizetést. A **WooCommerce → Beállítások → Előfizetések** oldalon ki- és bekapcsolható.
- **Megerősítés fizetési mód törlésekor:** emlékeztet, hogy a fizetési módot használó előfizetéseket is frissíteni kell. Csökkentheti a sikertelen fizetéseket.

**Gombok elrejtése és hozzáadása:**

- A **Fizetési módok** fül elrejtése a Fiókom menüből:

```php
add_filter( 'woocommerce_account_menu_items', 'remove_payment_methods_tab_my_account', 999 );

function remove_payment_methods_tab_my_account( $items ) {
    unset( $items['payment-methods'] );
    return $items;
}
```

- A **Lemondás** gomb elrejtése az előfizetés megtekintésénél (a többi művelet látszik marad):

```php
function eg_remove_my_subscriptions_button( $actions, $subscription ) {
    unset( $actions['cancel'] );
    return $actions;
}
add_filter( 'wcs_view_subscription_actions', 'eg_remove_my_subscriptions_button', 100, 2 );
```

- Egyes műveletek elrejtése csak egy adott termékű előfizetésnél: a `$subscription->has_product( $product_id )` feltétellel, a `change_payment_method`, `change_address`, `switch`, `resubscribe`, `pay`, `reactivate` és `cancel` kulcsok közül a kívántakat törölve az `$actions` tömbből ugyanazon a `wcs_view_subscription_actions` szűrőn.
- A felfüggesztés tiltása megadott termékeknél (a termékazonosítók listájában szereplő terméket tartalmazó előfizetést az ügyfél nem függesztheti fel):

```php
function prevent_suspension_per_product( $user_can_suspend, $subscription ) {
    if ( ! $user_can_suspend ) {
        return $user_can_suspend;
    }
    $product_ids = array( 438, 128, 2, 345 ); // a tiltandó termékek azonosítói
    foreach ( $product_ids as $product_id ) {
        if ( $subscription->has_product( $product_id ) ) {
            return false;
        }
    }
    return $user_can_suspend;
}
add_filter( 'wcs_can_user_put_subscription_on_hold', 'prevent_suspension_per_product', 15, 2 );
```

- A **Lemondás** gomb elrejtése a próbaidőszak alatt: a `wcs_view_subscription_actions` szűrőben a `$subscription->get_time( 'trial_end' )` értékét az aktuális időhöz mérve, ha a próbaidő még tart, töröld a `cancel` elemet.
- A **Lemondás** gomb elrejtése, ha az előfizetésnek van beállított befejezési dátuma: ugyanezen a szűrőn, a `get_time( 'end' )` értéke alapján.
- Gombok az **Előfizetések** listán (Fiókom): a `woocommerce_my_subscriptions_actions` akcióba kapcsolva a `wcs_get_all_user_actions_for_subscription()` eredményéből külön **Fizetési mód módosítása**, **Megújítás most** vagy **Lemondás** gomb írható ki a lista soraiban, ha az adott művelet elérhető.

## Termékek és pénztár

- **Egyedi árszöveg:** az Custom Price String for WooCommerce Subscriptions bővítménnyel átírhatod a termékoldalakon megjelenő árszöveget, az egyszerű, változó és előfizetéses termékekét, a „-tól” árakat és a foglalható termékeket is.
- **Kupon automatikus alkalmazása újrafeliratkozáskor:** a `WOOCOMMERCE_SUBSCRIPTIONS_AUTO_RESUBSCRIBE_COUPON` állandóval megadott kupont a bővítmény minden újrafeliratkozási kosárra ráteszi. A kupon máshol is használható, ha nem korlátozod.
- **Termékkategória elrejtése a bolt oldalról:** a `woocommerce_product_query` akcióban egy `tax_query` feltétellel (a `product_cat` taxonómia egy adott slugjára `NOT IN` operátorral) kizárhatod a kategóriát a boltból. A termékek közvetlen hivatkozással továbbra is elérhetők.
- **Átirányítás a kosárra:** a `woocommerce_add_to_cart_redirect` szűrőben, ha a hozzáadott termék előfizetéses (`WC_Subscriptions_Product::is_subscription()`), a visszaadott cím a kosár címe (`WC()->cart->get_cart_url()`). Egy meghatározott oldalra is irányíthatsz: a szűrő a `get_permalink( <oldal azonosítója> )` értékét adja vissza.
- **„Számlázási adatok” cím átírása „Fiókadatok”-ra** fizetés nélküli pénztárnál (például ingyenes próba): a `gettext` szűrővel, ha a kosárnak nincs szüksége fizetésre.
- **Az „ismétlődő összeg x-ként” szöveg a blokkos pénztárban:** a sorszámnév nélküli alak (például „3. naponta” helyett „3 naponta”) a blokkos pénztár szövegeinek `wp.hooks` `i18n.gettext` szűrőjével módosítható, a `woocommerce-subscriptions` szövegtartomány „Recurring total every” kezdetű szövegeire.
- **Egyedi számlázási gyakoriság** (például 50 havonta): a `woocommerce_subscription_period_interval_strings` szűrővel egy új érték adható az intervallumok listájához:

```php
function wcs_custom_frequency( $intervals ) {
    $custom_frequency = 50; // a kívánt szám
    $intervals[ $custom_frequency ] = sprintf( __( 'every %s', 'my-text-domain' ), WC_Subscriptions::append_numeral_suffix( $custom_frequency ) );
    return $intervals;
}
add_filter( 'woocommerce_subscription_period_interval_strings', 'wcs_custom_frequency' );
```

- **Hosszabb futamidők** (például 48 hónap, 10 és 20 év): a `woocommerce_subscription_lengths` szűrővel:

```php
function eg_extend_subscription_expiration_options( $subscription_lengths ) {
    $subscription_lengths['year'][10]  = wcs_get_subscription_period_strings( 10, 'year' );
    $subscription_lengths['year'][20]  = wcs_get_subscription_period_strings( 20, 'year' );
    $subscription_lengths['month'][48] = wcs_get_subscription_period_strings( 48, 'month' );
    return $subscription_lengths;
}
add_filter( 'woocommerce_subscription_lengths', 'eg_extend_subscription_expiration_options' );
```

- **Több változat az AJAX-os választóban:** a `woocommerce_ajax_variation_threshold` szűrő értékét 500-ra emelve sok változat esetén is gördülékenyen töltődnek be a változatok.

## Megújítás, lemondás és fizetés

- **Lemondás a sikertelen újrapróbálások után:** egy segédbővítmény lemondja a rendelést és az előfizetést is, ha minden automatikus újrapróbálás elbukott (alapból az előfizetés csak felfüggesztve marad).
- **A „Lemondás függőben” állapot kihagyása:** egy segédbővítmény azonnal **Lemondva** állapotba teszi az előfizetést, ha az ügyfél lemondja a Fiókomban.
- **Lemondás teljes visszatérítésnél:** egy segédbővítmény azonnal lemondja az előfizetést, ha a szülő vagy a legutóbbi megújítási rendelést teljesen visszatérítik. A régebbi rendelések visszatérítése nem váltja ki.
- **Csak kézi megújításra érvényes kupon:** a megadott kuponkódok csak megújítási rendelés kifizetésekor használhatók, az első feliratkozáskor nem. A kódok a beállítóoldalon, állandóval vagy szűrővel adhatók meg.
- **Termék korlátozása adott számú aktív előfizetésre:** az előfizetéses termék a megadott számú, még le nem zárult előfizetésig vásárolható (például kizárólagos tagság). A limit elérése után a termék a vásárlói oldalon már nem vásárolható, a kézi megújítás és a sikertelen fizetések rendezése viszont továbbra is megy.
- **Az eredeti számlázási nap megtartása késői fizetésnél:** a következő megújítás dátuma az eredeti ütemezett fizetési dátumból számolódik, nem a tényleges fizetésből, így az előfizetés például mindig a hónap 1-jén újul meg.
- **Korai megújítás szinkronizált előfizetéseknél:** egy segédbővítmény lehetővé teszi az idő előtti megújítást a számlázási napra igazított előfizetéseknél is.
- **A készlet ne csökkenjen megújításkor:** a WooCommerce alapból megújítási rendelésnél is csökkenti a készletet. Egy segédbővítmény ezt kikapcsolja, így a készlet csak az első vásárláskor módosul.
- **Egyedi újrapróbálási szabályok:** a `wcs_default_retry_rules` szűrővel lecserélheted az alapértelmezett szabályokat. A példában az első sikertelen fizetés után azonnal e-mail megy az ügyfélnek, majd 12 óra, 12 óra, 1 nap, 2 nap és 3 nap múlva próbál újra a rendszer. Közben a rendelés **Függőben**, az előfizetés **Felfüggesztve** állapotú marad. Minden szabály tartalmazza a `retry_after_interval`, `email_template_customer`, `email_template_admin`, `status_to_apply_to_order` és `status_to_apply_to_subscription` mezőt.
- **Szerepkör ne változzon:** alapból a bővítmény az előfizetés aktiválásakor, lemondásakor, lejáratakor módosítja a felhasználó szerepkörét. Kikapcsolható:

```php
add_filter( 'woocommerce_subscriptions_update_users_role', '__return_false', 100 );
```

- **Letöltések lemondás vagy lejárat után is:** a `woocommerce_order_is_download_permitted` szűrővel igaz értéket adva a **Lemondva** és **Lejárt** előfizetésekre, az ügyfél továbbra is eléri a letölthető fájlokat.
- **Az ügyfél is megkapja a lemondott rendelés e-mailjét:** a `woocommerce_email_recipient_cancelled_order` szűrővel a címzettekhez add hozzá az ügyfél e-mail-címét.

## Segédbővítmények üzemeltetéshez és hibakereséshez

- **Az összes megújítás szüneteltetése:** megakadályozza, hogy az Action Scheduler felvegye az ütemezett műveleteket (automatikus fizetés, újrapróbálás, futamidő vége), a többit nem érinti. A feloldás után a kimaradt műveletek azonnal lefutnak. Csak az Előfizetések bővítmény kezelte előfizetésekre hat, a régi PayPal Standardra és a WooPayments előfizetésekre nem.
- **Subscriptions Importer and Exporter:** ingyenes eszköz előfizetők CSV-vel történő átviteléhez, lásd [az átviteli fejezetet](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/uzemeltetes-migralas/).
- **A jelentések gyorsítótárának automatikus frissítése le:** teljesítményt javíthat, vagy megakadályozhatja az ismétlődő, nem kívánt frissítéseket jelentéssűrű oldalakon.
- **Összegek újraszámolása adóbeállítás-változás után:** minden előfizetés összegét újraszámolja, hogy az új adóbeállítások érvényesüljenek.
- **Megújítási események naplózása:** a WooCommerce naplóiba ír `wcs-renewal-log-` előtaggal, így követhető, miért nem megy végig az automatikus megújítás.
- **Megújítási események időtartamának mérése:** a megújítási események kezdetét és végét naplózza, szintén `wcs-renewal-log-` előtaggal. A naplók a **WooCommerce → Állapot → Naplók** oldalon láthatók.
- **Következő fizetési dátumok eltolása:** minden előfizetés következő fizetési dátumát 1 perccel hátrébb teszi. Az időzónák eltéréséből adódó dupla megújítások kezelésére való.
- **Az előkészítő mód kikapcsolása (Backstage):** kikapcsolja az előkészítő módot, amelyet egyébként a cím megváltozása indít el. Több előtér-címmel működő oldalnál hasznos (például WPML), ahol minden környezet ugyanazt a WordPresst használja. Figyelem: a másolt vagy előkészítő címeken is élesben fizetést fog feldolgozni, ezért klónozáskor nagyon kell vigyázni.
- **Automatikus fizetés kiválasztott előfizetésekre előkészítő módban (Upstage):** a duplikált terhelések elleni védelem megtartásával lehet fizetést tesztelni.
- **Előfizetés állapotának ellenőrzése adminértesítéssel:** egy adott azonosítójú előfizetés állapotát (aktív, nem aktív, nem található) admin figyelmeztetésben mutatja ki, hibakereséshez. Az előfizetést a `wcs_get_subscription( $azonosito )` függvénnyel kéri le, az állapotot a `get_status()` adja.
