解决WordPress自定义短代码导致“无效JSON响应”的策略与最佳实践

<?php

/**
 * 注册自定义短代码
 * 使用方法：[your_search_shortcode]
 */
function your_custom_search_shortcode_function() {
    global $wpdb;

    // 定义您的数据库表名。建议使用 $wpdb->prefix 确保与WordPress表前缀一致。
    // 如果表名是固定的，直接拼接比 prepare 更安全，因为 prepare 主要用于值。
    $table_name = $wpdb->prefix . 'your_custom_data_table'; // 替换为您的实际表名

    // 安全地获取并清理用户输入
    $filter = isset($_POST['filter']) ? sanitize_text_field($_POST['filter']) : '';

    // 启动输出缓冲，捕获所有HTML输出
    ob_start();

    // 1. 显示搜索表单
    ?>
    <div class="search-form-container">
        <form method="POST" action="">
            <input type="text" name="filter" placeholder="请输入关键词..." value="<?php echo esc_attr($filter); ?>"/>
            <input type="submit" value="搜索"/>
        </form>
    </div>
    <?php

    $results = [];
    // 2. 如果用户提供了搜索关键词，则执行数据库查询
    if (!empty($filter)) {
        // 构建安全的SQL查询
        // 使用 $wpdb->prepare() 防止SQL注入
        // %s 用于字符串占位符
        // $wpdb->esc_like() 用于转义 LIKE 模式中的特殊字符（%, _）
        $query = $wpdb->prepare(
            "SELECT id, column1, column2, column3 FROM {$table_name} WHERE column1 LIKE %s OR id LIKE %s",
            '%' . $wpdb->esc_like($filter) . '%', // 针对 column1 的模糊匹配
            '%' . $wpdb->esc_like($filter) . '%'  // 针对 id 的模糊匹配
        );

        // 执行查询并获取结果，ARRAY_A 表示以关联数组形式返回
        $results = $wpdb->get_results($query, ARRAY_A);
    }

    // 3. 显示查询结果或提示信息
    if (!empty($results)) {
        ?>
        <div class="search-results-container">
            <table>
                <thead>
                    <tr>
                        <th>列1标题</th>
                        <th>列2标题</th>
                        <th>列3标题</th>
                    </tr>
                </thead>
                <tbody>
                    <?php foreach ($results as $row) : ?>
                        <tr>
                            <td>
                                <!-- 使用 esc_url 和 esc_html 进行安全输出 -->
                                <a href="<?php echo esc_url(site_url('/displayjobs?id=' . $row['id'])); ?>">
                                    <?php echo esc_html($row['column1']); ?>
                                </a>
                            </td>
                            <td><?php echo esc_html($row['column2']); ?></td>
                            <td><?php echo esc_html($row['column3']); ?></td>
                        </tr>
                    <?php endforeach; ?>
                </tbody>
            </table>
        </div>
        <?php
    } elseif (!empty($filter)) {
        // 如果进行了搜索但没有结果
        ?>
        <div class="no-results-message">
            <p>抱歉，没有找到匹配“<?php echo esc_html($filter); ?>”的结果。</p>
        </div>
        <?php
    }
    // 如果 filter 为空，则只显示表单，不显示结果或“无结果”消息

    // 4. 获取缓冲区内容并返回
    return ob_get_clean();
}

// 注册短代码，'your_search_shortcode' 是您在内容中使用的标签
add_shortcode('your_search_shortcode', 'your_custom_search_shortcode_function');

?>