render_block_core_site_logo()


WordPressのrender_block_core_site_logo()関数は、サイトロゴを表示するためのコアブロックをレンダリングするために使用されます。この関数は、サイトロゴブロックのHTMLを生成し、フロントエンドに表示します。

構文

render_block_core_site_logo( array $attributes );

引数の説明:

  • $attributes(array) — サイトロゴブロックの属性を指定します。以下のキーを含むことができます:
    • width(int) — ロゴの幅を指定します。
    • height(int) — ロゴの高さを指定します。
    • isLink(bool) — ロゴをリンクとして表示するかどうかを指定します。
    • linkTarget(string) — リンクのターゲットを指定します(例: _blank)。

例1: 基本的なサイトロゴの表示

この例では、デフォルトの設定でサイトロゴを表示します。

<?php echo render_block_core_site_logo( array() ); ?>

例2: カスタムサイズのロゴを表示

この例では、幅と高さを指定してロゴを表示します。

<?php echo render_block_core_site_logo( array( 'width' => 200, 'height' => 100 ) ); ?>

例3: ロゴをリンクとして表示

この例では、ロゴをホームページへのリンクとして表示します。

<?php echo render_block_core_site_logo( array( 'isLink' => true ) ); ?>

例4: 新しいタブでロゴリンクを開く

この例では、ロゴをクリックした時に新しいタブでホームページを開きます。

<?php echo render_block_core_site_logo( array( 'isLink' => true, 'linkTarget' => '_blank' ) ); ?>

例5: ロゴの幅のみを指定

この例では、ロゴの幅のみを指定し、高さは自動調整されます。

<?php echo render_block_core_site_logo( array( 'width' => 150 ) ); ?>

例6: ロゴの高さのみを指定

この例では、ロゴの高さのみを指定し、幅は自動調整されます。

<?php echo render_block_core_site_logo( array( 'height' => 80 ) ); ?>

例7: ロゴを非リンクとして表示

この例では、ロゴをリンクなしで表示します。

<?php echo render_block_core_site_logo( array( 'isLink' => false ) ); ?>

注意点

  • この関数は、テーマやプラグイン内で直接使用することを想定しています。
  • 引数$attributesを正しく設定しないと、期待通りの表示が得られない場合があります。
  • ロゴのサイズを指定する際は、画像のアスペクト比を考慮してください。

関連機能: