Wordpress基本函数之wp_list_pages().doc

7史网http:/7.nu Word Press Wordpress初级教程 7史网荣誉出品|豆丁网首发 http:/7.nu 合作伙伴： 申明：为了便于搜索引擎收录，本教程分开来讲，每一讲为一个单独的函数。想看全部教程，请从目录中找。 Wordpress基本函数之wp_list_pages() 函数名：wp_list_pages（）基本用法及参数解释： 模板标签wp_list_pages( )将WordPress页面作为链接显示出来。该模板标签常用于自定义侧边栏或标题，也常用于其他模板中。该模板标签在WordPress 1.5及更新版本中可用。 作 者 原 创：列表显示页面链接部分常用参数：post_title：按标题字母顺序排列（默认）post_date：按创建时间排序post_modified：按最后修改时间排序ID：按照 id 排序post_author：按照作者 id 排序Wordpress官方：默认参数设置为：$defaults = array( depth = 0, 显示所有页面和子页面（无深度限制） show_date = , 不显示创建日期 date_format = get_option(date_format), child_of = 0, 子页面无限制 exclude = , 不删除任何页面 title_li = _(Pages), 页面列表的标题为“Pages（页面）” echo = 1, 回显（显示）结果 authors = , 不局限于特定作者 sort_column = menu_order, post_title, 先按页面顺序再按页面标题排序 link_before = , link_after = , exclude_tree= );不删除父级/子级树|隐藏或改变列表标题给title_li参数传递一个零值或空值，可以隐藏由wp_list_pages生成的页面列表默认标题。下面的代码可显示所述效果： 在下面这个例子中，列表中只包含编号为9，5，23的页面，标题内容被改为“Poetry”，格式为: ?phpwp_list_pages(include=5,9,23&title_li= ._(Poetry) . ); ? |将页面按页面顺序排列下面的例子将页面按管理栏中 Write Page 定义的页面顺序进行排列。 如果希望将列表按页面顺序进行排列并将“Prose”作为列表标题（以h2格式）显示在侧边栏中，可将以下代码添加到sidebar.php文件中： ?phpwp_list_pages(sort_column=menu_order&title_li= . _(Prose) . ); ? 使用下列代码段，可显示出无标题并以页面顺序排列的页面： |将页面按发表日期排列下列代码显示出的页面将按发表日期进行排列，在页面列表项旁显示日期。 |从列表中排除页面用exclude参数可隐藏列表中由wp_list_pages生成的若干页面。 |显示列表中特定页面若仅希望在列表中显示特定页面，例如编号为35，7，26和13的页面，可使用include参数。 ?phpwp_list_pages(include=7,13,26,35&title_li=. _(Pages) . ); ? |显示子页面注意：即使没有子页面，HTML标签也是必要的（ul或ol）。用css设置列表时需要将这一点谨记在心。 ID.&show_date=modified &date_format=$date_format); ? 以下代码仅在目前页面有子页面（将目前页面设为父级页面的页面）的情况下生成列表：ID.&echo=0); if ($children) ? |在子页面上列出子页面上述示例都是在父级页面上展示子页面，却没有说明如何在子页面上进行展示。可用下列代码在某一父页面或其中一个子页面上展示子页面。将本代码放在侧边栏的widget区块后，代码将无法运行。post_parent) $children =wp_list_pages(title_li=&child_of=.$post-post_parent.&echo=0); else $children =wp_list_pages(title_li=&child_of=.$post-ID.&echo=0); if ($children) ? 本代码也可用在sidebar.php中，仅显示顶级页面。但浏览到包含子页面的页面时，仅显示其子页面。浏览主页时在侧边栏显示所有顶级页面浏览没有子页面的顶级页面时，显示所有顶级页面浏览有子页面的顶级页面时，显示所有子页面及下一级页面浏览子页面时，显示其父级页面下的所有子页面和下一级页面?php $output =wp_list_pages(echo=0&depth=1&title_li=Top Level Pages ); if (is_page( ) $page = $post-ID; if ($post-post_parent) $page = $post-post_parent; $children=wp_list_pages( echo=0&child_of= .$page . &title_li= ); if ($children) $output = wp_list_pages (echo=0&child_of= .$page . &title_li=Child Pages); echo $output; ?页面选项标记与格式默认情况下，wp_list_pages( )生成一个嵌套的、由管理栏 Write Page 生成的无序WordPress页面列表。将title_li参数设为任意空字符后可除去最外围选项（li.pagenav）和列表（ul）。所有wp_list_pages( )生成的列表项（li）都被标上page_item类。显示页面时将调用wp_list_pages( )，这时该页面的列表项被赋予附加类current_page_item。?php Pages title_li parent of the current Page the current Page another Page 可以用CSS选择器为这些列表项进行样式设计：.pagenav /* the outermost list item;contains whole list */ .page-item-2 /* item for Page ID 2 */ .page_item /* any Page item */ .current_page_item /* the current Page */ .current_page_parent /* parent of thecurrent Page */ .current_page_ancestor /* any ancestor ofthe current Page */ 参数sort_column (字符)按不同方式对页面列表进行排序。默认设置成按页面标题的字母顺序排序。 post_title 按页面标题的字母顺序排序默认 menu_order 按页面顺序（Page Order）进行排序。注意页面顺序和页面编号的区别。页面编号是由WordPress为每篇文章或页面设定的独有的数字，而页面顺序则由用户在管理栏的WritePages中设置。 post_date 按页面创建日期排序。 post_modified 按最后修改时间进行排序。 ID 按页面序列编号排序。 post_author 按页面创建者的序列编号排序。 post_name 按页面缩略名的字母顺序排序。注意：sort_column参数可按WordPress数据库 wp_post table中任意字段的描述符来对页面列表进行排序。下面给出一些实用示例。sort_order (字符)更改页面列表的排列顺序（升序或降序）。默认为升序。可能的值为： asc 按从低到高顺序排列（默认） desc 按从高到低顺序排列exclude (字符)定义一列页面编号并用逗号隔开，将其从已有列表中删除（例如：exclude=3，7，1）。无默认值。exclude_tree (整数)与child_of相反，exclude_tree从结果中移除已知编号的所有子页面。也可用于隐藏已知页面的所有子页面。该参数还可联合child_of 的值以隐藏孙页面。在2.7版本中该参数可用。include (字符)仅包含get_pages生成的特定页面列表。include参数与exclude同样用逗号将页面编号隔开。无默认值。depth(整数)该参数决定wp_list_pages生成的列表中包含的页面层次级数。默认值为0（显示子页面内的所有页面）。 0 以层级方式（缩进）显示所有页面和子页面（默认） -1 以平级方式（不缩进）显示子页面中的页面 1 仅显示最上层页面 2 该值（或更大值）表示需要显示页面内部的层级数child_of (整数)仅显示单个页面的子页面；值为默认编号。默认值为0（显示所有页面）。注意child_of参数不仅获取直系子页面，也会从已知编号中获取“孙页面”。默认值为0（显示所有页面）。show_data(字符)在每篇页面旁显示创建日期或最新修改日期。默认值为空值（不显示日期）。可用的值包括： 不显示日期（默认） modified 显示最新修改日期 xxx 任何非modified值都将显示页面最初创建的日期（post_date）。参看上文中的示例。date_format(字符)该参数对show_date参数生成的页面日期格式（”l, F j, Y”）进行设置。默认格式为WordPress选项设定的日期格式。参见日期和时间设置以及php网站上的页面日期格式。title_li (字符)设置页面列表标题的内容与样式。默认值为“_（页面）”，显示结果为“页面”（_(”)用于本地定位）。若传递值为零或为空（”），则不显示标题，列表也不会被ul标签围绕。参见标题示例。echo (布尔型)触发显示所生成的链接列表，或将列表按HTML文本格式返回供PHP使用。默认值为1（显示生成的列表项）。可能的值包括： 1 (true) 默认 0（false）hierarchical（布尔型）在上级页面列表下以缩进方式显示下级页面。默认值为true（在父级列表项下显示