如何通过代码实现Ninja Forms导入CSV/Excel提交数据功能？

完全可以通过代码实现，核心是利用Ninja Forms提供的提交创建API，配合PHP读取CSV/Excel文件的能力完成导入。以下是具体实现方案：

一、CSV文件导入实现 #

实现思路 #

1. 读取CSV文件并解析每行数据
2. 将每行数据映射到对应表单的字段ID（需提前获取表单的字段ID）
3. 调用Ninja Forms的提交创建API插入记录

代码示例 #

// 自定义函数：从CSV导入Ninja Forms提交记录
function import_nf_submissions_from_csv($csv_file_path, $form_id) {
    // 校验文件是否存在
    if (!file_exists($csv_file_path)) {
        error_log("CSV文件路径无效：{$csv_file_path}");
        return false;
    }

    // 打开CSV文件
    $file_handle = fopen($csv_file_path, 'r');
    if (!$file_handle) {
        error_log("无法打开CSV文件：{$csv_file_path}");
        return false;
    }

    // 获取表头（第一行存储表单字段ID）
    $field_ids = fgetcsv($file_handle);
    if (empty($field_ids)) {
        error_log("CSV表头为空");
        fclose($file_handle);
        return false;
    }

    // 遍历处理每一行数据
    while (($row_data = fgetcsv($file_handle)) !== false) {
        $submission_fields = [];
        // 映射字段ID与对应值
        foreach ($field_ids as $index => $field_id) {
            if (!empty($field_id) && isset($row_data[$index])) {
                $submission_fields[$field_id] = [
                    'value' => $row_data[$index],
                    'key' => 'value' // Ninja Forms要求的固定结构
                ];
            }
        }

        // 构建提交核心数据
        $submission_args = [
            'form_id' => $form_id,
            'fields' => $submission_fields,
            'date_submitted' => current_time('mysql'), // 可替换为CSV中的提交时间
            'user_id' => get_current_user_id(), // 设为0表示访客提交
            'status' => 'published' // 提交状态：published为已发布，draft为草稿
        ];

        // 创建提交记录
        $submission = Ninja_Forms()->submissions()->create($submission_args);
        if (!$submission) {
            error_log("提交创建失败，行数据：" . print_r($row_data, true));
        }
    }

    fclose($file_handle);
    return true;
}

// 使用示例：替换为你的CSV路径和表单ID
// import_nf_submissions_from_csv('/var/www/html/wp-content/uploads/submissions.csv', 456);

使用说明 #

• CSV第一行必须为表单的字段ID：在Ninja Forms编辑界面，进入字段的「高级」设置面板即可查看字段ID
• 可将函数添加到主题functions.php或自定义插件中，通过管理员权限触发执行（比如添加后台按钮或使用WP-CLI调用）
• 测试时建议先导入少量数据，避免批量出错

二、Excel文件导入实现 #

如果需要处理Excel（.xlsx/.xls）文件，可借助PhpSpreadsheet库读取数据，核心逻辑和CSV一致，仅文件读取部分不同。

代码示例 #

// 先通过Composer安装PhpSpreadsheet：composer require phpoffice/phpspreadsheet
require_once 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;

function import_nf_submissions_from_excel($excel_file_path, $form_id) {
    try {
        // 加载Excel文件
        $spreadsheet = IOFactory::load($excel_file_path);
        $worksheet = $spreadsheet->getActiveSheet();
        $max_row = $worksheet->getHighestRow();
        $max_col = $worksheet->getHighestColumn();

        // 获取表头（第一行存储字段ID）
        $field_ids = [];
        for ($col = 'A'; $col <= $max_col; $col++) {
            $field_ids[] = $worksheet->getCell($col . '1')->getValue();
        }

        // 遍历处理数据行（从第2行开始）
        for ($row = 2; $row <= $max_row; $row++) {
            $submission_fields = [];
            $col_index = 0;
            for ($col = 'A'; $col <= $max_col; $col++) {
                $field_id = $field_ids[$col_index];
                $value = $worksheet->getCell($col . $row)->getValue();
                
                if (!empty($field_id) && $value !== null) {
                    $submission_fields[$field_id] = [
                        'value' => $value,
                        'key' => 'value'
                    ];
                }
                $col_index++;
            }

            // 构建提交数据（同CSV示例）
            $submission_args = [
                'form_id' => $form_id,
                'fields' => $submission_fields,
                'date_submitted' => current_time('mysql'),
                'user_id' => 0,
                'status' => 'published'
            ];

            Ninja_Forms()->submissions()->create($submission_args);
        }
        return true;
    } catch (Exception $e) {
        error_log("Excel导入错误：{$e->getMessage()}");
        return false;
    }
}

注意事项 #

• 在WordPress环境中使用PhpSpreadsheet，建议通过自定义插件封装，避免与其他插件的依赖冲突
• 大文件导入时需调整PHP内存限制，避免内存溢出

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