説明
string wp_title( [ string $sep = '»' [ , bool $display = true [ , string $seplocaution = '' ] ] ] )
各種アーカイブページや投稿ページなど、要求されているページに応じたページタイトルを作成し、パラメータ$displayがtrueならば表示する。$displayがfalseの場合は、文字列として返す。
パラメータ
- $sep区切り文字を指定。
- $displayタイトルを表示する場合はtrue（省略時）を、取得する場合はfalseを指定。
- $seplocaution区切り文字の連結場所指定（'right'かそれ以外）。'right'の場合は、作成したページタイトル文字列の後に区切り文字を連結する。'right'以外の場合はページタイトル文字列の前に連結する。
返り値
パラメータ$displayがfalseの場合はタイトルを返す。$displayがtrueの場合、返り値はない。注意
パラメータ$sepで指定する区切り文字は、ページタイトルが空になる場合は連結されない。
本関数ではブログ名は出力（表示）されない。標準テーマ「Twenty Twelve」ではwp_titleフィルターを利用し、ブログ名を含めたり、ページ番号を追加するといった対応をしており、header.phpなどのtitleタグ出力部分をすっきりさせている。
使用例
- ページタイトルを表示する。<title><?php wp_title('«', true, 'right'); ?> <?php bloginfo('name'); ?></title>
- ページタイトルを取得する。<?php $title = wp_title( '' , false ); ?>
フィルター
[4.0.0]タイトルを組み立てる前にwp_title_partsフィルターを呼び出す。パラメータ$title_arrayはタイトルを区切り文字で分割した配列となる。$title_array = apply_filters( 'wp_title_parts', $title_array );
[2.0.0]作成したタイトルを表示（または返す）直前にwp_titleフィルターを呼び出す。パラメーラ$titleには作成したタイトルが、$sepと$seplocautionには本関数で受け取った値がそのまま格納されている。
$title = apply_filters( 'wp_title', $title, $sep, $seplocaution );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/general-template.php最終更新 : 2018年05月27日 10:48
関連
お勧め
edit_custom_thumbnail_sizesフィルターを使ってみた（2022年5月30日 更新）
アップロード済みの画像は、トリミングや回転、反転といった編集が可能である。6.0.0で追加されたedit_custom_thumbnail_sizesフィルターは、編集された内容を反映させるサイズを拡張するものだったので、さっそく使ってみた。
WordPressと組み込まれている主なJavaScriptライブラリのバージョン一覧（2018年5月27日 更新）
WordPressの更新が遅れていたサイトを少し前に更新したところ、jQuery UI sortableを使って拡張したページに不具合が発生しました。WordPressの更新に伴って内部のjQuery UIが更新されたことに起因すると思われ、これを機にWordPressとそれに組み込まれたJavaScriptライブラリのバージョンを確認してみました。
投稿日の検索が自由自在に（2015年3月7日 更新）
WordPress 3.7.0ではWP_Date_Queryクラスが追加され、WP_Queryクラス（もちろん query_posts関数でも）で利用できるようになった。このWP_Date_Queryにより、○年○月○日以前や以降の投稿情報を取得したり、○年○月○日から○年○月○日の範囲の投稿情報を取得したりといったことが、容易に行えるようになった。
新テーマ「Twenty Twenty-Three」にはfunctions.phpがない（2022年10月6日 更新）
WordPress 6.1に同梱された新テーマ「Twenty Twenty-Three」を見てみると、そこには見慣れたfunctions.phpがない。Full Site Editing（FSE）対応テーマってこんな感じなのかと思いつつ、テーマの設定がどうなっているのか調べてみた。
WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。