本文最后更新于 976 天前,其中的信息可能已经有所发展或是发生改变。
wp_list_authors()
wp_list_authors(string/array $args = '');
显示出网站作者列表,可以是单个参数也可以是数组,我仅列出一些常用的参数供参考
orderby 依据什么来排序,默认以name来排序,可用值如下 nicename 昵称 email 邮箱地址 url 网址 registered 注册 user_nicename 用户昵称 user_email 用户邮箱 user_registered 用户注册 name 用户名 display_name 显示的名称 post_count 发布的文章数量 ID 作者id meta_value 作者个人说明 user_login 登录 order 排序方式,默认升序排序ASC ASC 顺序排序 DESC 倒序排序 number 最大作者数量,默认全部作者 echo 控制是输出结果还是返回结果,默认true输出结果 style 如果参数值为list,则被包含在li标签中,否则作者以逗号分隔 html 是以html形式输出还是以纯文本输出,默认true以html形式输出
使用案例
下面的函数,基本上都照着这样写就可以,两种方法都ok
wp_list_authors(array(
'orderby' => 'ID',
'order' => 'DESC',
'number' => 3,
'echo' => true,
'style' => 'list',
'html' => 'true'
));
wp_list_authors('orderby=id&order=desc&number=3&echo=true&style=list&html=true');
wp_list_categories()
wp_list_categories(string/array $args = '');
显示分类目录的html列表,常用参数
current_category 填写指定分类目录的id或者id数组,默认0。给指定的分类添加样式current-cat类 'current_category' => '1,2' include 指定特定的分类,只显示给定的分类。可以是分类id的数组,也可以逗号分隔多个id 'include' => '1,2' exclude 排除分类目录,可以是分类id的数组,也可以逗号分隔多个id,使用的时候include必须为空 'exclude' => '1,2' exclude_tree 同上,连同指定id的子分类也一起排除 'exclude_tree' => '1' hide_title_if_empty 分类目录下无子分类,是否隐藏。默认不隐藏,值1、0对应true和false,都可以使用 'hide_title_if_empty' => 'true' hide_empty 是否隐藏没有文章的分类,值1、0对应true和false,都可以使用 'hide_empty' => 'true' style 列表样式,默认li标签。设置为0时,以a标签显示 'style' => 'list' showcount 是否显示文章数量,值1、0对应true和false,都可以使用 'showcount' => '1' use_desc_for_title 是否显示title属性,值1、0对应true和false,都可以使用 'use_desc_for_title' => '1' child_of 指定一个分类,显示该分类的子分类。默认为0包含所有分类 'child_of' => '1' taxonomy 指定一个分类法,可用于自定义分类。默认category 'taxonomy' => 'category' depth 分类的深度,默认是0所有分类。-1所有分类在同一层级;1只显示顶级分类;n只显示第n层级的分类 'depth' => '2' title_li 设置列表的标题,默认为Categories。为空时,不显示。 'title_li' => '<h2>' . __( '分类1' ) . '</h2>'
wp_list_pages()
wp_list_pages(array|string $args = '');
显示页面列表,li标签包裹,常用参数
child_of 同wp_list_categories() depth 同wp_list_categories() include 同wp_list_categories() exclude 同wp_list_categories() exclude_tree 同wp_list_categories() title_li 同wp_list_categories() authors 指定作者id或者id数组,或以逗号分隔。输出该作者的页面,默认为空指定所有作者 'authors' => '1' post_type 输出指定的页面类型。默认为page 'post_type' => 'page' post_status 输出指定页面的状态。默认为publish发布 'post_status' => 'publish' show_date 输出指定页面的日期。为空时,隐藏日期;modified为修改日期;publish为发布日期 'show_date' => 'publish' item_spacing 是否保留列表中的空白文本。默认preserve保留;discard丢弃 'item_spacing' => 'discard'
自动添加的class类名
.page_item 列表中,每个页面的对应项会添加这个类名 .page-item-ID 列表中,每个页面的对应项会添加这个类名,ID就是页面的id .current_page_item 列表中,当前页面的对应项会添加这个类名 .current_page_parent 列表中,当前页面的父级页面会添加这个类名 .current_page_ancestor 列表中,当前页面的顶级页面会添加这个类名
wp_page_menu()
wp_page_menu(array|string $args = array());
跟上面的wp_list_pages()很相似,输出页面的列表。但是是以div包裹,可以定义类名等
include 同wp_list_pages() exclude 同wp_list_pages() exclude_tree 同wp_list_pages() item_spacing 同wp_list_pages() menu_id 指定特定页面的id,默认为空 'menu_id' => '12' menu_class 指定包含页面列表的标签的class类名,默认为class="menu" 'menu_class' => 'active' container 指定包含页面列表的标签,默认为"div"。 'container' => 'ul' show_home 是否显示首页链接,默认为不显示。值1、0对应true和false,都可以使用 'show_home' => '1' before div容器内,包裹列表的标签。默认为"<ul>" 'before' => '<ul>' after div容器内,包裹列表的结束标签。默认为"</ul>" 'after' => '</ul>'
wp_dropdown_pages()
wp_dropdown_pages(array|string $args = '');
输出页面列表,并以下来列表来显示页面列表以<select>包裹,暂时用不到这个。待更新…
wp_dropdown_categories()
wp_dropdown_categories(array|string $args = '');
输出分类列表,并以下拉形式来显示列表以<select>包裹。下拉形式的分类列表,应该用的不多。暂时用不到这个。待更新…
wp_list_bookmarks()
wp_list_bookmarks(string|array $args = '');
这个函数是使用wordpress自带的链接管理,一般用来输出友情链接的。不过现在的版本,wordpress都是默认关闭这个功能的,所以不研究它了。现行办法是在菜单管理中新增自定义菜单作为友情链接
wp_list_comments()
wp_list_comments(string|array $args = array(), WP_Comment[] $comments = null);
输出评论列表,个人一般都是做的企业网站。暂时用不到这个。待更新…
wp_get_archives()
wp_get_archives(string|array $args = '');
用于输出文章归档列表,博客类网站用的比较多。暂时用不到这个。待更新…
wp_dropdown_users
wp_dropdown_users(array|string $args = '');
用于用户列表。暂时用不到这个。待更新…