چرا AJAX شما داده برنمی‌گرداند؟ راهنمای wp_send_json_success

چرا پاسخ JSON استاندارد حیاتی است؟

تابع wp_send_json_success چیست؟

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

function wp_send_json_success( $data = null, $status_code = null, $options = 0 ) {
    $response = array( 'success' => true );
    if ( null !== $data ) {
        $response['data'] = $data;
    }
    wp_send_json( $response, $status_code, $options );
}

سازوکار داخلی تابع

ساختار پاسخ JSON

{
  "success": true,
  "data": {
    "postId": 42,
    "message": "نوشته با موفقیت ذخیره شد",
    "permalink": "https://example.com/post-42/"
  }
}

استفاده در AJAX

add_action( 'wp_ajax_myplugin_save_post', 'myplugin_save_post_handler' );
function myplugin_save_post_handler() {
    check_ajax_referer( 'myplugin_save_post_nonce', 'nonce' );

    if ( ! current_user_can( 'edit_posts' ) ) {
        wp_send_json_error( array( 'message' => 'دسترسی غیرمجاز' ), 403 );
    }

    $post_id = isset( $_POST['post_id'] ) ? absint( $_POST['post_id'] ) : 0;
    if ( ! $post_id ) {
        wp_send_json_error( array( 'message' => 'شناسه نامعتبر' ), 400 );
    }

    wp_update_post( array(
        'ID' => $post_id,
        'post_title' => sanitize_text_field( $_POST['title'] ),
    ) );

    wp_send_json_success( array(
        'postId' => $post_id,
        'message' => 'نوشته با موفقیت ذخیره شد',
    ) );
}

jQuery.post(
    mypluginData.ajaxUrl,
    {
        action: 'myplugin_save_post',
        nonce: mypluginData.nonce,
        post_id: 42,
        title: 'عنوان جدید'
    },
    function( response ) {
        if ( response.success ) {
            console.log( response.data.message );
        } else {
            console.error( response.data.message );
        }
    }
);

استفاده در REST API

function myplugin_rest_handler( WP_REST_Request $request ) {
    $data = myplugin_process_data( $request );

    if ( is_wp_error( $data ) ) {
        return new WP_Error( 'myplugin_error', $data->get_error_message(), array( 'status' => 400 ) );
    }

    // روش اول: استفاده از WP_REST_Response
    return new WP_REST_Response( array( 'data' => $data ), 200 );

    // روش دوم: استفاده از wp_send_json_success (در permission_callback یا مسیرهای خاص)
    // wp_send_json_success( $data );
}

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

add_action( 'wp_ajax_myplugin_save_settings', 'myplugin_save_settings_handler' );
function myplugin_save_settings_handler() {
    check_ajax_referer( 'myplugin_settings_nonce', 'nonce' );

    if ( ! current_user_can( 'manage_options' ) ) {
        wp_send_json_error( array( 'message' => 'دسترسی غیرمجاز' ), 403 );
    }

    $settings = isset( $_POST['settings'] ) ? (array) $_POST['settings'] : array();
    $sanitized = array();
    foreach ( $settings as $key => $value ) {
        $sanitized[ sanitize_key( $key ) ] = sanitize_text_field( $value );
    }

    update_option( 'myplugin_settings', $sanitized );

    wp_send_json_success( array(
        'message'  => 'تنظیمات با موفقیت ذخیره شد',
        'settings' => $sanitized,
    ) );
}

add_action( 'wp_ajax_myplugin_load_more', 'myplugin_load_more_handler' );
add_action( 'wp_ajax_nopriv_myplugin_load_more', 'myplugin_load_more_handler' );
function myplugin_load_more_handler() {
    check_ajax_referer( 'myplugin_load_more_nonce', 'nonce' );

    $page = isset( $_POST['page'] ) ? absint( $_POST['page'] ) : 1;

    $query = new WP_Query( array(
        'post_type'      => 'post',
        'posts_per_page' => 10,
        'paged'          => $page,
    ) );

    $posts = array();
    foreach ( $query->posts as $post ) {
        $posts[] = array(
            'id'    => $post->ID,
            'title' => get_the_title( $post ),
            'url'   => get_permalink( $post ),
        );
    }

    wp_send_json_success( array(
        'posts'      => $posts,
        'hasMore'    => $page < $query->max_num_pages,
        'nextPage'   => $page + 1,
    ) );
}

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

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

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

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