wc_update_order_item_meta() – обновляет метаданные позиции заказа

includes / wc-order-item-functions.php / Кодекс WordPress

Функция позволяет изменить какие-либо метаданные позиции заказа WooCommerce, например цену или даже ID товара, к которому она прикреплена. Если метаданных с указанным ключом не существует, то они будут добавлены.

Возвращает true, если обновление/добавление прошло успешно, иначе – false.

wc_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_value );

Параметры wc_update_order_item_meta()

$item_id: (целое число) ID позиции заказа, его кстати можно получить из самого заказа при помощи метода get_items(), подробнее тут.
$meta_key: (строка) Ключ метаданных.
$meta_value: Новое значение метаданных.
$prev_value: Иногда метаданных с одним и тем же ключом может быть несколько, в таких случаях мы можем обновить только определённые метаданные, чьё значение до изменения равно этому параметру.

Пример

В качестве примера попробуем изменить цену доставки в заказе с определённым ID.

$order_id = 5;
$order = wc_get_order( $order_id );
$order_items = $order->get_items( array( 'shipping' ) );
 
foreach( $order_items as $item_id => $order_item ) {
	wc_update_order_item_meta( $item_id, 'cost', 500 );
}
 
$order->calculate_totals();

Прежде всего мы используем метод get_items() объекта заказа WC_Order для получения всех позиций заказа, связанных с доставкой (для этого в качестве параметра передаём значение shipping).
cost – это предопределённое значение мета-ключа, отвечающего за цену доставки, полный список зарезервированных ключей вы найдёте здесь.
При изменении цен позиций заказа всегда делаем его перерасчёт методом $order->calculate_totals().

Кодекс WordPress: WooCommerce: get_woocommerce_currencies(), get_woocommerce_currency(), get_woocommerce_currency_symbol(), woocommerce_breadcrumb(), is_account_page(), is_add_payment_method_page(), is_cart(), is_checkout(), is_edit_account_page(), is_order_received_page(), is_product(), is_product_category(), is_product_tag(), is_product_taxonomy(), is_shop(), is_view_order_page(), is_wc_endpoint_url(), is_woocommerce(), wc_add_order_item(), wc_add_order_item_meta(), WC_Cart::add_to_cart(), WC_Cart::empty_cart(), wc_delete_order_item(), wc_delete_order_item_meta(), wc_get_cart_url(), wc_get_checkout_url(), wc_get_customer_total_spent(), wc_get_page_id(), wc_get_product_id_by_sku(), wc_get_product_ids_on_sale(), wc_get_product_terms(), WC_Order{}, wc_post_content_has_shortcode(), wc_price(), wc_print_notice(), WC_Product{}, wc_update_order_item(), wc_update_order_item_meta(), woocommerce_form_field(), woocommerce_wp_checkbox(), woocommerce_wp_radio(), woocommerce_wp_text_input(), woocommerce_wp_textarea_input()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Пример использования