. /** * FileManager form element * * Contains HTML class for a filemanager form element * * @package core_form * @copyright 2009 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ global $CFG; require_once('HTML/QuickForm/element.php'); require_once($CFG->dirroot.'/lib/filelib.php'); require_once($CFG->dirroot.'/repository/lib.php'); /** * Filemanager form element * * FilemaneManager lets user to upload/manage multiple files * @package core_form * @category form * @copyright 2009 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class MoodleQuickForm_filemanager extends HTML_QuickForm_element { /** @var string html for help button, if empty then no help will icon will be dispalyed. */ public $_helpbutton = ''; /** @var array options provided to initalize filemanager */ protected $_options = array('mainfile'=>'', 'subdirs'=>1, 'maxbytes'=>-1, 'maxfiles'=>-1, 'accepted_types'=>'*', 'return_types'=>FILE_INTERNAL); /** * Constructor * * @param string $elementName (optional) name of the filemanager * @param string $elementLabel (optional) filemanager label * @param array $attributes (optional) Either a typical HTML attribute string * or an associative array * @param array $options set of options to initalize filemanager */ function MoodleQuickForm_filemanager($elementName=null, $elementLabel=null, $attributes=null, $options=null) { global $CFG, $PAGE; $options = (array)$options; foreach ($options as $name=>$value) { if (array_key_exists($name, $this->_options)) { $this->_options[$name] = $value; } } if (!empty($options['maxbytes'])) { $this->_options['maxbytes'] = get_max_upload_file_size($CFG->maxbytes, $options['maxbytes']); } $this->_type = 'filemanager'; parent::HTML_QuickForm_element($elementName, $elementLabel, $attributes); } /** * Sets name of filemanager * * @param string $name name of the filemanager */ function setName($name) { $this->updateAttributes(array('name'=>$name)); } /** * Returns name of filemanager * * @return string */ function getName() { return $this->getAttribute('name'); } /** * Updates filemanager attribute value * * @param string $value value to set */ function setValue($value) { $this->updateAttributes(array('value'=>$value)); } /** * Returns filemanager attribute value * * @return string */ function getValue() { return $this->getAttribute('value'); } /** * Returns maximum file size which can be uploaded * * @return int */ function getMaxbytes() { return $this->_options['maxbytes']; } /** * Sets maximum file size which can be uploaded * * @param int $maxbytes file size */ function setMaxbytes($maxbytes) { global $CFG; $this->_options['maxbytes'] = get_max_upload_file_size($CFG->maxbytes, $maxbytes); } /** * Returns true if subdirectoy can be created, else false * * @return bool */ function getSubdirs() { return $this->_options['subdirs']; } /** * Set option to create sub directory, while uploading file * * @param bool $allow true if sub directory can be created. */ function setSubdirs($allow) { $this->_options['subdirs'] = $allow; } /** * Returns maximum number of files which can be uploaded * * @return int */ function getMaxfiles() { return $this->_options['maxfiles']; } /** * Sets maximum number of files which can be uploaded. * * @param int $num number of files */ function setMaxfiles($num) { $this->_options['maxfiles'] = $num; } /** * Sets help button for filemanager * * @param mixed $helpbuttonargs arguments to create help button * @param string $function name of the callback function * @deprecated since Moodle 2.0. Please do not call this function any more. * @todo MDL-31047 this api will be removed. * @see MoodleQuickForm::setHelpButton() */ function setHelpButton($helpbuttonargs, $function='helpbutton'){ debugging('component setHelpButton() is not used any more, please use $mform->setHelpButton() instead'); } /** * Returns html for help button. * * @return string html for help button */ function getHelpButton() { return $this->_helpbutton; } /** * Returns type of filemanager element * * @return string */ function getElementTemplateType() { if ($this->_flagFrozen){ return 'nodisplay'; } else { return 'default'; } } /** * Returns HTML for filemanager form element. * * @return string */ function toHtml() { global $CFG, $USER, $COURSE, $PAGE, $OUTPUT; require_once("$CFG->dirroot/repository/lib.php"); // security - never ever allow guest/not logged in user to upload anything or use this element! if (isguestuser() or !isloggedin()) { print_error('noguest'); } if ($this->_flagFrozen) { return $this->getFrozenHtml(); } $id = $this->_attributes['id']; $elname = $this->_attributes['name']; $subdirs = $this->_options['subdirs']; $maxbytes = $this->_options['maxbytes']; $draftitemid = $this->getValue(); $accepted_types = $this->_options['accepted_types']; if (empty($draftitemid)) { // no existing area info provided - let's use fresh new draft area require_once("$CFG->libdir/filelib.php"); $this->setValue(file_get_unused_draft_itemid()); $draftitemid = $this->getValue(); } $client_id = uniqid(); // filemanager options $options = new stdClass(); $options->mainfile = $this->_options['mainfile']; $options->maxbytes = $this->_options['maxbytes']; $options->maxfiles = $this->getMaxfiles(); $options->client_id = $client_id; $options->itemid = $draftitemid; $options->subdirs = $this->_options['subdirs']; $options->target = $id; $options->accepted_types = $accepted_types; $options->return_types = FILE_INTERNAL; $options->context = $PAGE->context; $html = $this->_getTabs(); $html .= form_filemanager_render($options); $html .= ''; // label element needs 'for' attribute work $html .= ''; return $html; } } /** * Data structure representing a file manager. * * This class defines the data structure for file mnager * * @package core_form * @copyright 2010 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @todo do not use this abstraction (skodak) */ class form_filemanaer_x { /** @var stdClass $options options for filemanager */ public $options; /** * Constructor * * @param stdClass $options options for filemanager */ public function __construct(stdClass $options) { global $CFG, $USER, $PAGE; require_once($CFG->dirroot. '/repository/lib.php'); $defaults = array( 'maxbytes'=>-1, 'maxfiles'=>-1, 'itemid'=>0, 'subdirs'=>0, 'client_id'=>uniqid(), 'accepted_types'=>'*', 'return_types'=>FILE_INTERNAL, 'context'=>$PAGE->context ); foreach ($defaults as $key=>$value) { if (empty($options->$key)) { $options->$key = $value; } } $fs = get_file_storage(); // initilise options, getting files in root path $this->options = file_get_drafarea_files($options->itemid, '/'); // calculate file count $usercontext = get_context_instance(CONTEXT_USER, $USER->id); $files = $fs->get_area_files($usercontext->id, 'user', 'draft', $options->itemid, 'id', false); $filecount = count($files); $this->options->filecount = $filecount; // copying other options foreach ($options as $name=>$value) { $this->options->$name = $value; } // building file picker options $params = new stdClass(); $params->accepted_types = $options->accepted_types; $params->return_types = $options->return_types; $params->context = $options->context; $params->env = 'filemanager'; $params->disable_types = !empty($options->disable_types)?$options->disable_types:array(); $filepicker_options = initialise_filepicker($params); $this->options->filepicker = $filepicker_options; } } /** * Print the file manager * *
 * $OUTPUT->file_manager($options);
 * 
* * @param array $options associative array with file manager options * options are: * maxbytes=>-1, * maxfiles=>-1, * itemid=>0, * subdirs=>false, * client_id=>uniqid(), * acepted_types=>'*', * return_types=>FILE_INTERNAL, * context=>$PAGE->context * @return string HTML fragment */ function form_filemanager_render($options) { global $CFG, $OUTPUT, $PAGE; $fm = new form_filemanaer_x($options); //TODO: this is unnecessary here, the nested options are getting too complex static $filemanagertemplateloaded; $html = ''; $options = $fm->options; $straddfile = get_string('addfile', 'repository'); $strmakedir = get_string('makeafolder', 'moodle'); $strdownload = get_string('downloadfolder', 'repository'); $strloading = get_string('loading', 'repository'); $icon_progress = $OUTPUT->pix_icon('i/loading_small', $strloading).''; $client_id = $options->client_id; $itemid = $options->itemid; list($context, $course, $cm) = get_context_info_array($options->context->id); if (is_object($course)) { $course_maxbytes = $course->maxbytes; } else { $course_maxbytes = $CFG->maxbytes; } if ($options->maxbytes == -1 || empty($options->maxbytes)) { $options->maxbytes = $CFG->maxbytes; } if (empty($options->filecount)) { $extra = ' style="display:none"'; } else { $extra = ''; } $maxbytes = display_size(get_max_upload_file_size($CFG->maxbytes, $course_maxbytes, $options->maxbytes)); if (empty($options->maxfiles) || $options->maxfiles == -1) { $maxsize = get_string('maxfilesize', 'moodle', $maxbytes); } else { $strparam = (object)array('size' => $maxbytes, 'attachments' => $options->maxfiles); $maxsize = get_string('maxsizeandattachments', 'moodle', $strparam); } $strdndenabled = get_string('dndenabled_insentence', 'moodle').$OUTPUT->help_icon('dndenabled'); $loading = get_string('loading', 'repository'); $html .= << $icon_progress
FMHTML; if (empty($filemanagertemplateloaded)) { $filemanagertemplateloaded = true; $html .= <<