[Summary view]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  namespace qbank_previewquestion;
  18  
  19  use core_question\local\bank\question_action_base;
  20  
  21  /**
  22   * Question bank columns for the preview action icon.
  23   *
  24   * @package   qbank_previewquestion
  25   * @copyright 2009 Tim Hunt
  26   * @author    2021 Safat Shahin <safatshahin@catalyst-au.net>
  27   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  28   */
  29  class preview_action extends question_action_base {
  30  
  31      /**
  32       * @var string store this lang string for performance.
  33       */
  34      protected $strpreview;
  35  
  36      public function init(): void {
  37          parent::init();
  38          $this->strpreview = get_string('preview');
  39      }
  40  
  41      protected function get_url_icon_and_label(\stdClass $question): array {
  42          if (!\question_bank::is_qtype_installed($question->qtype)) {
  43              // It sometimes happens that people end up with junk questions
  44              // in their question bank of a type that is no longer installed.
  45              // We cannot do most actions on them, because that leads to errors.
  46              return [null, null, null];
  47          }
  48  
  49          if (question_has_capability_on($question, 'use')) {
  50              $context = $this->qbank->get_most_specific_context();
  51              // Default previews to always use the latest question version, unless we are previewing specific versions from the
  52              // question history.
  53              if ($this->qbank->is_listing_specific_versions()) {
  54                  $requestedversion = $question->version;
  55              } else {
  56                  $requestedversion = question_preview_options::ALWAYS_LATEST;
  57              }
  58              $url = helper::question_preview_url($question->id, null, null,
  59                                                      null, null, $context, $this->qbank->returnurl, $requestedversion);
  60              return [$url, 't/preview', $this->strpreview];
  61          } else {
  62              return [null, null, null];
  63          }
  64      }
  65  }