在WordPress中,the_excerpt()
和 the_content()
是两个常用的模板函数,用于显示文章的摘要和全文。以下是如何使用这两个函数的步骤:
使用 the_excerpt()
显示文章摘要
-
确保摘要功能已启用:
在WordPress的设置中,确保“手动摘要”选项被选中。这可以通过以下步骤完成:- 登录到WordPress管理后台。
- 导航到“设置” > “撰写”。
- 在“摘选”部分,选择“手动摘选”选项。
- 点击“保存更改”。
-
在模板文件中使用
the_excerpt()
:
打开你想要显示摘要的模板文件(通常是index.php
、archive.php
或search.php
),然后在适当的位置添加以下代码:<?php the_excerpt(); ?>
-
自定义摘要长度:
默认情况下,WordPress的摘要长度是55个单词。如果你想自定义摘要的长度,可以在主题的functions.php
文件中添加以下代码:function custom_excerpt_length() { return 20; // 更改为你想要的单词数 } add_filter('excerpt_length', 'custom_excerpt_length');
使用 the_content()
显示文章全文
-
在模板文件中使用
the_content()
:
在单个文章页面(通常是single.php
或page.php
)中,你可以在适当的位置添加以下代码来显示全文:<?php the_content(); ?>
-
处理分页:
如果文章被分页,the_content()
会自动处理分页链接。如果你想要自定义分页链接的样式,可以使用以下代码:<?php the_content( sprintf( wp_kses( /* translators: %s: Name of current post. Only visible to screen readers */ __('Continue reading<span class="screen-reader-text"> "%s"</span>', 'textdomain'), array( 'span' => array( 'class' => array(), ), ) ), wp_kses_post(get_the_title()) ) ); wp_link_pages( array( 'before' => '<div class="page-links">' . esc_html__('Pages:', 'textdomain'), 'after' => '</div>', ) ); ?>
确保替换 'textdomain'
为你的主题的文本域。
使用这些函数时,请注意以下几点:
the_excerpt()
通常用于文章列表页面,如首页、分类页或搜索结果页。the_content()
通常用于单个文章或页面模板,用于显示完整内容。- 使用这些函数时,不需要在它们前面加上
echo
,因为这两个函数会自动输出内容。