add_option()

WordPressのadd_option()関数は、新しいオプションをデータベースに追加するために使用されます。この関数は、オプションがすでに存在する場合は新しい値を追加せず、既存の値を変更しません。

シンタックス

add_option( string $option, mixed $value = '', string $autoload = 'yes' );

引数の説明:

• $option (string) — 保存するオプションの名前。
• $value (mixed) — 保存するオプションの初期値（デフォルトは空文字列）。
• $autoload (string) — オプションを自動的にロードするかどうかを指定（'yes'または'no'）。

例 1: シンプルなオプションの追加

次のコードは、データベースにカスタムオプションを追加します。

add_option('my_custom_option', 'custom_value');

例 2: 自動ロードを無効にする

自動ロードを無効にしてオプションを追加する場合。

add_option('non_autoload_option', 'value', 'no');

例 3: 配列データの保存

配列をオプションとして保存する方法。

add_option('my_array_option', array('key1' => 'value1', 'key2' => 'value2'));

例 4: 値が存在しない場合にのみオプションを追加

既存のオプションを上書きしない仕組み。

if (!get_option('unique_option')) {
    add_option('unique_option', 'unique_value');
}

例 5: 関数を使用した動的なオプションの追加

動的なデータを基にオプションを追加します。

add_option('dynamic_option', wp_generate_password());

注意事項

• add_option()関数は、オプションが既に存在する場合に値を変更しません。この場合、代わりにupdate_option()を使用してください。
• $option引数にはユニークな名前を使用してください。同じ名前を持つオプションが存在する場合、意図しない結果を招く可能性があります。