Tovább a tartalomhoz

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

  • az egyszerű előfizetéses termék: WC_Product_Subscription (a WC_Product_Simple leszármazottja);
  • a változó előfizetéses termék: WC_Product_Variable_Subscription (a WC_Product_Variable leszármazottja);
  • az előfizetés-variáció: WC_Product_Subscription_Variation (a WC_Product_Variation leszá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 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_subscription egyéni bejegyzéstípusként tárolódik.
  • Nagy teljesítményű rendeléstárolóban (HPOS) shop_subscription típussal a wc_orders táblában.
  • A memóriában WC_Subscription objektum.

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

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