Adatszerkezet és tárolás
Hogyan tárolja és példányosítja a bővítmény az előfizetéses termékeket és az előfizetéseket.
Ez a fejezet az előfizetési adatok alapszerkezetét mutatja be. Nem lépésről lépésre útmutató, és nem teljes referencia az összes tulajdonságról és metódusról.
A bővítmény két összefüggő dolgot ad:
- Előfizetéses termékeket, amelyeket a vásárlók megvehetnek. Ezek a WooCommerce-termékek kiterjesztései: egyszerű előfizetés, változó előfizetés és előfizetés-variáció.
- Előfizetéseket, vagyis az áruház és a vásárló között a jövőbeli tranzakciókról szóló megállapodást. Ezek a WooCommerce-rendelések kiterjesztései.
A kódban az előfizetéses termék változóneve $product vagy $product_id, az előfizetésé $subscription vagy $subscription_id.
Az előfizetéses termék
Szekció neve “Az előfizetéses termék”Az adatbázisban product vagy product_variation egyéni bejegyzéstípusként tárolódik, a memóriában a WC_Product leszármazott osztályaként él.
A product_type taxonómia (a WooCommerce kezeli) subscription vagy variable-subscription értéke teszi egyedi terméktípussá. Az adatszerkezet azonos a megfelelő WooCommerce-terméktípusokéval: az egyszerű előfizetés az egyszerű termékével, a változó a változóéval, az előfizetés-variáció a variációéval.
Az előfizetéses termékek egyedi adatai a post meta táblában:
| Meta kulcs | Tartalom |
|---|---|
_subscription_price |
az ismétlődő ár |
_subscription_sign_up_fee |
opcionális egyszeri díj a feliratkozáskor |
_subscription_period |
a számlázási időszak egysége (nap, hét, hónap, év) |
_subscription_period_interval |
hány egység telik el két megújítás között (például 2) |
_subscription_length |
hány egység után jár le automatikusan az előfizetés |
_subscription_trial_period |
a próbaidőszak egysége |
_subscription_trial_length |
a próbaidőszak hossza az első megújítás előtt (például 2) |
Ez nem teljes lista, csak a legfontosabb és leggyakrabban használt adatokat tartalmazza. Más funkciók további meta-adatokat használnak, például a _subscription_limit a vásárlás korlátozásához, a _subscription_one_time_shipping az egyszeri szállításhoz, a _subscription_payment_sync_date a számlázási nap igazításhoz.
Osztályok
Szekció neve “Osztályok”- az egyszerű előfizetéses termék:
WC_Product_Subscription(aWC_Product_Simpleleszármazottja); - a változó előfizetéses termék:
WC_Product_Variable_Subscription(aWC_Product_Variableleszármazottja); - az előfizetés-variáció:
WC_Product_Subscription_Variation(aWC_Product_Variationleszármazottja).
Ezért a WC_Product és szülőosztályai minden metódusa használható rajtuk. A WC_Subscriptions_Product osztály kötelező jellegű API-t ad az adatok eléréséhez:
WC_Subscriptions_Product::get_period( $product ): a megújítás időegysége (_subscription_period);WC_Subscriptions_Product::get_interval( $product ): az időegységek száma a megújítások között (_subscription_period_interval);WC_Subscriptions_Product::get_length( $product ): a lejárat előtt feldolgozandó megújítások száma (_subscription_length).
A meta-adatok a termék tulajdonságain keresztül közvetlenül is elérhetők, de ez nem ajánlott, mert megkerüli az adatokra alkalmazott szűrőket.
Az előfizetés
Szekció neve “Az előfizetés”Az előfizetés szinte azonos a rendeléssel. Különbség a felhasználásban van: az előfizetés a jövőbeli tranzakciókról szóló megállapodás, a rendelés a múltbeli tranzakciók feljegyzése. Az adataik hasonlók: mindkettőben van tétel, vevői adat, státusz. Ezért az előfizetés a WooCommerce egyéni rendeléstípus API-jával tárolódik (ezt a WooCommerce a visszatérítésekhez is használja).
- Hagyományos WordPress-bejegyzéstárolásnál
shop_subscriptionegyéni bejegyzéstípusként tárolódik. - Nagy teljesítményű rendeléstárolóban (HPOS)
shop_subscriptiontípussal awc_orderstáblában. - A memóriában
WC_Subscriptionobjektum.
Az előfizetés tételei order_items-ként tárolódnak, és az előfizetéshez tartozó order_item order_id-ja az előfizetés azonosítója.
Az előfizetés és a rendelés közös adatai: vevői adatok (felhasználó azonosító, szállítási és számlázási cím, e-mail, telefonszám), tételek (termék, szállítás, adó, kupon/kedvezmény, díj), letöltési jogosultságok, fizetési mód, rendelésjegyzetek, státusz.
Az előfizetés megújításhoz kapcsolódó egyedi adatai a post meta táblában:
| Meta kulcs | Tartalom |
|---|---|
_schedule_trial_end |
a próbaidőszak vége, UTC, MySQL formátumban |
_schedule_next_payment |
a következő megújítási fizetés időpontja (ritkán múltbeli: amikor feldolgozták), UTC, MySQL formátumban |
_schedule_end |
az előfizetés lejáratának vagy a lemondás utáni végének időpontja, illetve a már megtörtént lejárat/lemondás ideje, UTC, MySQL formátumban |
_requires_manual_renewal |
jelző, hogy az előfizetés kézi megújítást használ-e |
Ez sem teljes lista. További adat például a _suspension_count a felfüggesztések számolásához, és a tételek meta táblájában a belső logikához használt _has_trial.
A következő fizetési dátum módosítása. A _schedule_next_payment közvetlen átírása nem ütemezi újra az ütemezett műveletet. Ha csak az értéket írod át, a következő megújítás a korábbi időpontban fut le, ami több, egymáshoz közeli megújítási rendelést okozhat. Használd helyette a WC_Subscription::update_dates metódust.
A WC_Subscription osztály
Szekció neve “A WC_Subscription osztály”A WC_Subscription a WC_Order (és a WC_Abstract_Order) leszármazottja, így örökli azok minden metódusát. Néhány saját metódusa:
WC_Subscription::get_date( $date_type ): egy dátum lekérdezése, például a következő fizetésé;WC_Subscription::update_dates( $dates ): dátumok beállítása, például a próbaidő végéé és a következő fizetésé;WC_Subscription::calculate_date( $date_type ): dátum kiszámítása az ütemezés alapján;WC_Subscription::get_related_orders( $return_fields, $order_type ): az előfizetéshez kapcsolódó rendelések (megújítási, váltási vagy szülő rendelés);WC_Subscription::is_manual(): kézi megújítást használ-e;WC_Subscription::update_manual( $is_manual ): kézi megújítás be- vagy kikapcsolása.
Az előfizetés bejegyzés-azonosítója egyedi azonosítóként használható, és a wcs_get_subscription() is ezzel adja vissza az előfizetést. A metódusok bővebb listája a Függvények fejezetben van.
Készült: