# Szűrők

> Az Előfizetések bővítmény fontosabb szűrői: árszöveg, periódusok, hosszak, megújítási rendelés, újrafeliratkozás és beállítások.

A bővítmény több mint 400 szűrőt használ. Itt a hasznosabbak szerepelnek. A lista nem oktatóanyag, csak a használható pontokat mutatja.

## Termék és árszöveg

**`woocommerce_is_subscription`** a bővítmény többi része számára dönti el, hogy egy termék előfizetéses-e.
Paraméterek: `$is_subscription` (logikai), `$product_id`, `$product` (`WC_Product`). Ezzel az előfizetési funkciók egy része nem előfizetéses termékekre is bekapcsolható.

**`woocommerce_subscriptions_product_price_string`** az előfizetéses termék ár-szövegét adja (például „10 Ft / hónap, 12 hónapig, 5 Ft feliratkozási díjjal”). Az előfizetés ára összetettebb, mint egy sima termék áráé: van számlázási időszaka (például hónap), intervalluma (például 2 hetente), hossza (például 12 hónap) és feliratkozási díja. A termék ára mindenhol a `WC_Subscriptions_Product::get_subscription_price_string()` függvényből jön, amely ezen a szűrőn megy át.
Paraméterek: `$subscription_string`, `$product`, `$include` (tömb):

- `tax_calculation`: `false` az adó figyelmen kívül hagyásához, `include_tax` vagy `exclude_tax` az adó hozzáadásához vagy kihagyásához;
- `subscription_length`: `true` (alap) a hossz szerepeltetéséhez, `false` a kihagyásához;
- `sign_up_fee`: `true` (alap) a feliratkozási díj szerepeltetéséhez, `false` a kihagyásához;
- `price`: a termék tényleges ismétlődő ára helyett használt ár.

**`woocommerce_subscription_price_string`** a kosár és a rendelés végösszegének árszövege. Ugyanezek az adatok a kosárban és a rendelésen is megjelennek, ezért a `WC_Subscriptions_Manager::get_subscription_price_string()` függvény ezen a szűrőn adja vissza az értéket.
Paraméterek: `$subscription_string`, `$subscription_details` (tömb): `initial_amount` (előre fizetett összeg a feliratkozási díjjal), `initial_description` (az összeg után álló szó, alapból „up front”), `recurring_amount`, `subscription_interval` (alap 1), `subscription_period` (`day`, `week`, `month`, `year`), `subscription_length` (alap 0, vagyis határozatlan), `trial_length` (alap 0), `trial_period`.

**`woocommerce_subscriptions_product_first_renewal_payment_time`** az első megújítás időpontját módosítja, például egyedi hosszúságú kezdő időszakhoz, vagy olyan fizetési napra igazításhoz, amit a beépített számlázási nap igazítás nem tud. Alapból a termék számlázási időszakából és intervallumából számolódik, de bármilyen jövőbeli érvényes időpontra állítható.
Paraméterek: `$first_renewal_timestamp`, `$product_id`, `$from_date_param` (MySQL dátum UTC-ben, üresen a mai nap), `$timezone` (`site` vagy `gmt`, alap `site`).

## Időszakok, hosszak, intervallumok

**`woocommerce_subscription_periods`** a bővítményben használt összes időszakot (`$period_key => $period_labels`) átadja, így módosítható, mely időszakok érhetők el és milyen felirattal. Figyelem: új időszak (például kéthetente vagy kétévente) bevezetésekor a pénztárban csak az ezeket támogató fizetési átjárókat szabad felkínálni.

**`woocommerce_subscription_lengths`** az előfizetéses termékeknél megadható hosszakat (a tömb első szintje az időszak: `day`, `week`, `month`, `year`; a második szinté a hossz egész számként, a 0 jelentése „nincs korlát”) adja át. Ezzel szűkíthetők a hosszak. Példa: határozatlan hosszú előfizetések tiltása.

```php
function eg_do_not_allow_all_time_subscriptions( $subscription_lengths ) {
    foreach ( $subscription_lengths as $period => $allowed_lengths ) {
        if ( isset( $subscription_lengths[ $period ][0] ) ) {
            unset( $subscription_lengths[ $period ][0] );
        }
    }
    return $subscription_lengths;
}
add_filter( 'woocommerce_subscription_lengths', 'eg_do_not_allow_all_time_subscriptions', 10 );
```

**`woocommerce_subscription_period_interval_strings`** a számlázási intervallumokat (például 10 / hónap, 2 havonta, 3 havonta) adja át, ezzel korlátozható a választék. Alapból legfeljebb minden 6. időszak választható (1: „per”, 2: „every 2nd” … 6: „every 6th”). Példa: csak a minden időszakos (napi, heti, havi) számlázás engedélyezése:

```php
function eg_do_not_allow_non_single_billing_intervals( $billing_intervals ) {
    array_splice( $billing_intervals, 1 );
    return $billing_intervals;
}
add_filter( 'woocommerce_subscription_period_interval_strings', 'eg_do_not_allow_non_single_billing_intervals', 10 );
```

