Описание woocommerce_get_order_payment_tokens
— Filter
Хук woocommerce_get_order_payment_tokens позволяет изменять список доступных токенов платежей для заказа. Он срабатывает при получении токенов платежей для конкретного заказа, что дает возможность модифицировать или добавлять токены перед их отображением или использованием
Примеры использования
Пример добавления нового токена платежа к списку токенов:
add_filter('woocommerce_get_order_payment_tokens', function($payment_tokens, $order) {
$new_token = array(
'id' => 'new_token_id',
'method_id' => 'custom_method',
'last4' => '5678',
'expiry_month' => '11',
'expiry_year' => '2026'
);
$payment_tokens[] = $new_token;
return $payment_tokens;
});
В этом примере мы добавляем новый токен платежа к списку доступных токенов для заказа
Пример изменения существующего токена платежа:
add_filter('woocommerce_get_order_payment_tokens', function($payment_tokens, $order) {
foreach ($payment_tokens as &$token) {
if ($token['id'] === 'existing_token_id') {
$token['last4'] = '9999';
}
}
return $payment_tokens;
});
Здесь мы изменяем последние 4 цифры существующего токена на ‘9999’
Пример удаления токена платежа из списка:
add_filter('woocommerce_get_order_payment_tokens', function($payment_tokens, $order) {
return array_filter($payment_tokens, function($token) {
return $token['id'] !== 'token_to_remove';
});
});
В этом примере мы удаляем токен платежа с идентификатором ‘token_to_remove’ из списка
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо модифицировать список токенов платежей для заказов, например, для добавления кастомных методов оплаты
– Производительность
Хук не должен значительно влиять на производительность, так как изменения происходят на уровне данных о заказе
– Предупреждения
Обратите внимание на уникальность идентификаторов токенов, чтобы избежать конфликтов
Альтернативы
Тип: action
Этот хук позволяет добавлять дополнительный функционал к уже существующим токенам платежей
Используйте его, если нужно добавить дополнительные настройки или функционал к токенам без изменения их списка
