ReviewerAction.inc.php

<?php
 
// Access decision actions constants.
import('classes.workflow.EditorDecisionActionsManager');
 
class ReviewerAction {
 
   function __construct() {
   }
 
   //
   // Actions.
   //
   function confirmReview($request, $reviewAssignment, $submission, $decline, $emailText = null) {
      $reviewAssignmentDao = DAORegistry::getDAO('ReviewAssignmentDAO'); /* @var $reviewAssignmentDao ReviewAssignmentDAO */
      $userDao = DAORegistry::getDAO('UserDAO'); /* @var $userDao UserDAO */
 
      $reviewer = $userDao->getById($reviewAssignment->getReviewerId());
      if (!isset($reviewer)) return true;
 
      // Only confirm the review for the reviewer if
      // he has not previously done so.
      if ($reviewAssignment->getDateConfirmed() == null) {
         $email = $this->getResponseEmail($submission, $reviewAssignment, $request, $decline);
         // Must explicitly set sender because we may be here on an access
         // key, in which case the user is not technically logged in
         $email->setReplyTo($reviewer->getEmail(), $reviewer->getFullName());
         HookRegistry::call('ReviewerAction::confirmReview', array($request, &$submission, &$email, $decline));
         import('lib.pkp.classes.log.SubmissionEmailLogEntry'); // Import email event constants
         $email->setEventType($decline?SUBMISSION_EMAIL_REVIEW_DECLINE:SUBMISSION_EMAIL_REVIEW_CONFIRM);
         if ($emailText) $email->setBody($emailText);
         if (!$email->send($request)) {
            import('classes.notification.NotificationManager');
            $notificationMgr = new NotificationManager();
            $notificationMgr->createTrivialNotification($request->getUser()->getId(), NOTIFICATION_TYPE_ERROR, array('contents' => __('email.compose.error')));
         }
 
         $reviewAssignment->setDeclined($decline);
         $reviewAssignment->setDateConfirmed(Core::getCurrentDate());
         $reviewAssignment->stampModified();
         $reviewAssignmentDao->updateObject($reviewAssignment);
 
         // Add log
         import('lib.pkp.classes.log.SubmissionLog');
         import('classes.log.SubmissionEventLogEntry');
 
         SubmissionLog::logEvent(
            $request,
            $submission,
            $decline?SUBMISSION_LOG_REVIEW_DECLINE:SUBMISSION_LOG_REVIEW_ACCEPT,
            $decline?'log.review.reviewDeclined':'log.review.reviewAccepted',
            array(
               'reviewAssignmentId' => $reviewAssignment->getId(),
               'reviewerName' => $reviewer->getFullName(),
               'submissionId' => $reviewAssignment->getSubmissionId(),
               'round' => $reviewAssignment->getRound()
            )
         );
      }
   }
 
   function getResponseEmail($submission, $reviewAssignment, $request, $decline) {
      import('lib.pkp.classes.mail.SubmissionMailTemplate');
      $email = new SubmissionMailTemplate($submission, $decline?'REVIEW_DECLINE':'REVIEW_CONFIRM');
 
      // Get reviewer
      $userDao = DAORegistry::getDAO('UserDAO'); /* @var $userDao UserDAO */
      $reviewer = $userDao->getById($reviewAssignment->getReviewerId());
 
      // Get editorial contact name
      $stageAssignmentDao = DAORegistry::getDAO('StageAssignmentDAO'); /* @var $stageAssignmentDao StageAssignmentDAO */
      $userGroupDao = DAORegistry::getDAO('UserGroupDAO'); /* @var $userGroupDao UserGroupDAO */
      $userDao = DAORegistry::getDAO('UserDAO'); /* @var $userDao UserDAO */
      $stageAssignments = $stageAssignmentDao->getBySubmissionAndStageId($submission->getId(), $reviewAssignment->getStageId());
      $recipient = null;
      $context = $request->getContext();
      while ($stageAssignment = $stageAssignments->next()) {
         $userGroup = $userGroupDao->getById($stageAssignment->getUserGroupId());
         if (!in_array($userGroup->getRoleId(), array(ROLE_ID_MANAGER, ROLE_ID_SUB_EDITOR))) continue;
 
         $recipient = $userDao->getById($stageAssignment->getUserId());
         $email->addRecipient($recipient->getEmail(), $recipient->getFullName());
      }
      if (!$recipient) {
         $email->addRecipient($context->getData('contactEmail'), $context->getData('contactName'));
      }
 
      // Get due date
      $reviewDueDate = strtotime($reviewAssignment->getDateDue());
      $dateFormatShort = $context->getLocalizedDateFormatShort();
      if ($reviewDueDate == -1) $reviewDueDate = $dateFormatShort; // Default to something human-readable if no date specified
      else $reviewDueDate = strftime($dateFormatShort, $reviewDueDate);
 
      $email->setReplyTo($reviewer->getEmail(), $reviewer->getFullName());
 
      $email->assignParams(array(
         'reviewerName' => $reviewer->getFullName(),
         'reviewDueDate' => $reviewDueDate
      ));
      $email->replaceParams();
 
      return $email;
   }
}