khanat-opennel-code/code/web/private_php/ams/autoload/ticket_queue_handler.php

138 lines
5.5 KiB
PHP
Raw Normal View History

<?php
/**
* returns tickets (queues) that are related in some way.
* This class handles the creation and returning of existing ticket queues. Normally a $_GET['get'] parameter is being used to identify what kind of tickets should be shown.
* the getTickets() function uses this parameter($input) and uses the ticket_queue class to load the specific query.
* @author Daan Janssens, mentored by Matthew Lagoe
*/
class Ticket_Queue_Handler{
private $pagination; /**< Pagination object, this way only a few tickets (related to that pagenumber) will be shown */
private $queue; /**< The queue object, being used to get the queries and parameters. */
/**
* A constructor.
* Instantiates the queue object.
*/
function __construct() {
$this->queue = new Ticket_Queue();
}
2013-08-05 20:35:22 +00:00
/**
* returns the tickets that are related in someway defined by $input.
* The $input parameter should be a string that defines what kind of queue should be loaded. A new pagination object will be instantiated and will load 10 entries,
* related to the $_GET['pagenum'] variable.
* @param $input identifier that defines what queue to load.
* @param $user_id the id of the user that browses the queues, some queues can be depending on this.
* @return an array consisting of ticket objects, beware, the author & category of a ticket, are objects on their own (no integers are used this time).
*/
2013-08-05 20:35:22 +00:00
public function getTickets($input, $user_id){
switch ($input){
case "all":
$this->queue->loadAllTickets();
break;
case "all_open":
$this->queue->loadAllOpenTickets();
break;
case "archive":
$this->queue->loadAllClosedTickets();
break;
case "not_assigned":
$this->queue->loadAllNotAssignedTickets();
break;
2013-07-21 13:38:22 +00:00
case "todo":
$this->queue->loadToDoTickets($user_id);
break;
case "create":
//set these with the createQueue function proceding the getTickets function
2013-07-21 13:38:22 +00:00
break;
default:
return "ERROR";
}
2013-08-06 04:07:49 +00:00
$this->pagination = new Pagination($this->queue->getQuery(),"lib",10,"Ticket",$this->queue->getParams());
$elemArray = $this->pagination->getElements();
if(!empty($elemArray)){
foreach( $elemArray as $element ){
$catInstance = new Ticket_Category();
$catInstance->load_With_TCategoryId($element->getTicket_Category());
$element->setTicket_Category($catInstance);
$userInstance = new Ticket_User();
$userInstance->load_With_TUserId($element->getAuthor());
$element->setAuthor($userInstance);
}
2013-08-05 20:35:22 +00:00
}
return $this->pagination->getElements();
2013-08-05 20:35:22 +00:00
}
/**
* get pagination attribute of the object.
*/
public function getPagination(){
return $this->pagination;
}
/**
* creates the queue.
* afterwards the getTickets function should be called, else a lot of extra parameters had to be added to the getTickets function..
*/
public function createQueue($userid, $groupid, $what, $how, $who){
$this->queue->createQueue($userid, $groupid, $what, $how, $who);
}
////////////////////////////////////////////Info retrievers about ticket statistics////////////////////////////////////////////////////
/**
* get the number of tickets in the todo queue for a specific user.
* @param $user_id the user being queried
*/
public static function getNrOfTicketsToDo($user_id){
$queueHandler = new Ticket_Queue_Handler();
$queueHandler->queue->loadToDoTickets($user_id);
$query = $queueHandler->queue->getQuery();
$params = $queueHandler->queue->getParams();
$dbl = new DBLayer("lib");
return $dbl->execute($query,$params)->rowCount();
}
/**
* get the number of tickets assigned to a specific user and waiting for support.
* @param $user_id the user being queried
*/
public static function getNrOfTicketsAssignedWaiting($user_id){
$queueHandler = new Ticket_Queue_Handler();
$queueHandler->queue->loadAssignedandWaiting($user_id);
$query = $queueHandler->queue->getQuery();
$params = $queueHandler->queue->getParams();
$dbl = new DBLayer("lib");
return $dbl->execute($query,$params)->rowCount();
}
/**
* get the total number of tickets.
*/
public static function getNrOfTickets(){
$queueHandler = new Ticket_Queue_Handler();
$queueHandler->queue->loadAllTickets();
$query = $queueHandler->queue->getQuery();
$params = $queueHandler->queue->getParams();
$dbl = new DBLayer("lib");
return $dbl->execute($query,$params)->rowCount();
}
/**
* get the ticket object of the latest added ticket.
*/
public static function getNewestTicket(){
$dbl = new DBLayer("lib");
$statement = $dbl->executeWithoutParams("SELECT * FROM `ticket` ORDER BY `TId` DESC LIMIT 1 ");
$ticket = new Ticket();
$ticket->set($statement->fetch());
return $ticket;
}
}