WordPress函数 get_the_excerpt

概述

返回当前文章的摘要并以 [...] 文本结束，这不是一个“阅读更多”的链接。这个模板标签必须用于主循环内。或者，使用 the_excerpt() 模板标签可直接显示摘要，但它在 get_the_excerpt() 返回的字符串前后添加了<p>段落的开始和闭合标签。

用法

<?php $excerpt = get_the_excerpt( $deprecated ) ?>

传入参数

这个函数不需要传入参数。

返回值

如果文章没有设置摘要，这个函数将使用 wp_trim_excerpt 返回截取的字符串并以 [...]文本结束。wp_trim_excerpt 通过了 get_the_excerpt 钩子，可以移除它。
对于密码保护的内容将返回一个字符串，默认是“没有摘录，因为这是一篇受到保护的文章”。这个文本可以通过函数定义。
如果内容没有密码保护而且设置有摘要，它将返回字符串形式的摘要。

参考案例

get_the_excerpt() 可以检索保存在变量里的值，如果没有则不输出到页面。

 <?php
 $my_excerpt = get_the_excerpt();
 if ( $my_excerpt != '' ) {
 // Some string manipulation performed
 }
 echo $my_excerpt; // Outputs the processed value to the page
 ?>

使用指定了最大字数的 get_the_excerpt() 摘要

<?php
 the_excerpt_max_charlength(140);
 function the_excerpt_max_charlength($charlength) {
 $excerpt = get_the_excerpt();
 $charlength++;
 if ( mb_strlen( $excerpt ) > $charlength ) {
 $subex = mb_substr( $excerpt, 0, $charlength - 5 );
 $exwords = explode( ' ', $subex );
 $excut = - ( mb_strlen( $exwords[ count( $exwords ) - 1 ] ) );
 if ( $excut < 0 ) {
 echo mb_substr( $subex, 0, $excut );
 } else {
 echo $subex;
 }
 echo '[...]';
 } else {
 echo $excerpt;
 }
 }
 ?>

变更记录

起源于：0.71

源文件

get_the_excerpt() 位于 wp-includes/post-template.php

另：

the_excerpt() 输出当前文章的摘要，并会附上"[...]"，这不是"更多"的链接。如果你没提供一篇文章明确的摘要（后台文章编辑器的可选摘要区域），它将自动摘录文章内容中前55个字作为摘要。而HTML标签和图片都会从摘要内容中去除。此标签必须用在主循环里。

get_the_excerpt() 返回文章摘要赋值给变量。此标签必须在主循环里。如果你仅希望输出文章摘要，你可以直接使用the_excerpt().