wp_list_categories()関数は、リンクの分類をクリックして、あなたはカテゴリページを訪問することができ、リンクの形で設定された分類です。私たちは時々、ページ番号でカテゴリのリンクを呼び出し、この関数は、あなたが過ごすことができます。注:wp_list_categories()およびlist_cats()とwp_list_cats()]同様の、しかし非推奨2後ろ。あなたは)(出力分類、利用get_categoriesをフォーマットしたくない場合
<?phpの$ argsを=配列( 'show_option_all' => ''、 'orderbyの' => '名前'、 '注文' => 'ASC'、 'スタイル' => 'リスト'、 'show_count' => 0、 'hide_empty' => 1、 'use_desc_for_title' => 1、 'child_of' => 0、 'フィード' => ''、 'feed_type' => ''、 'feed_image' => ''、 ''除外=> ''、 'exclude_tree' => ''、 => ''含みます'、 '階層」=> 1、 'title_li' => __( 'カテゴリー')、 'show_option_none' => __( 'ノーカテゴリ')、 '番号' => nullを、 'エコー' => 1、 '深さ' => 0、 'current_category' => 0、 'pad_counts' => 0、 '分類法' => 'カテゴリ'、 '歩行者' => NULL ); ?> <?phpのwp_list_categories($ argsを)。?>
デフォルトの出力効果の使用法:
- 接続しません分類
- 分類名に従って昇順に分類リスト
- 順不同リストのスタイルで表示されます
- これは、記事の数が表示されません
- 分類の記事のみを表示します
- 分類を記述するためにtitle属性を設定します。
- 無制限のサブカテゴリ
- フィードフィードの画像が表示されず、
- 任意の分類を排除し、すべてのカテゴリを含めないでください
- 現在の分類にCSSクラスの現在の猫」を追加します。
- カテゴリー一覧が階層的にインデント表示
- タイトルとしてリストショー「の分類(カテゴリー)」の上部には
- SQLは、(「番号」=> 0は上に示されていない)制限なし
- 表示(出力)の分類
- 表示された深さを制限することなく
- すべてのカテゴリー
- 一覧ウォーカーを表示するには、新しいクラスのオブジェクトを使用してWalker_Category
パラメータ
show_option_all
スタイルはすべてのカテゴリへのリンクのリストを表示するように設定されている場合(文字列)null以外の値が発生します。デフォルトでは、すべてのカテゴリへのリンクを表示することはありません。
ORDERBY
配置の基礎のためのカテゴリ名、カテゴリまたはID番号および他の記事へ(文字列)。有効な値:
- ID
- 名前 - デフォルト
- ナメクジ
- カウント
- term_group
注文
ソート順(文字列)ソート(昇順または降順)。デフォルトは昇順です。有効な値:
- ASC - 昇順(デフォルト)
- DESC - 降順
スタイル
スタイル(文字列)カテゴリ一覧が表示しました。分類リストは、(項目の<BR>タグ区切りのリストを使用して)表示されました。デフォルトの設定では、リスト(順不同リスト)です。有効な値:
- リスト - デフォルト
- 無し
show_count
(ブール値)の記事の数を示します。記事の数は、デフォルトでは表示されません。有効な値:
- 1(真)
- 0(偽) - デフォルト
hide_empty
(ブール値)分類の記事を隠しません。隠す記事デフォルトなし。有効な値:
- 1(真) - デフォルト
- 0(偽)
use_desc_for_title
(ブール値)title属性カテゴリのリンクで説明したように分類するかどうか、デフォルトはtrueです。有効な値:
- 1(真) - デフォルト
- 0(偽)
の子
このパラメータの分類の(整数)のみを示すサブカテゴリーが決定されます。このパラメータのデフォルト値はありません。
フィード
(文字列)のセットに連結された各分類フィードRSS-2フィードのテキストを表示します。デフォルトのフィードのテキストやリンクによっては表示されません。
feed_type
(文字列)
feed_image
(文字列)RSS-2フィードリンクの分類に画像を設定します。このパラメータは、上記のフィードパラメータを上書きします。このパラメータのデフォルト値はありません。
除外する
(文字列)は、1つ以上の分類を除外します。カテゴリのそれぞれを分離するために、カンマを使用してID。パラメータが空である必要があります。
exclude_tree
(文字列)分類ツリーを除外する。カテゴリのそれぞれを分離するために、カンマを使用してID。パラメータが空である必要があります。階層パラメータがtrueの場合、パラメータ置換のexclude_treeを除外します。
含める
各カテゴリIDを分離するために、カンマを使用して、特定の分類に(文字列)ディスプレイ。
階層
(ブール)ディスプレイサブ分類の階層的な分類。デフォルトでは(以下のサブカテゴリーの分類でそれらを表示する)真です。有効な値:
- 1(真) - デフォルト
- 0(偽)
title_li
(文字列)は、リストのタイトルを設定します。デフォルトでは、「カテゴリー」です。このパラメータが存在しますが、空の場合、リストには表示されません。
数
設定表示の分類番号(整数)。SQLの制限を定義します。デフォルトは無制限です。
エコー
(ブール値)結果を表示または変数に保存されました。デフォルトはTrueです。有効な値:
- 1(真) - デフォルト
- 0(偽)
深さ
(整数)表示深度分類(すなわち、どのように表示サブ分類の多くの層)。デフォルト値は0(すべてのカテゴリとサブカテゴリを表示)です。有効な値:
- 0 - すべてのカテゴリとサブカテゴリ(デフォルト)
- -1--すべてのカテゴリは、平面(インデントされていない)(被覆階層)の形で表示されます。
- 1--のみ、トップレベルの分類を示し、
- N - 分類の対応するレベルの数nに応じて表示されます。
current_category
(整数)は、分類ID番号、この分類のID名を加えCSS制御により電流猫その後、ユーザ定義の電流猫スタイルは、ハイライトに使用することができます。
pad_counts
(ブール値)またはサブ分類を含む記事の数を計算するためのリンク。show_countsと階層trueの場合、このパラメータは自動的にtrueに設定されています。有効な値:
- 1(真)
- 0(偽) - デフォルト
分類
分類を返す(文字列)。このパラメータは、3.0で追加されます。有効な値:
- カテゴリ - デフォルト
- 分類学 - またはその他の登録分類
ウォーカー
(ターゲット)がリストウォーカークラスを生成します。有効な値:
オブジェクト - Walker_Category又はウォーカーのいずれかを拡張するクラスのインスタンス
wp_list_categories()関数は、実施例の方法を使用し
アルファベット順にソート、唯一の分類は16,3,9と5は、次のコードを使用することができ、カテゴリIDが含まれています。
<UL> <?PHPのwp_list_categories( 'orderbyの=名前&含める= 3,5,9,16'); ?> </ UL>
名前の配置は、記事の数を表示し、分類ID 10が除外されます。
<UL> <PHPのwp_list_categories( 'orderbyの=名前&show_count = 1&除外= 10');??> </ UL>
表示またはタイトルのリスト非表示
title_liパラメータは、タイトルwp_list_categoriesは、リストを生成する機能セットまたは非表示にすることができます。デフォルトのタイトルは「分類(カテゴリー)」です。nullに設定されている場合、それはタイトルが表示されません。タイトル分類ID 4および7と同様に、非表示を除外:
<UL> <PHPのwp_list_categories( '= = 4,7&title_liを除外');??> </ UL>
詩にのみ分類ID 23と5,9、及びタイトルリストを表示しますが、あって<H2>タグを使用しました:
<UL> <PHPのwp_list_categories?( 'を含む= 5,9,23&title_li = <H2>' __( '詩') '</ H2>'。。); ?> </ UL>
サブカテゴリは、指定したカテゴリ表示
の記事の数を表示、ソートIDに応じて、分類8のサブカテゴリーとして表示IDを、接続title属性で説明したように分類されます。注:親記事を分類していない場合は、親の分類を表示しません。
<UL> <?PHPのwp_list_categories( 'ORDERBY = ID&show_count = 1&use_desc_for_title = 0&child_of = 8')。?> </ UL>
削除ブラケットはカウント
記事の各分類番号の後ろshow_count = 1は、表示されたときに、括弧の使用が含まれていながら、。あなたは括弧を削除したい場合は、次のコードを使用することができます
<?PHPの $変数= wp_list_categories( 'エコー= 0&show_count = 1&title_li = <H2>カテゴリー</ H2>'); $変数=にpreg_replace( '〜\((\ D +)\)(= \ S * + <)〜?'、 '$ 1'、$変数); $変数をエコー。 ?>
カテゴリーRSSフィード接続を表示し、
カテゴリ名に基づいてソート、ショー記事、リンクおよび表示RSSの数は、各カテゴリのフィード:
<UL> <?PHPのwp_list_categories( 'orderbyの=名前&show_count = 1&フィード= RSS'); ?> </ UL>
飼料利用の置換テキストのアイコンは、次のコードを使用することができます。
<UL> <?PHPのwp_list_categories( 'ORDERBY =名&show_count = 1&feed_image = /画像/ rss.gif')。?> </ UL>
ディスプレイのカスタム分類プロジェクト
バージョン3.0では)(wp_list_categoriesに分類パラメータを追加しました。だから、あなたが分類して表示するパラメータを設定することができた分類の下でプロジェクトの分類があります。例えば、ジャンル分類リストの分類を表示するには:
<?phpの wp_list_categoriesを使用して、指定された分類で//リストの用語(ウィジェットとしても有用でPHPコードのプラグインを使用している場合) $分類=「ジャンル」; $ orderbyの= '名前'; $ show_count = 0; はいについて// 1、なし0 $ pad_counts = 0; はいについて// 1、なし0 $の階層= 1; // yesのための1、なし0 $タイトル= ''; $引数=配列( '分類法' => $分類、 'ORDERBY' => $ ORDERBY、 'show_count' => $ show_count、 'pad_counts' => $ pad_counts、 '階層' => $階層、 'title_li' =>タイトル$ )。 ?> <UL> <?phpのwp_list_categories($ argsを)。?> </ UL>
分類を対応する表示記事
の親に応じて-子関係は、物品の分類をソートします。(ソートの名前に応じて分類)と同様get_the_category_list()関数。次の例では、ループ内で使用する必要があります。
<?phpの //投稿するために割り当てられたカテゴリID取得 (ID、配列( 'フィールド' => 'IDS')$カテゴリ= wp_get_post_categories $ポスト)>を、 //リンク間のセパレータ $区切り= ''; ($カテゴリ){もし $ cat_ids =破( ''、$カテゴリ)。 $猫= wp_list_categories( 'title_li =&スタイル=なし&エコー= 0&=含める' $ cat_ids。); $猫= RTRIM(トリム(str_replace( '<br />'、$セパレーター、$猫))、$セパレーター)。 //表示ポストカテゴリは $猫をエコー。 } ?>
タグとスタイリングは、リストを並べ替え
デフォルトでは、wp_list_categories()は各カテゴリを含めるように<LI>タグを使用して、順不同リスト(UL)を生成し、そしてタイトルリストは、「カテゴリー」です。
あなたはtitle_liを設定することにより、タイトルを非表示にするには、nullにすることができます。あなたは、パッケージ、順序リストや順不同リストをカスタマイズすることができます。あなたは、リスト出力分類する必要がない場合は、スタイルパラメータがnoneに設定されていることができます。
あなたは、次のCSSセレクタに応じた出力のスタイルを設定することができます:
li.categories {...} / *最外リスト項目* / li.cat項目{...} li.cat項目-7- {...} / *カテゴリID#7など* / li.current -cat {...} li.current-CAT-親{...} ul.children {...}
wp_list_categories()関数定義ファイルのwp-含ま/カテゴリtemplate.php