wp_list_pages()-WordPress模板函数 显示页面信息列表

<?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',

) );
?>