1. 首页
  2. WordPress 函数手册

get_the_excerpt()

get_the_excerpt( int|WP_Post $post = null )

检索文章摘要。
Retrieves the post excerpt.

目录锚点:#参数#返回#源码#笔记


参数(Parameters)

参数 类型 必填 说明
$post (int | WP_Post) 可选 Post ID或WP_Post对象。默认值为全局$post。

返回(Return)

(string)后摘录。


源码(Source)

/**
 * Retrieve the post excerpt.
 *
 * @since 0.71
 *
 * @param mixed $deprecated Not used.
 * @return string
 */
function get_the_excerpt( $deprecated = '' ) {
	if ( !empty( $deprecated ) )
		_deprecated_argument( __FUNCTION__, '2.3' );

	$post = get_post();
	if ( empty( $post ) ) {
		return '';
	}

	if ( post_password_required() ) {
		return __( 'There is no excerpt because this is a protected post.' );
	}

	/**
	 * Filter the retrieved post excerpt.
	 *
	 * @since 1.2.0
	 *
	 * @param string $post_excerpt The post excerpt.
	 */
	return apply_filters( 'get_the_excerpt', $post->post_excerpt );
}
更新版本 源码位置 使用 被使用
4.5.0 wp-includes/post-template.php:404 4 6

笔记(Notes)

如果此函数在循环外部使用,并且post没有自定义的摘录,则此函数将使用wp_trim_excerpt()生成摘录。该函数使用get_the_content(),该函数必须与循环一起使用,如果在循环外部使用get_the_excerpt(),则会导致问题。为了避免这些问题,请在调用get_the_execrpt()之前使用set up_postdata()设置全局$post对象。
对HTML元描述使用摘录
将主页上显示的手动摘录限制为260个字符,但在最后一个字后截断

get_the_excerpt() 为WP2原创文章,链接:https://www.wp2.cn/functions/get_the_excerpt/

发表评论

您的电子邮箱地址不会被公开。