Описание woocommerce_email_order_items_args
— Filter
Хук woocommerce_email_order_items_args позволяет изменять параметры, передаваемые в функции, отвечающие за вывод элементов заказа в электронных письмах WooCommerce. Он срабатывает при формировании содержимого электронного письма для заказов и позволяет настраивать отображение и форматирование этих элементов
Примеры использования
Пример изменения формата вывода элементов заказа в электронном письме:
add_filter('woocommerce_email_order_items_args', function($args) {
$args['items'] = array_map(function($item) {
$item->get_product()->set_price($item->get_total() * 1.1);
return $item;
}, $args['items']);
return $args;
});
В этом примере мы увеличиваем цену каждого элемента заказа на 10% перед отправкой письма
Пример добавления дополнительной информации к элементам заказа:
add_filter('woocommerce_email_order_items_args', function($args) {
foreach ($args['items'] as $item) {
$item->add_meta_data('Дополнительная информация', 'Это кастомное поле');
}
return $args;
});
Здесь мы добавляем дополнительное метаданные к каждому элементу заказа
Пример фильтрации элементов заказа перед отправкой письма:
add_filter('woocommerce_email_order_items_args', function($args) {
$args['items'] = array_filter($args['items'], function($item) {
return $item->get_quantity() > 0;
});
return $args;
});
В этом примере мы исключаем элементы заказа с нулевым количеством из письма
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить форматирование или содержимое элементов заказа в электронных письмах WooCommerce
– Производительность
При использовании этого хука следует учитывать, что изменения могут повлиять на скорость генерации писем, особенно при большом количестве заказов
– Предупреждения
Убедитесь, что изменения не затрагивают критически важные данные, такие как цены и описания продуктов
Альтернативы
Тип: action
Этот хук позволяет добавлять информацию перед элементами заказа в электронных письмах
Используйте его, если нужно добавить дополнительную информацию перед выводом элементов заказа