1. 首页
  2. Wordpress教程

WordPress获取所有子页面get_pages与wp_list_pages()

在页面模板的制作中,很多时候会在侧边栏调用当前页面的子页面名字和链接。如用于展示教程的页面模板,需要调用当前Page页面的page子页面标题、内容、链接、特色图像等内容,可以通过get_pages函数获取所属子页面信息,然后使用foreach循环输出。

get_pages函数

说明:get_pages( )函数用于获取博客中已定义页面的列表。下面是它的典型用法。
用法<?php get_pages(‘arguments’); ?>

参数
sort_column (字符)按不同方式对页面列表进行排序。默认设置成按页面标题的字母顺序排序。’post_title’ —— 按页面标题的字母顺序排序——默认
‘menu_order’ —— 按页面顺序(Page Order)进行排序。注意页面顺序和页面编号的区别。页面编号是由WordPress为每篇文章或页面设定的独有的数字,而页面顺序则由用户在管理栏的Write>Pages中设置。
‘post_date’ —— 按页面创建日期排序。
‘post_modified’ —— 按最后修改时间进行排序。
‘ID’ —— 按页面序列编号排序。
‘post_author’ —— 按页面创建者的序列编号排序。
‘post_name’ —— 按页面缩略名的字母顺序排序。

sort_order (字符) 更改页面列表的排列顺序(升序或降序)。默认为升序。可能的值为:’asc’ ——按从低到高顺序排列(默认);’desc’ —— 按从高到低顺序排列

exclude (字符) 定义一列页面编号并用逗号隔开,将其从已有列表中删除(例如:’exclude=3,7,1’)。无默认值。

include (字符) 仅包含get_pages生成的特定页面列表。include参数与exclude同样用逗号将页面编号隔开。无默认值。

child_of (整数) 仅显示单个页面的子页面;值为默认编号。默认值为0(显示所有页面)。注意child_of参数不仅获取直系子页面,也会从已知编号中获取“孙页面”。0 ——默认,不限制子页面

parent (整数) 显示以该整数为父级的页面。默认值为-1(显示所有页面)。注意这可限制child_of参数的“深度”,因此只能检索到下一级页面。-1 ——默认,不限制父页面

exclude_tree (整数) 与’child_of’相反,’exclude_tree’从结果中移除已知编号的所有子页面。也可用于隐藏已知页面的所有子页面。该参数还可联合’child_of’ 的值以隐藏孙页面。在2.7版本中该参数可用。

