网站首页 » CMS » WordPress » wordpress 分类目录函数 get_categories() 用法
上一篇:
下一篇:

wordpress 分类目录函数 get_categories() 用法

介绍

get_categories() 函数可以获得分类所有信息,返回与查询参数相匹配的类别对象数组。变量 与 wp_list_categories 的变量用法基本一致,而且变量可以以数组类型传递,也可在查询句法中被传递。

基本语法

<?php $categories = get_categories( $args ); ?>

参数说明

type
(字符)post和link 其中link在新版3.0以后已被弃用。
child_of
(整数)仅显示标注了编号的分类的子类。该参数无默认值。使用该参数时应将hide_empty参数设为false
parent
(整数)只显示某个父级分类以及下面的子分类(注:子分类只显示一个层级)。
orderby
(字符)将分类按字母顺序或独有分类编号进行排序。默认为按分类 编号排序包括ID(默认)和Name
order
(字符)为类别排序(升序或降序)。默认升序。可能的值包括asc(默认)和desc
hide_empty
(布尔值)触发显示没有文章的分类。默认值为true(隐藏空类别)。有效的值包括:1(true)和0(false)。
hierarchical
(布尔值)将子类作为内部列表项目(父列表项下)的层级关系。默认为true(显示父列表项下的子类)。有效值包括1 (true)和0(false),(亲测时:如果是“1”则把所有已有文章的分类包括子类有文章父类没有文章的分类都统统列出来,如果是“0”则只显示有文章的分类。)
exclude
(字符)除去分类列表中一个或多个分类,多个可以用逗号分开,用分类ID号表示。
include
(字符)只包含指定分类ID编号的分类。多个可以用逗号分开,用分类ID号表示。
pad_counts
(布尔值)通过子类中的项来计算链接或文章。有效值包括1(true)和0(false),0为默认。
number
(字符)将要返回的类别数量。
taxonomy
(字符)返回一个分类法,这个是wordpress3.0版本后新添加的一个参数。返回的值包括category(默认)和taxonomy(一些新定义的分类名称)。

函数实例

示例代码

<nav>
 <div class="container">
 <div class="row">
 <ul class="main-nav oh">
 <li><a href="<?php echo get_option('home'); ?>" title="首页"><span>网站首页</span></a></li>
 <?php
 $args=array(
 'orderby' => 'id',
 'order' => 'ASC',
 'include' => '88,89,85'
 );
 $categories=get_categories($args);
 foreach($categories as $category) {
 echo '<li><a class="nav-link" href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "%s" ), $category->name ) . '" ' . '>' . $category->name.'</a></li>';
 }
 ?>
 <li><a href="http://zhaoxixiong.com" title="朝夕熊博客"><span>朝夕熊</span></a></li>
 </ul>
 </div>
 </div>
</nav>

输出代码效果

<nav>
 <div class="container">
 <div class="row">
 <ul class="main-nav oh">
 <li><a href="http://yunkus.com" title="首页"><span>网站首页</span></a></li>
 <li><a class="nav-link" href="http://yunkus.com/category/fewd/" title="前端开发" >前端开发</a></li><li><a class="nav-link" href="http://yunkus.com/category/cms/" title="CMS" >CMS</a></li><li><a class="nav-link" href="http://yunkus.com/category/operator/" title="网站运营" >网站运营</a></li> <li><a href="http://zhaoxixiong.com" title="朝夕熊博客"><span>朝夕熊</span></a></li>
 </ul>
 </div>
 </div>
</nav>

注意:如果你没有为$args 添加’include’=>’88,89,85′ 这个变量,那么这个 get_categories() 函数就默认输出所有已有文章的分类包括顶级分类,子分类。

体会

使用这个函数可以更为方便地修改导航的代码结果,例如你可以快速的在每个栏目前面添加相应的小图标,或者给元素添加CLASS类,来让导航不再单调。又或者对代码结构进行优化,删除多余代码,或者以你喜欢的方式编写导航代码结构。

相关资料

函数文档

get_categories() 函数官方文档:https://developer.wordpress.org/reference/functions/get_categories/

官方中文文档:http://codex.wordpress.org.cn/模板标签

官方英文文档:http://codex.wordpress.org/

wordpress 官方下载

中文版:https://cn.wordpress.org/

英文版:https://wordpress.org/download/

wordpress 论坛:https://zh-cn.forums.wordpress.org/

  • 微信扫一扫,赏我

  • 支付宝扫一扫,赏我

声明

原创文章,不经本站同意,不得以任何形式转载,如有不便,请多多包涵!

本文永久链接:http://yunkus.com/wordpress-category-function-get_categories-usage/

Leave a Reply

Your email address will not be published. Required fields are marked *

评论 END