为WooCommerce Dokan插件添加自定义文件字段：供应商注册身份文件上传字段存储与显示异常问题求助

看起来你遇到的核心问题是没有正确处理文件上传的专属流程——文件上传和普通文本字段逻辑完全不同，不能直接通过$_POST获取数据，还需要配置表单编码、验证文件合法性、将文件存入WordPress上传目录，最后才能完成正确的存储与显示。下面一步步帮你修正代码：

第一步：修复注册表单的HTML配置 #

首先，你的注册表单必须添加enctype="multipart/form-data"属性，否则浏览器不会提交文件数据；另外原input标签存在语法错误（引号未闭合），修正后的字段代码如下：

<!-- 确保包裹此字段的form标签带有 enctype="multipart/form-data" 属性 -->
<p class="form-row form-group form-row-wide">
    <label for="veri-file"><?php esc_html_e( 'Upload Verification ID', 'dokan-custom-codes' ); ?><span class="required">*</span></label>
    <input type="file" class="verifile" name="veri_file" id="veri_file" accept="image/png, image/jpeg" required="required" />
</p>

提示：如果是通过Dokan钩子添加字段，可通过dokan_seller_registration_form挂载；若Dokan默认表单没有enctype属性，可通过以下钩子补充：

function dokan_add_form_enctype() {
    echo ' enctype="multipart/form-data"';
}
add_action( 'dokan_seller_registration_form_start', 'dokan_add_form_enctype' );

第二步：替换文件上传的保存逻辑 #

原代码直接从$_POST取文件值是错误的，文件上传数据存储在$_FILES数组中。我们用WordPress原生函数处理上传，确保文件安全存入上传目录：

// 保留原有必填字段校验逻辑
function dokan_custom_seller_registration_required_fields( $required_fields ) {
    $required_fields['veri_file'] = __( 'Please upload a valid means of Identification', 'dokan-custom' );
    return $required_fields;
};
add_filter( 'dokan_seller_registration_required_fields', 'dokan_custom_seller_registration_required_fields' );

// 正确处理文件上传并保存到用户元数据
function dokan_custom_new_seller_created( $vendor_id, $dokan_settings ) {
    // 检查是否有合法文件上传
    if ( isset( $_FILES['veri_file'] ) && $_FILES['veri_file']['error'] == UPLOAD_ERR_OK ) {
        $file = $_FILES['veri_file'];
        
        // 验证文件类型（仅允许PNG/JPEG）
        $allowed_types = array( 'image/png', 'image/jpeg' );
        if ( ! in_array( $file['type'], $allowed_types ) ) {
            wc_add_notice( __( 'Only PNG and JPEG images are allowed.', 'dokan-custom' ), 'error' );
            return;
        }

        // 引入WordPress上传处理依赖
        require_once( ABSPATH . 'wp-admin/includes/file.php' );
        require_once( ABSPATH . 'wp-admin/includes/image.php' );

        // 将文件上传到WordPress默认上传目录
        $upload = wp_handle_upload( $file, array( 'test_form' => false ) );
        
        if ( isset( $upload['error'] ) ) {
            wc_add_notice( $upload['error'], 'error' );
            return;
        }

        // 保存文件URL到用户元数据（也可保存附件ID，便于后续管理）
        update_user_meta( $vendor_id, 'dokan_custom_veri_file', $upload['url'] );
    }
}
add_action( 'dokan_new_seller_created', 'dokan_custom_new_seller_created', 10, 2 );

第三步：修复管理端的字段显示与更新逻辑 #

原代码的后端显示存在语法错误，且未处理编辑时的文件替换需求，修正后的代码如下：

// 在供应商资料页面显示验证文件
add_action( 'dokan_seller_meta_fields', 'my_show_extra_profile_fields' );
function my_show_extra_profile_fields( $user ) { 
    if ( ! current_user_can( 'manage_woocommerce' ) || ! user_can( $user, 'dokandar' ) ) {
        return;
    }

    $veri_file_url = get_user_meta( $user->ID, 'dokan_custom_veri_file', true );
    ?>
    <tr>
        <th><?php esc_html_e( 'Upload Verification ID', 'dokan-lite' ); ?></th>
        <td>
            <!-- 显示已上传的图片（若存在） -->
            <?php if ( ! empty( $veri_file_url ) ) : ?>
                <img src="<?php echo esc_url( $veri_file_url ); ?>" height="200" width="300" alt="Verification ID" />
                <p><?php esc_html_e( 'Current verification file:', 'dokan-custom' ); ?> <a href="<?php echo esc_url( $veri_file_url ); ?>" target="_blank"><?php echo esc_url( $veri_file_url ); ?></a></p>
                <p><?php esc_html_e( 'Upload a new file to replace the existing one:', 'dokan-custom' ); ?></p>
            <?php endif; ?>
            <!-- 文件上传框 -->
            <input type="file" name="veri_file" class="verifile" />
        </td>
    </tr>
    <?php
}

// 保存编辑后的文件上传
add_action( 'personal_options_update', 'my_save_extra_profile_fields' );
add_action( 'edit_user_profile_update', 'my_save_extra_profile_fields' );
function my_save_extra_profile_fields( $user_id ) {
    if ( ! current_user_can( 'manage_woocommerce' ) ) {
        return;
    }

    // 检查是否有新文件上传
    if ( isset( $_FILES['veri_file'] ) && $_FILES['veri_file']['error'] == UPLOAD_ERR_OK ) {
        $file = $_FILES['veri_file'];
        $allowed_types = array( 'image/png', 'image/jpeg' );
        
        if ( ! in_array( $file['type'], $allowed_types ) ) {
            wc_add_notice( __( 'Only PNG and JPEG images are allowed.', 'dokan-custom' ), 'error' );
            return;
        }

        require_once( ABSPATH . 'wp-admin/includes/file.php' );
        require_once( ABSPATH . 'wp-admin/includes/image.php' );

        $upload = wp_handle_upload( $file, array( 'test_form' => false ) );
        
        if ( isset( $upload['error'] ) ) {
            wc_add_notice( $upload['error'], 'error' );
            return;
        }

        // 更新用户元数据
        update_user_meta( $user_id, 'dokan_custom_veri_file', $upload['url'] );
    }
}

关键注意事项 #

• 目录权限：确保WordPress的wp-content/uploads目录有正确的写入权限（通常为755或775），否则文件无法上传。
• 安全强化：可根据需求添加文件大小限制（比如检查$file['size']是否小于2MB），进一步提升安全性。
• 附件ID存储：如果需要更灵活的文件管理（比如在媒体库中查看），可以将wp_handle_upload后的文件转为WordPress附件，保存附件ID而非直接保存URL。

这样修改后，文件就能正确上传到WordPress上传目录，并且在管理端显示已上传的图片，支持替换更新。

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