چرا تنظیمات افزونه شما درست خوانده نمی‌شود؟ راهنمای get_option

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

تابع get_option چیست؟

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

function get_option( $option, $default = false ) {
    global $wpdb;

    if ( ! isset( $option ) ) {
        return false;
    }

    $option = trim( $option );
    if ( empty( $option ) ) {
        return false;
    }

    if ( ! wp_installing() ) {
        $alloptions = wp_load_alloptions();

        if ( isset( $alloptions[ $option ] ) ) {
            $value = $alloptions[ $option ];
        } else {
            $row = $wpdb->get_row( $wpdb->prepare(
                "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1",
                $option
            ) );

            if ( is_object( $row ) ) {
                $value = $row->option_value;
            }
        }
    }

    if ( ! isset( $value ) ) {
        return $default;
    }

    return apply_filters( "option_{$option}", maybe_unserialize( $value ), $option );
}

سازوکار داخلی و Autoload

نقش default در پایداری

// اشتباه — اگر گزینه وجود نداشته باشد، false برمی‌گردد
$api_key = get_option( 'myplugin_api_key' );
$response = wp_remote_get( 'https://api.example.com/?key=' . $api_key );

// صحیح — مقدار پیش‌فرض مشخص است
$api_key = get_option( 'myplugin_api_key', '' );
if ( empty( $api_key ) ) {
    return new WP_Error( 'missing_api_key', 'کلید API تنظیم نشده است' );
}

نوع داده و سریالایز

$settings = array(
    'enabled'   => true,
    'threshold' => 100,
    'channels'  => array( 'email', 'sms' ),
);
update_option( 'myplugin_settings', $settings );

// در خواندن
$settings = get_option( 'myplugin_settings', array() );
$threshold = isset( $settings['threshold'] ) ? absint( $settings['threshold'] ) : 100;

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

function myplugin_get_settings() {
    $defaults = array(
        'enabled'       => true,
        'api_key'       => '',
        'cache_duration' => 3600,
        'debug_mode'    => false,
    );

    $settings = get_option( 'myplugin_settings', array() );

    if ( ! is_array( $settings ) ) {
        return $defaults;
    }

    return wp_parse_args( $settings, $defaults );
}

function myplugin_get_flag( $name, $default = false ) {
    $value = get_option( 'myplugin_flag_' . sanitize_key( $name ), null );

    if ( null === $value ) {
        return $default;
    }

    return (bool) $value;
}

function myplugin_get_environment() {
    $env = get_option( 'myplugin_environment', 'production' );

    if ( ! in_array( $env, array( 'development', 'staging', 'production' ), true ) ) {
        return 'production';
    }

    return $env;
}

Performance و Autoload

function myplugin_list_autoloaded_options() {
    global $wpdb;

    $rows = $wpdb->get_results(
        "SELECT option_name, LENGTH(option_value) AS size
         FROM {$wpdb->options}
         WHERE autoload = 'yes'
         ORDER BY size DESC
         LIMIT 20",
        ARRAY_A
    );

    return is_array( $rows ) ? $rows : array();
}

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

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

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

ادامه مسیر