在WordPress中,the_excerpt()
和 the_content()
是两个非常有用的模板函数,它们分别用于显示文章的摘要和完整内容。以下是如何使用这两个函数的简要指南:
使用 the_excerpt()
显示文章摘要
the_excerpt()
函数用于显示文章的摘要。在默认情况下,WordPress会自动从文章内容中提取前55个单词作为摘要。如果你在编辑文章时手动设置了摘录(Excerpt),那么它会显示你手动输入的摘要。
以下是如何在WordPress主题的模板文件中使用 the_excerpt()
:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_excerpt(); ?>
<a href="<?php the_permalink(); ?>">阅读更多</a>
<?php endwhile; endif; ?>
在上面的代码中,我们首先检查是否有文章,然后循环遍历每篇文章,显示文章标题、摘要,并添加一个链接指向文章的完整内容。
使用 the_content()
显示文章完整内容
the_content()
函数用于显示文章的完整内容。当你访问一个单独的文章页面(通常是 single.php 文件)时,你会使用这个函数来显示全文。
以下是如何在WordPress主题的模板文件中使用 the_content()
:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_content(); ?>
<?php
// 分页链接(如果文章被分页)
wp_link_pages( array(
'before' => '<div class="page-links">' . __( 'Pages:', 'textdomain' ),
'after' => '</div>',
) );
?>
<?php endwhile; endif; ?>
在上面的代码中,我们同样检查是否有文章,然后循环遍历每篇文章,显示文章标题和完整内容。wp_link_pages()
函数用于添加分页链接,如果你的文章内容很长并且被分成了多个页面。
注意事项
the_excerpt()
默认不显示HTML标签,如果你的摘要包含HTML,它会被自动去除。the_content()
会保留HTML标签,并且会处理短代码和自动分段等功能。- 你可以通过过滤器
excerpt_length
来更改摘要的默认长度。 - 使用
the_content()
时,如果文章被分页,确保使用wp_link_pages()
函数来提供分页链接。
使用这些函数时,请确保它们被放置在正确的WordPress模板文件中,并且遵循WordPress的主题开发最佳实践。