wordpress

WordPressテンプレートタグ・チートシート

2016年5月27日  

インクルードタグ

テンプレートファイルの中で他のテンプレートファイルを読み込むときに使用するテンプレートタグ

プラグイン動作用ヘッダータグ

プラグインの動作に必要なテンプレートタグであり、プラグインが使用する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'); ?>>

参考ページ:body_class を使ってページごとに違う表示をする

ヘッダーテンプレートタグ

「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; ?>