update_option

パラメータ

• $option
  サイトオプション名。'siteurl'、'home'、'blogname'、'template'など。
• $newvalue
  オプションの値。
• $autoload
  [4.2.0]自動的にロードするかどうかを指定。'yes'またはtrueの場合は自動的にロードされ、'no'またはfalseの場合は自動的にロードされない。

返り値

注意

一部のWordPressシステムのサイトオプション情報も更新できるが、テーマやプラグイン独自のオプション情報を保存する場合にも使用できる。
パラメータ$optionで指定されたオプションが登録されていない場合は、内部で add_option関数を呼び出してそのオプション情報を追加する。なおパラメータ$newvalueで指定される値は、サイトオプション名に応じてサニタイズしてから更新される。

[4.2.0]新しいオプション情報を追加する際、$autoloadが省略（null）の場合は'yes'となる。自動的にロードする指定を変更する場合は、オプション値を変更しなければならない（4.2.0では現在のオプション値のまま$autoloadの指定を変更することはできないため、既存のオプション値の指定を変更する場合は注意すること）。

使用例

• サイトオプション'blogname'の値を更新する。
  <?php update_option( 'blogname', 'Myブログ' ); ?>

フィルター

$value = apply_filters( 'pre_update_option_' . $option, $value, $old_value, $option );

$value = apply_filters( 'pre_update_option', $value, $option, $old_value );

アクション

do_action( "update_option_{$option}", $old_value, $value );

do_action( 'updated_option', $option, $old_value, $value );

ソースファイル