[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\menu_action_column_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_column extends menu_action_column_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      public function get_name(): string {
  42          return 'previewaction';
  43      }
  44  
  45      protected function get_url_icon_and_label(\stdClass $question): array {
  46          if (!\question_bank::is_qtype_installed($question->qtype)) {
  47              // It sometimes happens that people end up with junk questions
  48              // in their question bank of a type that is no longer installed.
  49              // We cannot do most actions on them, because that leads to errors.
  50              return [null, null, null];
  51          }
  52  
  53          if (question_has_capability_on($question, 'use')) {
  54              $context = $this->qbank->get_most_specific_context();
  55              // Default previews to always use the latest question version, unless we are previewing specific versions from the
  56              // question history.
  57              if ($this->qbank->is_listing_specific_versions()) {
  58                  $requestedversion = $question->version;
  59              } else {
  60                  $requestedversion = question_preview_options::ALWAYS_LATEST;
  61              }
  62              $url = helper::question_preview_url($question->id, null, null,
  63                                                      null, null, $context, $this->qbank->returnurl, $requestedversion);
  64              return [$url, 't/preview', $this->strpreview];
  65          } else {
  66              return [null, null, null];
  67          }
  68      }
  69  }