文章处理与CSV导出方法，WordPress导出时404跳转问题排查

问题2：为何使用pre_get_posts会跳转到404页面？ #

你的代码遇到404跳转主要有这几个核心原因：

1. pre_get_posts钩子的误用：这个钩子的设计初衷是修改主查询的参数，不是用来处理导出这类独立请求的。当你在这个钩子里面直接die()，会打断WordPress后台的正常页面渲染流程，系统无法识别这是合法的后台操作，就会 fallback 到前端路由，返回404页面。

2. 查询参数不完整：你直接复用$query->query作为get_posts的参数，会丢失后台列表页的关键参数（比如默认posts_per_page是5，而后台可能设置了显示更多内容，还有nopaging参数），导致查询结果不符合预期，甚至触发异常。

3. 缺少权限验证：没有检查当前用户是否具备导出文章的权限，虽然是后台操作，但严谨性不足，也可能引发系统的安全拦截。

修正方案：改用admin_init钩子处理导出请求 #

admin_init是处理后台初始化操作的合适钩子，不会干扰主查询的正常执行。下面是调整后的完整代码：

add_action('admin_init', 'yri_export_csv');
function yri_export_csv() {
    // 验证用户权限，确保只有有权限的用户能导出
    if (!current_user_can('export')) {
        wp_die(__('You do not have sufficient permissions to export content.'));
    }

    // 检查是否是自定义文章类型页面且带有导出参数
    if (isset($_GET['post_type']) && $_GET['post_type'] === 'kohde' && isset($_GET['export_csv'])) {
        // 安全处理筛选参数
        $kunta = isset($_GET['kunta']) ? sanitize_text_field($_GET['kunta']) : 'all';
        $osasto = isset($_GET['osasto']) ? sanitize_text_field($_GET['osasto']) : 'all';
        $time = time();

        // 构建查询参数，确保获取所有符合条件的文章
        $args = array(
            'post_type' => 'kohde',
            'posts_per_page' => -1, // 获取全部符合条件的文章
            'post_status' => 'publish', // 可根据需求调整为draft/private等
            'tax_query' => array(), // 用于分类筛选，若用自定义字段则换成meta_query
        );

        // 添加kunta分类筛选（假设kunta是自定义分类法，根据实际情况调整）
        if ($kunta !== 'all') {
            $args['tax_query'][] = array(
                'taxonomy' => 'kunta',
                'field' => 'slug',
                'terms' => $kunta,
            );
            // 如果是自定义字段筛选，替换为：
            // $args['meta_query'][] = array('key' => 'kunta', 'value' => $kunta);
        }

        // 添加osasto分类筛选，同理调整
        if ($osasto !== 'all') {
            $args['tax_query'][] = array(
                'taxonomy' => 'osasto',
                'field' => 'slug',
                'terms' => $osasto,
            );
        }

        $posts = get_posts($args);

        // 设置CSV响应头，确保浏览器识别为下载文件
        header('Content-Type: text/csv; charset=utf-8');
        header("Content-Disposition: attachment; filename=kohteet_{$kunta}_{$osasto}_{$time}.csv");
        // 输出UTF-8 BOM，解决Excel打开时的乱码问题
        echo "\xEF\xBB\xBF";

        // 打开输出流，准备写入CSV内容
        $output = fopen('php://output', 'w');

        // 写入CSV表头，根据你的需求调整字段
        fputcsv($output, array(
            '文章ID',
            '标题',
            '发布日期',
            'Kunta',
            'Osasto',
            // 可添加其他字段：自定义字段、内容摘要等
        ));

        // 循环处理每篇文章
        foreach ($posts as $post) {
            setup_postdata($post); // 初始化文章数据，方便调用WordPress内置函数

            // 获取分类值，处理多分类情况（转为逗号分隔的字符串）
            $kunta_terms = get_the_terms($post->ID, 'kunta');
            $kunta_value = $kunta_terms ? implode(', ', wp_list_pluck($kunta_terms, 'name')) : '';

            $osasto_terms = get_the_terms($post->ID, 'osasto');
            $osasto_value = $osasto_terms ? implode(', ', wp_list_pluck($osasto_terms, 'name')) : '';

            // 组装行数据
            $row = array(
                $post->ID,
                get_the_title(),
                get_the_date('Y-m-d H:i:s'),
                $kunta_value,
                $osasto_value,
                // 添加自定义字段示例：get_post_meta($post->ID, 'your_meta_key', true)
            );

            // 写入当前行到CSV
            fputcsv($output, $row);
        }

        wp_reset_postdata(); // 重置文章数据，避免影响后续操作
        fclose($output);
        die(); // 终止脚本，防止输出后台页面的多余内容
    }
}

问题1：如何处理文章并导出为CSV？ #

结合上面的代码，处理文章并导出CSV的核心步骤如下：

1. 监听导出请求：通过admin_init钩子捕获带有export_csv参数的后台请求，同时验证用户权限，确保操作安全。
2. 构建精准查询：根据筛选条件（比如kunta、osasto）获取所有符合要求的文章，注意设置posts_per_page=-1以获取全部内容。
3. 处理CSV格式：
   • 设置正确的响应头，指定CSV类型和下载文件名。
   • 输出UTF-8 BOM，避免Excel打开时出现乱码。
   • 定义CSV表头，对应你需要导出的字段（ID、标题、自定义字段等）。
4. 循环处理文章数据：
   • 用setup_postdata初始化文章数据，方便调用WordPress内置函数获取内容。
   • 提取需要的字段值，处理分类、自定义字段等复杂数据（比如将多分类转为逗号分隔的字符串）。
   • 使用fputcsv函数写入每一行数据，自动处理逗号、引号等特殊字符的转义。
5. 终止脚本：完成导出后调用die()，避免输出后台页面的多余内容。

关键注意事项： #

• 数据安全：对GET参数进行sanitize_text_field处理，防止SQL注入或恶意输入。
• 权限控制：确保只有具备export权限的用户才能执行导出操作。
• 编码兼容：使用UTF-8编码并添加BOM，确保在不同软件中打开CSV时显示正常。
• 特殊字符处理：fputcsv会自动处理逗号、引号和换行符，无需手动转义。

内容的提问来源于stack exchange，提问作者Simon Josef Kok