render_block_core_home_link()


WordPressのrender_block_core_home_link()関数は、ホームページへのリンクを表示するためのブロックをレンダリングするために使用されます。この関数は、コアブロック「ホームリンク」の出力を生成します。

構文

render_block_core_home_link( array $attributes );

引数の説明:

  • $attributes(array) — ホームリンクブロックの属性を指定します。以下のキーを持つ連想配列です：
    • label(string) — リンクに表示するテキスト。
    • url(string) — リンク先のURL。デフォルトはホームページのURL。

例1: 基本的なホームリンクの表示

ホームページへのリンクを表示する基本的な例です。

echo render_block_core_home_link( array( 'label' => 'ホームへ戻る', 'url' => home_url() ) );

例2: カスタムラベルを使用

リンクのテキストをカスタマイズする例です。

echo render_block_core_home_link( array( 'label' => 'トップページ', 'url' => home_url() ) );

例3: URLを指定しない場合

URLを指定しない場合、デフォルトでホームページのURLが使用されます。

echo render_block_core_home_link( array( 'label' => 'ホーム' ) );

例4: 空のラベルを使用

ラベルを空にすると、デフォルトのテキストが表示されます。

echo render_block_core_home_link( array( 'label' => '', 'url' => home_url() ) );

例5: 外部URLを指定

外部のURLを指定してリンクを作成する例です。

echo render_block_core_home_link( array( 'label' => '外部サイト', 'url' => 'https://example.com' ) );

例6: 属性を動的に設定

動的に属性を設定してリンクを表示する例です。

$attributes = array( 'label' => get_bloginfo( 'name' ), 'url' => home_url() ); echo render_block_core_home_link( $attributes );

例7: ショートコード内での使用

ショートコード内でホームリンクを表示する例です。

add_shortcode( 'home_link', function() { return render_block_core_home_link( array( 'label' => 'ホーム', 'url' => home_url() ) ); } );

注意点

  • この関数は、WordPressのブロックエディタで使用されることを前提としています。
  • URLが無効な場合、リンクは正しく機能しません。
  • ラベルが空の場合、デフォルトのテキストが使用されますが、テーマやプラグインによって異なる場合があります。

関連機能：