WordPress get_the_category() 取得分類 ID、名稱......所有資訊
在客製化版型時常需取得當前文章類別、特定文章類別 ID,才能製作出變化多樣的網站。這裡將為各位說明 WordPress 內建 get_the_category(),「MIS 腳印」網站側邊欄所呈現的【分類】列表,也是使用 get_the_category() 製作的。
函數用法
描述
返回物件的陣列。返回的值是一個物件的陣列,內容是當前文章分類的所有資訊,可以在文章主循環 (loop) 外使用。
語法
get_the_category($id);
參數
ID | (integer) 可選。文章的 ID 編號,預設值為 $post->ID (當前文章的 ID 編號) |
---|
返回值
cat_ID |
分類 ID 編號 |
---|---|
category_count |
該分類有多少文章 |
category_description |
分類描述 |
cat_name |
類別名稱 |
category_nicename |
分類名稱產生的一個 slug (代稱) |
category_parent |
當前分類的父類別 ID 編號。0 表示沒有父煩別 |
範例
顯示分類的所有資訊
顯示資訊就是上面提到的返回值。
<?php
$categories = get_the_category();
var_dump($categories);
顯示分類名稱
<?php
// 方式一 (須指定一個變數接收回傳值)
$category = get_the_category();
echo $category[0]->cat_name;
// 方式二(無須指定變數)
foreach ((get_the_category()) as $category) {
echo $category->category_name;
}
顯示多個分類名稱
當一篇文章有多個分類時。
<?php
$cat = get_the_category();
foreach ($cat as $key=>$category) {
echo $category->cat_name . '<br>';
}
參考
本著作係採用創用 CC 姓名標示-相同方式分享 3.0 台灣 授權條款授權.