pages/reviewer/SubmissionReviewHandler.inc.php

Go to the documentation of this file.

<?php

//$Id$

import('pages.reviewer.ReviewerHandler');

class SubmissionReviewHandler extends ReviewerHandler {
   var $submission;
   
   var $user;
      
   function SubmissionReviewHandler() {
      parent::ReviewerHandler();
   }

   function submission($args) {
      $reviewId = $args[0];

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;
      $user =& $this->user;
      $schedConf =& Request::getSchedConf();
      
      $reviewAssignmentDao =& DAORegistry::getDAO('ReviewAssignmentDAO');
      $reviewAssignment = $reviewAssignmentDao->getReviewAssignmentById($reviewId);
      
      $reviewFormResponseDao =& DAORegistry::getDAO('ReviewFormResponseDAO');

      if ($reviewAssignment->getDateConfirmed() == null) {
         $confirmedStatus = 0;
      } else {
         $confirmedStatus = 1;
      }

      $this->setupTemplate(true, $reviewerSubmission->getPaperId(), $reviewId);

      $templateMgr =& TemplateManager::getManager();

      $templateMgr->assign_by_ref('user', $user);
      $templateMgr->assign_by_ref('submission', $reviewerSubmission);
      $templateMgr->assign_by_ref('reviewAssignment', $reviewAssignment);
      $templateMgr->assign('confirmedStatus', $confirmedStatus);
      $templateMgr->assign('declined', $reviewerSubmission->getDeclined());
      $templateMgr->assign('reviewFormResponseExists', $reviewFormResponseDao->reviewFormResponseExists($reviewId));
      $templateMgr->assign_by_ref('reviewFile', $reviewAssignment->getReviewFile());
      $templateMgr->assign_by_ref('reviewerFile', $reviewerSubmission->getReviewerFile());
      $templateMgr->assign_by_ref('suppFiles', $reviewerSubmission->getSuppFiles());
      $templateMgr->assign_by_ref('schedConf', $schedConf);
      $templateMgr->assign_by_ref('reviewGuidelines', $schedConf->getLocalizedSetting('reviewGuidelines'));

      // The reviewer instructions differ depending on what is reviewed, and when.
      if($reviewAssignment->getStage()==REVIEW_STAGE_ABSTRACT && $reviewerSubmission->getReviewMode() != REVIEW_MODE_BOTH_SIMULTANEOUS)
         $templateMgr->assign('reviewerInstruction3', 'reviewer.paper.downloadSubmissionAbstractOnly');
      else
         $templateMgr->assign('reviewerInstruction3', 'reviewer.paper.downloadSubmissionSubmission');

      import('submission.reviewAssignment.ReviewAssignment');
      $templateMgr->assign_by_ref('reviewerRecommendationOptions', ReviewAssignment::getReviewerRecommendationOptions());

      $controlledVocabDao =& DAORegistry::getDAO('ControlledVocabDAO');
      $templateMgr->assign('sessionTypes', $controlledVocabDao->enumerateBySymbolic('sessionTypes', ASSOC_TYPE_SCHED_CONF, $schedConf->getId()));

      $templateMgr->assign('helpTopicId', 'editorial.reviewersRole.review');     
      $templateMgr->display('reviewer/submission.tpl');
   }

   function confirmReview($args = null) {
      $reviewId = Request::getUserVar('reviewId');
      $declineReview = Request::getUserVar('declineReview');

      $reviewerSubmissionDao =& DAORegistry::getDAO('ReviewerSubmissionDAO');

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;
      $this->setupTemplate();
      
      $decline = isset($declineReview) ? 1 : 0;

      if (!$reviewerSubmission->getCancelled()) {
         if (ReviewerAction::confirmReview($reviewerSubmission, $decline, Request::getUserVar('send'))) {
            Request::redirect(null, null, null, 'submission', $reviewId);
         }
      } else {
         Request::redirect(null, null, null, 'submission', $reviewId);
      }
   }

   function recordRecommendation() {
      $reviewId = Request::getUserVar('reviewId');
      $recommendation = Request::getUserVar('recommendation');

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;
      $this->setupTemplate(true);

      if (!$reviewerSubmission->getCancelled()) {
         if (ReviewerAction::recordRecommendation($reviewerSubmission, $recommendation, Request::getUserVar('send'))) {
            Request::redirect(null, null, null, 'submission', $reviewId);
         }
      } else {
         Request::redirect(null, null, null, 'submission', $reviewId);
      }
   }

