站长百科 | 数字化技能提升教程 数字化时代生存宝典
首页
数字化百科
电子书
▼
建站程序
开发
服务器
办公软件
开发教程
▼
服务器教程
软件使用教程
运营教程
热门电子书
▼
CSS教程
WordPress教程
导航
程序频道
推广频道
网赚频道
人物频道
网站程序
网页制作
云计算
服务器
CMS
论坛
网店
虚拟主机
cPanel
网址导航
WIKI使用导航
WIKI首页
热点词条
最新资讯
网站程序
站长人物
页面分类
使用帮助
编辑测试
创建条目
网站地图
站长百科导航
站长百科
主机侦探
IDCtalk云说
跨境电商导航
WordPress啦
站长专题
网站推广
网站程序
网站赚钱
虚拟主机
cPanel
网址导航专题
云计算
微博营销
虚拟主机管理系统
开放平台
WIKI程序与应用
美国十大主机
编辑“
WordPress:Template Tags/wp list pages
”
人物百科
|
营销百科
|
网赚百科
|
站长工具
|
网站程序
|
域名主机
|
互联网公司
|
分类索引
跳转至:
导航
、
搜索
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
== 描述 == 模板标签,'''wp_list_pages()''',显示了WordPres[[WordPress:Pages|网页]]的一个列表,作为一列链接。'''wp_list_pages()'''通过用来自定义[[WordPress:Customizing_Your_Sidebar|Sidebar]]或者 [[WordPress:Designing_Headers|Header]],但是也可能在其它的[[WordPress:Templates|模板]]中使用。 WordPress1.5版本以及更新的版本中拥有这个[[WordPress:Template Tags|模板标签]]。 == 用法== %%% <?php wp_list_pages('arguments'); ?> %%% == 例子== ===默认用法=== <pre> $defaults = array( 'depth' => 0, 'show_date' => '', 'date_format' => get_option('date_format'), 'child_of' => 0, 'exclude' => '', 'title_li' => __('Pages'), 'echo' => 1, 'authors' => '', 'sort_column' => 'menu_order, post_title'); </pre> 默认情况下,用法显示: *显示了所有的网页和子网页(没有层级限制) *不显示创建的日期 *不限制到任何网页的子网页 *不删除任何网页 *网页的标题列为"网页" *结果得到反映(显示) *文章不限制为某个作者的 *有网页顺序分类然后有网页标题分类。 *以升序分类(不在上面的默认设置中显示) *网页以层级嵌套的方式显示(不在上面的默认设置中显示) *包含所有的网页(不在上面的默认设置中显示) *不限制为拥有特别的meta key/meta参数值的网页(不显示在上述的默认设置中) wp_list_pages(); === 隐藏或者更改列表标头=== ''wp_list_pages''产生的网页("网页")列表的默认标题,可以通过向'''title_li''' 参数传递一个零或者空参数值,得到隐藏。下面的例子显示了列表上方没有标题文本。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('title_li='); ?> <br /> </ul> </tt> </div> 在下面的例子中,只有ID是9,5,23的网页包含在列表中而且标题文本被更改为"诗",标头形式为<tt><nowiki><h2></nowiki></tt>: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?> <br /> </ul> </tt> </div> === 根据网页顺序列出网页 === 下面的例子,根据[[WordPress:Administration_Panels#Write_Page|写]] > [[WordPress:Write_Page_SubPanel|网页]] 管理面板中设置的每个网页的'''排序'''来列出网页。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('sort_column=menu_order'); ?> <br /> </ul> </tt> </div> 如果你想要根据网页顺序给列表分类,而且在工具条上显示"散文"作为列表标题(以h2样式),你可以添加以下的代码到sidebar.php文件上: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('sort_column=menu_order&title_li=<h2>' . __('Prose') . '</h2>' ); ?> <br /> </ul> </tt> </div> 使用下面的这些代码,网页会以''网页顺序''显示,而且还没有标题: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('sort_column=menu_order&title_li='); ?> <br /> </ul> </tt> </div> === 根据文章日期给网页分类=== 这个例子显示了网页根据(创建)日期分类,而且在每个网页列表item的旁边显示了日期。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('sort_column=post_date&show_date=created'); ?> <br /> </ul> </tt> </div> === 从列表中删除网页=== 使用'''删除'''参数隐藏''wp_list_pages''产生的列表中的某个网页。<!-- '''注''': 网页数字必须以升序=排列(例如<tt>'删除=17,38'</tt> 而不 <tt>'删除=38,17'</tt>). 注意至少这个对于2.1.3 是行不通的--> <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('exclude=17,38' ); ?> <br /> </ul> </tt> </div> === 在列表中包含网页=== 在一个列表中只包含某个特别的网页,例如,ID数字为35,7,26和13的网页,使用'''包含'''参数。<!--'''注''': 网页数字必须以升序排列(例如 <tt>'include=7,13,26,35'</tt> 而不是<tt>'include=35,7,26,13'</tt>)。 至少2.1.3这样的序列是行不通的--> <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('include=7,13,26,35&title_li=<h2>' . __('Pages') . '</h2>' ); ?> <br /> </ul> </tt> </div> ===列出子网页(Wordpress 2.0.1之前的版本)=== 将这个放到<tt>the_content()</tt>后的WordPress主题的page.php 模板的<tt>the_post()</tt>部分的内部,或者将这个放到page.php模板的一个拷贝中,你为拥有子网页的网页使用这个page.php模板: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> global $id; // teensy bit insane, sorry <br /> $date_format = '<\b\r /><\s\p\a\n '. '\s\t\y\l\e="\f\o\n\t-\s\i\z\e: \s\m\a\l\l\e\r">'. '\l\a\s\t\m\o\d Y-n-j</\s\p\a\n>'; wp_list_pages("title_li=&child_of=$id&show_date=modified<br /> &date_format=$date_format"); ?> <br /> </ul> </tt> </div> <span style="color:#c00;">注:如果这个例子放到了一个网页模板中,在WordPress2.0.1或者更新的版本中不能够运行,因为没有设置全局$id。使用下面的代码</span> === 列出子网页 (Wordpress 2.0.1 或者更新的版本)=== 注意:即使没有子网页,也需要一个HTML标签(<tt><nowiki><ul></nowiki></tt> 或者<tt><nowiki><ol></nowiki></tt>)。当你使用css设计列表的时候,要牢记这一点。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_pages('title_li=&child_of='.$post->ID.'&show_date=modified<br /> &date_format=$date_format'); ?> <br /> </ul> </tt> </div> 只有当前的网页拥有子网页的时候,下面的例子才会产生一个列表(子网页是指定当前网页为母网页的网页): <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <?php<br /> $children = wp_list_pages('title_li=&child_of='.$post->ID.'&echo=0');<br /> if ($children) { ?> <br /> <ul> <br /> <?php echo $children; ?> <br /> </ul> <br /> <?php } ?> </tt> </div> === 即使没有子网页,也列出子网页 === 上述的例子指示显示了来自于母网页的子网页,但是并不是真正地在一个子网页上,这个代码会显示子网页,而且只有子网页在母网页上或者在其中的一个子网页上时,才会显示。 ** 警醒 ** 如果将这个代码放到一个工具条上的一个widget 块上时,这个代码就不会运行。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <?php<br /> if($post->post_parent)<br /> $children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0"); else<br /> $children = wp_list_pages("title_li=&child_of=".$post->ID."&echo=0");<br /> if ($children) { ?><br /> <ul> <br /> <?php echo $children; ?> <br /> </ul> <br /> <?php } ?> </tt> </div> === 网页items的标记和样式=== 默认情况下,'''wp_list_pages()'''产生一个无序的,嵌套的WordPress[[WordPress:Pages|网页]],这个网页是用[[WordPress:Administration_Panels#Write_Page|写]] > [[WordPress:Write_Page_SubPanel|网页]]管理面板创建的。你可以通过将<var>title_li</var>参数设置为一个空字符串,可以移除最外面的item(<tt>li.pagenav</tt>)并且列出(<tt>ul</tt>)。 '''wp_list_pages()'''产生的所有的列表items(<tt>li</tt>)都标记了class <tt>page_item</tt>。当显示网页的时候,调用了'''wp_list_pages()''',关于那个网页的列表item会得到额外的class<tt>current_page_item</tt>。 <pre> <li class="pagenav"> Pages <ul> <li class="page_item current_page_parent"> [parent of the current page] <ul> <li class="page_item current_page_item"> [the current page] </li> </ul> </li> <li class="page_item"> [another page] </li> </ul> </li> </pre> 这些可以用[[WordPress:Glossary#CSS|CSS 选择器]]设计: .pagenav { ... } .page_item { ... } .current_page_item { ... } .current_page_parent { ... } == 参数== ; '''sort_column''' (''string''):以许多不同的方式给列出的网页分类。默认设置为''根据网页标题的字母顺序分类''。 :* <tt>'post_title'</tt> - (根据标题)将网页按照字母顺序分类-默认 :* <tt>'menu_order'</tt> -根据网页顺序给网页分类。''N.B.'' 注意''Page Order'' 和''Page ID''之间的区别。网页ID是一个独特的数字,是由WordPress指定给每篇文章或者每个网页的。用户可以在[[WordPress:Write_Page_SubPanel|写>网页]]管理面板上设置网页顺序。请看看下面的[[#WordPress:List Pages by Page Order|例子]]。 :* <tt>'post_date'</tt> - 根据创建时间分类。 :* <tt>'post_modified'</tt> - 根据最后一次更改分类。 :* <tt>'ID'</tt> - 根据网页ID分类。 :* <tt>'post_author'</tt> -根据网页作者的 ID分类。 :* <tt>'post_name'</tt> - 根据文章的[[WordPress:Glossary#Slug|slug]],按字母顺序分类。 ---- '''注:''' '''sort_column'''参数可以用来给列出的网页分类,根据WordPress数据库的[[WordPress:Database Description#Table:_wp_posts|wp_post table]]的任何栏中的描述符来给文章分类。这里列出了一些有用的例子。 ---- ; '''sort_order''' (''string''):更改列出的网页的分类顺序(升序的或者降序的)。默认为''升序的'',有效的参数值: :* <tt>'asc'</tt> -从最低到最高分类 (默认)。. :* <tt>'desc'</tt> - 从最高到最低分类。 ; '''exclude''' (''string''):默认用逗号将需要从列表上删除的网页的ID分开(例如:<tt>'exclude=3,7,31'</tt>)。没有默认参数值。请看看下面的例子[[#WordPress:Exclude Pages from List|从列表中删除网页]]。 ; '''include''' (''string''):在''wp_list_pages''产生的列表上只包含特别的网页。像'''删除''',这个参数拥有一个用逗号分开的网页ID列表。没有默认参数值。请看看[[#WordPress:Include Pages in List|在一个列表中包含网页]]下面的例子。 ; '''depth''' (''integer''):这个参数控制了''wp_list_pages''产生的列表中可以包含多少层级的网页。默认值为''0''(显示所有的网页,包括子网页)。 :* <tt>0</tt> -以层级(嵌套)方式(默认)显示的网页和子网页。 :* <tt>-1</tt> -子网页中的网页以flat(非嵌套)的方式显示。 :* <tt>1</tt> -只显示最高级别的网页 :* <tt>2</tt> -值为2(或者更高)规定了显示网页时,可以下降的层次(或者层级)。 ; '''child_of''' (''integer''):只显示一个单独网页的子网页;为一个网页使用ID作为参数值。默认为''0''(显示所有网页)。 ; '''show_date''' (''string''):在每个网页的旁边显示创建或者最后更改的日期。默认值为''零''(不显示日期)。有效的参数值: :* <tt>'<nowiki></nowiki>'</tt> -不显示日期(默认)。 :* <tt>'modified'</tt> - 显示最后更改的日期。 :* <tt>'xxx'</tt> - 除了''modified''的任何参数值显示了网页首次创建时的日期('''文章_日期''')。请看看下面的[[#WordPress:Sort Pages by Post Date|例子]]。 ; '''date_format''' (''string''):控制了'''show_date'''参数设置的网页日期格式(例如:"<tt><nowiki>l, F j, Y</nowiki></tt>")。这个参数默认日期格式为配置在WordPress上的选项。请看看[[WordPress:Formatting Date and Time|日期和时间格式]]和[http://php.net/date php 网站上的日期格式网页] ; '''title_li''' (''string''):设置网页列表的标头的文本和样式。默认为<tt>'__('Pages')'</tt>,显示了"网页"(为[[WordPress:Localization|本地化目的]]使用<tt>__('')</tt>)。如果传递了一个零或者空的参数值,(<tt>''</tt>),不显示任何标题,而且列表也不会外包上<tt><ul>, </ul></tt>标签。请看看关于[[#WordPress:Hiding or Changing the List Heading|标头]]的例子。 ; '''echo''' (''boolean''):Toggles链接产生的列表的显示或者返回链接作为HTML文本字符串,用于PHP。默认值为''1''(显示产生的列表item)。有效的参数值: :* <tt>1 (true)</tt> - 默认 :* <tt>0 (false)</tt> ; hierarchical : (''boolean'') 在母网页下,以嵌套的方式显示子网页,或者列出网页inline。默认为''真的''(显示嵌套在母列表item下面的子网页)。有效的参数值: :* <tt>1 (true)</tt> - default :* <tt>0 (false)</tt> ; meta_key : (''string'')只包含拥有这个自定义Field Key的网页(和meta_value field用在一起)。 ; meta_value : (''string'') 只包含拥有这个自定义Field Key参数值的网页(和meta_key field用在一起)。 == 相关的 == {{标签 总 标签}} {{查询 字符串 标签 页底文字}} {{Copyedit}}
摘要:
请注意,您对站长百科的所有贡献都可能被其他贡献者编辑,修改或删除。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源(参阅
Wordpress-mediawiki:版权
的细节)。
未经许可,请勿提交受版权保护的作品!
取消
编辑帮助
(在新窗口中打开)
本页使用的模板:
模板:Copyedit
(
编辑
)
模板:查询 字符串 标签 页底文字
(
编辑
)
模板:标签 总 标签
(
编辑
)