# 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

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

- 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

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` 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](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/fejlesztoknek-fuggvenyek/) fejezetben van.
