# Az előfizetés szűrői

> Az előfizetés paramétereinek módosítása, a lemondás elhalasztása a időszak végéig, és az ügyfélportál előfizetéslistájának módosítása.

## `gform_stripe_subscription_params_pre_update_customer`: az előfizetés paraméterei

A szűrő az előfizetés paramétereit írja felül, mielőtt az ügyfél feliratkozik a csomagra. A bővítmény 5.2-es változata előtt a szűrő az előfizetés létrehozása előtt fut. Újabb változatban, ha a Stripe-mezőben be van kapcsolva a **Stripe Payment Element használata** beállítás, az már létrehozott előfizetés frissítésekor fut.

```php
add_filter( 'gform_stripe_subscription_params_pre_update_customer', 'your_function_name', 10, 7 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$subscription_params` | array | Az előfizetés paraméterei. A Stripe előfizetés-létrehozási és -frissítési leírása sorolja fel, mit fogadhat el. |
| `$customer` | object | A Stripe ügyfélobjektuma. |
| `$plan` | object | A Stripe csomagobjektuma. |
| `$feed` | Feed Object | A feldolgozott feed. |
| `$entry` | Entry Object | A feldolgozott bejegyzés. |
| `$form` | Form Object | Az űrlap, amelyből a bejegyzés keletkezett. |
| `$trial_period_days` | int | A próbaidőszak napjainak száma. |

### Lemondás az időszak végén

```php
add_filter( 'gform_stripe_subscription_params_pre_update_customer', function ( $subscription_params, $customer, $plan, $feed, $entry, $form, $trial_period_days ) {
    $subscription_params['cancel_at_period_end'] = true;

    return $subscription_params;
}, 10, 7 );
```

### Lemondás megadott időpontban

A Stripe `cancel_at` paramétere időbélyeget vár, amikor az előfizetés magától megszűnik. Így az előfizetés néhány terhelés után automatikusan lejárhat. A példa az előfizetés létrehozása után egy hónappal és egy nappal állítja be a lejáratot, ami havi számlázási ciklusnál két befizetés beszedését teszi lehetővé. Csak a felsorolt nevű feedekre fut le:

```php
add_filter( 'gform_stripe_subscription_params_pre_update_customer', function ( $subscription_params, $customer, $plan, $feed, $entry, $form, $trial_period_days ) {
    gf_stripe()->log_debug( 'Running custom code for cancel_at parameter for form ID: ' . $entry['form_id'] );

    // A feed neve, amely a bejegyzést feldolgozta.
    $feed_name = rgars( $feed, 'meta/feedName' );

    // Azoknak a feedeknek a nevei, amelyekre a kód lefut.
    $feed_names = array( 'My Subscription Feed', 'Another Feed', 'Stripe Feed 36' );

    if ( ! in_array( $feed_name, $feed_names ) ) {
        return $subscription_params;
    }

    // A lejárat: az előfizetés létrehozása után 1 hónappal és 1 nappal.
    $today = date_i18n( 'Y-m-d' );
    $subscription_params['cancel_at'] = strtotime( $today . ' +1 month +1 day' );

    return $subscription_params;
}, 10, 7 );
```

A szűrő a Stripe-bővítmény 2.3.4-es változatában került be.

## `gform_stripe_subscription_cancel_at_period_end`: a lemondás elhalasztása

Alapértelmezetten a bővítmény az előfizetést azonnal lemondja, amikor a bejegyzésnél lemondod. Ezzel a szűrővel a lemondás a jelenlegi időszak végére halasztható.

```php
add_filter( 'gform_stripe_subscription_cancel_at_period_end', 'your_function_name', 10, 3 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$at_period_end` | bool | Alapértéke `false`: az előfizetés azonnal megszűnik. |
| `$entry` | Entry Object | A bejegyzés, amelyből az előfizetés keletkezett. |
| `$feed` | Feed Object | A bejegyzést feldolgozó feed. |

Minden előfizetésre:

```php
add_filter( 'gform_stripe_subscription_cancel_at_period_end', '__return_true' );
```

Csak egy adott feedre, a feed neve alapján:

```php
add_filter( 'gform_stripe_subscription_cancel_at_period_end', function ( $at_period_end, $entry, $feed ) {
    $feed_name = rgars( $feed, 'meta/feedName' );
    if ( $feed_name == 'your feed name here' ) {
        return true;
    }

    return $at_period_end;
}, 10, 3 );
```

A szűrő a Stripe-bővítmény 2.1-es változatában került be.

## `gform_stripe_subscriptions_self_serve_markup`: az ügyfélportál előfizetéslistája

A szűrő az ügyfélportál shortcode műveletéből (`stripe_customer_portal_link`) előálló kimenetet módosítja a megjelenítés előtt: vagy az előfizetések listájának HTML-jét, vagy a „nincs előfizetés” üzenetét. A shortcode működéséről lásd [Az ügyfélportál shortcode](https://hub.hellowp.io/hu/plugins/gravityformsstripe/bejegyzesek-es-elofizetesek-ugyfelportal-shortcode/).

```php
add_filter( 'gform_stripe_subscriptions_self_serve_markup', 'your_function_name', 10, 3 );
```

Egy űrlapra szabva az azonosítót a szűrő nevéhez fűzve: `gform_stripe_subscriptions_self_serve_markup_7`.

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$markup` | string | A lista HTML-je. |
| `$subscriptions` | array | Az előfizetések adatai. |
| `$form_id` | integer | Az előfizetésekhez tartozó űrlap azonosítója. |

Példa: ha az ügyfélnek nincs előfizetése, a kimenet végére egy hivatkozás kerül az előfizetés indítására:

```php
add_filter( 'gform_stripe_subscriptions_self_serve_markup', function ( $markup, $subscriptions, $form_id ) {
    if ( empty( $subscriptions ) ) {
        $markup .= '<br><a href="{some_url}">Iratkozz fel most!</a>';
    }

    return $markup;
}, 10, 3 );
```

A `{some_url}` helyére az előfizetési oldal címe kerül. A szűrő a Stripe-bővítmény 4.2-es változatában került be.
