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
Szekció neve “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
Szekció neve “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:
- dinamikus, amelynek nevében szerepel a státusz, például
woocommerce_subscription_status_activevagywoocommerce_subscription_status_pending-cancel_to_cancelled; - 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
Szekció neve “Ü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
Szekció neve “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. |
Készült: