register_block_core_site_icon_setting()


WordPressのregister_block_core_site_icon_setting()関数は、ブロックエディタ内でサイトアイコンの設定を登録するために使用されます。この関数は、サイトアイコンを管理するための設定をブロックエディタに追加します。

構文

register_block_core_site_icon_setting();

例1: サイトアイコン設定の登録

この例では、ブロックエディタにサイトアイコンの設定を追加します。

add_action('init', 'register_custom_site_icon_setting'); function register_custom_site_icon_setting() { register_block_core_site_icon_setting(); }

例2: サイトアイコン設定をテーマに追加

テーマのfunctions.phpファイルに以下のコードを追加して、サイトアイコン設定を有効にします。

add_action('after_setup_theme', 'theme_support_site_icon'); function theme_support_site_icon() { add_theme_support('site-icon'); register_block_core_site_icon_setting(); }

例3: サイトアイコン設定をプラグインで使用

プラグイン内でサイトアイコン設定を登録する例です。

function custom_plugin_site_icon_setup() { register_block_core_site_icon_setting(); } add_action('plugins_loaded', 'custom_plugin_site_icon_setup');

例4: サイトアイコン設定をカスタマイズ例5: サイトアイコン設定を特定のユーザーロールに制限

管理者ユーザーのみがサイトアイコン設定を利用できるようにする例です。

add_action('init', 'register_site_icon_for_admin'); function register_site_icon_for_admin() { if (current_user_can('manage_options')) { register_block_core_site_icon_setting(); } }

例6: サイトアイコン設定を特定のページでのみ有効にする

特定のページでのみサイトアイコン設定を有効にする例です。

add_action('init', 'register_site_icon_for_specific_page'); function register_site_icon_for_specific_page() { if (is_page('about')) { register_block_core_site_icon_setting(); } }

例7: サイトアイコン設定をカスタム投稿タイプに追加

カスタム投稿タイプにサイトアイコン設定を追加する例です。

add_action('init', 'register_site_icon_for_custom_post_type'); function register_site_icon_for_custom_post_type() { if (get_post_type() === 'custom_post_type') { register_block_core_site_icon_setting(); } }

注意点

  • register_block_core_site_icon_setting()は、WordPress 5.8以降で利用可能です。
  • サイトアイコン設定を有効にするためには、テーマがadd_theme_support('site-icon')をサポートしている必要があります。
  • この関数は、ブロックエディタ内でのみ機能します。

関連機能：