wordpress教程之wp list pages

作者:  耕堂 | 本文浏览1289次 | 2009年08月9日

wordpress模板标签/wp list pages
-描述:
显示页面链接列表。它常用于自定义sidebar或header,其他模板也可用到。
-使用:

<?php wp_list_pages( $args ); ?>

-默认使用:

<?php $args = array(‘depth’ => 0, /*所有页面和子页面都显示(无层级限制)*/

’show_date’ => , /*创建日期不显示*/

‘date_format’ => get_option(‘date_format’),

‘child_of’ => 0, /*不限制任何页面的子页*/

‘exclude’ => , /*不排除任何页面*/

‘include’ => , /*不明确包含某页面*/

‘title_li’ => __(‘Pages’), /*被列页面title属性为pages*/

‘echo’ => 1, /*显示符合参数条件的结果*/

‘authors’ => , /*不限定任何特定作者*/

’sort_column’ => ‘menu_order, post_title’, /*先按页面顺序后按页面标题*/

‘link_before’ => ,

‘link_after’ => ,

‘exclude_tree’ => ); ?> /*不排除热火父/子树*/

-参数:

  • sort_column
  • (字符串)用不同的方式列页面。默认是按页面标题的字母顺序。
    post_title -按字母顺序区分页面(默认)
    menu_order -可在后台“页面”内设置
    post_date -按创建日期区分
    post_modified -按最后修改时间区分
    id -按页面id区分
    post_author -按页面作者id区分
    post_name -按文章或页面slug字母顺序区分,slug是wordpress在创建页面或文章是自动生成,
    
    如http://www.gengtang.net/wordpress/105,可以自己编辑它
  • sort_order
  • (字符串)列页面的顺序,默认为升序,‘asc’-由低到高(默认);‘desc’-由高到低

  • exclude
  • (字符串)一个字符串,它列出不显示的页面id,各id之间以半角逗号间隔。

  • exclude_tree
  • (字符串)它类似exclude,不过它作用是不显示某个页面和其下所有子页面。

  • include
  • (字符串)只显示某些页面,页面id加半角逗号为间隔。

  • depth
  • (整数)控制显示页面层数。0 -显示所有页面和其子页面(默认);-1 -子页面水平显示,无缩进;1 -只显示上层页面(父页面);大于等于2 -指定显示的页面层数。

  • child_of
  • (整数)只显示某一页面的子页面,该参数的值为页面id,若该页面的子页面下还有子子页面,也一并显示。默认值为0,即显示所有页面。

  • show_date
  • (字符串)显示每个页面创建或上次修改日期。默认为空(不显示)。modified -显示上次修改日期;xxx -任意日期。

  • date_format
  • (字符串)控制日期显示格式。默认格式在wordpress后台“常规”选项可以设置。

  • title_li
  • (字符串)设置文本和页面列表标题样式。默认为’__(‘Pages’)',如果留空,则不显示标题。

  • echo
  • (布尔)输出列表项。1(输出-默认)0(不输出)。

  • meta_key
  • (字符串)只包含有自定义字段关键词的页面(和meta_value结合使用)。

  • meta_value
  • (字符串)只包含有自定义字段值的页面(和meta_key结合使用)。

  • link_before
  • (字符串)设置<a>标签中链接文本前的文本或html(自2.7版加入)。

  • link_after/li>
    (字符串)设置<a>标签中链接文本后的文本或html(自2.7版加入)。
  • authors
  • (字符串)值为作者id加逗号间隔,只列出指定id的作者编辑的页面。如未指定id,所有作者编辑的页面都可以列出。

  • number
  • (整数)设置要显示的页面数(自2.8版加入)。

  • offset
  • (整数)在列页面之前要越过的页面数。默认没有。(自2.8版加入)
    -例子:
    1.默认列表标题为Pages,下面是在列表前不显示标题。

    <ul><?php wp_list_pages(‘title_li=’); ?>

    </ul>

    2.只显示id为9、5和23的页面,列表标题为Poetry。

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

    ?>

    </ul>

    3.按wordpress后台“页面”编辑里设置的page order列页面。

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

    </ul>

    4.按wordpress后台“页面”编辑里设置的page order列页面,并以prose为标题。

    <ul><?php wp_list_pages(’sort_column=menu_order&title_li=<h2>

    ‘ . __(‘Prose’) . ‘</h2>’ ); ?>
    </ul>

    5.按wordpress后台“页面”编辑里设置的page order列页面,并不设置标题。

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

    6.按页面创建日期显示页面,并在每个列表项后显示日期。

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

    7.显示除id为17和38以外的页面。

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

    8.只显示id为7、13、26和35的页面,并以pages为标题。

    <ul><?php wp_list_pages(‘include=7,13,26,35&title_li=<h2>

    ‘ . __(‘Pages’) . ‘</h2>’ ); ?>
    </ul>

    9.对于2.0.1以前的版本,在页面模板中wp list pages按如下用。

    <ul><?php

    global $id;

    wp_list_pages(“title_li=&child_of=$id&show_date=modified

    &date_format=$date_format”); ?>

    </ul>

    文章分页: 1 2

     右上方更多相关内容/站内搜索-关键词请用空格隔开

  • 标签 :  , , , ,
  • 原文链接 : http://www.gengtang.net/wordpress/wp-list-pages.html
  • 转载原创文章请注明 : 耕堂-gengtang.net
  • 发表留言

    可用HTML标签:<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>