Quick Template Tag
普段使うテンプレートタグを、使用途別にコピー・ペーストで使えるようにしただけのものです。使っているテンプレートタグはそんなに多くないですね。
ページナビのリンク表示
投稿記事の表示数がページ内に収まらないときに、前後のページへリンクするナビリンクを表示します。1ページの表示件数は管理画面の表示設定で指定できます。
<?php posts_nav_link('A','B','C'); ?>
PARAMETER or OTHER
A … sep : 前後リンクの区切り文字を指定
B … prelabel : 前へのリンクに表示する(テキスト)を指定
※初期設定 : « Prelabel Page
C … day : 後へのリンクに表示する(テキスト)を指定
※初期設定 : Next Page »
■テンプレート記述例
<?php posts_nav_link('|', '<< BACK', 'NEXT >>'); ?>
■画面表示例
<< BACK|NEXT >>
条件分岐で特定ページだけに表示させる
条件分岐を使えば、同じPHPテンプレートでカテゴリーによって表示するタイトルを変えたり、特定のページだけループを適応させたりできるので、ページデザインの一部を変えたりするの使用します。
※関数、パラメータは常時使用の一部のみ掲載しています。
<?php if(関数): ?>
<!------テキストまたはテンプレートタグ------>
<?php endif; ?>
PARAMETER or OTHER
■関数(通常使用の一部のみ掲載)
is_home() : メインページを表示する場合は
is_single('A') : Aで指定したシングルページを表示する場合は
is_page('B') : Bで指定したページ記事を表示する場合は
is_category('C') : Cで指定したカテゴリーページを表示する場合は
in_category('D') : Dで指定したカテゴリーに属したページを表示する場合は
is_search() : 検索結果のページを表示する場合は
is_404() : 404のページを表示する場合は
■パラメータ
A … post : 記事のID、タイトル、スラッグを指定
B … page : ページ記事のID、タイトル、スラッグを指定
C … category : カテゴリーのID、タイトル、スラッグを指定
※A、B、C は複数の指定ができます。
D … category_id : カテゴリーのIDを指定
■テンプレート記述例
<?php if(in_category('1')): ?>
こんにちは
<?php endif; ?>
<?php if(in_category('2')): ?>
さようなら
<?php endif; ?>
■画面表示例
カテゴリー1に属する記事を表示しているときは「こんにちは」のコメントを、カテゴリー9に属する記事を表示しているときは「さようなら」のコメントを表示します。
これ以外のカテゴリーを表示している時を、コメントは表示しません。
■複数を指定する場合は array を使って , で区切ります。
<?php if(in_category(array('1','2','3'))): ?>
こんにちは!
<?php endif; ?>
※カテゴリー1と2と3に属する記事だけ「こんにちは!」を表示します。
カテゴリーメニューの表示
このページの左に表示しているメニューで、シンプルで分かりやすいのでよく使います。矢印とか文字の太さは CSS で設定しています。
※パラメータは常時使用の一部のみ掲載しています。
<?php wp_list_categories('A&B&C...クエリ形式で記述'); ?>
PARAMETER or OTHER
A … show_option_all : カテゴリー記事すべてを表示するリンク文字指定
※すべての記事やALL POSTなど、任意の文字を入力します
B … order : 表示順を指定
ASC : 昇順で表示 ※初期設定
DESC : 降順で表示
C … orderby : 並び順を指定
ID : ID順で表示
name : カテゴリー名順で表示 ※初期設定
count : 記事数順で表示
D … show_count : 記事数の表示、非表示を指定
1 : 表示する
0 : 表示しない ※初期設定
E … hide_empty : 記事の無いカテゴリーの表示、非表示を指定
1 : 表示する ※初期設定
0 : 表示しない
F … child_of : 指定カテゴリーの子カテゴリーを表示
ID数値 : 表示する親カテゴリーのID
G … exclude : 表示しないカテゴリーを指定
ID数値 : 表示しないカテゴリーのID
H … hierarchical : 子カテゴリーの表示形式を指定
1 : 親カテゴリーの直下に「入れ子」で表示
0 : 親カテゴリーと同じ形式で表示
I … depth : 表示するカテゴリー階層を指定
数値 : (階層を2以上の数字で指定)階層まで表示
0 : すべて表示 ※初期設定
-1 : すべてをインデントなしで表示
1 : 最上位カテゴリーのみ表示
■テンプレート記述例
<?php wp_list_categories('hide_empty=0&orderby=name&exclude=1'); ?>
■画面表示例
記事の無いカテゴリーは非表示、カテゴリー名順に表示、カテゴリー1は非表示でカテゴリー一覧を表示します。
いままで使っていた wp_list_cats が非推奨になっていた(汗)パラメータも変更になっていたので、2.6対応で修正しました。この他のパラメータ、設定詳細は WordPress Codex 日本語版、ガイドブックを参照ください。
参考 : WordPress テンプレートタグ虎の巻 エ・ビスヒロ・テック・ラボ著
NEXT >>