hierarchical(布尔型)在上级页面列表下以缩进方式显示下级页面。默认值为true(在父级列表项下显示其子页面)。可能的值有:1(true默认; 0(false)

meta_key(字符)仅包含含有该自定义字段关键字的页面(与meta_value字段联合使用)。

meta_value(字符)仅包含含有该自定义字段值的页面(与meta_key字段联合使用)。

authors(字符)仅包含给定作者所写的文章。返回一个数组,数组中包含所有与请求匹配的页面。

get_pages获取子页面例子

<?php 
	$pages = get_pages('child_of='.$post->ID.'&amp;sort_column=post_date&amp;sort_order=desc&amp;parent='.$post->ID);
    foreach($pages as $page){
		$content = $page->post_content;
?>
	<div>
        特色图像:<?php echo get_the_post_thumbnail($page->ID); ?>
        输出标题:<?php echo $page->post_title; ?>
        输出内容:<?php echo $content; ?>
        输出链接<a href="<?php echo get_page_link($page->ID); ?>">阅读全文</a>
    </div>
<?php } ?>

get_page_children()函数

通过页面id获取所有子页面;用法:<?php get_page_children( $page_id, $pages ) ?>

wp_list_pages()函数

wp_list_pages( )将WordPress页面作为链接显示出来。该模板标签常用于自定义侧边栏或标题,也常用于其他模板中。该模板标签在WordPress 1.5及更新版本中可用。
用法: <?php wp_list_pages(‘arguments’); ?>

默认参数设置为: $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生成的页面列表默认标题。
<ul>
<?php wp_list_pages('title_li='); ?>
</ul> 

//在下面这个例子中,列表中只包含编号为9,5,23的页面,标题内容被改为“Poetry”,格式为< h2 >: <ul>
<?php wp_list_pages('include=5,9,23&amp;title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
</ul> 

//用exclude参数可隐藏列表中由wp_list_pages生成的若干页面。 <ul>
<?php wp_list_pages('exclude=17,38' ); ?>
</ul> 

页面按条件排列

//下面的例子将页面按管理栏中 Write > Page 定义的页面顺序进行排列。 
<ul>
<?php wp_list_pages('sort_column=menu_order'); ?>
</ul 

//如果希望将列表按页面顺序进行排列并将“Prose”作为列表标题(以h2格式)显示在侧边栏中,可将以下代码添加到sidebar.php文件中: 
<ul>
<?php wp_list_pages('sort_column=menu_order&amp;title_li=<h2>' . __('Prose') . '</h2>' ); ?>
</ul> 

//使用下列代码段,可显示出无标题并以页面顺序排列的页面:
 <ul>
<?php wp_list_pages('sort_column=menu_order&amp;title_li='); ?>
</ul> 

//下列代码显示出的页面将按发表日期进行排列,在页面列表项旁显示日期。 
<ul>
<?php wp_list_pages('sort_column=post_date&amp;show_date=created'); ?>
</ul> 

显示列表页面

//若仅希望在列表中显示特定页面,例如编号为35,7,26和13的页面,可使用include参数。 
<ul>
<?php wp_list_pages('include=7,13,26,35&amp;title_li=<h2>' . __('Pages') . '</h2>' ); ?>
</ul> 

//显示子页面 
//注意:即使没有子页面,HTML标签也是必要的(ul或ol)。用css设置列表时需要将这一点谨记在心。 <ul>
<?php
wp_list_pages('title_li=&amp;child_of='.$post->ID.'&amp;show_date=modified
&amp;date_format=$date_format'); ?>
</ul> 

//以下代码仅在目前页面有子页面(将目前页面设为父级页面的页面)的情况下生成列表: 
<?php
$children = wp_list_pages('title_li=&amp;child_of='.$post->ID.'&amp;echo=0');
if ($children) { ?>
<ul>
<?php echo $children; ?>
</ul>
<?php } ?> 

//将本代码放在侧边栏的widget区块后,代码将无法运行。
 <?php
if($post->post_parent)
$children = wp_list_pages("title_li=&amp;child_of=".$post->post_parent."&amp;echo=0");
else
$children = wp_list_pages("title_li=&amp;child_of=".$post->ID."&amp;echo=0");
if ($children) { ?>
<ul>
<?php echo $children; ?>
</ul>
<?php } ?> 

//本代码也可用在sidebar.php中,仅显示顶级页面。但浏览到包含子页面的页面时,仅显示其子页面。
//浏览主页时在侧边栏显示所有顶级页面
//浏览没有子页面的顶级页面时,显示所有顶级页面
//浏览有子页面的顶级页面时,显示所有子页面及下一级页面
//浏览子页面时,显示其父级页面下的所有子页面和下一级页面 
<?php
$output = wp_list_pages('echo=0&amp;depth=1&amp;title_li=<h2>Top Level Pages </h2>' );
if (is_page( )) {
$page = $post->ID;
if ($post->post_parent) {
   $page = $post->post_parent;
}
$children=wp_list_pages( 'echo=0&amp;child_of=' . $page . '&amp;title_li=' );
if ($children) {
   $output = wp_list_pages ('echo=0&amp;child_of=' . $page . '&amp;title_li=<h2>Child Pages</h2>');
}
}
echo $output;
?> 

原创文章,作者:懒咪WP,如若转载,请注明出处:https://www.lanmit.com/2756.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据