WooCommerce普通产品（非虚拟下载）后台如何添加PDF上传自定义字段

完全可以复用你熟悉的那套WooCommerce产品自定义字段的钩子逻辑实现，不需要因为是PDF上传就换一套完全不同的开发流程，只需要针对文件上传的特性做几个适配调整即可；且这套实现和WooCommerce虚拟可下载产品的核心功能完全独立，不会触发普通产品转可下载的设置判定。

和你现有文本字段方案的共通逻辑 #

• 字段渲染依然可以挂载在woocommerce_product_options_advanced，或是你想要放置的其他产品编辑页选项区块钩子下
• 字段值的持久化依然走woocommerce_process_product_meta钩子，用update_post_meta把值存在产品的自定义meta中，和你之前存文本字段的保存逻辑框架完全一致

和文本字段实现的关键差异 #

因为要实现PDF文件选择而非纯文本输入，你不需要像写原生表单文件上传那样修改产品表单的enctype属性、处理服务器端文件接收逻辑，直接对接WordPress自带的媒体上传器就能省掉大部分重复工作，核心要调整3个部分：

• 字段渲染不能直接用现成的woocommerce_wp_text_input，需要自己编写带隐藏值存储、文件选择按钮的简单控件结构
• 需要补充极简的JS交互代码，触发WordPress自带的媒体选择弹窗，限制弹窗内只能选中PDF类型文件，选完后自动把文件ID回填到对应的隐藏输入框
• 保存逻辑里增加一层附件合法性校验，防止非PDF类型的恶意附件值被写入meta

可直接落地的实现示例 #

1. 在产品高级选项区输出PDF上传控件

add_action( 'woocommerce_product_options_advanced', 'add_custom_pdf_upload_field' );
function add_custom_pdf_upload_field() {
    global $post;
    // 读取产品已存的PDF附件ID
    $pdf_attachment_id = get_post_meta( $post->ID, '_custom_product_pdf_id', true );
    $pdf_url = $pdf_attachment_id ? wp_get_attachment_url( $pdf_attachment_id ) : '';
    ?>
    <div class="options_group">
        <p class="form-field">
            <label for="custom_product_pdf_id">产品附加PDF文件</label>
            <input type="hidden" id="custom_product_pdf_id" name="custom_product_pdf_id" value="<?php echo esc_attr( $pdf_attachment_id ); ?>">
            <input type="text" id="custom_product_pdf_url" class="regular-text" value="<?php echo esc_attr( $pdf_url ); ?>" readonly placeholder="请选择需要附加的PDF文件">
            <button type="button" class="button" id="upload_pdf_button">选择PDF文件</button>
            <button type="button" class="button" id="remove_pdf_button" style="margin-left:4px; <?php echo $pdf_url ? '' : 'display:none'; ?>">移除已选文件</button>
        </p>
    </div>
    <?php
}

2. 加载媒体上传器依赖与交互逻辑

// 产品编辑页加载媒体库上传能力
add_action( 'admin_enqueue_scripts', 'load_media_uploader_for_pdf_field' );
function load_media_uploader_for_pdf_field( $hook ) {
    global $post_type;
    if ( $post_type === 'product' && in_array( $hook, ['post.php', 'post-new.php'] ) ) {
        wp_enqueue_media();
    }
}

// 上传控件的交互脚本
add_action( 'admin_footer', 'pdf_upload_field_admin_js' );
function pdf_upload_field_admin_js() {
    global $post_type;
    if ( $post_type !== 'product' ) return;
    ?>
    <script>
        jQuery( function($){
            // 触发PDF选择弹窗
            $('#upload_pdf_button').on('click', function(e){
                e.preventDefault();
                let mediaUploader = wp.media({
                    title: '选择产品附加PDF',
                    button: { text: '选中文件' },
                    library: { type: 'application/pdf' },
                    multiple: false
                }).on('select', function(){
                    let selectedFile = mediaUploader.state().get('selection').first().toJSON();
                    $('#custom_product_pdf_id').val(selectedFile.id);
                    $('#custom_product_pdf_url').val(selectedFile.url);
                    $('#remove_pdf_button').show();
                }).open();
            });
            // 清除已选文件
            $('#remove_pdf_button').on('click', function(e){
                e.preventDefault();
                $('#custom_product_pdf_id').val('');
                $('#custom_product_pdf_url').val('');
                $(this).hide();
            });
        });
    </script>
    <?php
}

3. 保存PDF字段值

add_action( 'woocommerce_process_product_meta', 'save_custom_pdf_field_value' );
function save_custom_pdf_field_value( $post_id ) {
    if ( isset( $_POST['custom_product_pdf_id'] ) ) {
        $pdf_id = absint( $_POST['custom_product_pdf_id'] );
        // 校验附件确实为PDF类型
        if ( $pdf_id && get_post_mime_type( $pdf_id ) === 'application/pdf' ) {
            update_post_meta( $post_id, '_custom_product_pdf_id', $pdf_id );
        } else {
            // 不合法则清空存储值
            delete_post_meta( $post_id, '_custom_product_pdf_id' );
        }
    }
}

前端展示注意点 #

等值成功存入产品meta后，在前端产品页输出PDF下载入口时，只需通过产品ID拿到存储的附件ID，用wp_get_attachment_url()获取文件真实路径，输出指向该路径的下载链接即可。整个流程和WooCommerce的商品购买、购物车、支付链路完全隔离，不会影响普通实物产品的下单逻辑。

实现细节提醒 #

• 存储附件ID而非直接存PDF访问URL稳定性更高：后续在媒体库替换、重命名该PDF文件时，前端拿到的链接会自动同步更新，不会出现链接失效的问题
• 两层校验（JS层限制只能选PDF、PHP层校验附件MIME类型）可以避免非法值写入，安全性优于直接存储用户提交的字符串
• 整个实现没有修改WooCommerce核心的可下载产品判定逻辑，哪怕产品是普通实物类，也不会因为加了这个字段就被系统判定成可下载商品

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