PESCMS Ticket事件参考表

本文档阅读时长约：4分钟发布时间：2022-06-02 最后更新时间：2024-08-05 1656 本页文档可切换别的版本

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

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

前台

登录页

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

用户界面

事件名称	传参	说明
memberMenu	不支持	用户中心操作相关的菜单

此事件根据模板选择提供，不是所有模板都支持。

后台

登录前切片事件

事件名称	传参	说明
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_form和new_ticket

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

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

5 人点赞过