wp_list_pages()函数用于调用wordpress页面标题并以超链接形式作为博客导航显示使用，是wordpress主题制作常用的调用函数。wp_list_pages()函数有多个参数供用户根据主题设计需要自由选择组合显示，下面是wp_list_pages()调用函数各个参数的使用说明。

函数用法：

1

<?php wp_list_pages('arguments'); ?>

函数默认参数如下：

1
2
3
4
5
6
7
8
9
10
11
12
13

$defaults = array(
   'depth' => 0, 显示所有页面和子页面（无深度限制）
   'show_date' => '', 不显示创建日期
   'date_format' => get_option('date_format'),
   'child_of' => 0, 子页面无限制
   'exclude' => '', 不删除任何页面
   'title_li' => __('Pages'), 页面列表的标题为“Pages（页面）”
   'echo' => 1, 回显（显示）结果
   'authors' => '', 不局限于特定作者
   'sort_column' => 'menu_order, post_title', 先按页面顺序再按页面标题排序
   'link_before' => '',
   'link_after' => '',
   'exclude_tree'=> '' );不删除父级/子级树

参数详细说明：

• depth表示包含的页面层次级数，默认值为0，显示所有页面和子页面；-1以平级方式显示子页面中的页面；1仅显示最上层页面；2表示需要显示页面内部的层级数；
• show_data表示在每篇页面旁显示创建日期或最新修改日期。默认值为空”，即不显示日期；’modified’显示最新修改日期；’xxx’任何非modified值都将显示页面最初的日期;
• data_format表示对show_data参数生成的页面日期格式进行设置，默认格式为wordpress选项设定的日期格式；
• child_of表示仅显示单个页面的子页面，默认值为0，显示所有页面。该参考不仅获取直系子页面，也会从已知编号中获取更深层次的页面。
• exclude表示排除不显示的页面，如exclude=1,2,3，数字为页面的ID；
• title_li设置页面列表标题的内容和样式。
• echo显示所生成的链接列表，或将列表按HTML文本格式返回供PHP使用。默认值为1（显示生成的列表项）。可能的值包括：1 (true) — 默认；0（false）
• authors不局限于特定作者
• sort_order更改页面列表的排列顺序。默认值为升序。可选的值’asc’按从低到高顺序排列（默认）;’desc’按从高到低顺序排列
• link_before设置a标签中文字链接前的文本或html代码
• link_after设置a标签中文字链接后的文本或html代码。
• exclude_tree从结果中移除已知编号的所有子页面，或者用于隐藏已知页面的所有子页面，还可联child_of参数隐藏孙页面。

wp_list_page()函数使用举例：

1

<?php wp_list_pages('sort_column=menu_order&title_li=<h2>' . __('Prose') . '</h2>' ); ?>

将列表按页面顺序进行排列并将“Prose”作为列表标题（以h2格式）显示在侧边栏中