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
Szekció neve “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.
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
Szekció neve “Lemondás az időszak végén”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
Szekció neve “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:
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
Szekció neve “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ó.
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:
add_filter( 'gform_stripe_subscription_cancel_at_period_end', '__return_true' );Csak egy adott feedre, a feed neve alapján:
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
Szekció neve “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.
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:
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.
Készült: