本文介绍如何通过 WooCommerce 原生钩子（而非短代码）精准控制订单项元数据（如属性、定制选项等）在“感谢页”（Order Received）中的渲染位置，避免 wc_get_order_item_meta() 短代码失效问题，并实现图文并排、结构清晰的商品展示布局。
本文介绍如何通过 woocommerce 原生钩子（而非短代码）精准控制订单项元数据（如属性、定制选项等）在“感谢页”（order received）中的渲染位置，避免 `wc_get_order_item_meta()` 短代码失效问题，并实现图文并排、结构清晰的商品展示布局。
在 WooCommerce 的“感谢页”（即订单成功页，order-received）中，开发者常需重构默认订单商品列表样式——例如添加缩略图、调整商品名称与元数据（item meta）的布局关系。但直接尝试将 wc_get_order_item_meta() 封装为短代码（如 add_shortcode('custom_order_meta', 'wc_get_order_item_meta')）是不可行的：该函数并非独立可调用的输出函数，它需要明确传入 $item_id、$meta_key 和 $single 参数，且依赖当前订单上下文，在短代码作用域中无法自动获取 $item 实例，因此会报错或返回空值。
✅ 正确做法是放弃短代码思路，转而使用 WooCommerce 提供的语义化动作钩子，尤其是：
-
woocommerce_order_item_meta_start woocommerce_order_item_meta_end
这两个钩子分别位于订单项元数据区域的起始与结束位置，且自动接收 $item、$order 和 $plain_text 三个参数，天然适配上下文需求。
以下为推荐实现方案：
1. 移除冗余过滤器，改用结构化钩子
首先，移除原代码中不必要且易出错的 woocommerce_order_item_name 过滤器和短代码注册逻辑：
// ❌ 删除以下两行（不再需要）
// add_shortcode('custom_order_meta', 'wc_get_order_item_meta');
// add_filter('woocommerce_order_item_name', 'custom_product_on_thankyou', 10, 3);
2. 使用 woocommerce_order_item_meta_start 插入商品缩略图与标题
在元数据区域之前注入自定义 HTML 结构（含图片与商品名），使视觉层级更清晰：
add_action('woocommerce_order_item_meta_start', 'render_thankyou_product_header', 10, 3);
function render_thankyou_product_header($item, $order, $plain_text) {
if (!is_order_received_page()) return;
$product = $item->get_product();
if (!$product) return;
$thumbnail = $product->get_image('woocommerce_thumbnail', ['class' => 'thankyou-product-img']);
$name = $item->get_name();
echo '<div class="checkout-product-wrapper">';
echo '<div class="product-image">' . $thumbnail . '</div>';
echo '<div class="product-content">';
echo '<div class="product-name">' . esc_html($name) . '</div>';
}<h3>3. 使用 <code>woocommerce_order_item_meta_end</code> 闭合结构</h3>
<p>确保 HTML 结构完整闭合，并可在此处追加额外信息（如 SKU、分类等）：</p>
<pre class="brush:php;toolbar:false;">add_action('woocommerce_order_item_meta_end', 'close_thankyou_product_wrapper', 10, 3);
function close_thankyou_product_wrapper($item, $order, $plain_text) {
if (!is_order_received_page()) return;
echo '
