HumHub搜索功能增强：自定义搜索结果标题的实现方案

背景介绍

HumHub作为一个开源社交网络平台，其搜索功能是用户发现内容和连接的重要途径。在最新版本中，开发团队针对搜索结果的标题显示功能进行了优化，特别是解决了第三方模块（如Verified模块）无法在搜索结果标题中添加验证图标的问题。

技术挑战

在原有架构中，搜索结果标题的生成存在以下限制：

1. 标题生成逻辑硬编码在核心类中，无法扩展
2. HTML标签在JS端被过滤，导致无法显示图标等富文本内容
3. 直接实例化类的方式限制了依赖注入的可能性

解决方案演进

开发团队经过多次讨论和验证，最终确定了以下技术方案：

1. 依赖注入改造

将核心搜索记录类改为通过Yii容器创建，而非直接实例化。这一改变使得模块可以通过容器定义来替换默认实现：

Yii::createObject(SearchRecord::class, [$user])

2. 模块扩展机制

第三方模块现在可以通过以下方式扩展搜索记录类：

1. 在模块初始化时注册自定义类

public static function onApplicationInit($event)
{
    $app = $event->sender;
    $app->setContainer(['definitions' => [
        user\SearchRecord::class => your_module\CustomSearchRecord::class,
    ]]);
}

2. 实现自定义搜索记录类

class CustomSearchRecord extends SearchRecord
{
    public function getTitle(): string
    {
        return parent::getTitle() . Icon::get('check');
    }
}

3. HTML内容处理优化

解决了HTML标签被过滤的问题：

• 移除了JS端的HTML过滤逻辑
• 确保PHP端已通过strip_tags()进行安全处理
• 保留了富文本内容的显示能力

实现效果

这一改进使得：

1. 第三方模块可以灵活定制搜索结果标题
2. 验证图标等富文本内容能够正常显示
3. 保持了系统的安全性和稳定性
4. 为未来更多自定义需求提供了扩展点

技术意义

这一改进不仅解决了具体问题，更重要的是：

1. 展示了HumHub良好的扩展性设计
2. 体现了框架依赖注入容器的强大能力
3. 为开发者提供了标准的扩展模式
4. 平衡了功能需求与安全性考虑

最佳实践建议

对于需要在搜索结果标题中添加自定义内容的开发者：

1. 优先使用容器定义来扩展核心类
2. 确保自定义内容不会破坏布局或功能
3. 考虑移动端和不同主题的兼容性
4. 保持简洁，避免过度定制

这一改进已在HumHub v1.16中实现，为平台的功能扩展性树立了新的标杆。