如何在WooCommerce中为可变产品添加仅管理员可见的自定义备注

Hey，我来帮你搞定WooCommerce可变产品添加仅管理员可见的自定义备注需求，两种方法任你选：

这个方法不用写代码，适合新手快速实现：

• 登录WordPress后台，打开你要编辑的可变产品
• 滚动页面到产品数据模块下方的「自定义字段」区域（如果没看到，点击右上角的「选项」，勾选「自定义字段」）
• 点击「添加自定义字段」，输入名称（比如「可变产品管理员备注」），然后在值里填写你的备注内容
• 点击「保存自定义字段」，再更新产品即可

这个字段默认只会在后台显示，前端不会对外展示。如果担心某些主题/插件会主动调用所有自定义字段，你可以加一段小代码彻底屏蔽前端输出：

// 隐藏指定自定义字段的前端显示
add_filter('the_meta', 'block_admin_only_custom_field');
function block_admin_only_custom_field($fields) {
    foreach ($fields as $key => $field) {
        // 把这里的字段名改成你刚才设置的名称
        if ($field['key'] == '可变产品管理员备注') {
            unset($fields[$key]);
        }
    }
    return $fields;
}

如果你想让备注区域更显眼、更独立，避免和其他自定义字段混淆，可以用代码添加一个专属的后台模块：
把下面的代码添加到你的子主题functions.php文件，或者新建一个自定义插件（更安全，避免主题更新丢失代码）：

// 注册可变产品专属管理员备注Metabox
add_action('add_meta_boxes', 'register_variable_product_admin_notes_metabox');
function register_variable_product_admin_notes_metabox() {
    add_meta_box(
        'variable_admin_notes_box', // 模块ID
        '可变产品管理员专属备注', // 模块标题
        'render_variable_admin_notes_box', // 渲染函数
        'product', // 关联的内容类型（产品）
        'normal', // 显示位置（产品编辑页的常规区域）
        'high' // 显示优先级（靠前显示）
    );
}

// 渲染Metabox的内容
function render_variable_admin_notes_box($post) {
    // 只对可变产品显示这个模块
    if (wc_get_product_type($post->ID) !== 'variable') {
        return;
    }

    // 获取已保存的备注内容
    $saved_notes = get_post_meta($post->ID, '_variable_admin_private_notes', true);
    // 安全验证字段
    wp_nonce_field('save_variable_admin_notes', 'variable_notes_nonce');

    // 输出文本编辑框
    echo '<textarea rows="6" style="width:100%; padding:10px;" name="variable_admin_notes">' . esc_textarea($saved_notes) . '</textarea>';
    echo '<p style="color:#666; margin-top:8px;">提示：此备注仅后台管理员可见，前端访客无法查看</p>';
}

// 保存Metabox的内容
add_action('save_post_product', 'save_variable_product_admin_notes');
function save_variable_product_admin_notes($post_id) {
    // 检查权限：只有能编辑产品的用户才能保存
    if (!current_user_can('edit_product', $post_id)) {
        return;
    }

    // 验证安全字段，防止恶意提交
    if (!isset($_POST['variable_notes_nonce']) || !wp_verify_nonce($_POST['variable_notes_nonce'], 'save_variable_admin_notes')) {
        return;
    }

    // 只处理可变产品
    if (wc_get_product_type($post_id) !== 'variable') {
        return;
    }

    // 保存/更新备注内容
    if (isset($_POST['variable_admin_notes'])) {
        update_post_meta($post_id, '_variable_admin_private_notes', sanitize_textarea_field($_POST['variable_admin_notes']));
    } else {
        // 如果内容为空，删除该元数据
        delete_post_meta($post_id, '_variable_admin_private_notes');
    }
}

添加后，你在编辑可变产品时，会看到一个独立的「可变产品管理员专属备注」模块，输入内容保存后，只有后台能看到，前端完全不会输出。

• 编辑主题代码前，记得备份functions.php文件，或者使用子主题，避免主题更新导致代码丢失
• 如果用自定义插件的方式，新建一个PHP文件，开头加上插件头部信息（如下），上传到wp-content/plugins目录后启用即可：

<?php
/*
Plugin Name: 可变产品管理员备注
Description: 为WooCommerce可变产品添加仅管理员可见的备注
Version: 1.0
Author: Your Name
*/
// 把上面的Metabox代码放在这里
?>

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