WordPress get_the_category() 取得分類 ID、名稱……所有資訊

在客製化版型,時常需取得當前文章類別、特定文章類別 ID,才能製作出變化多樣的網站。這裡將為各位說明 WordPress 內建 get_the_category() 方法(function),小傑網站側邊欄所呈現的「分類」列表,也是使用該 方法(function) 製作出來的。

wordpress

描述

返回物件的陣列。返回的值是一個物件的陣列,內容是當前文章分類的所有資訊,可以在文章主循環外使用(Loop)。

語法

<?php 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) {
    $category->category_name;
}
?>

顯示多個分類名稱(當一篇文章有多個分類時)

<?php
$cat = get_the_category();

foreach ($cat as $key=>$category) {
    echo $category->cat_name . '<br>';
}
?>

發表迴響