WordPressテンプレートタグ・チートシート
インクルードタグ
テンプレートファイルの中で他のテンプレートファイルを読み込むときに使用するテンプレートタグ。
プラグイン動作用ヘッダータグ
プラグインの動作に必要なテンプレートタグであり、プラグインが使用するcssやjsファイルを自動で出力するために、head終了タグの直前に挿入する。
<?php wp_head(); ?> </head>
プラグイン動作用フッタータグ
プラグインの動作に必要なテンプレートタグであり、プラグインが使用するcssやjsファイルを自動で出力するために、body終了タグの直前に挿入する。
<?php wp_footer(); ?> </body>
body要素用のテンプレートタグ
表示するページの種類(フロントページ・固定ページなど)によってbodyに自動的にクラスを追加する。
<body <?php body_class(); ?>>
独自のクラス名：classnameを追加したいときは下記のように記述する。
<body <?php body_class('classname'); ?>>
ヘッダーテンプレートタグ
「head.php」ファイルを読み込む。
<?php get_header(); ?>
サイドバーテンプレートタグ
「sidebar.php」ファイルを読み込む。
<?php get_sidebar(); ?>
「sidebar-top.php」ファイルを読み込む場合。
<?php get_sidebar('top'); ?>
フッターテンプレートタグ
「footer.php」ファイルを読み込む。
<?php get_footer(); ?>
コメントテンプレートタグ
「comments.php」ファイルを読み込む。
<?php comments_template(); ?>
検索フォームのテンプレートタグ
「searchform.php」ファイルを読み込む。
<?php get_search_form(); ?>
任意のテンプレートファイルの呼び出しテンプレートタグ
「failename.php」ファイルを読み込む。(ファイル名自由)
<?php include( TEMPLATEPATH . '/failename.php' ); ?>
「loop.phpとloop-2.php」ファイルを読み込む。
<?php get_template_part( 'loop' ); ?>
<?php get_template_part('loop', '2'); ?>
出力テンプレートタグ
基本情報を出力するテンプレートタグ。
タイトルテンプレートタグ
投稿記事・固定ページのタイトルを表示する。
<?php the_title(); ?>
title属性に記事のタイトルを付ける。
<?php the_title_attribute(); ?>
カテゴリーページ等のページのタイトルを表示する。
<?php wp_title(''); ?>
本文テンプレートタグ
投稿記事の本文を表示する。moreタグがある場合はsingleページ以外では概要文のみを表示し、「続きを読む」リンクをつけられて出力される。
<?php the_content(); ?>
<?php the_content('続きはこちら'); ?>
抜粋テンプレートタグ
投稿記事の抜粋110文字を表示する。
<?php the_excerpt(); ?>
文字数制限テンプレートタグ
記事の本文の文字数を制限して表示する。(120文字で区切って超える場合は語尾に…を追加)
<?php echo mb_substr(strip_tags($post-> post_content),0,120).'...'; ?>
投稿時間テンプレートタグ
投稿記事の投稿時間を表示。管理ページの一般設定から時刻フォーマットを選択した形式で出力される。
<?php the_time(); ?>
投稿日時を表示する具体例を下記に示す。
<?php the_time( 'Y年m月d日' ); ?>
投稿日時テンプレートタグ1
投稿記事の投稿日時を表示。管理ページの一般設定から日付フォーマットを選択した形式で出力される。
同じ日に複数の記事が投稿されている場合は、最初の記事にだけ日付を表示します。
<?php the_date(); ?>
投稿日時テンプレートタグ2
投稿記事の投稿日時を表示。管理ページの一般設定から日付フォーマットを選択した形式で出力される。
同じ日に複数の記事が投稿されている場合は、すべての記事に日付を表示します。
<?php echo get_the_date(); ?>
ナビゲーションメニューテンプレートタグ
管理画面のメニューで作成したナビゲーションメニューを表示します。
<?php wp_nav_menu(); ?>
パーマリンクテンプレートタグ
投稿記事のパーマリンクURLを表示する。
<?php the_permalink(); ?>
カテゴリーテンプレートタグ
投稿記事のカテゴリーをリンク付きで表示する。
<?php the_category(); ?>
タグテンプレートタグ
投稿記事のタグを表示する。
<?php the_tags(); ?>
著者名テンプレートタグ
投稿記事の著者名を表示する。
<?php the_author(); ?>
著者名リンクテンプレートタグ
投稿記事の投稿者名とリンクを出力する。
<?php the_author_posts_link(); ?>
記事IDテンプレートタグ
投稿記事の記事IDを表示する。
<?php the_ID(); ?>
ページリンクテンプレートタグ
前後のページへのリンクを表示する。
<?php posts_nav_link(); ?>
前後のページへのリンクを表示する具体例を下記に示す。
<?php posts_nav_link(' | ','前の記事','次の記事'); ?>
次へのページリンクテンプレートタグ
投稿記事ページで次の記事へのリンクを表示する。
<?php next_post_link(); ?>
前へのページリンクテンプレートタグ
投稿記事ページで前の記事へのリンクを表示する。
<?php previous_post_link(); ?>
検索文字列テンプレートタグ
検索文字列を表示する。
<?php the_search_query();?>
カレンダーテンプレートタグ
カレンダーを表示。投稿のある日付は日別アーカイブへリンクする。
<?php get_calendar(); ?>
ページ一覧テンプレートタグ
リンク付きページ一覧を表示する。
<?php wp_list_pages(); ?>
カテゴリ一覧テンプレートタグ
リンク付きカテゴリ一覧を表示する。
<?php wp_list_categories(); ?>
タグクラウドテンプレートタグ
タグクラウドを表示する。
<?php wp_tag_cloud(); ?>
タグクラウドを表示する具体例を下記に示す。
<?php wp_tag_cloud('smallest=10&largest=20'); ?>
アーカイブリストテンプレートタグ
日付に基づくリンク付きアーカイブリストを表示する。
<?php wp_get_archives(); ?>
bloginfoテンプレートタグ
ファイルまでのパス・URLや管理画面で設定したブログ情報などのさまざまな情報を、文字列として出力するテンプレートタグ。
ブログURLテンプレートタグ
ブログのURLを出力する。
<?php bloginfo('url'); ?>
<?php echo home_url(); ?>
タイトルテンプレートタグ
「一般設定」管理画面で指定したブログのタイトルを出力する。
<?php bloginfo('name'); ?>
キャッチフレーズテンプレートタグ
「一般設定」管理画面で指定したブログの説明文・キャッチフレーズを出力する。
<?php bloginfo('description'); ?>
メールアドレステンプレートタグ
「一般設定」管理画面で指定したブログのメールアドレスを出力する。
<?php bloginfo('admin_email'); ?>
スタイルシートテンプレートタグ
スタイルシートのディレクトリのURIを出力する。
<?php bloginfo( 'stylesheet_directory' ); ?>
<?php echo get_stylesheet_directory_uri(); ?>
スタイルシートテンプレートタグ
スタイルシート(style.css)のURIを出力する。
<?php bloginfo('stylesheet_url'); ?>
<?php echo get_stylesheet_uri(); ?>
ディレクトリテンプレートタグ
テーマファイルディレクトリのURLを出力する。
<?php bloginfo('template_url'); ?>
<?php bloginfo( 'template_directory' ); ?>
<?php echo get_template_directory_uri(); ?>
RSSテンプレートタグ
RSS2.0形式のメインフィードURLを出力する。
<?php bloginfo('rss2_url'); ?>
Atomテンプレートタグ
Atom形式のメインフィードURLを出力する。
<?php bloginfo('atom_url'); ?>
コメントフィードテンプレートタグ
RSS2.0形式のコメントフィードURLを出力する。
<?php bloginfo('comments_rss2_url'); ?>
文字コードテンプレートタグ
「表示設定」管理画面で指定された文字コードを出力する。
<?php bloginfo('charset'); ?>
バージョンテンプレートタグ
現在使用中のWordPressのバージョンを出力する。
<?php bloginfo('version'); ?>
Content typeテンプレートタグ
メディアタイプ“Content-type”の設定値を出力する。
<?php bloginfo('html_type'); ?>
条件分岐タグ
条件分岐タグはif文を使ってどのページかどうか、表示される内容がどうかを判断するタグ。
記事の有無
表示する記事があるかどうかを判定する。
<?php if(have_posts()): ?> // 処理内容 <?php endif; ?>
メインブログページの条件分岐
「表示設定」管理画面のフロントページの表示で設定してないとき、メインブログページかどうかを判定する。
<?php if(is_home()): ?> // 処理内容 <?php endif; ?>
サイトのフロントページの条件分岐
「表示設定」管理画面のフロントページの表示で設定したフロントページかどうかを判定する。
<?php if(is_front_page()): ?> // 処理内容 <?php endif; ?>
投稿記事ページの条件分岐
投稿記事のページかどうかを判定する。
投稿ID、投稿タイトル、投稿名をパラメータとして指定する。
<?php if(is_single('記事ID')): ?>
// 処理内容
<?php endif; ?>
固定ページの条件分岐
固定ページかどうかを判定する。
ページID、タイトル、スラッグをパラメータとして指定する。
<?php if(is_page('ページID')): ?>
// 処理内容
<?php endif; ?>
カテゴリーページの条件分岐
カテゴリーのアーカイブページかどうかを判定する。
<?php if(is_category('カテゴリID')): ?>
// 処理内容
<?php endif; ?>
アーカイブページの条件分岐
アーカイブページかどうかを判定する。
カテゴリー、タグ、作成者、日付をパラメータとして指定する。
<?php if(is_archive('カテゴリID')): ?>
// 処理内容
<?php endif; ?>
カテゴリーページの条件分岐
カテゴリーのアーカイブページかどうかを判定する。
カテゴリーID, カテゴリーのタイトル、カテゴリーのスラッグをパラメータとして指定する。
<?php if(is_category('カテゴリID')): ?>
// 処理内容
<?php endif; ?>
タグページの条件分岐
タグのアーカイブページかどうかを判定する。
タグのスラッグをパラメータとして指定する。
<?php if(is_tag()): ?> // 処理内容 <?php endif; ?>
日付ページの条件分岐
日付のアーカイブページかどうかを判定する。
<?php if(is_date()): ?> // 処理内容 <?php endif; ?>
ページ数の条件分岐
複数にわたるページのときに2ページ目以降かどうかを判定する。
<?php if(is_paged()): ?> // 処理内容 <?php endif; ?>
各ページの条件分岐
固定ページまたは個別投稿ページ、添付ファイルページかどうかを判定する。
パラメータを指定するとカスタム投稿タイプかどうか判断する。
<?php if(is_singular()): ?> // 処理内容 <?php endif; ?>
カスタム投稿タイプの条件分岐
カスタム投稿タイプのアーカイブページかどうかを判定する。
<?php if(is_post_type_archive()): ?> // 処理内容 <?php endif; ?>
ダッシュボードまたは管理パネルの条件分岐
ダッシュボードまたは管理パネルかどうかを判定する。
<?php if(is_admin()): ?> // 処理内容 <?php endif; ?>
404ページの条件分岐
404 Not Found ページかどうかを判定する。
<?php if(is_404()): ?> // 処理内容 <?php endif; ?>
前記事の条件分岐
前記事があるかどうか判定する。
<?php if(get_previous_post()): ?> // 処理内容 <?php endif; ?>
次記事の条件分岐
次記事があるかどうか判定する。
<?php if(get_next_post()): ?> // 処理内容 <?php endif; ?>
携帯・iPadの条件分岐
携帯かどうか判定する。iPadも携帯として認識される。
<?php if(wp_is_mobile()): ?> // 処理内容 <?php endif; ?>
