WordPressでよく使われる初歩的なテンプレートタグを覚えよう
WordPressを使って自作テーマを作ったり、カスタマイズしたりする時など、WordPressに用意されている様々なテンプレートタグを使用することが必要となってきます。今回はその中でも特に使用頻度が高いと思われる、初歩的なテンプレートタグをいくつかまとめましたのでご紹介します。
先にポイント:テンプレートタグは、情報を出力する命令
- PHPのテンプレートタグで、ページに記事の情報を出力できます
- よく使うのは3つ:
the_title()はタイトル、the_content()は本文、the_category()はカテゴリーです - パラメーターの指定がなければ、省略しても問題ありません
WordPressのテンプレートタグの書き方
WordPressではPHP ( PHP: Hypertext Preprocessor ) で記述されたテンプレートタグを実行することで、ページに様々な情報を出力することができます。

パラメーターの値に特に指定がない場合は記述を省略しても問題ありません。
テンプレートタグの詳しい説明はこちら。WordPress公式 テーマハンドブック「テンプレートタグ」
テンプレートタグを使ってみよう
<?php the_title(); ?>
<?php the_title(); ?>the_title();は記事のタイトル部分を出力するテンプレートです。WordPress内のメニュー【投稿>投稿一覧】の各投稿にあるタイトル部分を出力します。
<h1><?php the_title(); ?></h1>このように記述すると、タイトル部分を<h1>でマークアップする事ができます。また、この<h1>はパラメーターの値に指定することも可能です。
<?php the_title( '<h1>', '</h1>' ); ?>このように記述すると、先ほど<h1>で括ったものと同じ結果になります。テーマの書き方などは状況に合わせて使い分けてみてください。
<?php the_content(); ?>
<?php the_content(); ?>the_content();は投稿内の本文を出力するテンプレートタグです。本文は自動的に<p>でマークアップされて出力されます。
<?php the_category(); ?>
<?php the_category(); ?>記事に設定したカテゴリー部分を出力するテンプレートタグです。各カテゴリーへのリンクと<ul><li>が自動でマークアップされます。カテゴリーを複数設定している場合は全て出力されます。
<?php the_category( '-' ); ?><ul><li>が不必要な場合は、パラメータの値にハイフンを入力すると、<ul><li>ではマークアップされなくなります。テーマの状況に合わせて使い分けてみましょう。
<?php body_class(); ?>
<?php body_class(); ?><body>にページのIDやカテゴリー、プラグイン情報などをclassで出力するためのテンプレートタグです。
<body <?php body_class(); ?>>このように<body>の中にテンプレートタグを書きます。
<?php post_class(); ?>
<?php post_class(); ?>こちらは記事のclassを出力するためのテンプレートタグです。
<section <?php post_class(); ?>>
<article <?php post_class(); ?>><section>や<article>など、記事をマークアップしたタグに挿入することでclassを出力します。
ほかにもよく使うテンプレートタグ
記事ページや一覧ページを作るときによく使うテンプレートタグをまとめました。使い方は、これまでのタグと同じです。
- the_permalink();:記事のURLを出力します。一覧ページで、記事へのリンクを作るときに使います。
- the_time();:投稿日を出力します。
the_time( 'Y.m.d' );のように、日付の形式も指定できます。 - the_post_thumbnail();:アイキャッチ画像を出力します。テーマ側でアイキャッチ画像を有効にしておく必要があります。
- the_excerpt();:記事の抜粋を出力します。一覧ページで本文の冒頭だけを見せたいときに便利です。
- the_author();:記事の投稿者名を出力します。
- bloginfo( ‘name’ );:サイト名を出力します。ヘッダーのロゴ部分などで使います。
- home_url( ‘/’ );:トップページのURLを返します。出力するときは
echo esc_url( home_url( '/' ) );と書きます。
「the_〜」と「get_the_〜」の違い
テンプレートタグには、the_title();とget_the_title();のように、よく似た名前のものがあります。「the_〜」は値をそのまま画面に出力し、「get_the_〜」は値を返すだけで出力はしません。取得した値を加工したいときは「get_the_〜」を使いましょう。
<?php
// そのまま出力する
the_title();
// 値を受け取ってから出力する
$title = get_the_title();
echo '<h2>' . esc_html( $title ) . '</h2>';
?>気になるギモン
テンプレートタグはどのファイルに書けばいいですか?
single.php(記事ページ)やindex.php・archive.php(一覧ページ)など、テーマのテンプレートファイルに書きます。記事の情報を出すタグは、ループの中に書きましょう。
テンプレートタグを書いても何も表示されません。
ループの外に書いていないか、そのテンプレートファイルが実際に使われているかを確認しましょう。the_post_thumbnail();の場合は、記事にアイキャッチ画像が設定されているかも確認が必要です。
ブロックテーマでもテンプレートタグは使えますか?
ブロックテーマでは、タイトルや本文、日付などを「投稿タイトル」「投稿コンテンツ」といったブロックで配置するため、テンプレートタグを直接書く場面はほとんどありません。この記事の書き方は、PHPのテンプレートファイルを使うクラシックテーマ向けです。
まとめ
WordPressで使用するテンプレートタグはまだまだたくさんありますが、今回は初歩的なテンプレートタグをいくつかご紹介しました。これから初めてWordPressでテーマを作ったり、カスタマイズするといった方は、覚えておくと作業が捗ると思いますので、ぜひとも覚えてくださいね。
関連する記事もあわせてどうぞ。






