在输出摘要内容时,有两个主要选项,即函数the_content()
和the_excerpt()
。在我们讨论如何在WordPress中设置自定义摘录长度之前,最好先查看这两个函数之间的差异。
the_exceprt和the_content之间的差异
大多数WordPress主题使用The Loop内部的the_content()
来显示预览内容,然后使用Read More样式链接到本文的其余部分。 使用the_content时 ,将输出<--more-->
标记之前出现的文章中的所有内容,然后输出指向文章其余部分的链接。 如果没有更多标签,则输出整篇文章。
当负责输出文章WordPress模板使用the_excerpt
时 ,流程略有不同。 此标记 - the_excerpt
- 必须在The Loop中使用。
如果文章或自定义文章类型有手动摘要 ,那么将输出, 然后在方括号内输出省略号 。
如果文章没有手动摘要,则文章前55个单词将用作摘要内容。 这个默认长度为55个单词是我们想要改变的,有几种方法可以做到这一点。
获得自定义长度的不同方法
一种方法是在模板中使用wp_trim_excerpt()
函数。 首先,我们将文章内容存储在变量中。然后我们从文章的开头回响我们选择了多少个单词。这里,我们选择显示前20个单词。
<?php
/*
* Custom Excerpt Length WordPress using wp_trim_excerpt()
* Use directly in template
*/
$content = get_the_content();
echo wp_trim_words( $content , '20' );
?>
另一种获取自定义摘录长度的方法是使用WordPress Codex上提供的自定义摘要长度功能 。 此代码段直接进入您的functions.php
文件。
如果您在文章或自定义文章类型上启用了手动摘要,并且通过模板中的the_excerpt()
调用这些the_excerpt()
, 那些将覆盖此功能并显示您在其中输入的内容。
在下面的这种情况下,我们将显示文章内容的前十个单词。 除非您在主题中添加了自定义“阅读更多”链接功能 ,否则将会显示[...]
。
/**
* 通过钩子设置摘要长度为 10
*
* @param int $length Excerpt length.
* @return int (Maybe) modified excerpt length.
*/
function themebest_excerpt_length( $length ) {
return 10;
}
add_filter( 'excerpt_length', 'themebest_excerpt_length');
这些只是您可以自定义WordPress中摘录长度的两种方法。
设置摘要的更多字符
通常,我们还需要借助 excerpt_more 钩子去自定义摘要后面的字符,默认为 […] ,如果要改为 … ,可以使用下面的代码范例:
/**
* 钩子设置摘要后的更多字符
*/
function themebest_excerpt_more( $more ) {
return '...';
}
add_filter( 'excerpt_more', 'themebest_excerpt_more' );
不同文章类型设置不同摘要长度
如何为不同的文章类型设置不同的摘要长度,可以通过判断文章类型来分别定义,代码范例如下:
/**
* 不同文章类型设置不同摘要长度
*/
function themebest_variable_excerpt_length( $length ) {
// 使用全局变量 $post 检测当前文章所属的文章类型
global $post;
// 针对不同的文章类型设置不同长度
if ( 'post' === $post->post_type ) {
return 32;
} else if ( 'products' === $post->post_type ) {
return 65;
} else if ( 'testimonial' === $post->post_type ) {
return 75;
} else {
return 80;
}
}
add_filter( 'excerpt_length', 'themebest_variable_excerpt_length');
关注微信公众号themebest
- 第一时间获取主题更新动态,优惠信息
- WordPress动态、教程分享