single_post_title

説明

string single_post_title( [ string $prefix = '' [ , bool $display = true ] ] )
投稿ページのタイトルを表示する。

パラメータ

  • $prefix
    プレフィックス文字を指定(省略時は'')。
  • $display
    表示する場合はtrue、取得する場合はfalseを指定(省略時はtrue)。

返り値

パラメータ$displayがfalseの場合はタイトルを返す。なお、$displayがtrueか、リクエストページが投稿ページ以外の場合は何も返さない。

注意

get_queried_object関数を使って、投稿情報オブジェクトを取得している。

使用例

  • 投稿ページのタイトルを表示する。
    <?php single_post_title(); ?>
  • 投稿ページのタイトルを取得する。
    <?php $title = single_post_title( '', false ); ?>

フィルター

タイトルを表示または返す前にsingle_post_titleフィルターを実行する。パラメータ$titleには投稿タイトルが、$_postには投稿情報オブジェクトが格納される。
$title = apply_filters( 'single_post_title', $title, $_post );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/general-template.php

最終更新 : 2012年09月06日 16:20



お勧め

いまさらだけどツールバー(admin bar)を使う(2019年10月17日 更新)

これまでツールバーを積極的に活用することはなく、もっぱら show_admin_bar関数を使って非表示にしていた。そんなわけで、ツールバーについてはほとんど知識がなく、ソースコードを眺めながら使ってみた。

5.3の新機能:クエリーログに任意の項目を追加できる新フィルター(2019年10月23日 更新)

5.3 RC2」が公開され、正式リリースまであと20日。公式ディレクトリにプラグインを公開していることもあり、5.3に関する開発者向けの情報「Miscellaneous Developer Focused Changes in 5.3」を読んでいる。

全投稿を取得するのはnopaging=1でいい(2011年8月31日 更新)

query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?

「順序」をtextからnumberに変更してみた(2018年5月27日 更新)

固定ページの編集画面の「投稿の属性」ウィジェットには、ページの並び替えに使用できる「順序」のinput要素がある。この「順序」のinput要素はtype属性が'text'となっており、編集の際にIMEが有効になってしまう場合がある。ページの編集頻度が多くなると、その都度IMEをオフにするのがやや面倒になってくる。

タイトルのみをキーワード検索する(2014年4月3日 更新)

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。