single_post_title()


WordPressのsingle_post_title()関数は、現在表示されている投稿のタイトルを取得または表示するために使用されます。この関数は、シングルページや個別投稿ページで特に役立ちます。

構文

single_post_title( string $prefix = '', bool $display = true );

引数の説明:

  • $prefix (string) — タイトルの前に表示するテキストを指定します。デフォルトは空文字列です。
  • $display (bool) — タイトルを直接表示するかどうかを指定します。trueの場合、タイトルを表示し、falseの場合はタイトルを返します。

例1: 投稿タイトルの表示

この例では、現在の投稿のタイトルを表示します。

<?php single_post_title(); ?>

例2: プレフィックス付きでタイトルを表示

タイトルの前に「記事: 」というテキストを追加して表示します。

<?php single_post_title('記事: '); ?>

例3: タイトルを変数に格納

タイトルを表示せずに変数に格納します。

<?php $post_title = single_post_title('', false); ?>

例4: カスタムプレフィックスと非表示

タイトルを表示せずに、カスタムプレフィックスを付けて変数に格納します。

<?php $post_title = single_post_title('投稿: ', false); ?>

例5: 条件付きでタイトルを表示

特定の条件でタイトルを表示します。

<?php if ( is_single() ) { single_post_title(); } ?>

例6: タイトルをエスケープして表示

タイトルをエスケープして安全に表示します。

<?php echo esc_html( single_post_title('', false) ); ?>

例7: タイトルをリンク付きで表示

タイトルをリンク付きで表示します。

<?php echo '<a href="' . get_permalink() . '">' . single_post_title('', false) . '</a>'; ?>

例8: タイトルをカスタムHTMLでラップ

タイトルをカスタムHTMLタグでラップして表示します。

<?php echo '<h1 class="post-title">' . single_post_title('', false) . '</h1>'; ?>

注意点

  • この関数は、シングルページや個別投稿ページでのみ使用することを推奨します。それ以外のページでは期待した結果が得られない場合があります。
  • $display引数をfalseに設定した場合、関数はタイトルを返すだけで表示しません。表示するためにはechoを使用する必要があります。

関連機能：