WordPress 主题教程 #6b：页面链接列表
2007年06月11日
页面链接列表是从零开始创建 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 页面链接，你将不会注意有什么不同。）
这里是我的列表的不同之处：（对比这个截图和上面的截图。）
WordPress 主题教程
- WordPress 主题教程：从零开始制作 WordPress 主题
- WordPress 主题教程 #1：介绍
- WordPress 主题教程 #2：模板文件和模板
- WordPress 主题教程 #3：开始 Index.php
- WordPress 主题教程 #4a：Header 模板
- WordPress 主题教程 #4b：Header 模板 2
- WordPress 主题教程 #5：主循环
- WordPress 主题教程 #5b：日志内容
- WordPress 主题教程 #5c：日志元数据
- WordPress 主题教程 #5d：Else，日志 ID，链接标题
- WordPress 主题教程 #5e：日志导航链接
- WordPress 主题教程 #6：侧边栏
- WordPress 主题教程 #6b：页面链接列表
- WordPress 主题教程 #6c：存档和链接列表
- WordPress 主题教程 #6d：搜索框和日历
- WordPress 主题教程 #6e：窗体化侧边栏
- WordPress 主题教程 #7：尾部
- WordPress 主题教程 #8：验证 XHTML
- WordPress 主题教程 #9：Style.css 和 CSS 介绍
- WordPress 主题教程 #10：十六进制颜色代码和样式化链接
- WordPress 主题教程 #11：宽度和布局
- WordPress 主题教程 #12：日志样式化和其他杂项
- WordPress 主题教程 #13：样式化侧边栏
- WordPress 主题教程 #14：底部和拆分 Index
- WordPress 主题教程 #15：子模板文件
- WordPress 主题教程 #16：留言模板
- erdaoo 的 WP Theme 教程学习笔记
- WordPress 主题教程电子书下载
翻译自：http://www.wpdesigner.com/2007/03/03/wp-theme-lesson-6b-page-link-listing/，并根据中文习惯和个人理解做了修改！
18 条评论 添加你的评论 →
1. axz | 2007:06:12 - 15:08:37 | #
ok
2. 妈马米丫 | 2007:06:12 - 16:59:53 | #
猪 翻的太快了 来不及消化了~~~~
3. Denis | 2007:06:12 - 20:01:54 | #
慢慢看，黑大粗，我又不会删除！
4. 白驼山人 | 2007:08:11 - 01:58:16 | #
增加 depth 这个参数到函数 wp_list_pages() 并把它设置为 3：
为什么给出的图例中确是 cepth？？？
5. Denis | 2007:08:11 - 11:57:11 | #
你够细心，原作者笔误吧！
6. luis | 2007:11:11 - 18:22:04 | #
‘title_li=Pages’这里的Pages出来以后固定的，是否能像_e()这样让pages变成当前的语言呢，请指点一下！
7. levon | 2008:01:20 - 14:47:29 | #
楼上滴朋友，我也是新手哈，你的问题我也遇到了，，琢磨了下，这样改就行了：
ul>
h2>
?php wp_list_pages();?>
我把每行前的 < 去掉了，要不这里显示不出来
8. levon | 2008:01:20 - 14:50:15 | #
哎，，还是没显示全，我再发下试试
ul>
h2> ?php _e(‘Pages’);?> /h2>
?php wp_list_pages();?>
第2行的？前有 < ， 后面的 / 前也有个 <
这个其实和分类那里的道理是一样的，，摸索一下总会成功的
9. levon | 2008:01:20 - 15:13:29 | #
原来我改的也不对。看来只能修改成中文，保存UTF8格式了。
10. knight | 2008:01:24 - 12:24:39 | #
这个后面参数是什么意思？
11. knight | 2008:01:24 - 12:25:22 | #
php wp_list_pages(‘include=2,6,7,8,16&title_li=&depth=-1′);
是这个……
12. office2003 | 2008:03:08 - 17:08:30 | #
我想把“链接”两个字换了“可不知道怎么换！
13. kyle | 2008:05:06 - 11:14:41 | #
假如我只想显示perent1底下的链接（即二级页面的链接）该怎么写？
14. 月光使者 | 2009:03:08 - 14:54:11 | #
在这里添加那个 title_li=”Pages”
如果Pages是中文 “页面” 的话,显示的是乱码?
怎么让他前台显示的是”页面” 而不是 “Pages” 怎么做??
15. airdream | 2009:04:24 - 10:24:38 | #
同上
16. bolo | 2009:06:02 - 19:49:55 | #
继续学习，老是忘了
17. wordpp | 2009:10:19 - 17:26:06 | #
为什么我显示的是
Pages
关于
后台链接里面有链接啊，不懂！！
求助
18. 丸子 | 2009:12:31 - 17:38:44 | #
鱼叔新年快乐！