Tovább a tartalomhoz

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.

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.

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

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások