WordPress 函数 get_categories() 获取所有分类

本文被收录到:

WordPress 开发文档

WordPress是一款能让您建立出色网站、博客或应用程序的开源软件。美观的设计,强大的功能,助您自由发挥心中所想。WordPress既是免费的,也是无价的。全世界 43% 的网站都在使用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

声明:本站所有文章和图片,如无特殊说明,均为原创发布。商业转载请联系作者获得授权,非商业转载请注明出处。
真诚赞赏,手留余香
赞赏
搜神记
765 文章
4 教程
8 项目
随机推荐
Git push 错误:Updates were rejected because the remote contains work that you do not have locally
CSS 滚动条样式修改
HTML textarea 文本输入框
Node.js 安装第三方模块
JavaScript 类操作 classList
JavaScript 类
JavaScript 操作表单
Node.js zlib 模块