yoast_breadcrumb()


WordPressのyoast_breadcrumb()関数は、パンくずリストを表示するために使用されます。これは、ユーザーがサイト内での現在の位置を把握しやすくするためのナビゲーション補助機能です。

構文

yoast_breadcrumb( string $before, string $after, bool $display );

引数の説明:

  • $before (string) — パンくずリストの前に表示されるHTMLまたはテキスト。
  • $after (string) — パンくずリストの後に表示されるHTMLまたはテキスト。
  • $display (bool) — パンくずリストを表示するかどうか。trueの場合、直接出力されます。falseの場合、文字列として返されます。

例1: 基本的なパンくずリストの表示

この例では、パンくずリストをシンプルに表示します。

<?php yoast_breadcrumb(); ?>

例2: パンくずリストの前後にテキストを追加

パンくずリストの前後にカスタムテキストを追加します。

<?php yoast_breadcrumb('<p>','</p>'); ?>

例3: パンくずリストを変数に格納

パンくずリストを直接表示せず、変数に格納します。

<?php $breadcrumbs = yoast_breadcrumb('','',false); echo $breadcrumbs; ?>

例4: パンくずリストのスタイルをカスタマイズ

パンくずリストにクラスを追加してスタイルを適用します。

<?php yoast_breadcrumb('<div class="breadcrumb">','</div>'); ?>

例5: パンくずリストの区切り文字を変更

パンくずリストの区切り文字を変更します。

<?php add_filter('wpseo_breadcrumb_separator', function($separator) { return ' &gt; '; }); yoast_breadcrumb(); ?>

例6: パンくずリストのホームリンクテキストを変更

ホームリンクのテキストを変更します。

<?php add_filter('wpseo_breadcrumb_home_text', function($home_text) { return 'トップページ'; }); yoast_breadcrumb(); ?>

例7: パンくずリストのホームリンクURLを変更

ホームリンクのURLを変更します。

<?php add_filter('wpseo_breadcrumb_home_url', function($home_url) { return home_url('/custom-home'); }); yoast_breadcrumb(); ?>

例8: パンくずリストの最後のアイテムをリンクなしで表示

最後のアイテムをリンクなしで表示します。

<?php add_filter('wpseo_breadcrumb_single_link', '__return_false'); yoast_breadcrumb(); ?>

注意点

  • Yoast SEOプラグインが有効になっている必要があります。
  • パンくずリストの表示は、テーマのテンプレートファイル内で行うことが一般的です。
  • カスタマイズを行う際は、必ず子テーマを使用することを推奨します。