1. 首页
  2. WordPress 函数手册

wp_trim_excerpt()

wp_trim_excerpt( string $text = , WP_Post|object|int $post = null )

如果需要,从内容中生成摘录。
Generates an excerpt from the content, if needed.

目录锚点:#说明#参数#源码#笔记


说明(Description)

如果需要,最多返回55个单词,并附加省略号。55个单词的限制可以由插件/主题使用“extract_length”过滤器修改“[…]”字符串可以由插件/主题使用“extract_more”过滤器修改


参数(Parameters)

参数 类型 说明
$text (string) 节选。如果设置为空,则生成摘录。
$post (WP_Post | object | int) WP_Post实例或Post ID/对象。默认值为空。

源码(Source)

/**
 * Generates an excerpt from the content, if needed.
 *
 * The excerpt word amount will be 55 words and if the amount is greater than
 * that, then the string ' […]' will be appended to the excerpt. If the string
 * is less than 55 words, then the content will be returned as is.
 *
 * The 55 word limit can be modified by plugins/themes using the excerpt_length filter
 * The ' […]' string can be modified by plugins/themes using the excerpt_more filter
 *
 * @since 1.5.0
 *
 * @param string $text Optional. The excerpt. If set to empty, an excerpt is generated.
 * @return string The excerpt.
 */
function wp_trim_excerpt( $text = '' ) {
	$raw_excerpt = $text;
	if ( '' == $text ) {
		$text = get_the_content('');

		$text = strip_shortcodes( $text );

		/** This filter is documented in wp-includes/post-template.php */
		$text = apply_filters( 'the_content', $text );
		$text = str_replace(']]>', ']]>', $text);

		/**
		 * Filter 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 );
		/**
		 * Filter 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', ' ' . '[…]' );
		$text = wp_trim_words( $text, $excerpt_length, $excerpt_more );
	}
	/**
	 * Filter 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 );
}
更新版本 源码位置 使用 被使用
5.2.0 wp-includes/formatting.php 20 6

笔记(Notes)

如果我们已经摘录了一部分,只想把它裁剪成更小的数量,请使用以下方法:

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