wc_update_order_item() – изменяет информацию о позиции заказа

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

Функция позволяет изменить основную информацию о позиции заказа WooCommerce – название позиции, её тип и то, к какому заказу она прикреплена.

Возвращает true, если получилось обновить информацию, если не получилось – false.

wc_update_order_item( $item_id, $args )

Параметры функции wc_update_order_item()

$item_id

(целое число) ID позиции заказа, его кстати можно получить из самого заказа при помощи метода get_items(), подробнее тут.

$args

(массив) Массив параметров, которые вы хотите изменить.

order_id: (целое число) ID заказа, к которому прикреплена данная позиция.
order_item_name: (строка) Название позиции заказа. То есть, даже если вы планируете добавить какой-то определённый товар, то его название не обязательно должно совпадать с оригинальным названием товара.
order_item_type: (строка) Тип позиции заказа. По умолчанию line_item, что может являться товаром или вариацией товара, но также может принимать значения shipping (доставка) или fee (сбор).

Пример

В качестве примера можем получить все позиции заказа с ID=5 и переприкрепить все эти позиции к заказу с ID=55.

$order = wc_get_order( 5 );
$order_items = $order->get_items( array( 'line_item', 'fee', 'shipping' ) );
 
if ( ! is_wp_error( $order_items ) ) {
 
	foreach( $order_items as $item_id => $order_item ) {
		wc_update_order_item( $item_id, array( 'order_id' => 55 ) );
	}
 
}
 
// также возможно вы захотите пересчитать заказ с ID=55 методом calculate_totals()

Хук woocommerce_update_order_item

В случае, если информация о позиции заказа была успешно обновлена, то срабатывает хук woocommerce_update_order_item.

add_action( 'woocommerce_update_order_item', 'true_after_order_item_update', 25, 2 );
 
function true_after_order_item_update( $item_id, $args ) {
	// делаем что-либо
}

Кодекс 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. Преподаватель в школе Нетология.

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

Параметры
Пример
woocommerce_update_order_item