# Akciók

> Az Előfizetések bővítmény fontosabb akciói: fizetés, státuszváltozás, ütemezett események és létrehozás.

A bővítmény több mint 250 akciót indít. Itt a hasznosabbak szerepelnek, paraméterekkel és működéssel. A lista nem oktatóanyag: azt mutatja, mivel kapcsolódhatsz az Előfizetésekhez egyedi kódból.

## Fizetés

| Akció | Paraméterek | Mikor fut |
|---|---|---|
| `woocommerce_scheduled_subscription_payment` | `$subscription_id` (egész) | Egyszer, amikor egy megújítási fizetést fel kell dolgozni. Ütemezetten fut (például évi 50 dolláros előfizetésnél évente, a vásárlás évfordulóján), de kézzel vagy külső kóddal is indítható, például az előfizetés szerkesztőjében a megújítás feldolgozásával. |
| `woocommerce_scheduled_subscription_payment_{$gateway_id}` | `$renewal_total` (tizedes szám), `$renewal_order` (`WC_Order`) | Ugyanaz, de átjáró-specifikus: a fizetési átjárók ezen keresztül hajtják végre a terhelést, ezért más a paraméterezése. |
| `woocommerce_subscription_payment_complete` | `$subscription` | Fizetés érkezett az előfizetésre, akár a kezdő, akár megújítási rendelésre. A korai megújítás dátumváltozásait máshogy kezeli a bővítmény, ezért a következő fizetési dátum rögzítésére ne erre támaszkodj. |
| `woocommerce_subscription_renewal_payment_complete` | `$subscription`, `$last_order` | Csak megújítási fizetésnél fut (a kezdő és a váltási rendelésnél nem), automatikusnál és kézinél is. A következő fizetési dátum rögzítésére itt sem ez való. |
| `woocommerce_subscription_payment_failed` | `$subscription`, `$new_status` (alapból `on-hold`) | Sikertelen fizetésnél, kezdő, váltási vagy megújítási rendelésnél is. |
| `woocommerce_subscription_renewal_payment_failed` | `$subscription` | Csak a megújítási fizetés sikertelenségekor. |

## Státuszváltozás

Az előfizetés státuszát az áruházkezelő, az előfizető vagy egy ütemezett esemény (például lejárat) is megváltoztathatja. Az alábbi akciók mindig lefutnak, függetlenül attól, ki váltotta a változást. Kétféle akció van:

1. **dinamikus**, amelynek nevében szerepel a státusz, például `woocommerce_subscription_status_active` vagy `woocommerce_subscription_status_pending-cancel_to_cancelled`;
2. **statikus**, amelynek neve sosem változik, például `woocommerce_subscription_status_updated`.

Ha egyetlen státuszváltásra kell figyelned (aktiválás, lemondás), használj dinamikus akciót. Ha a kódod a státusztól függően más-más műveletet végez, használd a statikus akciót.

| Akció | Paraméterek | Mikor fut |
|---|---|---|
| `woocommerce_subscription_status_updated` | `$subscription`, `$new_status`, `$old_status` | Közvetlenül a státusz megváltozása után, a WooCommerce `woocommerce_order_status_changed` akciójához hasonlóan. Minden státuszra (`pending`, `active`, `on-hold`, `pending-cancel`, `cancelled`, `expired`) és az egyedi státuszokra is. |
| `woocommerce_subscription_status_active` | `$subscription` | Az előfizetés aktívvá vált (függőből, felfüggesztettből vagy egyedi státuszból). |
| `woocommerce_subscription_status_cancelled` | `$subscription` | Az előfizetés lemondottá vált. A lemondás nem azonnal ide visz: ha az áruházkezelő vagy a vásárló lemondja, az előfizetés előbb `pending-cancel` (lemondás függőben) státuszba kerül, és csak az előre kifizetett időszak végén lesz `cancelled`. |
| `woocommerce_subscription_status_expired` | `$subscription` | Az előfizetés elérte a futamidő végét (a termékben megadott hossz, vagy egy beállított záródátum miatt). A bővítmény ütemezett eseménye vagy külső kód (`WC_Subscription::update_status()`) is kiválthatja. |
| `woocommerce_subscription_status_on-hold` | `$subscription` | Az előfizetés felfüggesztésre került: az áruházkezelő vagy a vásárló kézzel felfüggesztette, vagy megújítási fizetés esedékes. Automatikus megújításnál ideiglenesen, a sikeres fizetésig, kézi megújításnál addig, amíg a vásárló be nem lép és ki nem fizeti. |

## Ütemezett események

| Akció | Paraméterek | Mikor fut |
|---|---|---|
| `woocommerce_scheduled_subscription_trial_end` | `$subscription_id` | A próbaidőszak vége. |
| `woocommerce_scheduled_subscription_expiration` | `$subscription_id` | Az előfizetés záródátuma, a termékben megadott hossz vagy kézzel beállított záródátum alapján. |
| `woocommerce_scheduled_subscription_end_of_prepaid_term` | `$subscription_id` | Egy lemondott előfizetés elérte az utolsó fizetéssel lefedett időszak végét. A bővítmény ezzel váltja a `pending-cancel` státuszt `cancelled`-re. |

Példa az előre fizetett időszak végére: a vásárló március 1-jén havi előfizetést vásárol, 15-én lemondja. A `woocommerce_subscription_status_pending-cancel` akció azonnal lefut, a `woocommerce_scheduled_subscription_end_of_prepaid_term` pedig április 1-jére ütemeződik, és akkor mondja le az előfizetést.

## Létrehozás és egyéb

| Akció | Paraméterek | Mikor fut |
|---|---|---|
| `woocommerce_checkout_subscription_created` | `$subscription`, `$order`, `$recurring_cart` | Az előfizetés létrejött a pénztárban. A WooCommerce a tranzakciót rögzítő rendelés után hozza létre, rendelésenként minden előfizetésre egyszer, függő státusszal, még a fizetés előtt. Mivel a kosárban több előfizetéses termék lehet, és ezeket külön ismétlődő kosarakba (`WC_Cart`) csoportosítja a bővítmény, a hozzá tartozó kosarat is megkapja a függvény. |
| `subscriptions_created_for_order` | `$order` | Egy rendelés előfizetései először létrejöttek, függő státusszal, a fizetés és az aktiválás előtt. |
| `woocommerce_subscriptions_updated_users_role` | `$role_new`, `$user` (`WP_User`), `$role_old` | Az előfizetés aktiválásakor, felfüggesztésekor, lemondásakor vagy lejártakor a felhasználó szerepköre is változik, és ez az akció ekkor fut. |
| `woocommerce_subscriptions_switch_completed` | `$order` | A váltási rendelés feldolgozás alatt vagy teljesített státuszba került, miután a váltás és minden frissítés megtörtént. |
