/**
* Update a ticket
*
* @apiMethod PUT
* @apiUri /support/tickets/{ticket}
* @apiParameter {
* "name": "ticket",
* "description": "Ticket identifier",
* "type": "integer",
* "required": true,
* "default": 0
* }
* @apiParameter {
* "name": "owner",
* "description": "Ticket owner",
* "type": "integer",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "status",
* "description": "Ticket status",
* "type": "integer",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "severity",
* "description": "Ticket severity",
* "type": "string",
* "required": false,
* "default": null,
* "allowed_values": "minor, normal, major, critical"
* }
* @apiParameter {
* "name": "group",
* "description": "Alias of group ticket should be assigned to",
* "type": "string",
* "required": false,
* "default": null
* }
* @return void
*/
public function updateTask()
{
$this->requiresAuthentication();
if (!$this->acl->check('edit', 'tickets')) {
throw new Exception(Lang::txt('Not authorized'), 403);
}
// Initiate class and bind data to database fields
$ticket_id = Request::getInt('id', 0);
$status = Request::getInt('status', null);
$owner = Request::getInt('owner', null);
$severity = Request::getString('severity', null);
$group = Request::getString('group', null);
// Initiate class and bind data to database fields
$model = \Components\Support\Models\Orm\Ticket::oneOrFail($ticket_id);
if ($status) {
//cheap check to see if we got a valid status
$status_model = \Components\Support\Models\Orm\Status::oneOrFail($status);
if (!$status_model->get('id')) {
throw new Exception(Lang::txt("COM_SUPPORT_ERROR_INVALID_STATUS"), 404);
}
$model->set('status', $status);
$model->set('open', $status_model->get('open'));
}
if ($owner) {
//cheap check to see if we got a valid user
$owner_model = \Hubzero\User\User::one($owner);
if (!$owner_model->get('id')) {
throw new Exception(Lang::txt("COM_SUPPORT_ERROR_INVALID_OWNER"), 404);
}
$model->set('owner', $owner);
}
if ($severity) {
if (in_array($severity, ['minor', 'normal', 'major', 'critical'])) {
$model->set('severity', $severity);
} else {
throw new Exception(Lang::txt("COM_SUPPORT_ERROR_INVALID_SEVERITY"), 404);
}
}
if ($group) {
$group_model = \Components\Groups\Models\Orm\Group::oneByCn($group);
if ($group_model->get('gidNumber')) {
$model->set('group', $group);
} else {
throw new Exception(Lang::txt("COM_SUPPORT_ERROR_INVALID_GROUP_CN"), 404);
}
}
if ($model->save()) {
$this->send(null, 204);
} else {
throw new Exception(Lang::txt('COM_SUPPORT_ERROR_CANNOT_SAVE'), 500);
}
}
/**
* Create a new comment
*
* @apiMethod POST
* @apiUri /support/comments
* @apiParameter {
* "name": "ticket",
* "description": "Id of the ticket to make a comment on",
* "type": "integer",
* "required": true,
* "default": null
* }
* @apiParameter {
* "name": "comment",
* "description": "Comment text",
* "type": "string",
* "required": true,
* "default": null
* }
* @apiParameter {
* "name": "group",
* "description": "Group to assign the ticket to (by alias)",
* "type": "string",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "owner",
* "description": "Id of the owner to assign ticket to",
* "type": "integer",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "severity",
* "description": "Severity of the ticket",
* "type": "string",
* "required": false,
* "default": null
* "allowed_values": "minor, normal, major, critical"
* }
* @apiParameter {
* "name": "status",
* "description": "Status of the ticket",
* "type": "integer",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "target_date",
* "description": "Target date for completion of ticket (YYYY-MM-DD hh:mm:ss)",
* "type": "string",
* "required": false,
* "default": null
* }
* @apiParameter {
* "name": "cc",
* "description": "Comma seperated list of email addresses to email updates to",
* "type": "string",
* "required": false,
* "default": submitter,owner
* }
* @apiParameter {
* "name": "private",
* "description": "Should the comment be flagged as private",
* "type": "boolean",
* "required": false,
* "default": false
* }
* @apiParameter {
* "name": "email_submitter",
* "description": "Should the submitter be emailed about this comment",
* "type": "boolean",
* "required": false,
* "default": false
* }
* @apiParameter {
* "name": "email_owner",
* "description": "Should the ticket owner be emailed about this comment",
* "type": "boolean",
* "required": false,
* "default": false
* }
* @return void
*/
public function createTask()
{
$this->requiresAuthentication();
if (!$this->acl->check('create', 'comments')) {
throw new Exception(Lang::txt('Not authorized'), 403);
}
$ticket_id = Request::getInt('ticket', null);
if (!isset($ticket_id)) {
throw new Exception(Lang::txt('Bad request - ticket ID required'), 400);
}
$comment_text = Request::getString('comment', '');
if ($comment_text == '') {
throw new Exception(Lang::txt('Bad request - comment required'), 400);
}
$ticket = \Components\Support\Models\Orm\Ticket::oneOrFail($ticket_id);
$comment = new \Components\Support\Models\Orm\Comment();
$changelog = new stdClass();
$comment->set('ticket', Request::get('ticket', ''));
$comment->set('comment', nl2br(Request::get('comment')));
$comment->set('created_by', User::get('id'));
$comment->set('access', Request::get('private', false) == 'true' ? 1 : 0);
$changes = array();
foreach (['group', 'owner', 'severity', 'status', 'target_date', 'category'] as $index) {
if (Request::get($index, null)) {
if (Request::get($index) != $ticket->get($index)) {
$temp = new stdClass();
$temp->field = $index;
$temp->before = $ticket->get($index);
$temp->after = Request::get($index);
if ($index == 'status') {
if ($ticket->get('status') == 0) {
$status_model = new \Components\Support\Models\Orm\Status();
$status_model->set('title', 'Closed');
$status_model->set('open', 0);
} else {
$status_model = \Components\Support\Models\Orm\Status::oneOrFail(Request::get('status'));
}
if ($ticket->get('status') == 0) {
$old_status = new \Components\Support\Models\Orm\Status();
$old_status->set('title', 'Closed');
$old_status->set('open', 0);
} else {
$old_status = \Components\Support\Models\Orm\Status::oneOrFail($ticket->get('status'));
}
$temp->before = $old_status->get('title');
$temp->after = $status_model->get('title');
$ticket->set('open', $status_model->get('open'));
if ($status_model->get('get') == 'open' && $ticket->get('status', null) == 'closed') {
$tiket->set('closed', '0000-00-00 00:00:00');
}
if ($status_model->get('get') == 'closed' && $ticket->get('status', null) == 'open') {
$ticket->set('closed', Date::toSql());
}
}
if ($index == 'owner') {
$old_owner = User::getInstance($ticket->get('owner'));
$new_owner = User::getInstance(Request::get('owner'));
$temp->before = $old_owner->get('username');
$temp->after = $new_owner->get('username');
}
$ticket->set($index, Request::get($index));
$changes[] = $temp;
}
}
}
$changelog->changes = $changes;
if ($comment->get('comment')) {
// If a comment was posted by the ticket submitter to a "waiting user response" ticket, change status.
$user = User::getInstance(User::get('id'));
if ($ticket->get('status') == 2 && $user->get('username') == $ticket->get('login')) {
$ticket->set('status', 0);
}
}
$comment->set('changelog', json_encode($changelog));
if (!$comment->save()) {
throw new Exception(print_r($comment->getErrors(), 1), 500);
}
if (!$ticket->save()) {
throw new Exception(print_r($ticket->getErrors(), 1), 500);
}
// There's now a ticket and a comment, lets add attachments
\Components\Support\Helpers\Utilities::addAttachments($ticket->get('id'), $comment->get('id'));
$msg = new stdClass();
$msg->id = $comment->get('id');
$msg->notified = $comment->get('changelog');
$this->send($msg, 200, 'OK');
/*
$changlog->notifications = array();
if (Request::get('email_owner'))
{
$comment->addTo(array(
'role' => Lang::txt('COM_SUPPORT_COMMENT_SEND_EMAIL_OWNER'),
'name' => $ticket->get_owner->get('name'),
'email' => $ticket->get_owner->get('email'),
'id' => $ticket->get_owner->get('id')
));
$changelog->notifications[] = json_encode(array('role'=>'Ticket owner', 'address'=>$ticket->get_owner()->get('email'), 'name'=>$ticket->get_owner()->get('name')));
}
// Add any CCs to the e-mail list
$cc = Request::get('cc', null);
if ($cc)
{
$cc = explode(',', $cc);
foreach ($cc)
{
$comment->addTo($cc, Lang::txt('COM_SUPPORT_COMMENT_SEND_EMAIL_CC'));
}
$changelog->cc = json_encode($cc);
}
// Check if the notify list has eny entries
if (count($comment->to()))
{
include_once(PATH_CORE . DS . 'components' . DS . 'com_support' . DS . 'helpers' . DS . 'utilities.php');
$allowEmailResponses = $ticket->config('email_processing');
if ($allowEmailResponses)
{
try
{
$encryptor = new \Hubzero\Mail\Token();
}
catch (Exception $e)
{
$allowEmailResponses = false;
}
}
$subject = Lang::txt('COM_SUPPORT_EMAIL_SUBJECT_TICKET_COMMENT', $ticket->get('id'));
$from = array(
'name' => Lang::txt('COM_SUPPORT_EMAIL_FROM', Config::get('sitename')),
'email' => Config::get('mailfrom'),
'multipart' => md5(date('U'))
);
$message = array();
// Plain text email
$eview = new \Hubzero\Mail\View(array(
'base_path' => PATH_CORE . '/components/com_support/site',
'name' => 'emails',
'layout' => 'comment_plain'
));
$eview->option = 'com_support';
$eview->controller = 'tickets';
$eview->comment = $comment;
$eview->ticket = $ticket;
$eview->delimiter = ($allowEmailResponses ? '~!~!~!~!~!~!~!~!~!~!' : '');
$message['plaintext'] = $eview->loadTemplate(false);
$message['plaintext'] = str_replace("\n", "\r\n", $message['plaintext']);
// HTML email
$eview->setLayout('comment_html');
$message['multipart'] = $eview->loadTemplate();
// Send e-mail to admin?
foreach ($comment->to('ids') as $to)
{
if ($allowEmailResponses)
{
// The reply-to address contains the token
$token = $encryptor->buildEmailToken(1, 1, $to['id'], $ticket->get('id'));
$from['replytoemail'] = 'htc-' . $token . strstr(Config::get('mailfrom'), '@');
}
// Get the user's email address
if (!Event::trigger('xmessage.onSendMessage', array('support_reply_submitted', $subject, $message, $from, array($to['id']), 'com_support')))
{
$this->setError(Lang::txt('COM_SUPPORT_ERROR_FAILED_TO_MESSAGE', $to['name'] . '(' . $to['role'] . ')'));
}
$comment->changelog()->notified(
$to['role'],
$to['name'],
$to['email']
);
}
foreach ($comment->to('emails') as $to)
{
if ($allowEmailResponses)
{
$token = $encryptor->buildEmailToken(1, 1, -9999, $ticket->get('id'));
$email = array(
$to['email'],
'htc-' . $token . strstr(Config::get('mailfrom'), '@')
);
// In this case each item in email in an array, 1- To, 2:reply to address
\Components\Support\Helpers\Utilities::sendEmail($email[0], $subject, $message, $from, $email[1]);
}
else
{
// email is just a plain 'ol string
\Components\Support\Helpers\Utilities::sendEmail($to['email'], $subject, $message, $from);
}
$comment->changelog()->notified(
$to['role'],
$to['name'],
$to['email']
);
}
}
$comment->set('changelog', json_encode($changelog));
$comment->save();
$ticket->save();
$msg = new stdClass;
$msg->id = $comment->get('id');
$msg->notified = $comment->get('changelog');
$this->send($msg, 200, 'OK');
*/
}
/**
* Delete one or more records
*
* @return void
*/
public function removeTask()
{
// Check for request forgeries
Request::checkToken();
if (!User::authorise('core.delete', $this->_option)) {
App::abort(403, Lang::txt('JERROR_ALERTNOAUTHOR'));
}
// Incoming
$ids = Request::getVar('id', array());
$ids = !is_array($ids) ? array($ids) : $ids;
// Check for an ID
if (count($ids) < 1) {
Notify::warning(Lang::txt('COM_SUPPORT_ERROR_SELECT_STATUS_TO_DELETE'));
return $this->cancelTask();
}
$i = 0;
foreach ($ids as $id) {
// Delete entry
$row = Status::oneOrFail(intval($id));
if (!$row->destroy()) {
Notify::error($row->getError());
continue;
}
$i++;
}
// Output messsage and redirect
if ($i) {
Notify::success(Lang::txt('COM_SUPPORT_STATUS_SUCCESSFULLY_DELETED', $i));
}
$this->cancelTask();
}