Typecho插件开发：优化文章摘要处理短代码问题

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的摘要生成非常简单：

1. 去除所有HTML标签
2. 截取前100个字符（支持多字节字符）

这种简单粗暴的方式无法识别和处理短代码，导致短代码直接暴露在摘要中。

短代码处理机制

Typecho本身没有内置短代码功能，但许多主题和插件会通过正则表达式实现短代码解析，例如：

function parseShortcode($content) {
   
    $pattern = '/\[(\w+)(.*?)\]/';
    return preg_replace_callback($pattern, function($matches) {
   
        // 短代码处理逻辑
    }, $content);
}

解决方案

方案一：修改摘要生成逻辑（推荐）

我们可以通过Typecho的插件机制重写摘要生成方法，在生成摘要前先去除短代码：

1. 创建一个插件ShortcodeExcerpt
2. 注册到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