カテゴリーリストを表示するWordPressテンプレートタグwp_list_categories()

初心者向けワードプレス作成方法とネットビジネスネタのメモサイト

MovableTypeを凌ぐ無料ブログツールWordPressの基本操作、カスタマイズ方法、プラグインなどの情報を提供

カテゴリーリストを表示するテンプレートタグwp_list_categories()

2008-03-28

WordPressでカテゴリーリストを表示するテンプレートタグが、
<?php wp_list_categories(); ?>
です。

wp_list_cats()を利用するのはやめて、wp_list_categories()を利用するように勧告されています。

リスト形式で表示されます。


<ul>
 <?php wp_list_categories(); ?>
</ul>

このテンプレートタグはパラメータ挿入ができます。

<?php wp_list_categories(‘①&②&③&~⑱’); ?>

①show_option_all
 投稿記事がある全カテゴリーのリンク表示を指定
  TRUE   ・・・ 表示(デフォルト) 
  FALSE  ・・・ 非表示

②orderby
 表示順序を指定
  ID    ・・・ カテゴリーid順
  name ・・・ カテゴリー名順(デフォルト)
  count ・・・ 投稿記事数順

③order
 表示順序の昇順、降順を指定
  asc  ・・・ 昇順(デフォルト)
  desc ・・・ 降順

④show_last_updated
 最新の投稿日時の表示を指定
  1(TRUE)   ・・・ 表示
  0(FALSE)  ・・・ 非表示(デフォルト)

⑤style
 リスト形式<li>での出力可否設定
  list   ・・・ リスト形式(デフォルト)
  none  ・・・ 改行タグで仕切り

⑥show_count
 投稿記事数の表示を指定
  1(TRUE)   ・・・ 表示 
  0(FALSE)  ・・・ 非表示(デフォルト)

⑦hide_empty
 投稿記事の無いカテゴリーの表示を指定
  1(TRUE)   ・・・ 非表示(デフォルト)
  0(FALSE)  ・・・ 表示

⑧use_desc_for_title
 aタグのtitle要素に、カテゴリー概要の挿入を設定
  1(TRUE)   ・・・ 表示 
  0(FALSE)  ・・・ 非表示(デフォルト)

⑨child_of
 指定した親カテゴリー配下の子カテゴリーの表示を指定
  カテゴリーid

⑩feed
 カテゴリーフィードへのリンク文字列を指定

⑪feed_image
 カテゴリーフィードへのリンク画像を指定
 ex)feed_image=/images/rss.gif
  デフォルトは空

⑫exclude
 非表示の投稿ページidを指定
  カテゴリーid

⑬include
 表示する投稿ページidを指定
  カテゴリーid

⑭hierarchical
 階層構造での表示を指定
  1(TRUE)   ・・・ 表示(デフォルト) 
  2(FALSE)  ・・・ 非表示

⑮title_li
 カテゴリーリストのタイトル名の文字列を指定
  デフォルトは、「カテゴリー」

⑯number
 表示するカテゴリーの数を指定
  デフォルトは無制限

⑰echo
 出力形式を指定
  1(TRUE)   ・・・ 標準(デフォルト)
  0(FALSE)  ・・・ PHP形式

⑱depth
 階層の深さ(数値)を指定
 ※WordPress2.5から
   0  ・・・ 全て表示 (デフォルト).
  -1  ・・・ 全てを並列に表示
   1  ・・・ 階層で1番上のカテゴリーのみ表示
   n  ・・・ n(整数)番目までのカテゴリーを表示

たとえば、カテゴリーリストのタイトルを表示せず、記事数を表示し、カテゴリーid=10配下の子カテゴリーだけを表示するときは、次のように記述します。


<ul>
 <?php wp_list_categories('show_count=TRUE&child_of=10&title_li='); ?>
</ul>

  タグ: ,

-スポンサーサイト-


コメント

コメントはございません。

コメントを投稿する

-スポンサーサイト-

HOME » WordPressカスタマイズ編 » テンプレートタグ » カテゴリーリストを表示するテンプレートタグwp_list_categories()
Google