在WordPress中,the_excerpt()
和 the_content()
是两个常用的模板函数,它们分别用于显示文章的摘要和全文。以下是这两个函数的基本用法:
the_excerpt()
the_excerpt()
函数用于显示文章的摘要。通常,摘要是由WordPress自动生成的,它截取文章内容的前55个单词。你也可以在编辑文章时,在“摘要”框中手动输入一个自定义摘要。
在主题的模板文件(如 index.php
、archive.php
、search.php
等)中使用 the_excerpt()
的示例:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_excerpt(); ?>
<a href="<?php the_permalink(); ?>">Read more...</a>
<?php endwhile; endif; ?>
the_content()
the_content()
函数用于显示文章的完整内容。它不仅会显示文章的主体内容,还会处理短代码、自动分页、嵌入媒体等。
在主题的模板文件(如 single.php
、page.php
等)中使用 the_content()
的示例:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_content(); ?>
<?php endwhile; endif; ?>
如果你想在文章内容后面添加一个“阅读更多”链接,可以使用以下代码:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_content( 'Read more...' ); ?>
<?php endwhile; endif; ?>
在上面的例子中,'Read more...'
是可选的,如果你不提供这个参数,WordPress会默认显示“[继续阅读]”。
注意事项
- 使用
the_excerpt()
时,如果文章没有自定义摘要,WordPress会自动生成一个。 - 使用
the_content()
时,如果文章被设置了“更多”标签(<!--more-->
),那么在主页或存档页面上,the_content()
会显示标签之前的内容,并在其后添加一个“阅读更多”链接。在单篇文章页面上,它会显示完整的文章内容。 - 这两个函数都应该在WordPress循环
while ( have_posts() ) : the_post();
内使用。
确保在使用这些函数时,你的主题文件是正确的,并且你的WordPress安装是正常的。