在WordPress中,the_excerpt()
和 the_content()
是两个常用的模板函数,用于显示文章的摘要和完整内容。以下是这两个函数的基本用法:
使用 the_excerpt()
显示文章摘要
the_excerpt()
函数用于显示文章的摘要。在WordPress中,摘要通常是文章开始部分的一段简短文本,或者是手动设置的摘录。
-
自动摘要:
- WordPress会自动生成文章的摘要,通常是从文章内容的第一段中提取,直到遇到一个双换行符(
<p>
标签)为止。
- WordPress会自动生成文章的摘要,通常是从文章内容的第一段中提取,直到遇到一个双换行符(
-
手动摘要:
- 在编辑文章时,有一个专门的“摘要”字段,可以在那里手动输入摘要。如果填写了手动摘要,
the_excerpt()
将显示手动摘要而不是自动生成的摘要。
- 在编辑文章时,有一个专门的“摘要”字段,可以在那里手动输入摘要。如果填写了手动摘要,
在主题的模板文件中(如 index.php
、archive.php
、search.php
等),你可以使用以下代码来显示摘要:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_excerpt(); ?>
<?php endwhile; endif; ?>
使用 the_content()
显示文章完整内容
the_content()
函数用于显示文章的完整内容。当你访问单个文章页面时,通常会使用这个函数。
在主题的 single.php
文件中,你可以使用以下代码来显示文章的完整内容:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_content(); ?>
<?php endwhile; endif; ?>
注意事项
the_excerpt()
通常不显示格式化的内容,即不会显示图片、短代码等。the_content()
会显示完整的文章内容,包括所有的格式、图片、短代码等。- 你可以使用
the_excerpt()
的过滤器excerpt_length
和excerpt_more
来自定义摘要的长度和省略符号。
例如,以下代码将摘要长度设置为50个单词,并将省略符号更改为“...”:
function custom_excerpt_length() {
return 50;
}
add_filter( 'excerpt_length', 'custom_excerpt_length' );
function custom_excerpt_more( $more ) {
return '...';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );
将以上代码添加到你的主题的 functions.php
文件中,即可自定义摘要的显示方式。