WordPress页面函数：wp_list_pages()

2010-04-04 20:35 ⁄ WP相关 ⁄ 共 5399字 ⁄ 字号小中大 ⁄ 评论 1 条

模板标签wp_list_pages( )将WordPress页面作为链接显示出来。该模板标签常用于自定义侧边栏或标题，也常用于其他模板中。该模板标签在WordPress 1.5及更新版本中可用。
用法：

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

默认参数设置为：

$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'=> '' );不删除父级/子级树

隐藏或改变列表标题

给title_li参数传递一个零值或空值，可以隐藏由wp_list_pages生成的页面列表默认标题。下面的代码可显示所述效果：

<ul>?
<?php wp_list_pages('title_li='); ?>?
</ul>

在下面这个例子中，列表中只包含编号为9，5，23的页面，标题内容被改为“Poetry”，格式为< h2 >:

<ul>? ?
? <?php wp_list_pages('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>?
</ul>

将页面按页面顺序排列

下面的例子将页面按管理栏中 Write > Page 定义的页面顺序进行排列。

<ul>? ?
? <?php wp_list_pages('sort_column=menu_order'); ?>?
</ul

如果希望将列表按页面顺序进行排列并将“Prose”作为列表标题（以h2格式）显示在侧边栏中，可将以下代码添加到sidebar.php文件中：

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

使用下列代码段，可显示出无标题并以页面顺序排列的页面：

<ul>? ?
? <?php wp_list_pages('sort_column=menu_order&title_li='); ?>?
</ul>

将页面按发表日期排列

下列代码显示出的页面将按发表日期进行排列，在页面列表项旁显示日期。

<ul>? ?
? <?php wp_list_pages('sort_column=post_date&show_date=created'); ?>?
</ul>

从列表中排除页面

用exclude参数可隐藏列表中由wp_list_pages生成的若干页面。

<ul>? ?
? <?php wp_list_pages('exclude=17,38' ); ?>?
</ul>

显示列表中特定页面

若仅希望在列表中显示特定页面，例如编号为35，7，26和13的页面，可使用include参数。

<ul>? ?
? <?php wp_list_pages('include=7,13,26,35&title_li=<h2>' . __('Pages') . '</h2>' ); ?>? ?
</ul>

显示子页面

注意：即使没有子页面，HTML标签也是必要的（ul或ol）。用css设置列表时需要将这一点谨记在心。

<ul>? ?
? <?php? ?
? wp_list_pages('title_li=&child_of='.$post->ID.'&show_date=modified? ?
? &date_format=$date_format'); ?>? ?
</ul>

以下代码仅在目前页面有子页面（将目前页面设为父级页面的页面）的情况下生成列表：

<?php? ?
? $children = wp_list_pages('title_li=&child_of='.$post->ID.'&echo=0');? ?
? if ($children) { ?>? ?
? <ul>? ?
? <?php echo $children; ?>? ?
? </ul>? ?
? <?php } ?>

在子页面上列出子页面

上述示例都是在父级页面上展示子页面，却没有说明如何在子页面上进行展示。可用下列代码在某一父页面或其中一个子页面上展示子页面。

将本代码放在侧边栏的widget区块后，代码将无法运行。

<?php? ?
? if($post->post_parent)? ?
? $children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0");? ?
? else? ?
? $children = wp_list_pages("title_li=&child_of=".$post->ID."&echo=0");? ?
? if ($children) { ?>? ?
? <ul>? ?
? <?php echo $children; ?>? ?
? </ul>? ?
? <?php } ?>

本代码也可用在sidebar.php中，仅显示顶级页面。但浏览到包含子页面的页面时，仅显示其子页面。

浏览主页时在侧边栏显示所有顶级页面
浏览没有子页面的顶级页面时，显示所有顶级页面
浏览有子页面的顶级页面时，显示所有子页面及下一级页面
浏览子页面时，显示其父级页面下的所有子页面和下一级页面

<?php?
$output = wp_list_pages('echo=0&depth=1&title_li=<h2>Top Level Pages </h2>' );?
if (is_page( )) {? ?
? $page = $post->ID;? ?
? if ($post->post_parent) {? ? ?
?? ?$page = $post->post_parent;? ?
? }? ?
? $children=wp_list_pages( 'echo=0&child_of=' . $page . '&title_li=' );? ?
? if ($children) {? ? ?
?? ?$output = wp_list_pages ('echo=0&child_of=' . $page . '&title_li=<h2>Child Pages</h2>');? ?
? }?
}?
echo $output;?
?>

页面选项标记与格式

默认情况下，wp_list_pages( )生成一个嵌套的、由管理栏 Write > Page 生成的无序WordPress页面列表。将title_li参数设为任意空字符后可除去最外围选项（li.pagenav）和列表（ul）。

所有wp_list_pages( )生成的列表项（li）都被标上page_item类。显示页面时将调用wp_list_pages( )，这时该页面的列表项被赋予附加类current_page_item。

<?php
<li class="pagenav">?
Pages [title_li]? ?
? <ul>? ? ?
?? ?? ? ?
?? ?<li class="page-item-2 page_item current_page_ancestor current_page_parent">? ? ? ?
?? ? ?[parent of the current Page]? ? ? ?
?? ? ?<ul>? ? ? ? ?
?? ? ? ?<li class="page-item-21 page_item current_page_item">? ? ? ? ? ?
?? ? ? ? ?[the current Page]? ? ? ? ?
?? ? ? ?</li>? ? ? ?
?? ? ?</ul>? ? ?
?? ?</li>? ? ?
?? ?<li class="page-item-3 page_item">? ? ? ?
?? ? ?[another Page]? ? ?
?? ?</li>? ?
? </ul>?
</li>

可以用CSS选择器为这些列表项进行样式设计：

.pagenav { … } /* the outermost list item; contains whole list */?
.page-item-2 { … } /* item for Page ID 2 */?
.page_item { … } /* any Page item */?
.current_page_item { … } /* the current Page */?
.current_page_parent { … } /* parent of the current Page */?
.current_page_ancestor { … } /* any ancestor of the current Page */? 参数
sort_column (字符)

按不同方式对页面列表进行排序。默认设置成按页面标题的字母顺序排序。

‘post_title’ ?? 按页面标题的字母顺序排序??默认
‘menu_order’ ?? 按页面顺序（Page Order）进行排序。注意页面顺序和页面编号的区别。页面编号是由WordPress为每篇文章或页面设定的独有的数字，而页面顺序则由用户在管理栏的Write>Pages中设置。
‘post_date’ ?? 按页面创建日期排序。
‘post_modified’ ?? 按最后修改时间进行排序。
‘ID’ ?? 按页面序列编号排序。
‘post_author’ ?? 按页面创建者的序列编号排序。
‘post_name’ ?? 按页面缩略名的字母顺序排序。

注意：sort_column参数可按WordPress数据库 wp_post table中任意字段的描述符来对页面列表进行排序。下面给出一些实用示例。

sort_order (字符)

更改页面列表的排列顺序（升序或降序）。默认为升序。可能的值为：