编辑“WordPress模板标签之wp list pages”（章节）

==参数==
'''sort_column (字符)'''

按不同方式对页面列表进行排序。默认设置成按页面标题的字母顺序排序。
*'post_title' —— 按页面标题的字母顺序排序——默认 
*'menu_order' —— 按页面顺序（Page Order）进行排序。注意页面顺序和页面编号的区别。页面编号是由WordPress为每篇文章或页面设定的独有的数字，而页面顺序则由用户在管理栏的页面>编辑页面中设置。 
*'post_date' —— 按页面创建日期排序。 
*'post_modified' —— 按最后修改时间进行排序。 
*'ID' —— 按页面序列编号排序。 
*'post_author' —— 按页面创建者的序列编号排序。 
*'post_name' —— 按页面缩略名的字母顺序排序。 
注意：sort_column参数可按WordPress数据库 wp_post table中任意字段的描述符来对页面列表进行排序。下面给出一些实用示例。

'''sort_order (字符)'''

更改页面列表的排列顺序（升序或降序）。默认为升序。可能的值为：
*'asc' ——按从低到高顺序排列（默认） 
*'desc' —— 按从高到低顺序排列 

'''exclude (字符)'''

定义一列页面编号并用逗号隔开，将其从已有列表中删除（例如：'exclude=3，7，1'）。无默认值。

'''exclude_tree (整数)'''

与'child_of'相反，'exclude_tree'从结果中移除已知编号的所有子页面。也可用于隐藏已知页面的所有子页面。该参数还可联合'child_of' 的值以隐藏孙页面。在2.7版本中该参数可用。

'''include (字符)'''

仅包含get_pages生成的特定页面列表。include参数与exclude同样用逗号将页面编号隔开。无默认值。

'''depth(整数)'''

该参数决定wp_list_pages生成的列表中包含的页面层次级数。默认值为0（显示子页面内的所有页面）。

*0 — 以层级方式（缩进）显示所有页面和子页面（默认） 
*-1 — 以平级方式（不缩进）显示子页面中的页面 
*1 — 仅显示最上层页面 
*2 — 该值（或更大值）表示需要显示页面内部的层级数 

'''child_of (整数)'''

仅显示单个页面的子页面；值为默认编号。默认值为0（显示所有页面）。注意child_of参数不仅获取直系子页面，也会从已知编号中获取“孙页面”。默认值为0（显示所有页面）。

'''show_data(字符)'''

在每篇页面旁显示创建日期或最新修改日期。默认值为空值（不显示日期）。可用的值包括：

*' ' — 不显示日期（默认） 
*'modified' — 显示最新修改日期 
*'xxx' — 任何非'modified'值都将显示页面最初创建的日期（post_date）。参看上文中的示例。 

'''date_format(字符)'''

该参数对show_date参数生成的页面日期格式（"l, F j, Y"）进行设置。默认格式为WordPress选项设定的日期格式。参见设置日期和时间格式以及php网站上的页面日期格式。

'''title_li (字符)'''

设置页面列表标题的内容与样式。默认值为“_（'页面'）”，显示结果为“页面”（_('')用于本地定位）。若传递值为零或为空（''），则不显示标题，列表也不会被< ul>，< ul>标签围绕。参见标题示例。

'''echo (布尔型)'''

触发显示所生成的链接列表，或将列表按[[HTML]]文本格式返回供PHP使用。默认值为1（显示生成的列表项）。可能的值包括：

*1 (true) — 默认 
*0（false） 

'''hierarchical'''

（布尔型）在上级页面列表下以缩进方式显示下级页面。默认值为true（在父级列表项下显示其子页面）。可能的值有：

*1（true）——默认 
*0（false） 

'''meta_key'''

（字符）仅包含含有该自定义字段关键字的页面（与meta_value字段联合使用）。

'''meta_value'''

（字符）仅包含含有该自定义字段值的页面（与meta_key字段联合使用）。

'''link_before（字符）'''

设置标签<a>中文字链接前的文本或html代码。（适用于2.7.0或更新版本）

'''link_after（字符）'''

设置标签<a>中文字链接后的文本或html代码。（适用于2.7.0或更新版本）
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*