在WordPress中,`get_categories`是一个函数,用于检索网站中定义的分类(Categories)。它返回一个包含所有分类信息的对象数组。每个对象都包含有关特定分类的详细信息,如分类的ID、名称、链接、描述等。
以下是`get_categories`函数的基本用法:
```php
$categories = get_categories();
foreach ($categories as $category) {
echo '<h2>' . $category->name . '</h2>';
echo '<p>' . $category->description . '</p>';
echo '<a href="' . get_category_link($category->term_id) . '">' . 'View category posts' . '</a>';
}
```
在这个例子中,我们首先调用`get_categories`函数并将返回的分类数组存储在`$categories`变量中。然后,我们使用`foreach`循环遍历数组中的每个分类对象。对于每个分类,我们输出其名称、描述和一个链接,该链接指向包含该分类文章的页面。
`get_categories`函数可以接受一些参数来定制返回的分类列表,例如:
- `'hide_empty'`:如果设置为`true`,则只返回包含文章的分类。
- `'parent'`:返回指定父分类下的子分类。
- `'orderby'`:设置排序分类的字段,例如`name`、`count`、`term_group`、`slug`、`none`等。
- `'order'`:设置排序方向,可以是`ASC`(升序)或`DESC`(降序)。
- `'number'`:返回的分类数量限制。
- `'include'`:返回指定ID的分类。
- `'exclude'`:排除指定ID的分类。
- `'pad_counts'`:如果设置为`true`,则分类计数将包括其子分类中的文章数量。
例如,要获取所有非空的分类,并按名称升序排序,可以这样做:
```php
$categories = get_categories(array(
'hide_empty' => 0,
'orderby' => 'name',
'order' => 'ASC'
));
```
注意,使用`get_categories`函数时,它默认获取的是网站的所有顶级分类。如果你需要获取特定父分类下的子分类,你需要传递`'parent'`参数,并设置为你想要检索的子分类的父分类ID。
请记住,在主题文件或插件中使用`get_categories`之前,需要确保WordPress环境已经加载完成,通常这意味着你需要在`init`或更晚的钩子之后调用它。