在WordPress中,the_excerpt()
和 the_content()
是两个非常有用的模板函数,它们分别用于显示文章的摘要和全文。以下是这两个函数的使用方法:
使用 the_excerpt()
显示文章摘要
the_excerpt()
函数用于显示文章的摘要。在默认情况下,WordPress会自动截取文章内容的前55个单词作为摘要。如果你在编辑文章时手动输入了“摘要”字段,那么将显示你输入的内容。
在主题的任何模板文件中(如 index.php
、archive.php
、search.php
等),你可以使用以下代码来显示文章摘要:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php the_excerpt(); ?>
<?php endwhile; endif; ?>
这段代码会在循环中显示每个文章的标题和摘要。
使用 the_content()
显示文章全文
the_content()
函数用于显示文章的完整内容。当你想要显示单篇文章的详细内容时,通常会在 single.php
文件中使用这个函数。
以下是如何在 single.php
中使用 the_content()
:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_content(); ?>
<?php endwhile; endif; ?>
这段代码会在单篇文章页面中显示文章的标题和全文。
注意事项
the_excerpt()
通常不包含HTML标签,而the_content()
则会保留文章中的所有格式和HTML标签。- 如果你想自定义摘要的长度或者想要在摘要中包含HTML标签,你可以使用
wp_trim_words()
函数来代替the_excerpt()
,或者修改excerpt_length
过滤器。
例如,以下代码将显示最多40个单词的摘要,并保留HTML标签:
<?php
function custom_excerpt_length() {
return 40;
}
add_filter( 'excerpt_length', 'custom_excerpt_length' );
function custom_excerpt_more( $more ) {
return '...';
}
add_filter( 'excerpt_more', 'custom_excerpt_more' );
the_excerpt();
?>
在使用这些函数时,请确保你遵循WordPress的编码标准,并且你的主题文件结构是正确的。