下载帮

您现在的位置是:首页 > CMS教程 > WordPress

WordPress

WordPress获取当前页面下所有子页面列表(含缩略图)的方法

2020-05-27 01:37WordPress

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

get_pages函数

说明:get_pages( )函数用于获取博客中已定义页面的列表。下面是它的典型用法。

用法:  <?php get_pages('arguments'); ?>

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 } ?>
 

这里的特色图像输出的为整个img标签,不能输出纯图片地址,下面的例子则是可以输出纯图片地址:


	
  <?php
      $pages = get_pages('child_of='.$post->ID.'&amp;sort_column=post_date&amp;sort_order=desc&amp;parent='.$post->ID);
      $post_thumbnail_id = get_post_thumbnail_id($post->ID);
      foreach($pages as $page){
      $content = $page->post_content;
      ?>
      <div class="col-12 col-sm-6 col-md-4 col-lg-3">
      <div class="zhuanti-tile">
      <div class="zhuanti-tile__wrap">
      <div class="background-img lazyload" data-bg="<?php echo get_the_post_thumbnail_url($page->ID); ?>">
      </div>
      <div class="zhuanti-tile__inner">
      <div class="zhuanti-tile__text inverse-text">
      <a class="zhuanti-tile__name cat-theme-bg" href="<?php echo get_page_link($page->ID); ?>"><?php echo $page->post_title; ?></a>
      </div>
    </div>
    </div>
      </div>
      </div>
<?php } ?>
 

参数说明

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_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;
?>
 

文章评论