説明
string get_the_category_list( [ string $separator = '' [ , string $parents = '' [ , mixed $post_id = false ] ] ] )
投稿記事のカテゴリー別アーカイブのリンクリストを取得する。
パラメータ
- $separator区切り文字。''の場合は、ulおよびliタグが適用される。
- $parents親カテゴリー対応を指定（'multiple'、'single'、''の何れか）。'multiple'の場合は親カテゴリーもリンク付きになる。
- $post_id投稿情報ID。falseの場合は現在の投稿情報が適用される。
返り値
カテゴリー別アーカイブのリンクリストを返す。注意
4.4で'the_category_list'フィルターが追加され、対象となるカテゴリー情報を調整できるようになった。
使用例
- カテゴリー別アーカイブのリンクリストを取得する。<?php $cat_link = get_the_category_list( ); ?>
フィルター
[4.4.0] get_the_category関数で取得したカテゴリー情報は'the_category_list'フィルターを経由する。パラメータ$categoriesにはカテゴリー情報が、$post_idは本関数が受け取った値が格納される。$categories = apply_filters( 'the_category_list', $categories, $post_id );
[1.2.0]値を返す直前に'the_category'フィルターを呼び出す。$thelistには返す直前の値が、$separatorと$parentsには本関数が受け取った値がそれぞれ格納される。
return apply_filters( 'the_category', $thelist, $separator, $parents );
アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/category-template.php最終更新 : 2018年05月27日 10:48
関連
お勧め
Gutenbergでカスタムフィールドを使う（2018年8月10日 更新）
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
4.4では投稿ページも専用テンプレートが適用できる（2018年5月27日 更新）
従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。
さくらのVPSでKUSANAGI#2（2018年5月27日 更新）
今回は「前回」の続き。さくらのVPS（メモリー2GB SSDプラン）でパフォーマンスをApacheのabコマンドで確認してみた。はてさて、うたい文句通りのパフォーマンスは発揮するのだろうか。
Widgets on dashboard：プラグイン作ってみました（2014年5月7日 更新）
サイトバーなどのページ構成パーツとしてウィジェットを利用し、ある程度頻繁に更新している場合、毎回ウィジェットページを表示するのはちょっとだけ面倒かも。そんなわけで、シンプルにダッシュボードで直接編集できればいいかなと思い、調べてみました。
WP_List_Tableクラスの「一括操作」フォームを使ってみた（2018年5月27日 更新）
今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」（Bulkアクション）フォーム対応に関するメモである。