wp_list_authors[作者标签]
WordPress作者列表标签:wp_list_authors WordPress模板标签wp_list_au…
WordPress模板标签wp_list_authors输出用户列表,并给出用户页面链接,默认以<li>列表输出。
1
|
wp_list_authors( string|array $args = ” )
|
函数参数
$args
数组或字符串值
wp_list_authors()函数$args参数默认的值如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
$args = array(
‘orderby’ => ‘name’,
‘order’ => ‘ASC’,
‘number’ => null,
‘optioncount’ => false,
‘exclude_admin’ => true,
‘show_fullname’ => false,
‘hide_empty’ => true,
‘echo’ => true,
‘feed’ => [empty string],
‘feed_image’ => [empty string],
‘feed_type’ => [empty string],
‘style’ => ‘list’,
‘html’ => true,
‘exclude’ => [empty string],
‘include’ => [empty string]
);
|
wp_list_authors()函数$args参数可用的值如下:
orderby
字符串值,默认值:name
指定输出的用户列表以哪个字段排列顺序
- name:以users表display_name字段排列顺序,也就是用户资料“公开显示为”
- email:以用户邮件地址排列
- url:以用户网址排列
- registered:以注册日期排列
- id:以用户ID排列
- user_login:以用户登录账号排列
- post_count:以用户发表的文章数量排列
order
字符串值,默认值:ASC
指定输出的用户列表的排序方式
- ASC:升序
- DESC:降序
number
整数型
指定要输出的用户数量
optioncount
布尔值,默认值:false
是否显示作者发表的文章总数
- 1(true):显示作者发表的文章总数
- 0(false):不显示作者发表的文章总数
exclude_admin
布尔值,默认值:true
排除名称为“admin”的用户,只有用户资料设置中“公开显示为”的名称为“admin”才被排除
- 1(true):排除“admin”用户
- 0(false):不排除“admin”用户
show_fullname
布尔值,默认值:false
显示用户的姓名而不是用户资料设置“公开显示为”中指定的名称
- 1(true):显示
- 0(false):不显示,此时显示用户资料设置“公开显示为”中设定的名称
hide_empty
布尔值,默认值:true
是否隐藏没有发表过文章的用户
- 1(true):隐藏
- 0(false):显示
feed
字符串值,默认为空
提供一个文本作为用户feed链接的锚文本,默认不显示用户feed链接
feed_image
字符串值,默认为空
提供一个图片的路径作为用户feed链接图片,并且会覆盖feed的设置
feed_type
字符串值,默认为空
feed的类型,可选的值有:
- -:默认值
- rss2
- atom
- rss
- rdf
style
字符串值,默认值:list
输出用户列表的HTML标签类型
- list:以<li>列表输出,不包括<ul>标签
- none:只输出链接,没有<li>标签,每个链接之间用逗号分隔
html
布尔值,默认值:true
是否输出HTML标签,如果为false,只输出文本,不同用户之前用逗号分隔
- 1(true):输出HTML标签
0(false):只输出文本,不包含<li>标签以及<a>标签,不同用户之前用逗号分隔
exclude
数组
要排除的用户ID,例如:array(1,6,9)
include
数组
要显示的用户ID,例如:array(1,3,5)
显示10个用户,并排除ID为1的用户,通常管理员的ID为1,同时即使没有发表过文章的用户也显示出来
1
2
3
4
5
6
7
8
|
<?php
$args = array(
‘number’ => 10,
‘exclude’ => array(1),
‘hide_empty’ => false
);
wp_list_authors($args);
?>
|
下面的写法也是一样的效果:
1
|
<?php wp_list_authors(‘number=10&exclude=1&hide_empty=0’); ?>
|
不同之处在于,true写成了1,false写成了0
如果要排除多个用户,则这样写:
1
|
<?php wp_list_authors(‘number=10&exclude=1,2,3&hide_empty=0’); ?>
|
扩展阅读
wp_list_authors()函数位于:wp-includes/author-template.php
WordPress模板标签the_author用于输出当前文章作者的名称,必须用在The Loop主循环中。
1
|
the_author()
|
the_author()函数没有任何参数,直接调用即可。
1
|
<p>作者:<?php the_author(); ?></p>
|
扩展阅读
the_author()函数位于:wp-includes/author-template.php
WordPress模板标签the_author_link输出带作者主页链接的作者名称,也就是作者在个人资料中设置的“站点”的链接,必须用在The Loop主循环中。
1
|
the_author_link()
|
the_author_link()函数没有任何参数,直接调用即可。
1
|
<p>作者: <?php the_author_link(); ?></p>
|
扩展阅读
the_author_link()函数位于:wp-includes/author-template.php
WordPress模板标签the_author_posts输出当前作者发表的文章总数,不包含草稿、私密文章,必须用在The Loop主循环中。
1
|
the_author_posts()
|
1
|
<p><?php the_author(); ?> 共发表了 <?php the_author_posts(); ?> 篇文章</p>
|
扩展阅读
the_author_posts()函数位于:wp-includes/author-template.php
WordPress模板标签the_author_posts_link用于输出指向当前作者所有文章页面的链接,其中锚文本为作者个人资料里“公开显示为”设置的名称。
需要注意the_author_posts_link()函数与the_author_link()函数的区别,前者输出的是该作者的文章归档页面链接,而the_author_link()函数输出的是作者在个人资料中设置的“站点”链接。
1
|
the_author_posts_link()
|
the_author_posts_link()函数不接收任何参数,直接调用即可。
1
|
<p>作者:<?php the_author_posts_link(); ?></p>
|
扩展阅读
the_author_link()函数位于:wp-includes/author-template.php
WordPress模板标签the_modified_author输出文章的最后修改作者名称,需要用在The Loop主循环里。
1
|
the_modified_author()
|
该函数没有参数,直接调用即可。
1
|
<p>文章最后由 <?php the_modified_author(); ?> 修改</p>
|
扩展阅读
the_modified_author()函数位于:wp-includes/author-template.php
相关函数:
- the_author()
- get_the_author()
- get_the_author_id()
- the_author_link()
- get_the_author_link()
- the_author_meta()
- get_the_author_meta()
- the_author_posts()
- get_the_author_posts()
- the_author_posts_link()
- get_author_posts_url()
- get_the_modified_author()
- the_modified_author()
- wp_dropdown_users()
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!