WordPress 短代码导致“无效 JSON 响应”的调试与最佳实践

<?php

/**
 * 注册自定义短代码
 * [my_custom_search_form]
 */
function register_my_custom_shortcode() {
    add_shortcode('my_custom_search_form', 'my_custom_search_form_function');
}
add_action('init', 'register_my_custom_shortcode');

/**
 * 自定义短代码函数：显示搜索表单并根据查询结果显示表格
 */
function my_custom_search_form_function() {
    global $wpdb;

    // 定义数据库表名，建议使用 $wpdb->prefix 获取带前缀的表名
    $table_name = $wpdb->prefix . 'your_custom_job_table'; // 替换为你的实际表名

    // 获取并清理用户输入的筛选条件
    $filter = isset($_POST['filter']) ? sanitize_text_field($_POST['filter']) : '';

    // 引入搜索表单 HTML，通常放在插件目录的某个文件中
    // 确保 form.html 存在于指定路径
    $form_path = WP_PLUGIN_DIR . '/your_plugin_directory/assets/runtime/shortcode/form.html';
    if (file_exists($form_path)) {
        require_once($form_path);
    } else {
        // 如果表单文件不存在，可以输出一个错误信息或默认内容
        error_log('Shortcode form file not found: ' . $form_path);
        // return '<p>搜索表单加载失败。</p>'; // 或者直接返回错误信息
    }

    // 开启输出缓冲
    ob_start();
    ?>

    <div class="my-custom-shortcode-wrapper">
        <?php
        // 只有当有筛选条件时才执行数据库查询并显示结果
        if (!empty($filter)) {
            // 构建查询：使用 $wpdb->prepare 防止 SQL 注入
            // 注意 LIKE 子句中的 %% 用于转义 %
            $query = $wpdb->prepare(
                "SELECT id, column1, column2, column3 FROM %i WHERE column1 LIKE %s OR id LIKE %s",
                $table_name,
                '%' . $wpdb->esc_like($filter) . '%', // 使用 $wpdb->esc_like 处理通配符
                '%' . $wpdb->esc_like($filter) . '%'
            );

            $results = $wpdb->get_results($query, ARRAY_A);

            if ($results && count($results) > 0) {
                ?>
                <table>
                    <thead>
                        <tr>
                            <th>列1</th>
                            <th>列2</th>
                            <th>列3</th>
                        </tr>
                    </thead>
                    <tbody>
                        <?php foreach ($results as $row) : ?>
                            <tr>
                                <td>
                                    <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>
                <?php
            } else {
                echo '<p>未找到匹配的结果。</p>';
            }
        } else {
            // 如果没有筛选条件，可以显示提示信息
            echo '<p>请输入搜索条件以查找信息。</p>';
        }
        ?>
    </div>

    <?php
    // 获取缓冲区内容并返回
    return ob_get_clean();
}

?>

<form method="POST" class="my-custom-search-form">
  <input type="text" name="filter" placeholder="请输入搜索关键词..." value="<?php echo isset($_POST['filter']) ? esc_attr(sanitize_text_field($_POST['filter'])) : ''; ?>"/>
  <input type="submit" value="搜索"/>
</form>