WordPressサイトを作成する時に、必ず必要になってくるのが、テンプレートタグです。今回はWordPressテーマ作成時に自分がよく使うテンプレートタグをまとめてみました。
主に自分がよく忘れてしまうのでまとめたものです。便利なテンプレートタグを発見すれば随時追加していこうかと思います。もし参考になればご活用ください。
インクルードタグ
WordPressに必要なメタ情報取得（ヘッダー用）
プラグインを使用する時に、必要なJavascriptなどを読み込むのに必要。
WordPressに必要なメタ情報取得（フッター用）
プラグインを使用する時に、必要なJavascriptなどを読み込むのに必要。
header.phpを取得
テンプレートファイルheader.phpを取得。
sidebar.phpを取得を取得
テンプレートファイルsidebar.phpを取得。
footer.phpを取得
テンプレートファイルfooter.phpを取得。
コメントフォームを取得
comments.phpがあれば取得、なければWP標準のコメントフォーム取得。
検索フォームを取得
searchform.phpがあれば取得、なければWP標準の検索フォーム取得。
テーマフォルダ内の別PHPファイルを取得
何度も使う部分を外部PHP化してこのget_template_part()で読み込めば、メンテンンス性が高まります。ひとつのファイルを修正すれば全部に反映されてとても便利。
インクルードタグをもっと詳しく調べたい人は WordPress Codex 日本語版: インクルードタグ をご参照ください。
テンプレートタグ
文字コード指定
サイトの文字コードを取得。
bodyタグに付与するクラス付与
表示される各ページの<body>にページごとのclassを付与。
サイトのタイトル取得
管理画面の「設定」 → 「一般」で設定された「サイトタイトル」を表示。
サイトのURL取得
style.cssのURLを取得
テーマフォルダ内のstyle.cssのURLを取得。
テーマフォルダのURL取得
ディスクリプション取得
管理画面の「設定」 → 「一般」で設定された「キャッチフレーズ」を表示。
投稿・固定ページのタイトルを取得
投稿・固定ページの本文を取得
ページのパーマリンクを取得
記事のカテゴリを取得
記事の更新日を取得
記事の投稿日を取得
記事の著者情報を取得（ニックネーム取得の場合）
記事のタグを取得
アーカイブタイトル取得
テーマフォルダのURLを取得（※WP4.7以降）
下記記述でテーマフォルダの/images/sample.pngの画像ファイルのURL取得。
カスタムメニューを取得
管理画面の「外観」 → 「メニュー」で設定された「カスタムメニュー」を表示。下記記述でメニュー名main-menuという名前のカスタムメニューを取得。
PHP内でショートコードを取得
投稿ページや固定ページなどの編集画面で使うシュートコードをPHP内で所得。
テンプレートタグをもっと詳しく調べたい人は WordPress Codex 日本語版: テンプレートタグ をご参照ください。
条件分岐タグ
メインページかどうかを判別
メインページの場合 // コンテンツを表示部分に記載した内容を表示。
フロントページかどうかを判別
フロントページの場合 // コンテンツを表示部分に記載した内容を表示。
記事ページかどうかを判別
記事ページの場合 // コンテンツを表示部分に記載した内容を表示。
固定ページかどうかを判別
固定ページの場合 // コンテンツを表示部分に記載した内容を表示。
カテゴリのアーカイブページかどうかを判別
カテゴリアーカイブページの場合 // コンテンツを表示部分に記載した内容を表示。
タグのアーカイブページかどうかを判別
タグアーカイブページの場合 // コンテンツを表示部分に記載した内容を表示。
アーカイブページかどうかを判別
アーカイブページの場合 // コンテンツを表示部分に記載した内容を表示。
複数にわたるページの2ページ目以降がどうかを判別
複数にわたるページの2ページ目以降の場合 // コンテンツを表示部分に記載した内容を表示。
検索結果ページかどうかを判別
検索結果ページの場合 // コンテンツを表示部分に記載した内容を表示。
404 Not Foundページかどうかを判別
404 Not Foundページの場合 // コンテンツを表示部分に記載した内容を表示。
モバイル（タブレット含む）かPCかを判別
モバイルでアクセスした場合 // ここにモバイル用コンテンツを表示部分に記載した内容を表示、PCでアクセスした場合 // ここにPC用コンテンツを表示部分に記載した内容を表示。
テンプレートタグをもっと詳しく調べたい人は WordPress Codex 日本語版: 条件分岐タグ をご参照ください。