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.phpfá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: