# Rendelés-, kosár- és termékfüggvények

> Az előfizetéses rendelésekkel, a kosárral és az előfizetéses termékekkel dolgozó nyilvános segédfüggvények.

Ez a fejezet néhány nyilvános segédfüggvényt gyűjt össze, amelyeket külső kód is használhat. Nem teljes lista, és nem mondja meg, mikor melyiket érdemes használni. A teljes képhez a bővítmény `wcs-order-functions.php`, `wcs-cart-functions.php`, `class-wc-subscriptions-order.php` és `class-wc-subscriptions-cart.php` fájljait érdemes átnézni. A `WC_Subscription` objektum metódusairól a [Függvények és tulajdonságok](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/fejlesztoknek-fuggvenyek/) fejezet szól.

Az egyedi kódokra nem vonatkozik terméktámogatás: ha egy kódrészletet testre kell szabni, fordulj fejlesztőhöz.

## Rendelés és kosár

### `wcs_order_contains_subscription( $order, $order_type )`

Megnézi, hogy a megadott rendelésen keresztül vásároltak-e előfizetést a pénztárban.

- `$order` (kötelező): `WC_Order` objektum vagy rendelésazonosító.
- `$order_type` (opcionális): szöveg vagy tömb, értéke `parent`, `renewal`, `resubscribe` és/vagy `switch` lehet. Alapértéke `parent`.
- Visszatérési érték: logikai, `true`, ha a rendelés tartalmaz előfizetést.

### `wcs_get_subscriptions_for_order( $order_id, $args )`

Visszaadja a rendeléshez tartozó összes előfizetést (`WC_Subscription` objektumot).

- `$order_id` (kötelező): `WC_Order` objektum vagy rendelésazonosító.
- `$args` (opcionális): név-érték párokból álló szűrők. A lehetséges szűrők a függvény PHP DocBlockjában vannak felsorolva.
- Visszatérési érték: tömb `azonosító => WC_Subscription` alakban.

### `WC_Subscriptions_Cart::cart_contains_subscription()`

A `WC_Subscriptions_Cart` osztály nagyrészt a `WC_Cart` megfelelő metódusait bővíti, ezért kevés olyan függvénye van, amelyet nyilvános felületnek szántak. Ez az egyik fontos kivétel: megnézi, hogy a kosárban van-e előfizetéses termék. Logikai értéket ad, `true`, ha van.

## Előfizetéses termék: `WC_Subscriptions_Product`

A `WC_Subscriptions_Product` osztály a `WC_Product` előfizetéses párja: az előfizetéses terméktípus adatait érhető el vele. A `$product` paraméter mindegyik függvénynél `WC_Product` objektum vagy termékazonosító, és kötelező.

| Függvény | Mit ad vissza |
|---|---|
| `WC_Subscriptions_Product::get_price_string( $product )` | Szöveg az előfizetés részleteiről, például „20 Ft havonta 3 hónapon át 10 Ft feliratkozási díjjal”: ár, időszak, hossz és feliratkozási díj, ha van. |
| `WC_Subscriptions_Product::get_price( $product )` | Az időszakonként felszámított ár. Ha a termék nem előfizetés, üres szöveg. |
| `WC_Subscriptions_Product::get_period( $product )` | Az időszak szövegként: `Day`, `Week`, `Month` vagy `Year`. Ha a termék nem előfizetés, üres szöveg. |
| `WC_Subscriptions_Product::get_length( $product )` | Az előfizetés hossza egész számként: hány időszakon át ismétlődik a fizetés (egy 6 hónapos előfizetésnél 6). 0, ha a termék nem előfizetés, vagy az előfizetés határozatlan ideig tart. |
| `WC_Subscriptions_Product::get_expiration_date( $product_id, $order_date )` | Az előfizetéses termék lejáratának dátuma az előfizetés hossza alapján. A `$product_id` kötelező egész szám. Az `$order_date` opcionális MySQL formátumú dátum-idő szöveg, ettől számolja a lejáratot; ha üres, a mai dátumtól. Ha a terméknek van hossza, MySQL formátumú dátum-idő a visszatérési érték, egyébként 0. |
