如何使用WordPress的 the_excerpt() 和 the_content() 函数来显示文章摘要和内容?

2024-12-12 54 0

在WordPress中,the_excerpt()the_content() 是两个常用的模板函数,用于显示文章的摘要和完整内容。以下是这两个函数的基本用法:

使用 the_excerpt() 显示文章摘要

the_excerpt() 函数用于显示文章的摘要。在WordPress中,摘要通常是文章开始部分的一段简短文本,或者是手动设置的摘录。

  1. 自动摘要

    • WordPress会自动生成文章的摘要,通常是从文章内容的第一段中提取,直到遇到一个双换行符(<p> 标签)为止。
  2. 手动摘要

    • 在编辑文章时,有一个专门的“摘要”字段,可以在那里手动输入摘要。如果填写了手动摘要,the_excerpt() 将显示手动摘要而不是自动生成的摘要。

在主题的模板文件中(如 index.phparchive.phpsearch.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_lengthexcerpt_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 文件中,即可自定义摘要的显示方式。

相关文章

如何在WordPress插件中使用ajax?
如何通过WordPress函数创建自定义菜单?
在WordPress主题开发中,如何使用WP_Customize_Manager来自定义主题选项?
如何使用WordPress的filter钩子修改输出内容?
如何使用WordPress的action钩子添加自定义JavaScript?
在WordPress插件中,如何使用自定义表单和nonce字段来增强安全性?