WordPress函数:wp_list_pages()

WordPress函数:wp_list_pages()是用来显示页面信息列表的函数

<?php 
/*
*  函数:wp_list_pages( $args )
*  作用:显示页面信息列表
*/
wp_list_pages( array( 
   /*
      @成员参数:sort_column
      @参数作用:页面信息列表的排序方式
      @可选的值:
      post_title          按照页面的标题排序  【默认】
      menu_order    按照页面的数序排序(在发布页面时设置的“排序”属性的值)   
      post_date        按照页面的发布时间排序
      post_modified  按照页面的修改时间排序
      ID                   按照页面的编号排序
      post_author       按照页面的作者的编号排序
      post_name        按照页面的别名排序
   */
   'sort_column'  => 'menu_order, post_title',

   /*
      @成员参数:sort_order
      @参数作用:按照升序还是降序的方式排列页面信息列表
      @可选的值:
      ASC                   按照升序的方式排列     【默认】
      DESC               按照降序的方式排列
   */
   'sort_order'   => '',

   /*
      @成员参数:exclude
      @参数作用:在显示结果中排除某些页面信息
      @可选的值:页面信息的ID编号
      @特别提醒:当要排除多个页面信息的话,之间要用逗号隔开(英文输入环境)
   */
   'exclude'      => '',

   /*
      @成员参数:exclude_tree 
      @参数作用:在显示结果中排除某系列页面信息(即,排除某个父页面及其子页面)
      @可选的值:要排除的页面信息的ID编号(填写要排除的父页面的编号,不用填写子页面的编号)
      @特别提醒:当要排除多个页面信息的话,之间要用逗号隔开(英文输入环境)
   */
   'exclude_tree'    => '', 

   /*
      @成员参数:include
      @参数作用:仅显示在该参数中设置的页面信息
      @可选的值:页面信息的ID编号
      @特别提醒:当要包含多个页面信息的话,之间要用逗号隔开(英文输入环境)
   */
   'include'  => '',    

   /*
      @成员参数:depth 
      @参数作用:显示结果中要显示到哪个层级?
      @可选的值:
      0              显示所有层级,而且不干涉其层级(即,保留层级)       【默认】
      -1             显示所有层级,不保留层级关系(即,所有页面信息在同一级中显示)
      1              显示所有顶级页面信息
      2, 3, ...        显示到第2, 3, ....级
   */
   'depth'       => 0, 

   /*
      @成员参数:child_of
      @参数作用:仅显示某个页面信息下的子页面信息
      @可选的值:父页面的编号 或者 0(显示所有页面信息)    
      @默认的值:0
   */
   'child_of'    => 0,

   /*
      @成员参数:show_date
      @参数作用:是否显示页面信息的发布、修改日期?显示发布日期还是修改日期?
      @可选的值:
      ''             空值,不显示日期   【默认】
      modified      显示修改日期
      created       显示发布日期
   */
   'show_date'       => '',

   /*
      @成员参数:date_format 
      @参数作用:日期的格式
      @参数说明:
      Y              年     如,2014
      m              月     如,08
      d              日     如,20
      h              时     如,21
      i              分     如,18
      s              秒     如,59
      @默认的值:get_option('date_format')  即在后台设置的日期格式
   */
   'date_format'  => get_option('date_format'),

   /*
      @成员参数:title_li
      @参数作用:页面信息列表的标题
      @默认的值:__('Pages')
   */
   'title_li'    => __('Pages'),

   /*
      @成员参数:echo
      @参数作用:是否直接显示页面信息列表?
      @可选的值:
      1              直接显示      【默认】
      0              不显示,作为结果返回
   */
   'echo' => 1,

   /*
      @成员参数:meta_key 
      @参数作用:仅显示包含该参数指定的键(所谓键,是指发布页面时设置的自定栏目名称)的页面信息
   */
   'meta_key' => '',

   /*
      @成员参数:meta_value 
      @参数作用:与meta_key配合使用,meta_value是值自定义栏目的值。如果指定了一个值,那么仅显示自定义栏目的值与此参数设置的值相同的页面信息
   */
   'meta_value'   => '',

   /*
      @成员参数:link_before
      @参数作用:在页面信息的标题之前添加的内容( 举例,<a>link_before页面标题</a> )
   */
   'link_before'  => '',

   /*
      @成员参数:link_after
      @参数作用:在页面信息的标题之后添加的内容( 举例,<a>页面标题link_after</a> )
   */
   'link_after'   => '',

   /*
      @成员参数:authors
      @参数作用:显示指定作者(用作者的id编号指定)发布的页面,当要显示多个作者发布的页面时,作者的编号之间用逗号隔开(英文输入环境)
      @默认的值:空值,当值为空值时,则显示所有作者发布的页面信息
   */
   'authors'     => '',

   /*
      @成员参数:number
      @参数作用:此参数设定要显示多少篇页面信息
      @默认的值:null  没有数量限制,有多少页面就显示多少页面
   */
   'number'      => null,

   /*
      @成员参数:offset
      @参数作用:获取页面信息列表时跳过的页面信息的数量
      @特别说明:此参数仅在参数number的值为大于0的值时有效
      @默认的值:0, 即在获取页面信息列表时不跳过任何的页面信息
   */
   'offset'         => 0,

   /*
      @成员参数:post_type
      @参数作用:获取的信息类型
      @默认的值:page  即获取页面信息
      @特别说明:此处的值只能为page,填写其他的信息类型如post,则无法获取任何信息
   */
   'post_type'       => 'page',

   /*
      @成员参数:post_status
      @参数作用:调取指定状态的页面信息,如publish, private
      @默认的值:publish 即公开的页面信息, private是私密的页面信息
      @特别说明:既想显示公开的页面也想显示私有的页面,那么参数为'publish,private'
   */
   'post_status'     => 'publish',

) );
?>