CashCtrl Gateway for WooCommerce
Programmierbare Felder
Programmierbare Felder erlauben es, eigenständiger Code in der functions.php des Child-Themes zu definieren und das Resultat innerhalb vordefinierten Funktionen an ein Zusatzfeld in CashCtrl zu übergeben.
Nachfolgender Inhalt richtet sich an Nutzer mit Programmierkenntnissen!
Um die Stabilität der Seite und dessen Prozesse zu gewährleisten, sollte Innerhalb der Funktionen ein minimales Exception- und Error-Handling angewendet werden.
Funktionen
Folgende fünf Funktionsnamen stehen zur freien Nutzung innerhalb von CashCtrl Gateway for WooCommerce zur Verfügung:
wgc_programmable_field_1( $order_id )
wgc_programmable_field_2( $order_id )
wgc_programmable_field_3( $order_id )
wgc_programmable_field_4( $order_id )
wgc_programmable_field_5( $order_id )Allen fünf Funktionen wird immer die $order_id der jeweiligen Bestellung übergeben, womit grundsätzlich Zugriff auf die komplette Bestellung gewährleistet ist.
Die Funktionen müssen nicht speziell aufgerufen werden (z.B. durch einen Hook) da diese, sobald definiert, durch das Plugin verwendet werden.
Deklaration
Der Rückgabewert muss immer ein Array, bestehend aus den folgenden beiden Keys sein:
| Key | Beschreibung |
|---|---|
name | MANDATORY STRINGFrei definierbaren Namen welcher im Dropdown Menü neben dem jeweiligen Feld angezeigt wird. Dieser sollte ausserhalb von jeder Prüfung definiert werden damit der Namen jederzeit angezeigt wird. |
result | MANDATORY STRINGWert als String welcher dem CashCtrl Zusatzfeld übergeben werden soll. Spezielle Symbole oder HTML/XML Tags werden herausgefiltert bevor diese an CashCtrl übergeben werden. |
Beispiel eines Anwendungsfalls
Das Plugin Order Delivery Date for WooCommerce speichert, dass durch den Kunden bei der Bestellung angegebene Lieferdatum in einem benutzerdefinierten Auftragsfeld. Mit der nachfolgenden Funktion kann dieses ausgelesen, an CashCtrl übergeben und in einen Zusatzfeld gespeichert werden.
function wgc_programmable_field_1( $order_id ) {
/* DEFINE NAME OF FIELD, ONLY FOR CONVENIENCE */
$return = array(
'name' => 'Delivery Date'
);
/* VALIDATE IF THERE HAS BEEN PASSED AN ID */
if ( $order_id ) {
/* PREPARE RESULT */
$return = array(
'result' => get_post_meta( $order_id, 'Delivery Date', true )
);
}
/* RETURN ARRAY */
return $return;
}Wie Variablen in CashCtrl Zusatzfelder übermittelt werden können, ist im nachfolgenden Tutorial beschrieben.
Kontaktieren Sie uns, falls wir Sie bei der Umsetzung von Ihren Ideen zur Automatisierung unterstützen können.
