the_custom_logo()


WordPressのthe_custom_logo()関数は、テーマカスタマイザーで設定されたカスタムロゴを表示するために使用されます。この関数は、ロゴが設定されている場合にHTMLマークアップを出力します。

構文

the_custom_logo( int $blog_id = 0 );
  • $blog_id (int) — ロゴを取得するブログのID。マルチサイト環境で使用されます。デフォルトは0で、現在のサイトを指します。

例1: 基本的なカスタムロゴの表示

カスタムロゴを表示する最もシンプルな例です。

<?php the_custom_logo(); ?>

例2: カスタムロゴを特定のブログIDで表示

マルチサイト環境で、特定のブログIDのロゴを表示します。

<?php the_custom_logo(2); ?>

例3: カスタムロゴを条件付きで表示

ロゴが設定されている場合のみ表示します。

<?php if ( has_custom_logo() ) { the_custom_logo(); } ?>

例4: カスタムロゴにクラスを追加

カスタムロゴのHTMLにクラスを追加します。

<?php the_custom_logo(); echo '<style>.custom-logo { border: 2px solid #000; }</style>'; ?>

例5: カスタムロゴをリンクなしで表示

カスタムロゴをリンクなしで表示します。

<?php $custom_logo_id = get_theme_mod( 'custom_logo' ); $image = wp_get_attachment_image_src( $custom_logo_id , 'full' ); echo '<img src="' . $image[0] . '" alt="' . get_bloginfo('name') . '">'; ?>

例6: カスタムロゴのサイズを変更

カスタムロゴの表示サイズを変更します。

<?php $custom_logo_id = get_theme_mod( 'custom_logo' ); $image = wp_get_attachment_image_src( $custom_logo_id , 'medium' ); echo '<img src="' . $image[0] . '" alt="' . get_bloginfo('name') . '">'; ?>

例7: カスタムロゴを背景画像として使用

カスタムロゴを背景画像として使用します。

<?php $custom_logo_id = get_theme_mod( 'custom_logo' ); $image = wp_get_attachment_image_src( $custom_logo_id , 'full' ); echo '<div style="background-image: url(' . $image[0] . '); width: 100px; height: 100px;"></div>'; ?>

例8: カスタムロゴを特定の投稿に表示

特定の投稿にカスタムロゴを表示します。

<?php $post_id = get_the_ID(); $custom_logo_id = get_post_meta( $post_id, 'custom_logo', true ); $image = wp_get_attachment_image_src( $custom_logo_id , 'full' ); echo '<img src="' . $image[0] . '" alt="' . get_the_title($post_id) . '">'; ?>

注意点

  • カスタムロゴが設定されていない場合、the_custom_logo()は何も出力しません。
  • マルチサイト環境で特定のブログIDを使用する場合、そのブログが存在することを確認してください。
  • ロゴのサイズやスタイルを変更する場合は、CSSを使用するか、wp_get_attachment_image_src()で画像サイズを指定してください。

関連機能：