如何为WordPress的Contact Form 7从服务器CSV动态加载下拉选项？

你可以通过wpcf7_form_tag过滤器实现这个需求，具体步骤如下：

1. 在CF7中创建占位标签 #

在Contact Form 7的表单编辑器里，添加一个自定义类型的占位下拉标签，比如：

[dynamic-select my_dynamic_dropdown]

这里的dynamic-select是我们自定义的标签类型，后续会用过滤器替换成真正的下拉选项。

2. 添加PHP代码到主题functions.php #

将以下代码添加到你的WordPress主题（或子主题）的functions.php文件中：

add_filter( 'wpcf7_form_tag', 'dynamic_dropdown_from_csv', 10, 2 );
function dynamic_dropdown_from_csv( $tag, $unused ) {
    // 仅处理我们定义的dynamic-select标签
    if ( 'dynamic-select' !== $tag['type'] ) {
        return $tag;
    }

    // 定义CSV文件路径（示例为主题目录下的assets/csv/options.csv）
    $csv_path = get_stylesheet_directory() . '/assets/csv/options.csv';

    // 检查文件是否存在
    if ( ! file_exists( $csv_path ) ) {
        $tag['raw_values'] = array( '选项加载失败' );
        $tag['values'] = array( '选项加载失败' );
        $tag['labels'] = array( '选项加载失败' );
        return $tag;
    }

    // 读取并解析CSV内容
    $csv_data = array_map( 'str_getcsv', file( $csv_path ) );
    $options = array();

    // 遍历CSV行，假设每行格式为「值,显示文本」
    foreach ( $csv_data as $row ) {
        if ( count( $row ) >= 2 ) {
            $value = trim( $row[0] );
            $label = trim( $row[1] );
            $options[$value] = $label;
        }
    }

    // 处理无有效选项的情况
    if ( empty( $options ) ) {
        $tag['raw_values'] = array( '无可用选项' );
        $tag['values'] = array( '无可用选项' );
        $tag['labels'] = array( '无可用选项' );
        return $tag;
    }

    // 将解析后的选项赋值给CF7标签参数
    $tag['raw_values'] = array_keys( $options );
    $tag['values'] = array_keys( $options );
    $tag['labels'] = array_values( $options );

    // 将标签类型改为标准select，让CF7正确渲染
    $tag['type'] = 'select';

    return $tag;
}

3. 准备CSV文件 #

• 在你的主题目录下创建assets/csv文件夹（如果不存在）。
• 上传你的CSV文件到该目录，命名为options.csv（和代码中的路径对应）。CSV格式需为每行一个选项，示例：

product_001,产品A
product_002,产品B
product_003,产品C

确保CSV文件编码为UTF-8，避免前端出现乱码。

4. 验证效果 #

保存CF7表单后，刷新前端页面，下拉框就会自动加载CSV中的选项。

注意事项 #

• 确保CSV文件的服务器权限为644，保证PHP能正常读取。
• 如果更新CSV后选项未变化，尝试清除WordPress缓存或浏览器缓存。
• 若需要调整CSV路径，修改代码中的$csv_path变量即可。

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