Tovább a tartalomhoz

Kapcsolat és átirányítás: API-mód, Stripe Connect, megszakítási cím

Az API-mód felülírása, a Stripe Connect kikapcsolása, a Stripe-ból visszatérő vásárló címeinek és a kiszolgáló portjának módosítása szűrőkkel.

Ez a fejezet öt PHP-szűrőt mutat be, amelyekkel a Stripe-kapcsolat működését és a Stripe Checkoutból visszatérő vásárló útját módosíthatod. A kódot az aktív téma functions.php fájljába, egy saját funkcióbővítő bővítménybe, egy saját Add-On-ba vagy egy kódrészlet-kezelő bővítménybe (snippets plugin) teheted.

gform_stripe_api_mode: éles vagy teszt mód kényszerítése

Szekció neve “gform_stripe_api_mode: éles vagy teszt mód kényszerítése”

A szűrővel az API módját állíthatod „live” (éles) vagy „test” (teszt) értékre, függetlenül attól, mit választottál a Űrlapok → Beállítások → Stripe oldalon.

add_filter( 'gform_stripe_api_mode', 'your_function_name', 10, 2 );
Paraméter Típus Jelentés
$api_mode string Az API módja: live vagy test.
$feed_id int A szűrő környezete. Ha null, a globális kapcsolati beállítások érvényesek. Ha meg van adva, a mód a feedhez tartozó kapcsolatra vonatkozik.

Mód beállítása az egész webhelyen:

add_filter( 'gform_stripe_api_mode', function ( $api_mode, $feed_id ) {
return 'live';
}, 10, 2 );

Mód beállítása csak egy adott feedre (itt az 521-es azonosítójúra):

add_filter( 'gform_stripe_api_mode', function ( $api_mode, $feed_id ) {
if ( $feed_id === 521 ) {
return 'live';
}
return $api_mode;
}, 10, 2 );

gform_stripe_connect_enabled: a Stripe Connect kikapcsolása

Szekció neve “gform_stripe_connect_enabled: a Stripe Connect kikapcsolása”

Alapértelmezés szerint új telepítéseknél a bővítmény a Stripe Connect (OAuth) kapcsolatot használja. Ezzel a szűrővel kikapcsolhatod, és visszatérhetsz a régi, API-kulcsos kapcsolati módhoz: ilyenkor a régi beállítóképernyő jelenik meg a Connect-képernyő helyett.

add_filter( 'gform_stripe_connect_enabled', '__return_false' );
Paraméter Típus Jelentés
$stripe_connect_enabled boolean Új telepítéseknél alapból true. false esetén a régi beállítóképernyő látszik.

Tudnivalók:

  • A szűrő beállítása után előbb le kell választanod a webhelyet a Stripe-ról, hogy a kulcsmezők megjelenjenek.
  • A kódot az aktív téma functions.php fájljába tedd.

gform_stripe_cancel_url: a megszakítás utáni cím

Szekció neve “gform_stripe_cancel_url: a megszakítás utáni cím”

Ha a vásárló a Stripe Checkout oldalán megszakítja a fizetést, a Stripe visszairányítja a webhelyedre. A szűrővel ennek a visszatérési címnek (a Stripe-munkamenet cancel URL-jének) a módosítására használhatod.

add_filter( 'gform_stripe_cancel_url', 'your_function_name', 10, 2 );
Paraméter Típus Jelentés
$url string A szűrendő cím.
$form_id int Az elküldött űrlap azonosítója.

Példa: a cím gazdagépnevének cseréje (helyi fejlesztői környezetből éles tartományra):

add_filter( 'gform_stripe_cancel_url', function ( $url, $form_id ) {
GFCommon::log_debug( __METHOD__ . '(): Original URL: ' . $url );
// Cseréld az example.com-ot a saját tartományodra.
$url = str_replace( 'localhost', 'example.com', $url );
GFCommon::log_debug( __METHOD__ . '(): New URL: ' . $url );
return $url;
}, 10, 2 );

A kódot az aktív téma functions.php fájljába tedd.

gform_stripe_success_url: a sikeres fizetés utáni cím

Szekció neve “gform_stripe_success_url: a sikeres fizetés utáni cím”

A szűrő a Stripe-munkamenet sikeres visszatérési címét (success URL) módosítja, vagyis azt a címet, ahová a vásárló a Stripe oldalán befejezett fizetés után kerül.

add_filter( 'gform_stripe_success_url', 'your_function_name', 10, 3 );
Paraméter Típus Jelentés
$url string A szűrendő cím.
$form_id int Az elküldött űrlap azonosítója.
$query string A cím lekérdezési (query string) része.

Példa: ha a webhely valamiért localhost tartománnyal adja át a címet, ezzel kicserélheted a saját tartományodra:

add_filter( 'gform_stripe_success_url', function ( $url, $form_id, $query ) {
GFCommon::log_debug( __METHOD__ . '(): Original URL: ' . $url );
// Cseréld az example.com-ot a saját tartományodra.
$url = str_replace( 'localhost', 'example.com', $url );
GFCommon::log_debug( __METHOD__ . '(): New URL: ' . $url );
return $url;
}, 10, 3 );

A kódot az aktív téma functions.php fájljába tedd.

gform_stripe_url_port: a kiszolgáló portja a címekben

Szekció neve “gform_stripe_url_port: a kiszolgáló portja a címekben”

Ha a webhely nem a 80-as porton fut, a szűrővel megadhatod, melyik portot használja a bővítmény. Az alapérték a kiszolgáló portja ($_SERVER['SERVER_PORT']).

add_filter( 'gform_stripe_url_port', 'your_function_name' );
Paraméter Típus Jelentés
$server_port string Az alapértelmezett kiszolgálóport.

Példa:

add_filter( 'gform_stripe_url_port', function ( $server_port ) {
gf_stripe()->log_debug( __METHOD__ . '(): Original port: ' . $server_port );
$server_port = '80'; // A 80 helyére írd a használni kívánt portot.
gf_stripe()->log_debug( __METHOD__ . '(): Custom port: ' . $server_port );
return $server_port;
} );

A kódot az aktív téma functions.php fájljába tedd.

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