WordPress 主题教程 #6b：页面链接列表

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

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

<?php wp_list_pages(); ?>

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

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

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

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

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

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

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

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

进一步定制化：

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

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

这里是我的列表的不同之处：（对比这个截图和上面的截图。）