چرا AJAX شما ۴۰۰ می‌گیرد؟ راهنمای کامل wp_localize_script

چرا انتقال امن داده از PHP به JS ضروری است؟

تابع wp_localize_script چیست؟

امضای تابع و پارامترها

function wp_localize_script( $handle, $object_name, $l10n ) {
    // ...
}

<script>
var mythemeData = {"ajaxUrl":"...","nonce":"abc123"};
</script>

ترتیب صحیح فراخوانی

add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_scripts' );
function mytheme_enqueue_scripts() {
    wp_enqueue_script(
        'mytheme-ajax',
        get_template_directory_uri() . '/assets/js/ajax.js',
        array( 'jquery' ),
        '1.0.0',
        true
    );

    wp_localize_script(
        'mytheme-ajax',
        'mythemeData',
        array(
            'ajaxUrl' => admin_url( 'admin-ajax.php' ),
            'nonce'   => wp_create_nonce( 'mytheme_ajax_nonce' ),
        )
    );
}

استفاده در AJAX و nonce

wp_localize_script(
    'mytheme-ajax',
    'mythemeData',
    array(
        'ajaxUrl' => admin_url( 'admin-ajax.php' ),
        'nonce'   => wp_create_nonce( 'mytheme_load_more' ),
    )
);

jQuery.ajax({
    url: mythemeData.ajaxUrl,
    type: 'POST',
    data: {
        action: 'mytheme_load_more',
        nonce: mythemeData.nonce,
        page: 2
    },
    success: function( response ) {
        console.log( response );
    }
});

add_action( 'wp_ajax_mytheme_load_more', 'mytheme_load_more_handler' );
add_action( 'wp_ajax_nopriv_mytheme_load_more', 'mytheme_load_more_handler' );

function mytheme_load_more_handler() {
    if ( ! check_ajax_referer( 'mytheme_load_more', 'nonce', false ) ) {
        wp_send_json_error( array( 'message' => 'درخواست نامعتبر' ), 403 );
    }

    // پردازش و پاسخ
    wp_send_json_success( array( 'posts' => $posts ) );
}

Escape و امنیت داده‌ها

wp_localize_script(
    'mytheme-form',
    'mythemeFormData',
    array(
        'strings' => array(
            'required'  => esc_html__( 'این فیلد اجباری است', 'mytheme' ),
            'invalid'   => esc_html__( 'مقدار نامعتبر است', 'mytheme' ),
            'success'   => esc_html__( 'با موفقیت ارسال شد', 'mytheme' ),
        ),
        'maxUpload' => wp_max_upload_size(),
    )
);

کاربردهای عملی در قالب و افزونه

wp_enqueue_script(
    'mytheme-map',
    get_template_directory_uri() . '/assets/js/map.js',
    array(),
    '1.0.0',
    true
);

wp_localize_script(
    'mytheme-map',
    'mythemeMap',
    array(
        'apiKey'  => get_option( 'mytheme_maps_api_key' ),
        'markers' => get_option( 'mytheme_markers' ),
        'zoom'    => 12,
    )
);

wp_localize_script(
    'mytheme-main',
    'mythemeSettings',
    array(
        'stickyHeader' => (bool) get_theme_mod( 'sticky_header', true ),
        'smoothScroll' => (bool) get_theme_mod( 'smooth_scroll', true ),
        'darkMode'     => (bool) get_theme_mod( 'dark_mode', false ),
    )
);

$user_data = array();
if ( is_user_logged_in() ) {
    $current_user = wp_get_current_user();
    $user_data = array(
        'id'        => $current_user->ID,
        'name'      => $current_user->display_name,
        'canEdit'   => current_user_can( 'edit_posts' ),
    );
}

wp_localize_script( 'mytheme-app', 'mythemeUser', $user_data );

جایگزین‌های مدرن

$data = wp_json_encode( array(
    'ajaxUrl' => admin_url( 'admin-ajax.php' ),
    'nonce'   => wp_create_nonce( 'mytheme_nonce' ),
) );

wp_add_inline_script(
    'mytheme-ajax',
    'window.mythemeData = ' . $data . ';',
    'before'
);

نقش در Child Theme

add_action( 'wp_enqueue_scripts', 'mychild_localize_scripts', 20 );
function mychild_localize_scripts() {
    wp_localize_script(
        'mytheme-main',
        'mychildData',
        array(
            'childActive' => true,
            'customColor' => get_theme_mod( 'child_accent_color', '#1a1a1a' ),
        )
    );
}

نکات امنیتی و اشتباهات رایج

تحلیل فنی پیشرفته

پرسش‌های پرتکرار

نتیجه و مسیر ادامه