页面链接列表是从零开始创建 WordPress 主题系列教程的第六篇的第二部分,通过上一篇的学习,现在已经熟悉了侧边栏的结构,接下来我们将继续修改侧边栏,完成页面链接(Page-link)列表。当完成常规的侧边栏之后,我们将学习如何窗体化(widgetize)侧边栏。

在分类链接上面添加以下代码:

<?php wp_list_pages(); ?>

wp-list-pages.gif

保存并刷新浏览器。效果如下所示:

wp-list-pages-listing.gif

在默认情况下只有一个页面链接,就是 About 链接。我在我的本地的博客增加了很多多页面和子页面,这样我就有四级页面链接。

查看页面源代码,我们可以看到 wp_list_pages() 产生的完整结构以及代码,如下:

wp-list-pages-default.gif

第一,它把所有东西放入列表元素标签(LI),第二,它给列表一个名字,Pages 。第三,它增加一个无序列表(UL)。第四,它把每个链接放入到 <li></li> 标签之间。

在上面的截图中,注意到 “Pages” 这个列表标题和 “Categories” 这个分类链接标题的大小不一样。

如何使它们一致呢? 添加 ‘title_li=<h2>Pages</h2>’wp_list_pages() 作为参数。

title-li.gif

保存并刷新浏览器结果如下:

wp-list-pages-listing-2.gif

title_li 是一个用来定制化页面链接列表的标题的参数。<h2>Pages</h2>title_li 这个参数的值

进一步定制化

在我的例子中,我有四级页面链接。由于布局或者设计的原因使得不能在侧边栏处理那么多级别的链接。为了限制显示列表的层数,增加了 depth 这个参数,并把它设置为 3

add-depth3.gif

注意,我添加了 depth=3& 而不是仅仅 depth=3 。这个 & 在这儿用于把 depthtitle_li 这两个参数区分开。(如果你只有一个 about 页面链接,你将不会注意有什么不同。)

这里是我的列表的不同之处:(对比这个截图和上面的截图。)

wp-list-pages-listing-3.gif