add_allowed_options()


WordPressのadd_allowed_options()関数は、管理画面で許可されるオプションを追加するために使用されます。主にマルチサイト環境やプラグイン開発で利用されます。

構文

add_allowed_options( string|array $options, string $deprecated = '' );

引数の説明:

  • $options(string|array)—追加するオプション名（文字列または配列）
  • $deprecated(string)—非推奨パラメータ（空文字列）

例1:単一オプションの追加

基本的な使用例で、1つのオプションを許可リストに追加します。

add_allowed_options('my_custom_option');

例2:複数オプションの追加

配列を使用して複数のオプションを一度に追加します。

add_allowed_options(array('option1','option2','option3'));

例3:プラグイン有効化時のオプション追加

プラグイン有効化時にオプションを登録する例です。

register_activation_hook(__FILE__,function(){add_allowed_options('plugin_option');});

例4:ネットワーク管理者向けオプション追加

マルチサイト環境でネットワーク管理者のみに許可するオプションを追加します。

if(is_network_admin()){add_allowed_options('network_setting');}

例5:条件付きオプション追加

特定の条件下でのみオプションを許可リストに追加します。

if(current_user_can('manage_options')){add_allowed_options('admin_only_option');}

例6:フックを使用したオプション追加

admin_initフックを使用してオプションを追加します。

add_action('admin_init',function(){add_allowed_options('hook_added_option');});

例7:動的オプション名の追加

変数を使用して動的にオプション名を指定します。

$option_name='dynamic_'.time();add_allowed_options($option_name);

注意事項

  • この関数は管理者権限が必要です
  • マルチサイト環境ではスーパーアドミン権限が必要です
  • セキュリティ上の理由から信頼できるオプションのみ追加してください

関連機能：