lib/filebrowser/file_info_context_system.php

   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 /**
  19  * Utility class for browsing of system files.
  20  *
  21  * @package    core_files
  22  * @copyright  2008 Petr Skoda (http://skodak.org)
  23  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24  */
  25
  26 defined('MOODLE_INTERNAL') || die();
  27
  28 /**
  29  * Represents the system context in the tree navigated by {@link file_browser}.
  30  *
  31  * @package    core_files
  32  * @copyright  2008 Petr Skoda (http://skodak.org)
  33  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  34  */
  35 class file_info_context_system extends file_info {
  36
  37     /**
  38      * Constructor
  39      *
  40      * @param file_browser $browser file_browser instance
  41      * @param stdClass $context context object
  42      */
  43     public function __construct($browser, $context) {
  44         parent::__construct($browser, $context);
  45     }
  46
  47     /**
  48      * Return information about this specific part of context level
  49      *
  50      * @param string $component component
  51      * @param string $filearea file area
  52      * @param int $itemid item ID
  53      * @param string $filepath file path
  54      * @param string $filename file name
  55      * @return file_info|null file_info instance or null if not found or access not allowed
  56      */
  57     public function get_file_info($component, $filearea, $itemid, $filepath, $filename) {
  58         if (empty($component)) {
  59             return $this;
  60         }
  61
  62         $methodname = "get_area_{$component}_{$filearea}";
  63
  64         if (method_exists($this, $methodname)) {
  65             return $this->$methodname($itemid, $filepath, $filename);
  66         }
  67
  68         return null;
  69     }
  70
  71     /**
  72      * Gets a stored file for the backup course filearea directory.
  73      *
  74      * @param int $itemid item ID
  75      * @param string $filepath file path
  76      * @param string $filename file name
  77      * @return file_info|null file_info instance or null if not found or access not allowed
  78      */
  79     protected function get_area_backup_course($itemid, $filepath, $filename) {
  80         global $CFG;
  81
  82         if (!isloggedin()) {
  83             return null;
  84         }
  85
  86         if (!has_any_capability(array('moodle/backup:backupcourse', 'moodle/restore:restorecourse'), $this->context)) {
  87             return null;
  88         }
  89
  90         if (is_null($itemid)) {
  91             return $this;
  92         }
  93
  94         $fs = get_file_storage();
  95
  96         $filepath = is_null($filepath) ? '/' : $filepath;
  97         $filename = is_null($filename) ? '.' : $filename;
  98         if (!$storedfile = $fs->get_file($this->context->id, 'backup', 'course', 0, $filepath, $filename)) {
  99             if ($filepath === '/' && $filename === '.') {
 100                 $storedfile = new virtual_root_file($this->context->id, 'backup', 'course', 0);
 101             } else {
 102                 // Not found.
 103                 return null;
 104             }
 105         }
 106
 107         $downloadable = has_capability('moodle/backup:downloadfile', $this->context);
 108         $uploadable = has_capability('moodle/restore:uploadfile', $this->context);
 109
 110         $urlbase = $CFG->wwwroot . '/pluginfile.php';
 111         return new file_info_stored($this->browser, $this->context, $storedfile, $urlbase,
 112             get_string('coursebackup', 'repository'), false, $downloadable, $uploadable, false);
 113     }
 114
 115     /**
 116      * Returns localised visible name.
 117      *
 118      * @return string
 119      */
 120     public function get_visible_name() {
 121         return get_string('arearoot', 'repository');
 122     }
 123
 124     /**
 125      * Whether or not new files or directories can be added
 126      *
 127      * @return bool
 128      */
 129     public function is_writable() {
 130         return false;
 131     }
 132
 133     /**
 134      * Whether or not this is a directory
 135      *
 136      * @return bool
 137      */
 138     public function is_directory() {
 139         return true;
 140     }
 141
 142     /**
 143      * Returns list of children.
 144      *
 145      * @return array of file_info instances
 146      */
 147     public function get_children() {
 148         global $DB, $USER;
 149
 150         $children = array();
 151
 152         $course_cats = $DB->get_records('course_categories', array('parent'=>0), 'sortorder', 'id,visible');
 153         foreach ($course_cats as $category) {
 154             $context = context_coursecat::instance($category->id);
 155             if (!$category->visible and !has_capability('moodle/category:viewhiddencategories', $context)) {
 156                 continue;
 157             }
 158             if ($child = $this->browser->get_file_info($context)) {
 159                 $children[] = $child;
 160             }
 161         }
 162
 163         $courses = $DB->get_records('course', array('category'=>0), 'sortorder', 'id,visible');
 164         foreach ($courses as $course) {
 165             if (!$course->visible and !has_capability('moodle/course:viewhiddencourses', $context)) {
 166                 continue;
 167             }
 168             $context = context_course::instance($course->id);
 169             if ($child = $this->browser->get_file_info($context)) {
 170                 $children[] = $child;
 171             }
 172         }
 173
 174         return $children;
 175     }
 176
 177     /**
 178      * Returns parent file_info instance
 179      *
 180      * @return file_info|null file_info instance or null for root
 181      */
 182     public function get_parent() {
 183         return null;
 184     }
 185 }