wp_apply_colors_support()


WordPressのwp_apply_colors_support()関数は、テーマやプラグインで色のサポートを追加するために使用されます。主にカスタマイザーやエディターの色設定を管理します。

構文

wp_apply_colors_support( array $args );

引数の説明:

  • $args(array)—色サポートの設定を含む配列。
  • 'default_background'(string)—デフォルトの背景色。
  • 'default_text'(string)—デフォルトのテキスト色。
  • 'default_link'(string)—デフォルトのリンク色。
  • 'editor'(bool)—ブロックエディターで色設定を有効にする。
  • 'custom'(bool)—カスタマイザーで色設定を有効にする。

例1:基本的な色サポートの追加

テーマで色サポートを有効にします。

add_theme_support('editor-color-palette',wp_apply_colors_support(array('default_background'=>'#ffffff')));

例2:カスタムテキスト色の設定

デフォルトのテキスト色を変更します。

wp_apply_colors_support(array('default_text'=>'#333333'));

例3:リンク色のカスタマイズ

リンク色を青色に設定します。

wp_apply_colors_support(array('default_link'=>'#0066cc'));

例4:ブロックエディターのみ有効化

エディターでの色設定のみを許可します。

wp_apply_colors_support(array('editor'=>true,'custom'=>false));

例5:カスタマイザーの色設定を無効化

カスタマイザーでの色変更を禁止します。

wp_apply_colors_support(array('custom'=>false));

例6:複数の色設定を同時に適用

背景色とテキスト色を一度に設定します。

wp_apply_colors_support(array('default_background'=>'#f5f5f5','default_text'=>'#222222'));

例7:子テーマで親テーマの色設定を上書き

親テーマの色設定を変更します。

add_action('after_setup_theme',function(){wp_apply_colors_support(array('default_background'=>'#000000'));},20);

注意点

  • この関数はテーマのfunctions.phpまたはプラグイン内で使用します。
  • add_theme_support()と組み合わせて使う場合があります。
  • 色の値はHEX形式（例:#ffffff）で指定します。

関連機能：