WordPress插件AJAX功能失效：izinYonetimiAjax未定义问题求助

问题核心原因 #

你的自定义页面izin_turleri_listesi.php通过require_once('../wp-load.php')直接加载WordPress环境，但这种方式不会触发WordPress的后台钩子机制（比如admin_enqueue_scripts），导致你注册的脚本和通过wp_localize_script生成的izinYonetimiAjax全局变量根本没有输出到页面中，因此JS会抛出Uncaught ReferenceError错误。而将代码放到主题functions.php时，你应该是通过正常的WordPress后台菜单访问页面，钩子正常触发，所以变量能被正确识别。

解决方案一：按WordPress规范集成后台菜单（推荐） #

这种方式完全贴合WordPress生态，避免自定义页面的兼容性问题。

1. 修改izin_functions.php，添加后台菜单注册代码 #

// 注册插件后台菜单
function izin_yonetimi_menu() {
    add_menu_page(
        'İzin Yönetimi',          // 页面标题
        'İzin Yönetimi',          // 菜单显示名称
        'manage_options',         // 访问权限
        'izin-yonetimi',          // 菜单唯一标识（slug）
        'izin_turleri_listesi_render', // 页面内容渲染回调
        'dashicons-shield',       // 菜单图标
        6                         // 菜单排序位置
    );
}
add_action('admin_menu', 'izin_yonetimi_menu');

// 插件页面内容渲染函数
function izin_turleri_listesi_render() {
    // 二次权限校验
    if (!current_user_can('manage_options')) {
        wp_die(__('Bu sayfaya erişim izniniz yok.'));
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <div id="izinTurleriListesi"></div>
    </div>
    <?php
}

2. 删除独立的izin_turleri_listesi.php文件 #

现在页面内容通过菜单回调函数输出，不需要单独的页面文件，访问插件页面直接通过WordPress后台菜单进入即可。

3. 优化脚本加载（可选，提升性能） #

修改izin_yonetimi_scripts函数，仅在插件页面加载脚本：

function izin_yonetimi_scripts($hook) {
    // 仅在插件专属页面加载脚本
    if ($hook !== 'toplevel_page_izin-yonetimi') {
        return;
    }

    wp_enqueue_script('izin-yonetimi-script', plugin_dir_url(__DIR__) . 'js/izin-turleri.js', array('jquery'), '3.7.1', true);
    
    // 添加安全nonce（强烈建议）
    wp_localize_script('izin-yonetimi-script', 'izinYonetimiAjax', array(
        'ajaxurl' => admin_url('admin-ajax.php'),
        'nonce' => wp_create_nonce('izin-yonetimi-security')
    ));
}
add_action('admin_enqueue_scripts', 'izin_yonetimi_scripts');

4. 增强AJAX安全性（可选） #

在JS的AJAX请求中加入nonce校验：

// 示例：列表加载请求中添加nonce
data: {
    action: 'get_izin_turleri_listesi',
    nonce: izinYonetimiAjax.nonce
},

在PHP的AJAX处理函数中验证nonce：

function get_izin_turleri_listesi_handler() {
    // 验证安全nonce
    if (!wp_verify_nonce($_POST['nonce'], 'izin-yonetimi-security')) {
        wp_send_json_error(['message' => 'Güvenlik doğrulaması başarısız.']);
    }
    
    // 原有业务逻辑...
}

解决方案二：保留自定义页面（不推荐） #

如果必须使用独立页面，需要手动输出全局变量和脚本：
修改izin_turleri_listesi.php的内容：

<?php
require_once('../wp-load.php');

if (!is_user_logged_in() || !current_user_can('manage_options')) {
    wp_redirect(wp_login_url());
    exit;
}

// 手动准备本地化数据
$izin_ajax_data = array(
    'ajaxurl' => admin_url('admin-ajax.php'),
    'nonce' => wp_create_nonce('izin-yonetimi-security')
);
?>

<!DOCTYPE html>
<html lang="tr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>İzin Türleri Listesi</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
    
    <!-- 手动输出全局变量 -->
    <script type="text/javascript">
        var izinYonetimiAjax = <?php echo json_encode($izin_ajax_data); ?>;
    </script>
    
    <!-- 加载jQuery（通过WordPress内置版本） -->
    <?php wp_enqueue_script('jquery'); wp_print_scripts('jquery'); ?>
</head>
<body>

<div class="container mt-5">
    <h2>İzin Türleri Listesi</h2>
    <div id="izinTurleriListesi"></div>
</div>

<!-- 加载插件JS -->
<script src="<?php echo plugin_dir_url(__DIR__) . 'js/izin-turleri.js'; ?>"></script>

</body>
</html>

内容的提问来源于stack exchange，提问作者Fatih ATEŞ