Typecho插件开发：优化文章摘要处理短代码问题
文章目录
- Typecho解决文章太短描述中暴露短代码的问题
- 问题背景
- 技术分析
- Typecho摘要生成机制
- 短代码处理机制
- 解决方案
- 方案一：修改摘要生成逻辑（推荐）
- 方案二：自定义字段替代摘要
- 方案三：主题层过滤处理
- 完整插件实现
- 性能优化
- 部署与维护
- 扩展思考
- 更智能的摘要生成
- SEO优化建议
- 结论
Typecho解决文章太短描述中暴露短代码的问题
🌐 我的个人网站：乐乐主题创作室
问题背景
Typecho作为一款轻量级的博客系统，因其简洁高效而受到许多博主的喜爱。然而在实际使用中，用户经常会遇到一个令人困扰的问题：当文章内容较短时，系统自动生成的摘要(description)会暴露文章中的短代码(shortcode)，严重影响SEO效果和用户体验。
例如，当文章内容包含类似[gallery ids="1,2,3"]这样的短代码时，如果文章正文内容较少，Typecho可能会直接将这个短代码作为文章描述输出到首页或RSS中，这显然不是我们想要的结果。
技术分析
Typecho摘要生成机制
Typecho默认的摘要生成逻辑位于var/Widget/Abstract/Contents.php文件中。当excerpt参数为空时，系统会调用excerpt方法来生成摘要：
public function excerpt($content, $length = 100)
{$content = strip_tags($content);$content = function_exists('mb_substr') ? mb_substr($content, 0, $length, 'utf-8') : substr($content, 0, $length);return $content;
}
从代码可以看出，Typecho的摘要生成非常简单：
- 去除所有HTML标签
- 截取前100个字符（支持多字节字符）
这种简单粗暴的方式无法识别和处理短代码，导致短代码直接暴露在摘要中。
短代码处理机制
Typecho本身没有内置短代码功能，但许多主题和插件会通过正则表达式实现短代码解析，例如：
function parseShortcode($content) {$pattern = '/\[(\w+)(.*?)\]/';return preg_replace_callback($pattern, function($matches) {// 短代码处理逻辑}, $content);
}
解决方案
方案一：修改摘要生成逻辑（推荐）
我们可以通过Typecho的插件机制重写摘要生成方法，在生成摘要前先去除短代码：
- 创建一个插件
ShortcodeExcerpt - 注册到
excerpt过滤器
class ShortcodeExcerpt_Plugin implements Typecho_Plugin_Interface
{public static function activate(){Typecho_Plugin::factory('Widget_Abstract_Contents')->excerpt = array('ShortcodeExcerpt_Plugin', 'filter');}public static function filter