wordpress CMS主题 微信
Home > wordpress主题常用函数 > wordpress常用函数详解13:wp_list_pages()

wordpress常用函数详解13:wp_list_pages()

高时银博客 wordpress主题常用函数 点击: 2,331 次 0 1

wp_list_pages()函数的功能是以页面名称的超链接形式显示WordPress博客内的所有页面。wp_list_pages()函数在WordPress还没有出现自定义菜单功能的时候,常使用该函数做网站导航使用,大多用来修饰侧边栏。

wp_list_pages()函数语法结构:

wp_list_pages(’title_li=&sort_column=menu_order&include=12,25,38,57&depth=1& ’);

wp_list_pages()函数各参数意义如下:

  • title_li=:用来设置所有显示页面的一个总名称;后面没有参数值时,表示不显示名称;默认值为“_(’页面’)”,显示结果为“页面”。
  • sort_column=menu_order:表示按照WP后台设置的各页面顺序显示,post_title按标题字母顺序排序(默认)、post_date、ID、post_modified按最后修改时间、post_author按页面创建者排序等等;
  • include=12,25,38,57:表示只显示ID为这四个数值的四个页面;同样,也可以使用exclude来排除相应ID的页面;
  • depth=1:表示只显示父页面,对所有子页面不予显示;其他数值还包括默认的0,表示显示所 有页面(子页面有缩进);-1显示所有页面(子页面无缩进);2 表示需要显示页面内部的层级数;
  • ort_order:更改页面列表的排列顺序(升序或降序)。默认为升序‘asc’、‘desc’。
  • child_of :仅显示单个页面的子页面;值为默认编号。默认值为0(显示所有页面)。注意child_of参数不仅获取直系子页面,也会从已知编号中获取“孙页面”。默认值为0(显示所有页面)。
  • show_data:在每篇页面旁显示创建日期或最新修改日期。默认值为空值(不显示日期)。可用的值包括:' '不显示日期(默认)、‘modified’ 显示最新修改日期。
  • date_format:该参数对show_date参数生成的页面日期格式(”l, F j, Y”)进行设置。默认格式为WordPress选项设定的日期格式。参见日期和时间设置以及php网站上的页面日期格式。
  • echo:触发显示所生成的链接列表,或将列表按HTML文本格式返回供PHP使用。默认值为1(显示生成的列表项)。可能的值包括:1 (true) 、0(false)。
  • hierarchical:在上级页面列表下以缩进方式显示下级页面。默认值为true(在父级列表项下显示其子页面)。可能的值有:1(true)、0(false)。
  • meta_key:仅包含含有该自定义字段关键字的页面(与meta_value字段联合使用)。
  • meta_value:仅包含含有该自定义字段值的页面(与meta_key字段联合使用)。

 


文章作者:高时银博客
本文地址:http://wanlimm.com/77201403131434.html
版权所有 © 转载时必须以链接形式注明作者和原始出处!

目前还没有评论。赶快来坐沙发吧。

发表评论