Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.

Differences Between: [Versions 310 and 400] [Versions 311 and 400] [Versions 39 and 400] [Versions 400 and 401] [Versions 400 and 402] [Versions 400 and 403]

   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   * Label module upgrade
  19   *
  20   * @package mod_label
  21   * @copyright  2006 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com}
  22   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  // This file keeps track of upgrades to
  26  // the label module
  27  //
  28  // Sometimes, changes between versions involve
  29  // alterations to database structures and other
  30  // major things that may break installations.
  31  //
  32  // The upgrade function in this file will attempt
  33  // to perform all the necessary actions to upgrade
  34  // your older installation to the current version.
  35  //
  36  // If there's something it cannot do itself, it
  37  // will tell you what you need to do.
  38  //
  39  // The commands in here will all be database-neutral,
  40  // using the methods of database_manager class
  41  //
  42  // Please do not forget to use upgrade_set_timeout()
  43  // before any action that may take longer time to finish.
  44  
  45  defined('MOODLE_INTERNAL') || die;
  46  
  47  function xmldb_label_upgrade($oldversion) {
  48      global $CFG, $DB;
  49  
  50      // Automatically generated Moodle v3.6.0 release upgrade line.
  51      // Put any upgrade step following this.
  52  
  53      // Automatically generated Moodle v3.7.0 release upgrade line.
  54      // Put any upgrade step following this.
  55  
  56      // Automatically generated Moodle v3.8.0 release upgrade line.
  57      // Put any upgrade step following this.
  58  
  59      // Automatically generated Moodle v3.9.0 release upgrade line.
  60      // Put any upgrade step following this.
  61  
  62      // Automatically generated Moodle v4.0.0 release upgrade line.
  63      // Put any upgrade step following this.
  64  
  65      if ($oldversion < 2022041901) {
  66          $module = $DB->get_field('modules', 'id', ['name' => 'label']);
  67          $DB->execute('
  68              UPDATE {course_modules}
  69                 SET visible = 0, visibleoncoursepage = 1
  70               WHERE module = :module
  71                     AND visible = 1
  72                     AND visibleoncoursepage = 0',
  73              ['module' => $module]
  74          );
  75          upgrade_mod_savepoint(true, 2022041901, 'label');
  76      }
  77  
  78      if ($oldversion < 2022041902) {
  79          $prevlang = force_current_language($CFG->lang);
  80  
  81          $select = $DB->sql_like('name', ':tofind');
  82          $params = ['tofind' => '%@@PLUGINFILE@@%'];
  83          $total = $DB->count_records_select('label', $select, $params);
  84          if ($total > 0) {
  85              $labels = $DB->get_recordset_select('label', $select, $params, 'id, name, intro');
  86  
  87              // Show a progress bar.
  88              $pbar = new progress_bar('upgrademodlabelpluginfile', 500, true);
  89              $current = 0;
  90  
  91              $defaultname = get_string('modulename', 'label');
  92              foreach ($labels as $label) {
  93                  $originalname = $label->name;
  94                  // Make sure that all labels have now the same name according to the new convention.
  95                  // Note this is the same (and duplicated) code as in get_label_name as we cannot call any API function
  96                  // during upgrade.
  97                  $name = html_to_text(format_string($label->intro, true));
  98                  $name = preg_replace('/@@PLUGINFILE@@\/[[:^space:]]+/i', '', $name);
  99                  // Remove double space and also nbsp; characters.
 100                  $name = preg_replace('/\s+/u', ' ', $name);
 101                  $name = trim($name);
 102                  if (core_text::strlen($name) > LABEL_MAX_NAME_LENGTH) {
 103                      $name = core_text::substr($name, 0, LABEL_MAX_NAME_LENGTH) . "...";
 104                  }
 105                  if (empty($name)) {
 106                      $name = $defaultname;
 107                  }
 108                  $label->name = $name;
 109                  if ($originalname !== $name) {
 110                      $DB->update_record('label', $label);
 111                  }
 112                  $current++;
 113                  $pbar->update($current, $total, "Upgrading label activity names - $current/$total.");
 114              }
 115              $labels->close();
 116          }
 117          force_current_language($prevlang);
 118          upgrade_mod_savepoint(true, 2022041902, 'label');
 119      }
 120  
 121      return true;
 122  }