返回

WooCommerce 订单项元数据：管理订单列表中添加自定义列

php

在 WooCommerce 管理订单列表中针对订单项元数据自定义列

简介

WooCommerce 是一个流行的电子商务平台，它为管理订单提供了强大的功能。用户可以轻松查看订单详情，包括订单日期、客户信息和运输状态等。然而，有时需要根据订单项元数据进一步定制订单列表。本文将指导你如何在 WooCommerce 管理订单列表中针对订单项元数据添加自定义列。

添加自定义列

要添加自定义列，需要使用 add_filter() 钩子修改 manage_edit-shop_order_columns 过滤器。此过滤器允许修改管理订单列表中显示的列。代码如下：

add_filter('manage_edit-shop_order_columns', 'add_meeting_points_column');
function add_meeting_points_column($columns) {
    $columns = array_merge(
        array_slice($columns, 0, array_search('order_date', array_keys($columns)), true),
        array('meeting_points' => __('Meeting Points', 'text-domain')),
        array_slice($columns, array_search('order_date', array_keys($columns)), null, true)
    );
    return $columns;
}

显示自定义列数据

添加自定义列后，需要使用 add_action() 钩子显示自定义列数据。为此，请使用 manage_shop_order_posts_custom_column 钩子。

add_action('manage_shop_order_posts_custom_column', 'display_meeting_points_column', 20, 2);
function display_meeting_points_column($column, $post_id) {
    if ('meeting_points' === $column) {
        $order = wc_get_order($post_id);

        if ($order) {
            $meeting_points = wc_get_order_meta_keys($order->get_keys(), 'MeetingPoints', true);
            echo !empty($meeting_points) ? esc_html($meeting_points) : esc_html__('Not Available', 'text-domain');
        }
    }
}

错误分析

如果遇到错误，请仔细检查代码中以下两点：

  • 确保 MeetingPoints 拼写正确，且大小写一致。
  • 确保 display_meeting_points_column 函数的名称拼写正确，且小写“m”。

常见问题解答

Q1：自定义列可以显示哪些类型的元数据？
A1：可以使用 wc_get_order_meta_keys() 函数获取订单项元数据的键值对。

Q2：可以在自定义列中显示多个元数据字段吗？
A2：可以，只需在 add_filter() 钩子中添加多个自定义列，并在 display_meeting_points_column() 函数中处理相应的元数据字段。

Q3：可以对自定义列进行排序吗？
A3：默认情况下，自定义列不支持排序。要启用排序，需要编写额外的代码。

Q4：可以将自定义列添加到不同的订单状态吗？
A4：是的，可以使用 pre_get_posts 过滤器根据订单状态有条件地添加自定义列。

Q5：如何隐藏默认列以获得更简洁的视图？
A5：可以使用 manage_edit-shop_order_columns 过滤器隐藏默认列，只需从 $columns 数组中删除相应列的键即可。

总结

通过遵循本文中的步骤，你可以针对 WooCommerce 订单项元数据在管理订单列表中自定义列。这使你能够根据特定业务需求创建更具信息性和可定制的订单视图。通过利用 WooCommerce 的钩子和函数，你可以扩展平台以满足你的独特要求。