Možnosti rozšírenia – hooks

Plugin CardPay pre WooCommerce od Pluginatora Vám umožňuje upravovať jeho funkcionalitu pomocou WordPress hooks (akcií a filtrov).

V rámci úprav je možné využiť nasledovné hooks pre úpravu údajov odosielaných do CardPay.

• cardPayRequestVariableSymbol – slúži na úpravu hodnoty pre variabilný symbol. Default: $order->getId()

/**
 * $value - obsahuje $order->getId()
 * $params['orderId'] obsahuje identifikátor objednávky
 */
add_filter("cardPayRequestVariableSymbol", function($value, $params) {
    return $value;
}, 10, 2);

• cardPayRequestName – slúži na úpravu hodnoty pre názov platby. Hodnota môže obsahovať iba písmena a medzery, bez diakritiky a maximálne 30 znakov – presná špecifikácia je dodávaná v rámci CardPay. Default: $order->getCustomerFirstName() . ‚ ‚ . $order->getCustomerLastName()

/**
 * $value - obsahuje meno a priezvisko z objednávky ošetrené podľa pravidiel
 * $params['orderId'] obsahuje identifikátor objednávky
 */
add_filter("cardPayRequestName", function($value, $params) {
    return $value;
}, 10, 2);

• wf_payment_reduce_order_stock_before_payment – slúži na nastavenie automatickej úpravy skladových zásob. Plugin automaticky rezervuje množstvo skladových zásob tesne pred presmerovaním na platobnú bránu. Ak chcete toto nastavenie vypnúť, je to možné pomocou tohoto filter-hooku.
  Default: true

/**
 * $value - true/false, či sa majú upraviť skladové zásoby pred platbou. 
 * $gateway - identifikátor platobnej brány. V prípade CardPay je 'cardpay'
 * $order - objednávka
 */
add_filter('wf_payment_reduce_order_stock_before_payment', function($value, $gateway, $order) {
	return $value;
}, 10, 3);

• wf_payments_cardpay_icon – slúži na nastavenie zobrazenia loga CardPay platobnej brány (pokiaľ nepostačujú možnosti z nastavení v administrácii). Hodnota obsahuje celú URL obrázku.

/**
 * $value - URL pre logo platobnej brány 
 */
add_filter('wf_payments_cardpay_icon', function($value) {
	return $value;
}, 10, 1);

Úprava nastavení pluginu

Nasledujúce filtre umožňujú upraviť tieto nastavenia, ktoré sa nastavujú v rámci administrácie platobných brán WooCommerce.

Takýmto spôsobom je možné upraviť napríklad autentifikačné údaje platobnej brány na základe dodatočných podmienok – napr. pre rôzne domény, ktoré sú poskytované jednou WooCommerce inštanciou.

• wf_payments_cardpay_settings_mid – slúži na úpravu „MID„, jedinečného identifikátora priradeného obchodníkovi.

/**
 * $value - obsahuje MID
 */
add_filter("wf_payments_cardpay_settings_mid", function($value) {
    return $value;
});

• wf_payments_cardpay_settings_secret_key – slúži na úpravu „Secret key„, bezpečnostného kľúča pre komunikáciu s CardPay.

/**
 * $value - obsahuje Secret Key
 */
add_filter("wf_payments_cardpay_settings_secret_key", function($value) {
    return $value;
});