Tovább a tartalomhoz

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.
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 );

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások