WordPress 开发文档
收录了这篇文章 

get_categories() 函数是 WordPress 提供的一个简单方法，用于获取所有分类（categories）的信息。这个函数返回一个包含分类对象的数组，每个对象都包含了分类的详细信息，如 ID、名称、描述、链接等。以下是如何使用 get_categories() 的一个基本示例：

<?php
$categories = get_categories(); 

if ($categories) {
    foreach($categories as $category) {
        echo '<h2><a href="' . get_category_link( $category->term_id ) . '">' . $category->name . '</a></h2>';
        echo '<p>' . $category->description . '</p>';
    }
} else {
    echo '没有分类。';
}
?>

参数说明

虽然上述例子没有直接使用参数，但 get_categories() 函数实际上接受一个关联数组作为参数，用于过滤和排序返回的分类。一些常用的参数包括：

• exclude：要排除的分类ID数组。
• include：仅包括指定ID的分类数组。
• orderby：排序依据，如 'name', 'count', 'id' 等。
• order：排序方向，'ASC'（升序）或 'DESC'（降序）。
• hide_empty：是否隐藏空分类，默认为 true，若想显示空分类，则设为 false。
• parent：仅获取指定父分类下的子分类。

示例：获取所有非空的顶级分类

$args = array(
    'parent' => 0, // 只获取顶级分类
    'hide_empty' => false, // 显示空分类
    'orderby' => 'name', // 按名称排序
    'order' => 'ASC' // 升序排列
);

$categories = get_categories( $args );

if ( ! empty( $categories ) ) {
    foreach ( $categories as $category ) {
        echo '<h2><a href="' . get_category_link( $category->term_id ) . '">' . $category->name . '</a></h2>';
    }
} else {
    echo '没有顶级分类。';
}

修改时间 2024-06-04