FreeScout 会话工具栏自定义开发指南

会话工具栏扩展机制解析

FreeScout作为一款开源的帮助台系统，在v1.8.154版本中提供了会话视图界面的工具栏扩展能力。开发者可以通过特定的钩子(Hook)机制，在会话信息区域前后插入自定义HTML内容。

工具栏结构分析

会话工具栏主要包含以下几个关键部分：

1. 会话基本信息区域(convinfo)
2. 分配人(Assignee)显示区域
3. 状态(Status)显示区域

系统提供了两个专门的扩展点：

• conversation.convinfo.prepend - 在会话信息区域最前面插入内容
• conversation.convinfo.before_nav - 在导航按钮前插入内容

实现方式详解

开发者可以通过创建自定义模块来扩展工具栏功能。以下是两种实现方式：

1. 使用过滤器(Filter)方式

\Eventy::addFilter('conversation.convinfo.prepend', function($data) {
    return $data."<li><div class='btn-group'>自定义按钮</div></li>";
}, 20, 1);

2. 使用动作(Action)方式

\Eventy::addAction('conversation.convinfo.prepend', function($conversation, $mailbox) {
    echo "<li><div class='btn-group'>自定义按钮</div></li>";
}, 20, 2);

开发建议

1. 样式一致性：建议使用系统原有的btn-group类来保持UI一致性
2. 功能隔离：每个自定义按钮应该封装在独立的<li>元素中
3. 参数利用：动作方式提供了当前会话($conversation)和邮箱($mailbox)对象，可用于条件性显示内容
4. 优先级设置：合理设置钩子优先级(第三个参数)，确保多个扩展间的执行顺序

实际应用场景

这种扩展机制可用于：

• 添加快速操作按钮
• 显示自定义状态标签
• 集成第三方系统快捷入口
• 添加会话备注或标记功能

通过合理利用这些扩展点，开发者可以灵活地增强FreeScout的会话管理功能，满足各种业务场景需求。