SubmissionFilesGridHandler.inc.php

<?php
 
// Import UI base classes.
import('lib.pkp.classes.controllers.grid.GridHandler');
 
// Import submission files grid specific classes.
import('lib.pkp.controllers.grid.files.SubmissionFilesGridRow');
import('lib.pkp.controllers.grid.files.FileNameGridColumn');
import('lib.pkp.controllers.grid.files.FileDateGridColumn');
 
// Import submission file class which contains the SUBMISSION_FILE_* constants.
import('lib.pkp.classes.submission.SubmissionFile');
 
// Import the class that defines file grids capabilities.
import('lib.pkp.classes.controllers.grid.files.FilesGridCapabilities');
 
class SubmissionFilesGridHandler extends GridHandler {
 
   var $_capabilities;
 
   var $_stageId;
 
   function __construct($dataProvider, $stageId, $capabilities = 0) {
      parent::__construct($dataProvider);
 
      if ($stageId) {
         $this->_stageId = (int)$stageId;
      }
      $this->_capabilities = new FilesGridCapabilities($capabilities);
   }
 
 
   //
   // Getters and Setters
   //
   function getCapabilities() {
      return $this->_capabilities;
   }
 
   function setCapabilities($capabilities) {
      $this->_capabilities = $capabilities;
   }
 
   function getStageId() {
      return $this->_stageId;
   }
 
   function getSubmission() {
      // We assume proper authentication by the data provider.
      $submission = $this->getAuthorizedContextObject(ASSOC_TYPE_SUBMISSION);
      assert(is_a($submission, 'Submission'));
      return $submission;
   }
 
 
   //
   // Implement template methods from PKPHandler
   //
   function authorize($request, &$args, $roleAssignments) {
      // Set the stage id from the request parameter if not set previously.
      if (!$this->getStageId()) {
         $stageId = (int) $request->getUserVar('stageId');
         // This will be validated with the authorization policy added by
         // the grid data provider.
         $this->_stageId = $stageId;
      }
 
      $dataProvider = $this->getDataProvider();
      $dataProvider->setStageId($this->getStageId());
 
      return parent::authorize($request, $args, $roleAssignments);
   }
 
   function initialize($request, $args = null) {
      parent::initialize($request, $args);
 
      // Load translations.
      AppLocale::requireComponents(
         LOCALE_COMPONENT_APP_SUBMISSION,
         LOCALE_COMPONENT_PKP_SUBMISSION,
         LOCALE_COMPONENT_APP_EDITOR,
         LOCALE_COMPONENT_PKP_EDITOR,
         LOCALE_COMPONENT_PKP_COMMON,
         LOCALE_COMPONENT_APP_COMMON
      );
 
      // Add grid actions
      $capabilities = $this->getCapabilities();
      $dataProvider = $this->getDataProvider();
 
      $submission = $this->getSubmission();
 
      if($capabilities->canAdd()) {
         assert(isset($dataProvider));
         $this->addAction($dataProvider->getAddFileAction($request));
      }
 
      // Test whether an archive tool is available for the export to work, if so, add 'download all' grid action
      if ($capabilities->canDownloadAll() && $this->hasGridDataElements($request)) {
         $stageId = $this->getStageId();
         $linkParams = array('submissionId' => $submission->getId(), 'stageId' => $stageId);
         $files = $this->getFilesToDownload($request);
 
         $this->addAction($capabilities->getDownloadAllAction($request, $files, $linkParams), GRID_ACTION_POSITION_BELOW);
      }
 
      // The file name column is common to all file grid types.
      $this->addColumn(new FileNameGridColumn($capabilities->canViewNotes(), $this->getStageId()));
 
      // Additional column with file upload date/creation date
      $this->addColumn(new FileDateGridColumn($capabilities->canViewNotes()));
 
      // Set the no items row text
      $this->setEmptyRowText('grid.noFiles');
   }
 
   protected function getFilterForm() {
      return 'controllers/grid/files/filesGridFilter.tpl';
   }
 
   function renderFilter($request, $filterData = array()) {
      return parent::renderFilter(
         $request,
         array(
            'columns' => $this->getFilterColumns(),
            'gridId' => $this->getId()
         )
      );
   }
 
   function getFilterSelectionData($request) {
      return array(
         'search' => (string) $request->getUserVar('search'),
         'column' => (string) $request->getUserVar('column'),
      );
   }
 
   protected function getFilterColumns() {
      return array(
         'name' => __('common.name'),
      );
   }
 
 
   //
   // Overridden methods from GridHandler
   //
   protected function getRowInstance() {
      return new SubmissionFilesGridRow($this->getCapabilities(), $this->getStageId());
   }
 
 
   //
   // Protected methods.
   //
   function getFilesToDownload($request) {
      return $this->getGridDataElements($request);
   }
}