現役エンジニアが厳選！WordPressテーマ開発に使うテンプレートタグ全集

みなさんこんにちは！エンジニアの高澤です！

今回はWordPressテーマ開発に使うテンプレートタグ全集について解説していきたいと思います。

テンプレートタグとはWordPressで用意された専用の関数のことをいいますが、このテンプレートタグはテーマ開発はもちろん、プラグイン開発などにも必ず使用する必須の知識になります。

必須なだけに、初心者エンジニアの方にとっては「テンプレートタグはたくさんありすぎて学習したいけど一体どのテンプレートタグがテーマ開発で必要なのか？」

また上級者エンジニアの方にとっては「テンプレートタグがたくさんありすぎて忘れてるから仕事ですぐに使えるチートシートが欲しい！」

といった問題やご要望があるかと思います。

今回の記事はそこを解決する構成で現役エンジニアのわたくし高澤が力を入れて執筆いたしました。

よろしければぜひ当記事をお仕事などにお役立ていただけましたら幸いです。

テンプレートタグとは

テンプレートタグとは、WordPressで用意された専用の関数のことをいいます。

WordPressのコアの内部では、WordPressのデータベースに保存されたデータを出力したり取得したりといったデータベース操作を簡単にしてくれるAPIという目的で、専用のテンプレートタグという関数を定義しています。

このテンプレートタグを使えば、以下のような関数一つ記述するだけで記事のタイトルや記事の本文などを簡単に表示することが可能です。

<!-- the_title(): 現在の投稿やページのタイトルを表示します。 -->
<h1><?php the_title(); ?></h1>

<!-- the_content(): 現在の投稿やページのコンテンツを表示します。 -->
<div class="entry-content">
    <?php the_content(); ?>
</div>

<!-- the_post_thumbnail(): 現在の投稿やページのアイキャッチ画像（投稿サムネイル）を表示します。 -->
<?php if ( has_post_thumbnail() ) : ?>
    <div class="post-thumbnail">
        <?php the_post_thumbnail(); ?>
    </div>
<?php endif; ?>

<!-- the_author(): 現在の投稿やページの著者を表示します。 -->
<p>投稿者: <?php the_author(); ?></p>

<!-- the_time(): 現在の投稿やページの投稿日時を表示します。 -->
<p>投稿日: <?php the_time('Y年m月d日'); ?></p>

<!-- wp_nav_menu(): ナビゲーションメニューを表示します。 -->
<?php wp_nav_menu( array( 'theme_location' => 'primary' ) ); ?>

上記コードのように、たった一つの関数を書くだけで必要なデータを表示することができてしまいます。

このテンプレートタグは数千ほどの非常に膨大な数があるので、すべてを習得することは現実的ではありません。

そのため、当記事では現役エンジニアであるわたくし高澤が本当にお仕事に必要な厳選したテンプレートタグをご紹介したいと思います。

テンプレートタグを知っておくメリット

テンプレートタグを知っておくべきメリットについて解説いたします。

筆者が考えるメリットは以下になります。

• テーマを開発できる
• プラグインを開発できる
• データ処理の効率化や管理画面カスタマイズなどの応用力がつく

テンプレートタグを知っておくことで、問題なくテーマ開発をできるようになり、またフックというWordPress専用の仕組みと組み合わせればプラグインを開発することも可能です。

また、データ処理の効率化や管理画面カスタマイズなどの応用力がつき、WordPressを自由自在にカスタマイズすることができます。

テンプレートタグが定義されたコアファイル

テンプレートタグはWordPress本体に定義されているため使用することが可能です。

このテンプレートファイルが定義されているファイルは、WordPressコアファイルを構成するものの一つであるwp-includesファイル内のPHPファイルに定義されております。

具体的には以下になります。

• wp-includes/general-template.php
• wp-includes/author-template.php
• wp-includes/bookmark-template.php
• wp-includes/category-template.php
• wp-includes/comment-template.php
• wp-includes/link-template.php
• wp-includes/post-template.php
• wp-includes/post-thumbnail-template.php
• wp-includes/nav-menu-template.php

上記内容を把握しておくことで、今後応用をきかせて実際に上記PHPファイルを開いて、どのような関数が定義されているのか、どのような処理が記述されているのかを確認して色々と対応することが可能となります。

WordPress構築で知っておくべきテンプレートタグ

それでは早速、WordPressのテーマ開発やプラグイン開発で知っとくべきテンプレートタグを解説していきたいと思います。

もしお仕事で必要になったらよろしければぜひ当記事をご確認いただきながら快適に開発をしていただけましたら幸いです。

それではジャンル別に確認していきましょう。

インクルード系

コンテンツ系

タグ出力系

条件分岐タグ系（クエリフラグ取得系）

投稿タイプの主なAPI

カスタムフィールドの主なAPI

タクソノミーの主なAPI

コメントの主なAPI

コメントのカスタムフィールドAPI

ユーザーの主なAPI（WP_Roles）

WP_Rolesは、WordPressのユーザーロールと権限管理を管理するクラスです。

以下に、WP_Rolesの各メソッドについてご説明いたします。

ユーザーの主なAPI（WP_User）

WP_Userは、WordPressのユーザーを表すクラスです。

以下に、WP_Userの各メソッドについてご説明いたします。

トップメニューにメニューを追加する主なAPI

サブメニューにメニューを追加する主なAPI

Settings API

バリデーションの関数

サニタイズの関数

オプションAPI

JavaScript管理の主なAPI

CSS管理の主なAPI

Object Cache API

Transients API

マルチサイト特有の関数

国際化するための関数

テーマのPHPテンプレートファイル以外のPHPファイルでテンプレートタグを使用可能にする方法

WordPressをインストールしたトップディレクトリ以降のサーバー階層の中に、任意でPHPファイルを作成し、ファイルの先頭付近に以下のコードをコピー＆ペーストしてください。

<?php require_once($_SERVER['DOCUMENT_ROOT']."/【サイトディレクトリ】/wp-load.php");?>

上記のコードをコピー＆ペーストしていただき保存していただくことで、ペーストした上記コードの下からはWordPressのテンプレートタグが使えるようになり、WordPressループなどWordPress独自の実装をおこなうことができます。

これはいざというときに便利なので、ぜひ覚えておきましょう。

まとめ

WordPressテーマ開発に使うテンプレートタグ全集についての解説は以上になります。

テンプレートタグとはWordPressで用意された専用の関数のことをいい、テンプレートタグはテーマ開発はもちろん、プラグイン開発などにも必ず使用する必須の知識になります。

テンプレートタグの数は非常に膨大で全てを覚えることはとても現実的ではありません。

また、初心者エンジニアの方からしたら一体何のテンプレートタグを覚えなければならないのか、また、上級者エンジニアの方からしたら仕事で使えるチートシートのようなものが欲しい、という疑問やご要望があるかと思います。

当記事ではそんな問題を解説するため、テンプレートタグについて現役エンジニアがこれまでの仕事の経験から厳選したテンプレートタグをご紹介いたしました。

よろしければぜひ当記事をご活用いただけましたら幸いです。