Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.

Differences Between: [Versions 39 and 402]

   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  /**
  18   * This file contains the core_userfeedback class
  19   *
  20   * @package    core
  21   * @copyright  2020 Shamim Rezaie <shamim@moodle.com>
  22   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  defined('MOODLE_INTERNAL') || die();
  26  
  27  /**
  28   * This Class contains helper functions for user feedback functionality.
  29   *
  30   * @copyright  2020 Shamim Rezaie <shamim@moodle.com>
  31   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  32   */
  33  class core_userfeedback {
  34      /**
  35       * @var int Ask user to give feedback a few days after each major upgrade.
  36       */
  37      public const REMIND_AFTER_UPGRADE = 1;
  38  
  39      /**
  40       * @var int Ask user to give feedback periodically.
  41       */
  42      public const REMIND_PERIODICALLY = 2;
  43  
  44      /**
  45       * @var int Do not ask user to give feedback.
  46       */
  47      public const REMIND_NEVER = 3;
  48  
  49      /**
  50       * Displays the feedback reminder block.
  51       */
  52      public static function print_reminder_block(): void {
  53          global $PAGE;
  54  
  55          static $jscalled = false;
  56  
  57          $actions = [
  58              [
  59                  'title' => get_string('calltofeedback_give'),
  60                  'url' => static::make_link()->out(false),
  61                  'data' => [
  62                      'action' => 'give',
  63                      'record' => 1,
  64                      'hide' => 1,
  65                  ],
  66                  'newwindow' => true,
  67              ],
  68              [
  69                  'title' => get_string('calltofeedback_remind'),
  70                  'url' => '#',
  71                  'data' => [
  72                      'action' => 'remind',
  73                      'record' => 1,
  74                      'hide' => 1,
  75                  ],
  76              ],
  77          ];
  78          $icon = [
  79              'pix' => 'i/bullhorn',
  80              'component' => 'core'
  81          ];
  82  
  83          \core\notification::add_call_to_action($icon, get_string('calltofeedback'), $actions, 'core/userfeedback');
  84  
  85          if (!$jscalled) {
  86              $jscalled = true;
  87              // Calling the following more than once will register event listeners twice.
  88              $PAGE->requires->js_call_amd('core/userfeedback', 'registerEventListeners');
  89          }
  90      }
  91  
  92      /**
  93       * Indicates whether the feedback reminder block should be shown or not.
  94       *
  95       * @return bool
  96       */
  97      public static function should_display_reminder(): bool {
  98          global $CFG;
  99  
 100          if (static::can_give_feedback()) {
 101              $give = get_user_preferences('core_userfeedback_give');
 102              $remind = get_user_preferences('core_userfeedback_remind');
 103  
 104              $lastactiontime = max($give ?: 0, $remind ?: 0);
 105  
 106              switch ($CFG->userfeedback_nextreminder) {
 107                  case static::REMIND_AFTER_UPGRADE:
 108                      $lastupgrade = static::last_major_upgrade_time();
 109                      if ($lastupgrade >= $lastactiontime) {
 110                          return $lastupgrade + ($CFG->userfeedback_remindafter * DAYSECS) < time();
 111                      }
 112                      break;
 113                  case static::REMIND_PERIODICALLY:
 114                      return $lastactiontime + ($CFG->userfeedback_remindafter * DAYSECS) < time();
 115                      break;
 116              }
 117          }
 118          return false;
 119      }
 120  
 121      /**
 122       * Prepare and return the URL of the feedback site
 123       *
 124       * @return moodle_url
 125       */
 126      public static function make_link(): moodle_url {
 127          global $CFG, $PAGE;
 128  
 129          $baseurl = $CFG->userfeedback_url ?? 'https://feedback.moodle.org/lms';
 130          $lang = clean_param(current_language(), PARAM_LANG); // Avoid breaking WS because of incorrect package langs.
 131          $moodleurl = $CFG->wwwroot;
 132          $moodleversion = $CFG->release;
 133          $theme = $PAGE->theme->name;
 134          $themeversion = get_config('theme_'.$theme, 'version');
 135  
 136          $url = new moodle_url($baseurl, [
 137              'lang' => $lang,
 138              'moodle_url' => $moodleurl,
 139              'moodle_version' => $moodleversion,
 140              'theme' => $theme,
 141              'theme_version' => $themeversion,
 142              'newtest' => 'Y', // Respondents might be using the same device/browser to fill out the survey.
 143                                // The newtest param resets the session.
 144          ]);
 145  
 146          return $url;
 147      }
 148  
 149      /**
 150       * Whether the current can give feedback.
 151       *
 152       * @return bool
 153       */
 154      public static function can_give_feedback(): bool {
 155          global $CFG;
 156  
 157          return !empty($CFG->enableuserfeedback) && isloggedin() && !isguestuser();
 158      }
 159  
 160      /**
 161       * Returns the last major upgrade time
 162       *
 163       * @return int
 164       */
 165      private static function last_major_upgrade_time(): int {
 166          global $DB;
 167  
 168          $targetversioncast = $DB->sql_cast_char2real('targetversion');
 169          $versioncast = $DB->sql_cast_char2real('version');
 170  
 171          // A time difference more than 3 months has to be a core upgrade.
 172          // Also, passing IGNORE_MULTIPLE because we are only interested in the first field and LIMIT is not cross-DB.
 173          $time = $DB->get_field_sql("SELECT timemodified
 174                                       FROM {upgrade_log}
 175                                      WHERE plugin = 'core' AND $targetversioncast - $versioncast > 30000
 176                                   ORDER BY timemodified DESC", null, IGNORE_MULTIPLE);
 177  
 178          return (int)$time;
 179      }
 180  }