y.o.designers-works

WordPressでよく使うテンプレートタグのまとめ

WordPressテンプレートタグ、関数は、数多くあり全て覚えるのは大変です。
なのでよく使うテンプレートタグと関数は自分でチートシートを作るなり、ブログ上にまとめたりするのが良いかと思いましたのでまとめました。

必須のテンプレートタグ

用途 挿入箇所 テンプレートタグ
プラグイン動作用 head閉じタグ前 <?php wp_head(); ?>
プラグイン動作用 body閉じタグ前 <?php wp_footer(); ?>

これがないとプラグインが動かなかったりします。オリジナルテーマを一から作成すると抜けやすいので注意すること

ファイルのインクルードタグ

インクルードするファイル テンプレートタグ
header.php <?php get_header(); ?>
footer.php <?php get_footer(); ?>
sidebar.php <?php get_sidebar(); ?>
comments.php <?php comments_template(); ?>
searchform.php <?php get_search_form(); ?>
任意のテンプレートファイル名.php <?php get_template_part(‘任意のファイル名’); ?>

WordPress基本情報系タグ

用途 記入例
ブログ名 <?php bloginfo(‘name’); ?>
文字コード指定 <meta charset=”<?php bloginfo(‘charset’);" ?>
タイトル <title><?php wp_title(); ?></title>
ブログのURL <?php echo home_url(); ?>
スタイルシートのURL <link rel="stylesheet" href="<?php echo get_stylesheet_directory_uri();”> ?>
テーマのルートディレクトリ <?php echo get_template_directory_uri(); ?>

記事のループ内でよく使うタグ

用途 記入例
投稿内容を表示させる <?php the_content(); ?>
記事の抜粋を表示 <?php the_excerpt(); ?>
記事のURL <?php the_permalink(); ?>
記事の投稿日時(投稿日が重複してる場合は最初の1記事のみ) <?php the_date(); ?>
記事の投稿日時 <?php the_time(); ?>
記事の投稿者名 <?php the_author(); ?>
記事の投稿者名とリンクを出力 <?php the_author_posts_link(); ?>

アーカイブ(カテゴリ、タグ)関連のタグ

用途 記入例 備考
リンク付きカテゴリーリストを表示する。 <?php wp_list_categories( $args ); ?> カスタム投稿タイプのカテゴリも表示できる
現在の記事が属するカテゴリーへのリンクを表示 <?php the_category(); ?> ループの中で使用する
指定したカテゴリーIDのURLへのリンクを生成 <?php get_category_link( $category_id ); ?> 存在しないカテゴリーIDを使用した場合、親ディレクトリへのリンクを返す
ページタイトル(カテゴリー名またはタグ名)を表示 <?php single_cat_title( ”, true ); ?> ループの外側で使用する
現在の記事に付けられたタグを表示する <?php the_tags(); ?> そのタグのアーカイブページへリンクする
現在の投稿タイプのアーカイブページのタイトルを表示または取得する <?php post_type_archive_title(); ?> カスタム投稿タイプのタイトルを表示する
投稿タイプのアーカイブのためのパーマリンクを取得する <?php get_post_type_archive_link( $post_type ); ?> 投稿タイプを指定する
指定された(タクソノミー)タームのアーカイブページへのパーマリンクを返す <?php get_term_link( $term, $taxonomy ); ? > タクソノミーのスラッグを指定する
アーカイブリストの出力(投稿) <?php wp_get_archives( ‘type=monthly’ ); ?> 月別が初期値だが年別、週別、日別なども指定化

マルチサイト構築時に便利なタグ

用途 記入例 備考
親サイトのトップページURL <?php network_home_url(); ?> <?php echo get_theme_root_uri(); ?>は子サイトのTOPページURL
現在のブログとは違う子ブログの情報を表示 <?php switch_to_blog($blog_id) ?> 切り替え後、戻すときは、<?php restore_current_blog() ?>

まとめ

WordPressのテンプレートタグは、気がつくと新しいものが公開されていたり、便利なテンプレートタグがあったりするので情報収集はまめにしたいと思います。

スポンサーリンク

他にオススメな記事