چرا تنظیمات افزونه شما ذخیره نمی‌شود؟ راهنمای تخصصی update_option

چرا ذخیره درست تنظیمات اهمیت دارد؟

تابع update_option چیست؟

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

function update_option( $option, $value, $autoload = null ) {
    // ...
}

سازوکار داخلی و مقدار بازگشتی

Sanitize پیش از ذخیره

// اشتباه
$title = $_POST['title']; // داده خام
update_option( 'myplugin_title', $title );

// صحیح
$title = isset( $_POST['title'] )
    ? sanitize_text_field( wp_unslash( $_POST['title'] ) )
    : '';

update_option( 'myplugin_title', $title );

نقش autoload در کارایی

update_option( 'myplugin_api_key', $api_key, false );
update_option( 'myplugin_enabled', $enabled, true );

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

function myplugin_save_settings( $input ) {
    $sanitized = array(
        'enabled'       => ! empty( $input['enabled'] ),
        'api_key'       => isset( $input['api_key'] )
            ? sanitize_text_field( wp_unslash( $input['api_key'] ) )
            : '',
        'cache_duration' => isset( $input['cache_duration'] )
            ? absint( $input['cache_duration'] )
            : 3600,
        'debug_mode'    => ! empty( $input['debug_mode'] ),
    );

    $result = update_option( 'myplugin_settings', $sanitized, false );

    return $result;
}

function myplugin_update_flag( $flag_name, $value ) {
    $option_name = 'myplugin_flag_' . sanitize_key( $flag_name );
    $current = get_option( $option_name, null );

    if ( $current === $value ) {
        return true;
    }

    return update_option( $option_name, $value, false );
}

add_action( 'wp_ajax_myplugin_save_state', 'myplugin_save_state_handler' );
function myplugin_save_state_handler() {
    check_ajax_referer( 'myplugin_state_nonce', 'nonce' );

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

    $state = isset( $_POST['state'] )
        ? sanitize_key( wp_unslash( $_POST['state'] ) )
        : '';

    if ( ! in_array( $state, array( 'active', 'paused' ), true ) ) {
        wp_send_json_error( array( 'message' => 'وضعیت نامعتبر' ), 400 );
    }

    update_option( 'myplugin_state', $state, false );

    wp_send_json_success( array( 'state' => $state ) );
}

هوک‌های مرتبط با ذخیره‌سازی

add_action( 'update_option_myplugin_settings', 'myplugin_settings_updated', 10, 3 );
function myplugin_settings_updated( $old_value, $value, $option ) {
    if ( $old_value === $value ) {
        return;
    }

    if ( function_exists( 'myplugin_flush_all_transients' ) ) {
        myplugin_flush_all_transients();
    }
}

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

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

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

ادامه مسیر