首页 WordPress函数 WordPress获取标签信息函数:get_tags
正文 评论

WordPress获取标签信息函数:get_tags

WordPress函数get_tags用于获取标签对象。

get_tags( string|array $args = \'\' )

函数参数

$args

数组或字符串,可用值如下。

taxonomy

字符串,默认值:post_tag

分类法名称

object_ids

整数或数组

对应于wp_term_relationships表object_id字段,该字段对应于wp_posts表的ID,也就是指定文章的ID

orderby

字符串,默认值:name

排序的参照标准,可用值如下:

  • terms字段:name、slug、term_group、term_id、id、description、parent、term_order;
  • count:按文章数排序;
  • include:匹配include参数;
  • slug__in:匹配slug参数;
  • meta_value/meta_value_num:按照termmeta表中meta_value字段值排序,需指定meta_key参数;

order

字符串,默认值:ASC

排序的方式,可用值如下:

  • ASC:默认值,以升序排列;
  • DESC:降序排列;

hide_empty

布尔值,默认值:true

是否隐藏没有文章的标签

include

数组或字符串

要包含的标签ID

exclude

数组或字符串

要排除的标签ID

number

整数

返回的标签数量

offset

整数

查询偏移量

fields

字符串

要查询的terms字段,指定字段后将只返回指定字段值

  • all:返回包含所有WP_Term Object的数组;
  • all_with_object_id:测试中没有发现与all有区别;
  • ids:仅返回标签的ID;
  • tt_ids:返回term_taxonomy_id,一般情况下与term_id的值是相同的;
  • names:仅返回标签的名称;
  • slugs:仅返回标签的别名;
  • count:返回查询到的标签总数;
  • id=>name:以ID为键,返回标签名称;
  • id=>slug:以ID为键,返回标签别名;

count

布尔值,默认值:false

返回标签文章数量,优先于fields的设置,实际测试没有任何效果。

name

字符串

指定标签的名称,则返回该标签对象

slug

字符串

指定标签别名,则返回该标签对象

term_taxonomy_id

整数

根据指定的分类法ID返回数据

search

字符串

搜索匹配条件的标签

name__like

字符串

返回名称中包含指定关键词的标签

description__like

字符串

返回描述中包含指定关键词的标签

cache_domain

字符串,默认值:core

指定对象缓存的Key

update_term_meta_cache

布尔值,默认值:true

meta_query

数组

元数据查询

meta_key

字符串

元数据键的名称

meta_value

字符串

元数据键的值

meta_type

字符串

meta_compare

字符串

meta_value的比较运算符

函数返回值

Array(    [0] => WP_Term Object        (            [term_id] => 10            [name] => 建站教程            [slug] => site-tutorial            [term_group] => 0            [term_taxonomy_id] => 10            [taxonomy] => post_tag            [description] =>             [parent] => 0            [count] => 11            [filter] => raw        )    [1] => WP_Term Object        (            [term_id] => 11            [name] => 互联网            [slug] => internet            [term_group] => 0            [term_taxonomy_id] => 11            [taxonomy] => post_tag            [description] =>             [parent] => 0            [count] => 1            [filter] => raw        ))

函数使用示例

$args = array(\'hide_empty\' => false,);$tags = get_tags($args);$html = \'<div >\';foreach($tags as $tag) {    $tag_link = get_tag_link($tag->term_id);           $html .= \'<a href=\"\' . $tag_link .\'\" title=\"\' . $tag->name. \'\" >\';    $html .= $tag->name . \'</a>\';}$html .= \'</div>\';echo $html;

扩展阅读

get_tags()函数位于:wp-includes/category.php

相关函数:

  • get_terms()
  • get_categories()
-=||=-收藏赞 (0)
更多主题
单栏极简文艺WordPress博客主题:Diaspora主题
¥ 0 关注:20,377
详情
简约黑白WordPress个人博客主题:Personal主题
¥ 0 关注:20,230
详情
v1.0.0
小程序收录免费WordPress主题:XCX主题
¥ 0 关注:20,028
详情
v1.0.0
一款简约单栏的免费WordPress博客主题:itheme主题
¥ 0 关注:18,247
详情
功能丰富切轻量的WordPress虚拟资源主题:Rizhuti主题
¥ 599 关注:18,202
详情
大气优雅免费WordPress博客主题:HONEY主题
¥ 0 关注:15,017
详情
回复
暂无评论

不要再留垃圾评论了,主题君整理资源不容易,留几句鼓励的话吧。