中文环境下，WordPress 截取个摘要，竟然有那么多问题！

我们先从 WordPress 文章摘要功能说起，大部分 WordPress 主题在首页，分类搜索等各种列表页，会只显示文章摘要，而不显示文章内容全文，所以摘要很重要，在列表页，用户是否会点击查看这篇文章，摘要会起到很重要的效果。

怎么设置文章摘要

那么怎么设置摘要呢？在使用经典编辑器的年代，摘要是非常容易设置的，就在文章内容的下面，很多人写完文章，顺手也设置了文章摘要：

但是升级到古腾堡编辑器之后，很多人就发现不知道去哪里设置摘要了，摘要设置文本框被移到编辑器右侧文章设置的很下面，很多人没有认真去看，还以为没了。😅

甚至有些人因为这个原因，从来没有去设置过文章摘要，也有人因为这个原因坚持在用经典编辑器。😅

WPJAM Basic 插件支持一键屏蔽古腾堡编辑器，此外 WPJAM Basic 还提供一个扩展「摘要快速编辑」，让你可以在文章列表快速设置文章摘要：

使用文章摘要

设置了 WordPress 摘要，那就要去用，这个一般来说都是主题开发者的工作，这里简单了解一下就好，如果你要自己修改主题，那就就要认真看下。😄

WordPress 提供了两个文章摘要的模板函数，这个知道就好，一般主题就是使用这两个函数实现的。

1. get_the_excerpt( $post = null ) ，用于获取文章的摘要，它只有一个参数，就是 $post，可以是文章对象，或者文章 ID， 也可以不传，不传则获取当前文章的摘要。

2. the_excerpt()，直接输出当前文章的摘要，该函数没有任何参数，所以模板开发很简单，直接在文章列表页使用该模板函数即可。

自动获取文章摘要

由上可知，并不是每篇文章都设置了摘要，这个时候，WordPress 默认会自动获取：

WordPress 默认会使用 wp_trim_excerpt 去获取文章内容，加上摘要长度传递给 wp_trim_words 函数处理， wp_trim_words 会基于用户所处的环境：

• 单词之间没有空格的，比如中日韩，它就按照中文字符和英文字符都算一个字符来截取。
• 单词之间有空格的，比如英文或其他，它就按照空格或者回车来获取单词数组，截取输入长度的单词数。

这种算法对于中文来说，非常不好，因为一个中文字符，宽度基本上是一个英文字符的两倍，如果文章中的中英文混排的话，截取出来肯定会长度不一。

所以现在很多主题会加入自动摘要截取优化的代码，但是有些主题直接使用 substr 函数来获取摘要，该函数是把中文算成 3 个字符，英文字符算 1 个字符，这个算法有点奇怪，但是如果英文不多，截取的产地还算一致，但是比较致命的是，该函数无法判断一个完整的中文字符，截取的时候，可能在中文字符中间劈开了，然后就出现乱码：😅

所以对于中文环境，最好按照「中文 2 个字节，英文 1 个字节」的方式来截取，并且中文字符会当作一个完整的字符来处理，而采用该截取算法 PHP 函数则是 mb_strimwidth：

mb_strimwidth($text, 0, 240, '...', 'utf-8');

为了方便大家的设置，我在 WPJAM Basic 集成了自动获取文章摘要的设置，无需修改任何代码，简单选择设置一下即可，点击「WPJAM」菜单下「文章设置」子菜单下之后可以看到：

当文章未设置摘要时候，默认还是 WordPress 默认自带的截取摘要的方式，然后 WPJAM Basic 插件增加了两个选项：

• 第一个很简单直接：直接不显示摘要。
• 第二个选项就是前面介绍的算法，按照中文最优方式截取，并且还可以设置文章摘要的长度。
  再次提醒一下注意算法是「中文 2 个字节，英文 1 个字节」，设置长度的时候要注意下。

这个时候再看看，除了第二篇是后台设置了摘要，其他三篇摘要都基本差不多长度了，并且也没有出现乱码：

mb_strimwidth 不存在？

写到这里，你是不是觉得 WordPress 摘要的问题已经解决了？现在还存在两个问题：

1. WPJAM Basic 的设置不生效，还是出现上面那种乱码，或者长短不一的情况。

因为插件的优化摘要的代码和主题优化摘要的代码优先级是不一定的，可能主题占优了，那么你这个时候应该咨询主题作者，让他提供选项，然后你可以关闭主题的摘要优化功能。

2. 直接报错了：

Call to undefined function mb_strimwidth()

好吧，mb_ 打头的函数，需要 PHP 安装 mb_string 扩展，在后台「WPJAM」菜单下的「系统信息」的子菜单中，可以快速查看：

所以我又升级了一下 WPJAM Basic ，做了兼容，就是说现在没有装该扩展，也有该函数了：

if(!function_exists('mb_strimwidth')){
	function mb_strimwidth($str, $start, $width, $trimmarker=''){
		preg_match_all('/./us', $str, $match);

		$count	= count($match[0]);
		$start	= $start < 0 ? $count-1+$start : $start;
		$chars	= array_slice($match[0], $start);

		if($width >= array_sum(wpjam_map($chars, fn($char)=> ord($char) >=224 ? 2 : 1))){
			return implode('', $chars);
		}

		$length	= 0;
		$result	= '';
		$count	-= $start;
		$width	-= strlen($trimmarker);

		for($i=0; $i<$count; $i++){
			$char	= $chars[$i];
			$w		= ord($char) >= 224 ? 2 : 1;

			if($length + $w > $width){
				break;
			}

			$result	.= $char;
			$length	+= $w;
		}

		return $result.$trimmarker;
	}
}

这就是我最近发现大家在设置 WordPress 文章摘要中碰到的问题。好累，一个摘要的问题写了那么长。😅

还有一点，文章摘如果设置得好，结合一些 SEO 插件，比如 WPJAM Basic 的「简单SEO」扩展，摘要也可以设置成 meta description，搜索引擎收录内容之后，在搜索结果页面显示的内容也是文章的摘要。