PESCMS Ticket事件参考表

创建于 2022-06-02 / 最近更新于 2024-01-17 / 711 / 本页文档可切换别的版本
字体: [默认] [大] [更大]

PESCMS Ticket提供了如下事件参考表:

本文档版本适用于PESCMS Ticket v1.3.21

前台

登录页

事件名称 传参 说明
OAuth2 不支持 社交账户登录按钮

后台

登录前切片事件

事件名称 传参 说明
loginSlice 不支持 执行登录校验前运行的插件事件

工单列表

事件名称 传参 说明
filterTool 不支持 工单列表筛选栏按钮
searchTool 不支持 工单列表搜索按钮
listTopTool 当前行工单参数值 $value 工单列表标题信息栏
listOPEvent 当前行工单参数值 $value 工单列表操作按钮
filterTool 不支持 工单列表筛选按钮
searchTool 不支持 工单搜索按钮

页脚

事件名称 传参 说明
suspensionButton - 工单客服端的悬浮按钮

全局

工单表单扩展

若需要扩展工单表单类型,可以通过如下方式操作。

regForm(array $name)

在插件启用代码中,您需要用regForm()方法声明注册的表单的名称和值。

参数 类型 是否必填 默认值 说明
$name array - 结构示例:regForm( ['新表单' => 'new' ] )

示例代码

public function enabled() {

        $this->regForm(['新表单' => 'new']); //注册一个名为新表单的表单类型

        $config = $this->loadConfig($this);
        $config['plugin']['status'] = 'enabled';

        (new \Core\Plugin\Plugin())->updateConfig($this, $config)
            ->register("\\Plugin\\New\\Form\\Index", [
            'new_form' => [
                'index' => 'Form-Category-ticket' //工单提交页
            ],
        ])
            ->register("\\Plugin\\New\\Ticket\\Index", [
                'new_ticket' => [
                    'index' => [
                        'Form-View-ticket', //前台工单查看
                        'Ticket-Ticket-handle', //后台工单查看
                        'Ticket-Ticket-complainDetail', //后台工单投诉反馈界面
                    ],
                ],
            ]);
        $this->success('插件启用成功');

    }

removeForm($key)

要删除新增的表单类型,需要用removeForm()方法,同理需要在插件禁用和删除方法中声明。否则扩展的表单将一直保存于系统之类。

参数 类型 是否必填 默认值 说明
$key string - 根据您注册的表单名字填写

扩展表单在插件中声明完毕后,还需要定义2个方法,否则工单界面将无法调用表单和内容。具体的代码请参考上面的示例代码。

事件

事件名称 传参 说明
前缀填写您的表单字段_form 支持 本表单的所有field值。
前缀填写您的表单字段_ticket 支持 本表单的所有field值。

扩展表单的事件分提交和查阅。

_form后缀的为表单提交界面的事件,用于渲染给客户提交内容的事件。

_ticket后缀的为表单内容查询界面的事件,就是说这是用户提交内容后,我们将内容渲染给客户和客服看的事件。

以上面的[ '新表单' => 'new' ] 为例。他的事件均为 new_formnew_ticket

上面我们定义了_form执行控制\Plugin\New\Form\Index的index() 方法。由于事件支持传参,因此可以在index()方法中声明一个参数。即可获得本表单的所有field数组。

public function index($filed){
        echo '<pre>';
        print_r($filed);
        echo '</pre>';
        echo '<br/>';
        exit;
}

image.png

5 人点赞过