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

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

Добавляет метаданные для позиций заказа, возвращает либо ID строки метаданных в базе данных, либо false, если метаданные добавлены не были.

Читайте отдельный урок про позиции заказа.

wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = false )

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

$item_id: (целое число) ID позиции заказа.
$meta_key: (строка) Ключ.
$meta_value: (строка) Значение.
$unique: (логическое) Должна ли функция добавлять метаданные с указанным ключом, если они уже присутствуют в базе данных. По умолчанию false – метаданные будут добавляться, true – не будут, каждый ключ будет уникальным.

Зарезервированные ключи

У метаданных позиций заказа уже имеется какой-то набор предопределённых ключей, имеющих определённое назначение. Что это за ключи – зависит от типа позиции товара.

Например для типа line_item (товары и вариации) набор ключей будет следующим:

Ключ	Описание
`_product_id`	ID товара, с которым ассоциирована позиция заказа
`_variation_id`	ID вариации товара, с которой ассоциирована позиция заказа
`_line_subtotal`	Цена одной позиции товара
`_qty`	Количество позиций товара
`_line_total`	Общая стоимость

Ключи для типа shipping:

Ключ	Описание
`cost`	Стоимость доставки
`method_id`	Тип метода доставки, например «flat_rate»
`instance_id`	ID метода доставки

Ключи для типа fee:

Ключ	Описание
`_fee_amount`	Сумма сбора

Пример

В качестве примера можем добавить позицию заказа типа line_item, которая будет прилинкована к определённой вариации.

// допустим мы будем добавлять позиции в заказ с ID=5
$order_id = 5;
 
$order_item_id = wc_add_order_item( $order_id, array( 'order_item_name' => 'Футболка', 'order_item_type' => 'line_item' ) );
 
wc_add_order_item_meta( $order_item_id, '_product_id', 13, true );
wc_add_order_item_meta( $order_item_id, '_variation_id', 53, true );
wc_add_order_item_meta( $order_item_id, '_line_subtotal', 10, true ); // цена
wc_add_order_item_meta( $order_item_id, '_qty', 2, true ); // количество
wc_add_order_item_meta( $order_item_id, '_line_total', 20, true ); // стоимость
 
$order = new WC_Order( $order_id );
$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. Преподаватель в школе Нетология.

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

Параметры
Зарезервированные ключи
Пример