## Felhasználó és vásárlói műveletek

| Szűrő | Paraméterek | Mire jó |
|---|---|---|
| `wcs_get_users_subscriptions` | `$subscriptions`, `$user_id` | A `wcs_get_users_subscriptions()` visszatérési értéke. Ezzel adhatsz a felhasználóhoz adatbázisban nem tárolt előfizetést, például ha az másik áruházban van. |
| `wcs_user_has_subscription` | `$has_subscription`, `$user_id`, `$product_id`, `$status` (alap `any`) | Megadja, hogy a felhasználónak van-e előfizetése egy termékre, opcionális státuszszűréssel. |
| `wcs_users_change_status_link` | `$action_link`, `$subscription_id`, `$status` | A vásárló a **Fiókom → Előfizetés megtekintése** oldalon gombbal módosíthatja az előfizetés státuszát. A gomb URL-jét a `wcs_get_users_change_status_link()` adja, ez a szűrő módosítja. Ha a link paraméterei (`change_subscription_to` érvényes státusszal, `_wpnonce`, `subscription_id`) rendben vannak, a bejelentkezett felhasználó saját előfizetése módosul. |
| `wcs_view_subscription_actions` | `$action_link`, `$subscription_id`, `$status` | A **Fiókom → Előfizetés megtekintése** oldal gombjait a `wcs_get_all_user_actions_for_subscription()` adja, és ezen a szűrőn át külső kód új gombokat adhat hozzá. |
| `wcs_can_user_resubscribe_to_subscription` | `$can_user_resubscribe`, `$subscription`, `$user_id` | Szabályozza, hogy a felhasználó újrafeliratkozhat-e. Alapból az előfizetésnek inaktívnak (lejárt vagy lemondott) kell lennie, legalább egy fizetésnek meg kell történnie (a feliratkozási díj megkerülése ellen), a szülő rendelést nem válthatta le megújítási rendelés, és a megvásárolt termék nem törölhető. Ezeket a feltételeket módosíthatod. |

## Megújítási rendelés

Az Előfizetések a megújítások minden adatát egy szokásos WooCommerce-rendelésben tárolja, amely külön jelölővel kapcsolódik az előfizetéshez.

**`wcs_renewal_order_created`**: a megújítási rendelés a `wcs_create_renewal_order()` függvényből jön létre (ütemezett megújításnál, kézi feldolgozásnál az előfizetés szerkesztőjében, vagy a REST API-val), ezért ezen a szűrőn bármi hozzáadható, eltávolítható vagy módosítható rajta. Például kedvezmény adható egy bizonyos megújításra (évi 12.-re), vagy egyszeri extra díj egy havi előfizetés éves megújításán.
Paraméterek: `$renewal_order` (`WC_Order`), `$subscription` (`WC_Subscription`).

**`wcs_renewal_order_meta_query`**: megújítási rendelés létrehozásakor a bővítmény a rendelés szinte minden meta-adatát átmásolja (kivéve néhány WooCommerce- és Előfizetések-adatot). A bővítmény kizárásos elvet követ: ami nincs kizárva, az másolódik, így jobb a kompatibilitás más bővítményekkel. Ha a bővítményed meta-adata egy rendeléshez kötődik (például fizetési token vagy csomagkövetési kód), ezzel a szűrővel zárd ki a másolásból. A szűrő érvényes SQL-t vár.
Paraméterek: `$order_meta_query` (SQL-szöveg), `$to_order`, `$from_order`.

```php
function eg_do_not_copy_meta_data( $order_meta_query, $to_order, $from_order ) {
    $order_meta_query .= " AND `meta_key` NOT IN ('_my_extensions_meta_key', '_my_extensions_other_meta_key')";
    return $order_meta_query;
}
add_filter( 'wcs_renewal_order_meta_query', 'eg_do_not_copy_meta_data', 10, 3 );
```

## Váltás és beállítások

**`wcs_switch_proration_extra_to_pay`**: a váltáskor az időarányos fizetendő többletet módosítja. Az `apply_filters( 'wcs_switch_proration_extra_to_pay', $extra_to_pay, $subscription, $cart_item, $switch_item )` hívás paraméterei: `$extra_to_pay` (tizedes szám, a váltás miatt fizetendő időarányos összeg), `$subscription` (a váltott előfizetés), `$cart_item` (az új termék kosártétele), `$switch_item` (a váltási kosártétel a váltás adataival, például a forrás előfizetéssel és a cél variációval).

**`woocommerce_subscription_settings`**: egyedi beállításokat adhatsz a **WooCommerce → Beállítások → Előfizetések** oldalhoz. A beállítások tömbje a `woocommerce_admin_fields()` formátumú, ugyanezt használja a megjelenítés (`woocommerce_admin_fields()`) és a mentés (`woocommerce_update_options()`) is.
