Woocommerce: какой хук заменить устаревший woocommerce_add_order_item_meta

Если вы посмотрите на wc-deprecated-functions.php, вы увидите

/**
 * @deprecated
 */
function woocommerce_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = false ) {
    return wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique );
}

По сути, функция была переименована в wc_add_order_item_meta(), поэтому, если вам нужна функция, используйте ее. Обработчик действия не был переименован и остается в class-wc-checkout.php как:

// Allow plugins to add order item meta
do_action( 'woocommerce_add_order_item_meta', $item_id, $values, $cart_item_key );

2017/2018 ПРАВИЛЬНЫЙ ПУТЬ (с использованием новых методов установки и получения CRUD)

По теме: Заменить крючок woocommerce_add_order_item_meta в Woocommerce 3.4

Начиная с woocommerce 3, который улучшил многие вещи, внося кардинальные изменения, обработчик действий woocommerce_add_order_item_meta по-прежнему отлично работает даже в woocommerce версии 3.3+.

Эта ловушка активируется WC_Checkout методами класса и связанными функциями в процессе оформления заказа, а не в WC_Order классе, где данные корзины больше не доступны.

Теперь, когда Woocommmerce 3 представила новые методы установки и получения CRUD, будет использоваться аналогичный перехватчик замены woocommerce_checkout_create_order_line_item, который имеет те же полезные аргументы, что и данные корзины.

woocommerce_new_order_item действительно НЕ удобно, поскольку данные корзины недоступны.

Посмотрим, как работать с woocommerce_checkout_create_order_line_item. У него есть 4 доступных аргумента:

• $item - это экземпляр WC_Order_Item_Product нового представленного класса
• $cart_item_key - уникальный хэш-ключ корзины.
• $values - это элемент корзины
• $order экземпляр объекта WC_Order (это очень полезный дополнительный аргумент в некоторых конкретных случаях)

В этой ловушке мы заменим старые рабочие функции wc_add_order_item_meta () новым методом WC_Data update_meta_data(), который будет использоваться с аргументом $item.

Пример:

## --- New way --- ##
add_action( 'woocommerce_checkout_create_order_line_item', 'custom_checkout_create_order_line_item', 20, 4 );
function custom_checkout_create_order_line_item( $item, $cart_item_key, $values, $order ) {
    // Get a product custom field value
    $custom_field_value = get_post_meta( $item->get_product_id(), '_meta_key', true );
    // Update order item meta
    if ( ! empty( $custom_field_value ) ){
        $item->update_meta_data( 'meta_key1', $custom_field_value );
    }
    // … … Or … …

    // Get cart item custom data and update order item meta
    if( isset( $values['custom_data'] ) ) {
        $item->update_meta_data( 'meta_key2', $values['custom_data'] );
    }
}

Наконец, мы можем сделать то же самое старым способом, используя хук woocommerce_add_order_item_meta, поскольку он имеет почти те же полезные аргументы:

## --- Old way --- ##
add_action( 'woocommerce_add_order_item_meta', 'custom_add_order_item_meta', 20, 3 );
function custom_add_order_item_meta( $item_id, $values, $cart_item_key ) {
    // Get a product custom field value
    $custom_field_value = get_post_meta( $values['data']->get_id(), '_meta_key', true );
    // Update order item meta
    if ( ! empty( $custom_field_value ) ){
        wc_add_order_item_meta( $item_id, 'meta_key1', $custom_field_value );
    }
    // … … Or … …

    // Get cart item custom data and update order item meta
    if( isset( $values['custom_data'] ) ) {
        wc_add_order_item_meta( $item_id, 'meta_key2', $values['custom_data'] );
    }
}

Заключение: woocommerce_checkout_create_order_line_item - это подходящая замена для использования с WooCommerce 3+ и новыми методами установки и получения CRUD.

Кажется, что ловушка теперь также устарела с версии 3.0.4. Я получаю это уведомление:

The The "woocommerce_add_order_item_meta" hook uses out of date data structures and function is deprecated since version 3.0.4. Replace with woocommerce_new_order_item.

Я заменил имя действия «woocommerce_add_order_item_meta» на «woocommerce_new_order_item» в операторе add_action в нарушающем плагине, и уведомление об устаревании исчезает. Проблема в том, что некоторые параметры теперь появляются внутри массива legacy_values. Я использую плагин YITH WooCommerce Product Add Ons, и метаданные продукта, которые должны быть прикреплены к заказу, не принимаются плагином и, следовательно, не сохраняются вместе с заказом. Так что, пока это не будет исправлено в плагине, вам придется жить с уведомлением об устаревании.

Я знаю, что на это был дан ответ, и уже есть принятый ответ. Я просто хотел дать другой способ справиться с этим, не получая фактического сообщения об устаревании (см. ссылка);

add_action('woocommerce_new_order_item', 'saveMetaData', 10, 3); // or use just 2 instead of 3; if you don't need order id

/**
 * Add meta to order item
 *
 * @param int $itemId
 * @param WC_Order_Item_Product|WC_Order_Item_Shipping $item
 * @param int @orderId
*/
function saveMetaData($itemId, $item, $orderId)
{
    if (!isItemValid($item))
    {
        return;
    }

    wc_add_order_item_meta($itemId, 'my_custom_data', $item->legacy_values['my_custom_data']);
}

/**
 * @param WC_Order_Item_Product|WC_Order_Item_Shipping $item
 *
 * @return bool
*/
function isItemValid($item)
{
    return (
        $item instanceof WC_Order_Item_Product &&
        isset($item->legacy_values) &&
        isset($item->legacy_values['my_custom_data']) &&
        !empty($item->legacy_values['my_custom_data'])
    );
}

Ваш конкретный вариант использования не очень ясен (вы не указали, когда и где вам нужно добавить эту метаинформацию), но вы можете использовать woocommerce_checkout_update_order_meta во время оформления заказа.

Дополнительные сведения см. В разделе настройка полей оформления заказа .

Нет, похоже, что ловушка также устарела: Ошибка PHP: ловушка "woocommerce_add_order_item_meta" использует устаревшие структуры данных, а функция устарела, начиная с версии 3.1.2. Замените на woocommerce_new_order_item.

Я также не могу найти его здесь: https://docs.woocommerce.com/wc-apidocs/hook-docs.html

Я хотел добавить к ответу Ilgıt Yıldırım: в моем случае мои пользовательские значения не существовали в массиве item-> legacy_values. Чтобы исправить это, я использовал ловушку woocommerce_checkout_create_order_line_item, чтобы добавить пользовательские значения к элементу перед вызовом ловушки woocommerce_new_order_item. Вот пример этого:

add_action ('woocommerce_checkout_create_order_line_item', 'save_values_in_item', PHP_INT_MAX, 4);

функция save_values_in_item ($ item, $ cart_item_key, $ values, $ order) {

                $item->myCustomValues = $values;

}

// ТО вызвать новую ловушку: add_action ('woocommerce_new_order_item', 'add_product_input_fields_to_order_item_meta_wc3', PHP_INT_MAX, 3);

function add_product_input_fields_to_order_item_meta_wc3 ($ item_id, $ item, $ order_id) {

            if ( isset( $item->myCustomValues ) ) 
            {
                  //iterate through array and place desired values into the meta data using the wc_add_order_item_meta function
            }

}

Чтобы прояснить ситуацию, эта функция устарела, но крючок все еще в порядке