为含特定标签的WooCommerce产品添加metabox时遇PHP报错求助

错误原因分析 #

你遇到的Warning: Attempt to read property "ID" on null，是因为直接全局调用$wp_query->post的时机不对——在functions.php中，代码可能在WordPress查询初始化完成前就执行了，此时$wp_query->post还未被赋值，自然是null。

正确实现代码 #

要给带hasparts标签的产品添加自定义Metabox，应该利用WordPress提供的钩子，直接获取当前产品的$post对象，而非依赖$wp_query。以下是完整可运行的代码：

// 仅针对WooCommerce产品添加Metabox的钩子
add_action('add_meta_boxes_product', 'add_hasparts_custom_metabox');

function add_hasparts_custom_metabox($post) {
    // 检查产品是否带有"hasparts"标签（WooCommerce产品标签属于product_tag分类）
    if (!has_term('hasparts', 'product_tag', $post->ID)) {
        return; // 不满足条件则终止，不添加Metabox
    }

    // 添加自定义Metabox
    add_meta_box(
        'hasparts_product_metabox', // Metabox唯一ID
        '部件信息管理', // Metabox标题
        'render_hasparts_metabox_content', // 渲染内容的回调函数
        'product', // 绑定的内容类型（产品）
        'normal', // 显示位置（常规区域）
        'default' // 优先级
    );
}

// 渲染Metabox的内容
function render_hasparts_metabox_content($post) {
    // 获取产品基础属性
    $product_id = $post->ID; // 直接从$post对象取ID
    $product = wc_get_product($product_id); // 转为WooCommerce产品对象
    $product_sku = $product->get_sku(); // 获取SKU

    // 输出内容示例
    echo '<div class="metabox-content">';
    echo '<p><strong>产品ID：</strong>' . esc_html($product_id) . '</p>';
    echo '<p><strong>产品SKU：</strong>' . esc_html($product_sku) . '</p>';
    echo '<label for="parts_detail">部件详情：</label>';
    echo '<textarea id="parts_detail" name="parts_detail" rows="3" style="width:100%;">' . esc_textarea(get_post_meta($post->ID, '_parts_detail', true)) . '</textarea>';
    echo '</div>';
}

// 保存Metabox数据（可选，根据需求添加）
add_action('save_post_product', 'save_hasparts_metabox_data');

function save_hasparts_metabox_data($post_id) {
    // 跳过自动保存和无权限操作
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    if (!current_user_can('edit_product', $post_id)) return;

    // 保存表单数据
    if (isset($_POST['parts_detail'])) {
        update_post_meta($post_id, '_parts_detail', sanitize_textarea_field($_POST['parts_detail']));
    }
}

关键知识点说明 #

1. $post变量的正确使用 #

• 不要随意全局调用$wp_query->post，在add_meta_boxes、save_post这类钩子中，WordPress会自动传递当前的$post对象作为参数，直接在函数中接收即可，此时$post一定是有效的对象。
• 如果需要在其他场景获取当前post，可使用get_post()函数，它会返回当前查询的post对象。

2. 获取产品基础属性 #

• 产品ID：直接从$post->ID获取，因为WooCommerce产品本质是一种自定义post类型。
• 产品SKU：SKU是WooCommerce特有的属性，需要先将$post转为WC_Product对象（wc_get_product($post->ID)），再调用get_sku()方法获取。其他产品属性（如价格、库存）也可通过WC_Product对象的对应方法获取。

3. 标签判断的准确写法 #

WooCommerce产品的标签属于自定义分类product_tag，而非WordPress默认的post_tag，因此用has_term('hasparts', 'product_tag', $post->ID)比has_tag更准确，避免出现判断失效的情况。

内容的提问来源于stack exchange，提问作者mrslope