说明

该标签显示当前文章的摘要，摘要之后带有[…]符号，而非“read more”链接。如果用户没有为文章提供摘要（在文章编辑界面下方的摘要字段中填写摘要），WordPress会自动截取文章的前55个单词作为摘要。在后面这种情况下，摘要中的HTML标签和图形都会被剥离。该标签必须在WordPress主循环（loop）内。

注意：若当前文章是一个附件，例如在attachment.php和image.php模板循环中，那么显示该附件的说明文字。说明文字不包含摘要的[…]标记。

the_excerpt() VS. the_content()

有时只使用the_content函数更具实用意义。根据有否使用 <!–more–> 标签，the_content()函数将决定所显示的内容。 <!–more–> 标签将文章/页面分割为两部分，标签前的内容用以显示在网页上。浏览单篇文章/页面时， <!–more–>会被忽略。

用法

<?php the_excerpt(); ?> 

参数

该标签无参数。

示例

默认用法

显示文章摘要。用在非单篇或非固定链接的文章中，代替the_content()，强制摘要显示在循环内。

<?php the_excerpt(); ?>  

与条件标签共同使用

在存档页面（由is_archive()函数判断）或分类页面（由is_category() 函数判断）上用the_excerpt()代替the_content()标签。

以下两个示例都可在WP 1.5及更高版本中运行。

<?php if ( is_category() || is_archive() ) {
the_excerpt();
} else {
the_content();
} ?>

而对WP 1.5之前的版本，只能使用下面这个示例：

<?php if ( $cat || $m ) {
the_excerpt();
} else {
the_content();
} ?>
 

用过滤器控制摘要长度

默认情况下，摘要的长度为55个单词。要用 excerpt_length过滤器更改摘要的长度，可在主题的functions.php文件中添加以下代码：

function new_excerpt_length($length) {
return 20;
}
add_filter(‘excerpt_length’, ‘new_excerpt_length’);
 

用过滤器删除[…]字符串

在WP 2.9及更高版本中

默认情况下，摘要之后（more字符串之后）的文章内容显示为“[…]”。要用 excerpt_more过滤器删除摘要more字符串，请在主题的functions.php文件中添加以下代码：

function new_excerpt_more($more) {
return ‘[…..]’;
}
add_filter(‘excerpt_more’, ‘new_excerpt_more’);

在WP 2.8及之前的版本中

function new_excerpt_more($excerpt) {
return str_replace(‘[…]’, ‘…’, $excerpt);
}
add_filter(‘wp_trim_excerpt’, ‘new_excerpt_more’);

注释

• 用法：get_the_excerpt
• 用法：为’the_excerpt’调用apply_filters

历史记录

• 始见于WordPress 0.71版本

源文件

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

分类：中文手册