填写您的邮件地址,订阅我们的精彩内容:

the_excerpt doesn't work 神秘代码解决摘要显示无效

在一次开发中,我突然发现,the_excerpt函数无效了,不能显示文章的摘要。我尝试了多种可能的根源,仍然不解,为了不用query_posts就没有问题,用query_posts之后就无效。为了解决这个问题,我翻阅了the_excerpt的源码,具体如下:

/**
 * Display the post excerpt.
 *
 * @since 0.71
 * @uses apply_filters() Calls 'the_excerpt' hook on post excerpt.
 */
function the_excerpt() {
        echo apply_filters('the_excerpt', get_the_excerpt());
}

/**
 * Retrieve the post excerpt.
 *
 * @since 0.71
 *
 * @param mixed $deprecated Not used.
 * @return string
 */
function get_the_excerpt( $deprecated = '' ) {
        if ( !empty( $deprecated ) )
                _deprecated_argument( __FUNCTION__, '2.3' );

        $post = get_post();

        if ( post_password_required() ) {
                return __( 'There is no excerpt because this is a protected post.' );
        }

        return apply_filters( 'get_the_excerpt', $post->post_excerpt );
}

如果你仔细研究过,就会发现get_the_excerpt和the_excpert都是以抓取文章在数据库中的post_excerpt字段来实现的,而当这个字段(也就是在后台没有填写摘要时)为空,则会执行filter来调整和控制输出的长度与内容。

如果你在开发中发现,怎么都不能让the_excerpt显示出原本的形式,你打算自己通过字符串截取等方法来代替这个函数的时候,不妨试试下面这段代码:

if(has_excerpt())the_excerpt();else{
	$length = apply_filters('excerpt_length',20);
	echo apply_filters('the_excerpt',wp_trim_words($post->post_content,$length));
}

看上去极其简单的几行代码,却包含了很多我们以往没有接触过的知识。

首先,apply_filters的运用很少有人做到娴熟。例如我们希望让文章按照WordPress的输出格式输出时,我们可以使用

echo apply_filters('the_content','你的HTML代码')

来代替,这一招几乎被90%的开发者忽略,甚至很多人根本不知道这种用法。

其次,wp_trim_words是最长被忽视的函数,我们老是希望截取一段特定字符串长度的文字,结果根本不知道WordPress早就准备好了这样的函数出来。

虽然只是简单的一段代码,却反馈出很多信息,今天,你学习了吗?

下面我简单说几句