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 = '');

用于用户列表。暂时用不到这个。待更新…