wordpress页面导航调用函数wp_list_pages()使用说明

yibin 2016-06-01 WordPress 607

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格式)显示在侧边栏中

扫码添加微信

13013082126 扫描微信 建站咨询 优化咨询