diff --git a/application/models/tables/Requests.php b/application/models/tables/Requests.php index c9340671fae8d94edf22d4ad10d335dd56242313..630471d05c79d83f6a5787f988a431a5b05e5d03 100644 --- a/application/models/tables/Requests.php +++ b/application/models/tables/Requests.php @@ -24,6 +24,11 @@ class Requests extends Nmc_Db_Table return self::$_instance; } + /** + * Fetch a row + * + * @return Request + */ public function fetchNew() { $new = parent::fetchNew(); @@ -31,6 +36,14 @@ class Requests extends Nmc_Db_Table return $new; } + /** + * Fetch all requests initiated by the given user. + * Option to include or hide completed requests. + * + * @param Person $user + * @param int $completedRequests + * @return Nmc_Db_Table_Rowset + */ public function getRequestsForUser(Person $user, $completedRequests = self::COMPLETED_REQUESTS_NO) { @@ -41,6 +54,14 @@ class Requests extends Nmc_Db_Table return $requests; } + /** + * Fetches all requests. + * Option to include or hide completed requests. + * + * @param string $where + * @param int $completedRequests + * @return Nmc_Db_Table_Rowset + */ public function fetchAllSorted($where = null, $completedRequests = self::COMPLETED_REQUESTS_NO) { @@ -91,6 +112,12 @@ class Requests extends Nmc_Db_Table return $requests; } + /** + * Fetch all requests currently pending at the given action + * + * @param ApprovalAction $action + * @return Nmc_Db_Table_Rowset + */ public function fetchAllWithCurrentAction(ApprovalAction $action) { $db = $this->getAdapter(); $select = new Zend_Db_Select($db);