本文へスキップ
TYP create

WordPressでよく使われる初歩的なテンプレートタグを覚えよう

WordPress
WordPressでよく使われる初歩的なテンプレートタグを覚えよう

WordPressを使って自作テーマを作ったり、カスタマイズしたりする時など、WordPressに用意されている様々なテンプレートタグを使用することが必要となってきます。今回はその中でも特に使用頻度が高いと思われる、初歩的なテンプレートタグをいくつかまとめましたのでご紹介します。

先にポイント:テンプレートタグは、情報を出力する命令

  1. PHPのテンプレートタグで、ページに記事の情報を出力できます
  2. よく使うのは3つ:the_title()はタイトル、the_content()は本文、the_category()はカテゴリーです
  3. パラメーターの指定がなければ、省略しても問題ありません

WordPressのテンプレートタグの書き方

WordPressではPHP ( PHP: Hypertext Preprocessor ) で記述されたテンプレートタグを実行することで、ページに様々な情報を出力することができます。

WordPressのテンプレートタグの書き方

パラメーターの値に特に指定がない場合は記述を省略しても問題ありません。

テンプレートタグの詳しい説明はこちら。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でテーマを作ったり、カスタマイズするといった方は、覚えておくと作業が捗ると思いますので、ぜひとも覚えてくださいね。

関連する記事もあわせてどうぞ。

人気記事