   function viewMetadata($args) {
      $reviewId = $args[0];
      $paperId = $args[1];

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;

      $this->setupTemplate(true, $paperId, $reviewId);
      AppLocale::requireComponents(array(LOCALE_COMPONENT_OCS_AUTHOR)); // author.submit.agencies

      ReviewerAction::viewMetadata($reviewerSubmission, ROLE_ID_REVIEWER);
   }

   function uploadReviewerVersion() {
      $reviewId = Request::getUserVar('reviewId');

      $this->validate($reviewId);
      $this->setupTemplate(true);
      
      if (!ReviewerAction::uploadReviewerVersion($reviewId)) {
         $templateMgr =& TemplateManager::getManager();
         $templateMgr->assign('pageTitle', 'submission.uploadFile');
         $templateMgr->assign('message', 'common.uploadFailed');
         $templateMgr->assign('backLink', Request::url(null, null, null, 'submission', array($reviewId)));
         $templateMgr->assign('backLinkLabel', 'common.back');
         return $templateMgr->display('common/message.tpl');
      }
      Request::redirect(null, null, null, 'submission', $reviewId);
   }

   /*
    * Delete one of the reviewer's annotated versions of a paper.
    */
   function deleteReviewerVersion($args) {      
      $reviewId = isset($args[0]) ? (int) $args[0] : 0;
      $fileId = isset($args[1]) ? (int) $args[1] : 0;
      $revision = isset($args[2]) ? (int) $args[2] : null;

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;

      if (!$reviewerSubmission->getCancelled()) ReviewerAction::deleteReviewerVersion($reviewId, $fileId, $revision);
      Request::redirect(null, null, null, 'submission', $reviewId);
   }

   //
   // Misc
   //

   function downloadFile($args) {
      $reviewId = isset($args[0]) ? $args[0] : 0;
      $paperId = isset($args[1]) ? $args[1] : 0;
      $fileId = isset($args[2]) ? $args[2] : 0;
      $revision = isset($args[3]) ? $args[3] : null;

      $this->validate($reviewId);
      $reviewerSubmission =& $this->submission;
      if (!ReviewerAction::downloadReviewerFile($reviewId, $reviewerSubmission, $fileId, $revision)) {
         Request::redirect(null, null, null, 'submission', $reviewId);
      }
   }
   
   //
   // Review Form
   //

   function editReviewFormResponse($args) {
      $reviewId = isset($args[0]) ? $args[0] : 0;
      
      $this->validate($reviewId);

      $reviewAssignmentDao =& DAORegistry::getDAO('ReviewAssignmentDAO');
      $reviewAssignment =& $reviewAssignmentDao->getReviewAssignmentById($reviewId);
      $reviewFormId = $reviewAssignment->getReviewFormId();
      if ($reviewFormId != null) {
         ReviewerAction::editReviewFormResponse($reviewId, $reviewFormId);    
      }
   }

   function saveReviewFormResponse($args) {
      $reviewId = isset($args[0]) ? $args[0] : 0;
      $reviewFormId = isset($args[1]) ? $args[1] : 0;

      $this->validate($reviewId);
      $this->setupTemplate(true);

      if (ReviewerAction::saveReviewFormResponse($reviewId, $reviewFormId)) {
               Request::redirect(null, null, null, 'submission', $reviewId);
      }
   }

   //
   // Validation
   //

   function validate($reviewId) {
      $reviewerSubmissionDao =& DAORegistry::getDAO('ReviewerSubmissionDAO');
      $schedConf =& Request::getSchedConf();
      $user =& Request::getUser();

      $isValid = true;
      $newKey = Request::getUserVar('key');

      $reviewerSubmission =& $reviewerSubmissionDao->getReviewerSubmission($reviewId);

      if (!$reviewerSubmission || $reviewerSubmission->getSchedConfId() != $schedConf->getId()) {
         $isValid = false;
      } elseif ($user && empty($newKey)) {
         if ($reviewerSubmission->getReviewerId() != $user->getId()) {
            $isValid = false;
         }
      } else {
         $user =& SubmissionReviewHandler::validateAccessKey($reviewerSubmission->getReviewerId(), $reviewId, $newKey);
         if (!$user) $isValid = false;
      }

      if (!$isValid) {
         Request::redirect(null, null, Request::getRequestedPage());
      }

      $this->submission =& $reviewerSubmission;
      $this->user =& $user;
      return true;
   }
}
?>

---