この記事は最後に更新してから1年以上経過しています。

wp_titleからwp_get_document_titleへ

説明

先週、WordPress 4.4 beta1(以降4.4 beta1)が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

はじめに、この記事の内容は4.4 beta1のソースコードをもとにしており、正式リリース時には変わる可能性があることをあらかじめお断りしておきます。

wp_titleが4.4で非推奨にwp_titleはけっきょく非推奨にならないっぽい

wp-includes/deprecated.phpによると、4.4で非推奨になる関数は次の4つ3つとなっています。

廃止予定の関数名定義された
バージョン
廃止予定になった
バージョン
代替関数など
post_permalink1.0.04.4.0 get_permalink
wp_get_http2.5.04.4.0WP_Httpクラス
force_ssl_login2.6.04.4.0 force_ssl_admin
wp_title1.0.04.4.0 add_theme_support

ページタイトルを出力する関数として長らく使用されてきたwp_title関数が、非推奨になったのはちょっと驚きですね。代わりにadd_theme_support関数が追加され、今後はこちらを利用することになりそうです。wp_title関数は結局のところ非推奨にならないようです(beta4で復帰)。現在のテーマのafter_setup_themeアクションで以下のようにadd_theme_support関数を使っている場合は影響ありませんが、今後のことを考えると直接wp_title関数を使っているテーマはそろそろadd_theme_support関数に切り替える必要がありそうです。

add_theme_support( 'title-tag' );

最終更新 : 2018年05月27日 10:45


お勧め

get_the_post_thumbnail_caption(2018年5月27日 更新)

string get_the_post_thumbnail_caption( mixed $post = null )
投稿ページのサムネイル(アイキャッチ画像)キャプションを取得する。

wp_enqueue_style(2019年11月25日 更新)

void wp_enqueue_style( string $handle [ , string $src = false [ , array $deps = array() [ , string $ver = false [ , string $media = 'all' ] ] ] ] )
使用するスタイルシート(CSS)を出力用のキューに入れる。パラメータ$srcが指定された場合は、グローバル変数$wp_stylesに登録してから出力用のキューに入れる。

post_class(2018年5月27日 更新)

void post_class( [ string $class = '' [ , int $post_id = null ] ] )
投稿情報の種別に応じたクラス属性(class="post-?? post ...")を表示する。具体的なクラス名は、投稿ID(post-番号)、投稿種別(postやpage)、カテゴリー(category-名前)、タグ(tag-名前)などがある。これらクラス名に合わせたCSSを準備することで、投稿ページのユニークなデザインが表現可能になる。

get_header(2020年8月18日 更新)

void | false get_header( [ string $name = null [ , array $args = array() ] ] )
ヘッダパーツを記述したメインヘッダファイルheader.php(またはサブヘッダファイルheader-???.php)を読み込む。

get_the_excerpt(2018年5月27日 更新)

string get_the_excerpt( [ mixed $post = null$deprecated = '' ] )
投稿情報の抜粋記事を取得する。