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

2024-12-12 39 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主题开发中,如何使用wp_footer()和wp_head()钩子来添加自定义代码?
在WordPress插件中,如何使用wp_enqueue_script()和wp_enqueue_style()来正确地注册和加载脚本和样式?
在WordPress插件开发中,如何使用register_post_type()来创建自定义文章类型?
在WordPress主题开发中,如何使用is_page()和is_single()等条件标签来控制内容输出?
如何使用acf_add_options_page()来为WordPress主题添加自定义设置页面?
如何使用WordPress的 add_menu_page() 函数在后台创建自定义菜单页面?