README

使用JSON API在Zendesk中创建新的支持工单

需求

此插件需要Craft CMS 3.0.0-beta.23或更高版本。

安装

要安装插件，请按照以下说明操作。

1. 打开您的终端并转到您的Craft项目

    cd /path/to/project
   

2. 然后告诉Composer加载插件

    composer require adigital/zendesk
   

3. 在控制面板中，转到设置 → 插件，并为Zendesk点击“安装”按钮。

Zendesk概述

此插件可以作为您客户网站上仪表板的小部件运行，或者您也可以从您自己的网站上前端表单中向其发送内容。

配置Zendesk

您需要输入您的Zendesk API密钥、用户账户和API URL。此插件是为Zendesk V2 API构建的。其余设置是可选的。您可以给小部件一个自定义名称，例如“Ask A Digital”。您还可以添加一个URL，以便请求者可以在成功提交工单后直接查看。

已包含一个config.php文件，其中包含我们为Zendesk集成设置的2个自定义字段的示例。将此文件移动到Craft主配置文件夹中，如果要将自己的自定义字段包含在仪表板小部件中，请将其重命名为zendesk.php。

使用Zendesk

以下是一个非常基本的示例前端表单，该表单可以通过此插件向Zendesk提交工单。如果您希望向此表单添加自己的自定义字段，只需在插件配置文件中定义它们，然后将输入添加到表单中。请确保输入名称属性与config fieldName值匹配。

<form method="post" accept-charset="utf-8" enctype="multipart/form-data">
	<input type="hidden" name="action" value="zendesk/default/submit">
	{{ redirectInput('support/thank-you') }}
	<input type="hidden" name="success" value="/support/thank-you">
	<input type="hidden" name="failed" value="/support/failed">
	{{ csrfInput() }}
	
	Name: <input type="text" name="name">
	Email: <input type="text" name="email">
	Type: <select name="type">
		<option value="question">Question</option>
		<option value="incident">Incident</option>
		<option value="problem">Problem</option>
		<option value="task">Task</option>
	</select>
	Priority: <select name="priority">
		<option value="low">Low</option>
		<option value="normal">Normal</option>
		<option value="high">High</option>
		<option value="urgent">Urgent</option>
	</select>
	Subject: <input type="text" name="subject">
	Body: <input type="text" name="body">
	Attachment(s): <input type="file" name="attachments[]" multiple>
	
	<button type="submit">Raise Ticket</button>
</form>

由Matt Shearing提供