register_block_core_site_logo_setting()


WordPressのregister_block_core_site_logo_setting()関数は、ブロックエディタ内でサイトロゴの設定を登録するために使用されます。この関数を使うことで、カスタマイザーやテーマ設定でサイトロゴを管理できるようになります。

構文

register_block_core_site_logo_setting( string $setting_name, array $args = array() );

引数の説明:

  • $setting_name(string) — 設定名を指定します。これは一意である必要があります。
  • $args(array) — 設定に関する追加の引数を指定します。デフォルトは空の配列です。

例1: 基本的なサイトロゴ設定の登録

この例では、サイトロゴの設定を登録します。

register_block_core_site_logo_setting('custom_site_logo');

例2: カスタム設定を追加してサイトロゴを登録

カスタム設定を追加してサイトロゴを登録します。

register_block_core_site_logo_setting('custom_logo', array('default' => get_theme_mod('custom_logo')));

例3: サイトロゴの設定をテーマサポートに追加

テーマサポートにサイトロゴの設定を追加します。

add_theme_support('custom-logo'); register_block_core_site_logo_setting('theme_logo');

例4: サイトロゴの設定をカスタマイザーに表示

カスタマイザーにサイトロゴの設定を表示します。

register_block_core_site_logo_setting('customizer_logo', array('transport' => 'postMessage'));

例5: サイトロゴの設定を特定のユーザー権限に制限

特定のユーザー権限を持つユーザーのみがサイトロゴの設定を変更できるようにします。

register_block_core_site_logo_setting('restricted_logo', array('capability' => 'edit_theme_options'));

例6: サイトロゴの設定にデフォルト値を設定

サイトロゴの設定にデフォルト値を設定します。

register_block_core_site_logo_setting('default_logo', array('default' => get_template_directory_uri() . '/images/logo.png'));

例7: サイトロゴの設定を複数のテーマで共有

複数のテーマで同じサイトロゴ設定を共有します。

register_block_core_site_logo_setting('shared_logo', array('theme_supports' => array('theme1', 'theme2')));

注意点

  • この関数は、ブロックエディタが有効な場合にのみ動作します。
  • 設定名は一意である必要があります。重複するとエラーが発生する可能性があります。
  • カスタマイザーやテーマ設定との連携を確認するために、テスト環境で動作を確認してください。

関連機能：