如何在WooCommerce附加信息标签页以单表行展示带自定义数据的商品变体
需求描述
我有一款包含多个变体的商品,希望在附加信息标签页展示所有变体(非商品属性项)及其对应的SKU,实现效果参考示例图:

我参考了附加信息标签页展示自定义字段值的实现方案,已向商品信息标签页添加了基础代码框架,其中$custom_field1需要实现的输出逻辑为:属性名称 + 对应变体SKU + 对应变体GTIN值,GTIN值通过Product GTIN (EAN, UPC, ISBN) for WooCommerce 插件添加。
实现约束
- 简单商品的原有展示逻辑需保持不受影响
- 最终展示结果需为现有商品信息表格的新增行,也可支持替换原有属性相关行
- GTIN是商品的私有自定义字段,对应meta_key为
_wpm_gtin_code,持有商品对象时可通过以下方法获取值:
$gtin = $product->get_meta('_wpm_gtin_code');
实现方案
将以下代码添加到主题functions.php文件或自定义功能插件中即可生效:
add_filter('woocommerce_display_product_attributes', 'add_variants_to_additional_info_tab', 10, 2); function add_variants_to_additional_info_tab($attributes, $product) { // 仅对可变商品执行自定义逻辑,简单商品直接返回原有属性数组 if (!$product->is_type('variable')) { return $attributes; } $variant_ids = $product->get_visible_children(); if (empty($variant_ids)) { return $attributes; } foreach ($variant_ids as $variant_id) { $variant = wc_get_product($variant_id); // 跳过未公开的变体 if ($variant->get_status() !== 'publish') { continue; } // 拼接变体的属性描述,作为表格行标题 $variant_attr_labels = []; foreach ($variant->get_attributes() as $attr_slug => $attr_value) { // 兼容全局分类属性和自定义变体属性 if (str_starts_with($attr_slug, 'pa_')) { $term = get_term_by('slug', $attr_value, $attr_slug); $variant_attr_labels[] = $term ? $term->name : $attr_value; } else { $variant_attr_labels[] = $attr_value; } } $row_label = implode(' / ', $variant_attr_labels); // 获取变体对应的SKU和GTIN $variant_sku = $variant->get_sku(); $variant_gtin = $variant->get_meta('_wpm_gtin_code'); // 拼接表格行内容 $row_content = []; if ($variant_sku) { $row_content[] = sprintf('SKU: %s', esc_html($variant_sku)); } if ($variant_gtin) { $row_content[] = sprintf('GTIN: %s', esc_html($variant_gtin)); } $row_value = implode(' | ', $row_content); // 新增独立表格行,避免与原有属性key冲突 $attributes['variant_' . $variant_id] = [ 'label' => $row_label, 'value' => $row_value ]; } return $attributes; }
逻辑说明
- 代码通过WooCommerce内置的
woocommerce_display_product_attributes钩子修改附加信息表格的输出内容,完全适配现有表格结构,不需要修改主题模板文件 - 简单商品直接返回原有属性数组,不会改动任何原有展示逻辑
- 可变商品会在原有属性列表后,为每个可见变体新增独立展示行
- 如果需要完全替换原有属性行,只需在获取变体列表前添加
$attributes = [];清空原有数组即可
内容的提问来源于stack exchange,提问作者Artemis
相关产品推荐
相关产品推荐

