php - Woocommerce：哪个钩子可以替换已弃用的“woocommerce_add_order_item_meta”

Question

需要添加自定义元来订购商品。谷歌搜索，大多数文章都说使用“woocommerce_add_order_item_meta”钩子。这个钩子在最新版本 2.3.7 中已弃用。有人，请告诉我用哪个钩子代替。

http://docs.woothemes.com/wc-apidocs/function-woocommerce_add_order_item_meta.html

score 20 · Accepted Answer

2017/2018 THE RIGHT WAY （使用新的 CRUD setter 和 Getters 方法）

相关：替换 Woocommerce 3.4 中的 woocommerce_add_order_item_meta 钩子

由于 woocommerce 3 改进了许多事情并做出了巨大的变化，因此woocommerce_add_order_item_meta即使在 woocommerce 3.3+ 版本中，动作挂钩仍然可以完美运行。

此挂钩由结帐过程WC_Checkout中的类方法和相关函数启用，而不是在购物车数据不再可用的类中启用。WC_Order

现在，由于Woocommmerce 3 引入了新的 CRUD setter 和 getter 方法，要使用的类似替换钩子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是购物车项目
$orderWC_Order 对象的一个实例（在某些特定情况下这是一个非常有用的附加参数）

在这个钩子中，我们将用与参数一起使用的新WC_Data update_meta_data()方法替换旧的工作函数 wc_add_order_item_meta() 。$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_metahook 对旧方法做同样的事情，因为它具有几乎相同的有用参数：

## --- 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 setter 和 getter 方法一起使用的正确替换钩子。

score 18 · Accepted Answer

如果你看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 );

score 5 · Accepted Answer

从 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.

我在有问题的插件的 add_action 语句中将操作名称 'woocommerce_add_order_item_meta' 替换为 'woocommerce_new_order_item'，弃用通知消失了，问题是一些参数现在出现在legacy_values数组中。我使用插件 YITH WooCommerce 产品附加组件，并且应该附加到订单的产品元数据不会被插件拾取，因此不会与订单一起存储。因此，在插件中修复此问题之前，您必须接受弃用通知。

score 3 · Accepted Answer

我知道这已得到答复，并且已经接受了答复。我只是想提供另一种方法来处理此问题，而不会实际收到已弃用的消息（请参阅参考资料）；

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'])
    );
}

score 1 · Accepted Answer

您的具体用例不是很清楚（您没有指定何时何地需要添加此元信息），但您可以woocommerce_checkout_update_order_meta在结帐时使用。

在自定义结帐字段中阅读更多内容。

score 1 · Accepted Answer

不，似乎该钩子也已弃用：PHP错误：“woocommerce_add_order_item_meta”钩子使用过时的数据结构，并且自版本 3.1.2 起已弃用函数。替换为 woocommerce_new_order_item。

我在这里也找不到： https ://docs.woocommerce.com/wc-apidocs/hook-docs.html

score 1 · Accepted Answer

我想补充 Ilgıt Yıldırım 的回答：在我的情况下，我的自定义值不存在于 item->legacy_values 数组中。为了解决这个问题，我在调用 woocommerce_new_order_item 钩子之前使用了 woocommerce_checkout_create_order_line_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 );

功能 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
            }

}

score 0 · Accepted Answer

0

只是为了说清楚，这个功能已被弃用，但钩子仍然可以

于 2015-07-03T19:30:38.033 回答

php - Woocommerce：哪个钩子可以替换已弃用的“woocommerce_add_order_item_meta”

8 回答 8

Related

Reference