如果需要,可以从内容中生成摘录。

原型

wp_trim_excerpt( string $text = '' )

描述

摘录词数量将为55个单词,如果数量大于该单词,则字符串’[…]‘将附加到摘录中。如果字符串少于55个单词,则内容将按原样返回。

参数

$text (string) (Optional)  摘录。如果设置为空,则生成摘录。

返回值

(string)  摘录。

源文件

路径:wp-includes/formatting.php

<?php
...
function wp_trim_excerpt( $text = '' ) {
	$raw_excerpt = $text;
	if ( '' == $text ) {
		$text = get_the_content('');
		$text = strip_shortcodes( $text );
		$text = excerpt_remove_blocks( $text );
		/** This filter is documented in wp-includes/post-template.php */
		$text = apply_filters( 'the_content', $text );
		$text = str_replace(']]>', ']]&gt;', $text);
		/**
		 * Filters the number of words in an excerpt.
		 *
		 * @since 2.7.0
		 *
		 * @param int $number The number of words. Default 55.
		 */
		$excerpt_length = apply_filters( 'excerpt_length', 55 );
		/**
		 * Filters the string in the "more" link displayed after a trimmed excerpt.
		 *
		 * @since 2.9.0
		 *
		 * @param string $more_string The string shown within the more link.
		 */
		$excerpt_more = apply_filters( 'excerpt_more', ' ' . '[&hellip;]' );
		$text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
	}
	/**
	 * Filters the trimmed excerpt string.
	 *
	 * @since 2.8.0
	 *
	 * @param string $text        The trimmed text.
	 * @param string $raw_excerpt The text prior to trimming.
	 */
	return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_trim_excerpt/