File manager - Edit - /home/u466501803/domains/qurdis.my.id/public_html/files.zip
Back
PK b<�\��� classes/converter_interface.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class for converting files between different file formats. * * @package core_files * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files; defined('MOODLE_INTERNAL') || die(); /** * Class for converting files between different file formats. * * @package docconvert_unoconv * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface converter_interface { /** * Whether the plugin is configured and requirements are met. * * Note: This function may be called frequently and caching is advisable. * * @return bool */ public static function are_requirements_met(); /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param conversion $conversion The file to be converted * @return $this */ public function start_document_conversion(conversion $conversion); /** * Poll an existing conversion for status update. * * @param conversion $conversion The file to be converted * @return $this */ public function poll_conversion_status(conversion $conversion); /** * Determine whether a conversion between the two supplied formats is achievable. * * Note: This function may be called frequently and caching is advisable. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to); /** * A list of the supported conversions. * * Note: This information is only displayed to administrators. * * @return string */ public function get_supported_conversions(); } PK b<�\ ��X� � ! classes/external/delete/draft.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * This is the external method for deleting draft files. * * @package core_files * @since Moodle 3.10 * @copyright 2020 Juan Leyva <juan@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\external\delete; defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->libdir . '/filelib.php'); use core_external\external_api; use core_external\external_function_parameters; use core_external\external_multiple_structure; use core_external\external_single_structure; use core_external\external_value; use core_external\external_warnings; use context_user; /** * This is the external method for deleting draft files. * * @copyright 2020 Juan Leyva <juan@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class draft extends external_api { /** * Describes the parameters for execute. * * @return external_function_parameters * @since Moodle 3.10 */ public static function execute_parameters(): external_function_parameters { return new external_function_parameters ( [ 'draftitemid' => new external_value(PARAM_INT, 'Item id of the draft file area'), 'files' => new external_multiple_structure( new external_single_structure( [ 'filepath' => new external_value(PARAM_PATH, 'Path to the file or directory to delete.'), 'filename' => new external_value(PARAM_FILE, 'Name of the file to delete.'), ] ), 'Files or directories to be deleted.' ), ] ); } /** * Delete the indicated files (or directories) from a user draft file area. * * @param int $draftitemid item id of the draft file area * @param array $files files to be deleted * @return array of warnings and parent paths of the files deleted * @since Moodle 3.10 */ public static function execute(int $draftitemid, array $files): array { global $CFG, $USER; require_once($CFG->dirroot . '/repository/lib.php'); $params = self::validate_parameters(self::execute_parameters(), compact('draftitemid', 'files')); [$draftitemid, $files] = array_values($params); $usercontext = context_user::instance($USER->id); self::validate_context($usercontext); $files = array_map(function($file) { return (object) $file; }, $files); $parentpaths = repository_delete_selected_files($usercontext, 'user', 'draft', $draftitemid, $files); return [ 'parentpaths' => array_keys($parentpaths), 'warnings' => [], ]; } /** * Describes the execute return value. * * @return external_single_structure * @since Moodle 3.10 */ public static function execute_returns(): external_single_structure { return new external_single_structure( [ 'parentpaths' => new external_multiple_structure( new external_value(PARAM_PATH, 'Path to parent directory of the deleted files.') ), 'warnings' => new external_warnings(), ] ); } } PK b<�\�Q % classes/external/get/unused_draft.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Generate a new draft itemid for the current user. * * @package core_files * @since Moodle 3.11 * @copyright 2020 Juan Leyva <juan@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\external\get; defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->libdir . '/filelib.php'); use core_external\external_api; use core_external\external_function_parameters; use core_external\external_single_structure; use core_external\external_value; use core_external\external_warnings; use context_user; /** * Generate a new draft itemid for the current user. * * @copyright 2020 Juan Leyva <juan@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class unused_draft extends external_api { /** * Describes the parameters for execute. * * @return external_function_parameters * @since Moodle 3.11 */ public static function execute_parameters(): external_function_parameters { return new external_function_parameters ([]); } /** * Generate a new draft itemid for the current user. * * @return array of information containing the draft item area and possible warnings. * @since Moodle 3.11 */ public static function execute(): array { global $USER; $usercontext = context_user::instance($USER->id); self::validate_context($usercontext); return [ 'component' => 'user', 'contextid' => $usercontext->id, 'userid' => $USER->id, 'filearea' => 'draft', 'itemid' => file_get_unused_draft_itemid(), 'warnings' => [], ]; } /** * Describes the execute return value. * * @return external_single_structure * @since Moodle 3.11 */ public static function execute_returns(): external_single_structure { return new external_single_structure( [ 'component' => new external_value(PARAM_COMPONENT, 'File area component.'), 'contextid' => new external_value(PARAM_INT, 'File area context.'), 'userid' => new external_value(PARAM_INT, 'File area user id.'), 'filearea' => new external_value(PARAM_ALPHA, 'File area name.'), 'itemid' => new external_value(PARAM_INT, 'File are item id.'), 'warnings' => new external_warnings(), ] ); } } PK b<�\=�s?� � ) classes/external/stored_file_exporter.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\external; use coding_exception; use core_text; use moodle_url; use renderer_base; use stdClass; use stored_file; /** * Class for exporting stored_file data. * * @package core_files * @copyright 2015 Frédéric Massart - FMCorz.net * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class stored_file_exporter extends \core\external\exporter { /** @var int Length of the shortened filename */ protected const FILENAMESHORT_LENGTH = 25; /** @var stored_file */ protected $file; public function __construct(stored_file $file, $related = array()) { $this->file = $file; $data = new stdClass(); $data->contextid = $file->get_contextid(); $data->component = $file->get_component(); $data->filearea = $file->get_filearea(); $data->itemid = $file->get_itemid(); $data->filepath = $file->get_filepath(); $data->filename = $file->get_filename(); $data->isdir = $file->is_directory(); $data->isimage = $file->is_valid_image(); $data->timemodified = $file->get_timemodified(); $data->timecreated = $file->get_timecreated(); $data->filesize = $file->get_filesize(); $data->author = $file->get_author(); $data->license = $file->get_license(); if ($related['context']->id != $data->contextid) { throw new coding_exception('Unexpected context ID received.'); } parent::__construct($data, $related); } protected static function define_related() { return array('context' => 'context'); } protected static function define_properties() { return array( 'contextid' => array( 'type' => PARAM_INT ), 'component' => array( 'type' => PARAM_COMPONENT ), 'filearea' => array( 'type' => PARAM_AREA ), 'itemid' => array( 'type' => PARAM_INT ), 'filepath' => array( 'type' => PARAM_PATH ), 'filename' => array( 'type' => PARAM_FILE ), 'isdir' => array( 'type' => PARAM_BOOL ), 'isimage' => array( 'type' => PARAM_BOOL ), 'timemodified' => array( 'type' => PARAM_INT ), 'timecreated' => array( 'type' => PARAM_INT ), 'filesize' => array( 'type' => PARAM_INT ), 'author' => array( 'type' => PARAM_TEXT ), 'license' => array( 'type' => PARAM_TEXT ) ); } protected static function define_other_properties() { return array( 'filenameshort' => array( 'type' => PARAM_RAW, ), 'filesizeformatted' => array( 'type' => PARAM_RAW ), 'icon' => array( 'type' => PARAM_RAW, ), 'timecreatedformatted' => array( 'type' => PARAM_RAW ), 'timemodifiedformatted' => array( 'type' => PARAM_RAW ), 'url' => array( 'type' => PARAM_URL ), ); } protected function get_other_values(renderer_base $output) { $filename = $this->file->get_filename(); $filenameshort = $filename; if (core_text::strlen($filename) > static::FILENAMESHORT_LENGTH) { $extension = pathinfo($filename, PATHINFO_EXTENSION); $extensionlength = core_text::strlen($extension) + 1; $filenameshort = core_text::substr($filename, 0, -$extensionlength); $filenameshort = shorten_text($filenameshort, static::FILENAMESHORT_LENGTH - $extensionlength, true, '..') . ".{$extension}"; } $icon = $this->file->is_directory() ? file_folder_icon() : file_file_icon($this->file); $url = moodle_url::make_pluginfile_url( $this->file->get_contextid(), $this->file->get_component(), $this->file->get_filearea(), $this->file->get_itemid(), $this->file->get_filepath(), $this->file->get_filename(), true ); return array( 'filenameshort' => $filenameshort, 'filesizeformatted' => display_size((int) $this->file->get_filesize()), 'icon' => $icon, 'url' => $url->out(false), 'timecreatedformatted' => userdate($this->file->get_timecreated()), 'timemodifiedformatted' => userdate($this->file->get_timemodified()), ); } } PK b<�\�c�� � $ classes/hook/before_file_created.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\hook; use core\exception\coding_exception; use core\attribute; /** * A hook which is fired before a file is created in the file storage API. * * @package core_files * @copyright 2024 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ #[attribute\label('Allows subscribers to modify file content before it is stored in the file pool')] #[attribute\tags('file')] #[attribute\hook\replaces_callbacks('before_file_created')] final class before_file_created { use \core\hook\stoppable_trait; /** @var bool Whether the content has been updated at all */ public bool $contentupdated = false; /** * Constructor. * * @param \stdClass|null $filerecord * @param string|null $filepath The path to the file on disk * @param string|null $filecontent The content of the file */ public function __construct( /** @var \stdClass The file record */ protected ?\stdClass $filerecord = null, /** @var string|null $filepath The source file on disk */ protected ?string $filepath = null, /** @var string|null $filecontent The content of the file if it is not stored on disk */ protected ?string $filecontent = null, ) { if ($filepath === null && $filecontent === null) { throw new \InvalidArgumentException('Either $filepath or $filecontent must be set'); } if ($filepath !== null && $filecontent !== null) { throw new \InvalidArgumentException('Only one of $filepath or $filecontent can be set'); } } /** * Whether the file path was specified. * * @return bool */ public function has_filepath(): bool { return $this->filepath !== null; } /** * Whether the file content was specified. * * @return bool */ public function has_filecontent(): bool { return $this->filecontent !== null; } /** * Get the file path to the file that will be stored. * * @return string */ public function get_filepath(): ?string { return $this->filepath; } /** * Get the file content that will be stored. * * @return string */ public function get_filecontent(): ?string { return $this->filecontent; } /** * Get the file record. * * @return \stdClass|null */ public function get_filerecord(): ?\stdClass { return $this->filerecord; } /** * Update the file path to a new value. * * @param string $filepath */ public function update_filepath(string $filepath): void { if ($this->filepath === null) { throw new coding_exception('Cannot update file path when the file path is not set'); } if ($filepath !== $this->filepath) { $this->contentupdated = true; $this->filepath = $filepath; } } /** * Update the file content to a new value. * * @param string $filecontent */ public function update_filecontent(string $filecontent): void { if ($this->filecontent === null) { throw new coding_exception('Cannot update file content when the file content is not set'); } if ($filecontent !== $this->filecontent) { $this->contentupdated = true; $this->filecontent = $filecontent; } } /** * Whether the file path or file content has been changed. * * @return bool */ public function has_changed(): bool { return $this->contentupdated; } /** * Process legacy callbacks. */ public function process_legacy_callbacks(): void { if ($pluginsfunction = get_plugins_with_function(function: 'before_file_created', migratedtohook: true)) { foreach ($pluginsfunction as $plugintype => $plugins) { foreach ($plugins as $pluginfunction) { $pluginfunction($this->filerecord); } } } } } PK b<�\����Q Q # classes/hook/after_file_created.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\hook; use core\attribute; use core\hook\stoppable_trait; /** * A hook which is fired after a file is created in the file storage API. * * @package core * @copyright 2024 Huong Nguyen <huongnv13@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ #[attribute\label('Allows subscribers to inspect a file after it is created in the file pool')] #[attribute\tags('file')] #[attribute\hook\replaces_callbacks('after_file_created')] final class after_file_created { use stoppable_trait; /** * Hook to allow subscribers to modify file after it is created. * * @param \stored_file $storedfile The stored file. * @param \stdClass $filerecord The file record. */ public function __construct( /** @var \stored_file The stored file. */ public readonly \stored_file $storedfile, /** @var \stdClass The file record. */ public readonly \stdClass $filerecord, ) { } /** * Process legacy callbacks. */ public function process_legacy_callbacks(): void { if ($pluginsfunction = get_plugins_with_function(function: 'after_file_created', migratedtohook: true)) { foreach ($pluginsfunction as $plugintype => $plugins) { foreach ($plugins as $pluginfunction) { $pluginfunction($this->filerecord); } } } } } PK b<�\�0�<V V classes/privacy/provider.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Data provider. * * @package core_files * @copyright 2018 Frédéric Massart * @author Frédéric Massart <fred@branchup.tech> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\privacy; defined('MOODLE_INTERNAL') || die(); use core_privacy\local\metadata\collection; use core_privacy\local\request\contextlist; use core_privacy\local\request\approved_contextlist; use core_privacy\local\request\userlist; use core_privacy\local\request\approved_userlist; /** * Data provider class. * * This only describes the files table, all components must handle the file exporting * and deletion themselves. * * @package core_files * @copyright 2018 Frédéric Massart * @author Frédéric Massart <fred@branchup.tech> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements \core_privacy\local\metadata\provider, \core_privacy\local\request\subsystem\plugin_provider, \core_privacy\local\request\core_userlist_provider, // We store a userkey for token-based file access. \core_privacy\local\request\subsystem\provider, \core_privacy\local\request\shared_userlist_provider { /** * Returns metadata. * * @param collection $collection The initialised collection to add items to. * @return collection A listing of user data stored through this system. */ public static function get_metadata(collection $collection): collection { $collection->add_database_table('files', [ 'contenthash' => 'privacy:metadata:files:contenthash', 'filepath' => 'privacy:metadata:files:filepath', 'filename' => 'privacy:metadata:files:filename', 'userid' => 'privacy:metadata:files:userid', 'filesize' => 'privacy:metadata:files:filesize', 'mimetype' => 'privacy:metadata:files:mimetype', 'source' => 'privacy:metadata:files:source', 'author' => 'privacy:metadata:files:author', 'license' => 'privacy:metadata:files:license', 'timecreated' => 'privacy:metadata:files:timecreated', 'timemodified' => 'privacy:metadata:files:timemodified', ], 'privacy:metadata:files'); // Regarding this block, we are unable to export or purge this data, as // it would damage the file conversion data across the whole site. $collection->add_database_table('file_conversion', [ 'usermodified' => 'privacy:metadata:file_conversion:usermodified', ], 'privacy:metadata:file_conversions'); $collection->add_subsystem_link('core_userkey', [], 'privacy:metadata:core_userkey'); return $collection; } /** * Get the list of contexts that contain user information for the specified user. * * This is currently just the user context. * * @param int $userid The user to search. * @return contextlist $contextlist The contextlist containing the list of contexts used in this plugin. */ public static function get_contexts_for_userid(int $userid): contextlist { $sql = "SELECT ctx.id FROM {user_private_key} k JOIN {user} u ON k.userid = u.id JOIN {context} ctx ON ctx.instanceid = u.id AND ctx.contextlevel = :contextlevel WHERE k.userid = :userid AND k.script = :script"; $params = [ 'userid' => $userid, 'contextlevel' => CONTEXT_USER, 'script' => 'core_files', ]; $contextlist = new contextlist(); $contextlist->add_from_sql($sql, $params); return $contextlist; } /** * Get the list of users within a specific context. * * @param userlist $userlist The userlist containing the list of users who have data in this context/plugin combination. */ public static function get_users_in_context(userlist $userlist) { $context = $userlist->get_context(); if (!$context instanceof \context_user) { return; } \core_userkey\privacy\provider::get_user_contexts_with_script($userlist, $context, 'core_files'); } /** * Export all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts to export information for. */ public static function export_user_data(approved_contextlist $contextlist) { // If the user has data, then only the CONTEXT_USER should be present so get the first context. $contexts = $contextlist->get_contexts(); if (count($contexts) == 0) { return; } // Sanity check that context is at the user context level, then get the userid. $context = reset($contexts); if ($context->contextlevel !== CONTEXT_USER) { return; } // Export associated userkeys. $subcontext = [ get_string('files'), ]; \core_userkey\privacy\provider::export_userkeys($context, $subcontext, 'core_files'); } /** * Delete all use data which matches the specified deletion_criteria. * * @param context $context A user context. */ public static function delete_data_for_all_users_in_context(\context $context) { // Sanity check that context is at the user context level, then get the userid. if ($context->contextlevel !== CONTEXT_USER) { return; } // Delete all the userkeys. \core_userkey\privacy\provider::delete_userkeys('core_files', $context->instanceid); } /** * Delete multiple users within a single context. * * @param approved_userlist $userlist The approved context and user information to delete information for. */ public static function delete_data_for_users(approved_userlist $userlist) { $context = $userlist->get_context(); if ($context instanceof \context_user) { \core_userkey\privacy\provider::delete_userkeys('core_files', $context->instanceid); } } /** * Delete all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts and user information to delete information for. */ public static function delete_data_for_user(approved_contextlist $contextlist) { // If the user has data, then only the user context should be present so get the first context. $contexts = $contextlist->get_contexts(); if (count($contexts) == 0) { return; } // Sanity check that context is at the user context level, then get the userid. $context = reset($contexts); if ($context->contextlevel !== CONTEXT_USER) { return; } // Delete all the userkeys for core_files.. \core_userkey\privacy\provider::delete_userkeys('core_files', $context->instanceid); } } PK b<�\R�l� � classes/archive_writer.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Abstraction of general file archives. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files; use core_files\local\archive_writer\file_writer_interface as file_writer_interface; use core_files\local\archive_writer\stream_writer_interface as stream_writer_interface; /** * Each file archive type must extend this class. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ abstract class archive_writer { /** * The zip writer class. */ public const ZIP_WRITER = 'zip_writer'; /** * Returns the stream writer. * * @param string $filename * @param string $type * @return stream_writer_interface */ public static function get_stream_writer(string $filename, string $type): stream_writer_interface { $classname = self::get_classname_for_type($type); if (!is_a($classname, stream_writer_interface::class, true)) { throw new \InvalidArgumentException("{$type} does not support streaming"); } return $classname::stream_instance($filename); } /** * Returns the file writer. * * @param string $filepath * @param string $type * @return file_writer_interface */ public static function get_file_writer(string $filepath, string $type): file_writer_interface { $classname = self::get_classname_for_type($type); if (!is_a($classname, file_writer_interface::class, true)) { throw new \InvalidArgumentException("{$type} does not support writing to files"); } return $classname::file_instance($filepath); } /** * Sanitise the file path, removing any unsuitable characters. * * @param string $filepath * @return string */ public function sanitise_filepath(string $filepath): string { return clean_param($filepath, PARAM_PATH); } /** * Returns the class name for the type that was provided in get_file_writer(). * * @param string $type * @return string */ protected static function get_classname_for_type(string $type): string { return "core_files\local\archive_writer\\" . $type; } /** * The archive_writer Constructor. */ protected function __construct() { } /** * Adds a file from a file path. * * @param string $name The path of file in archive (including directory). * @param string $path The path to file on disk (note: paths should be encoded using * UNIX-style forward slashes -- e.g '/path/to/some/file'). */ abstract public function add_file_from_filepath(string $name, string $path): void; /** * Adds a file from a string. * * @param string $name The path of file in archive (including directory). * @param string $data The contents of file */ abstract public function add_file_from_string(string $name, string $data): void; /** * Adds a file from a stream. * * @param string $name The path of file in archive (including directory). * @param resource $stream The contents of file as a stream resource */ abstract public function add_file_from_stream(string $name, $stream): void; /** * Adds a stored_file to archive. * * @param string $name The path of file in archive (including directory). * @param \stored_file $file */ abstract public function add_file_from_stored_file(string $name, \stored_file $file): void; /** * Finish writing the zip footer. */ abstract public function finish(): void; } PK b<�\���7! 7! classes/converter.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class for converting files between different file formats using unoconv. * * @package core_files * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files; defined('MOODLE_INTERNAL') || die(); use stored_file; /** * Class for converting files between different formats using unoconv. * * @package core_files * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class converter { /** * Get a list of enabled plugins and classes. * * @return array List of enabled plugins */ protected function get_enabled_plugins() { $plugins = \core\plugininfo\fileconverter::get_enabled_plugins(); $pluginclasses = []; foreach ($plugins as $plugin) { $pluginclasses[$plugin] = \core\plugininfo\fileconverter::get_classname($plugin); } return $pluginclasses; } /** * Return the file_storage API. * * This allows for mocking of the file_storage API. * * @return \file_storage */ protected function get_file_storage() { return get_file_storage(); } /** * Start the conversion for a stored_file into a new format. * * @param stored_file $file The file to convert * @param string $format The desired target file format (file extension) * @param boolean $forcerefresh If true, the file will be converted every time (not cached). * @return conversion conversion object */ public function start_conversion(stored_file $file, $format, $forcerefresh = false) { $conversions = conversion::get_conversions_for_file($file, $format); if ($forcerefresh || count($conversions) > 1) { while ($conversion = array_shift($conversions)) { if ($conversion->get('id')) { $conversion->delete(); } } } if (empty($conversions)) { $conversion = new conversion(0, (object) [ 'sourcefileid' => $file->get_id(), 'targetformat' => $format, ]); $conversion->create(); } else { $conversion = array_shift($conversions); } if ($conversion->get('status') !== conversion::STATUS_COMPLETE) { $this->poll_conversion($conversion); } return $conversion; } /** * Poll for updates to the supplied conversion. * * @param conversion $conversion The conversion in progress * @return $this */ public function poll_conversion(conversion $conversion) { $format = $conversion->get('targetformat'); $file = $conversion->get_sourcefile(); if ($conversion->get('status') == conversion::STATUS_IN_PROGRESS) { // The current conversion is in progress. // Check for updates. if ($instance = $conversion->get_converter_instance()) { $instance->poll_conversion_status($conversion); } else { // Unable to fetch the converter instance. // Reset the status back to PENDING so that it may be picked up again. $conversion->set('status', conversion::STATUS_PENDING); } $conversion->update(); } // Refresh the status. $status = $conversion->get('status'); if ($status === conversion::STATUS_PENDING || $status === conversion::STATUS_FAILED) { // The current status is either pending or failed. // Attempt to pick up a new converter and convert the document. $from = pathinfo($file->get_filename(), PATHINFO_EXTENSION); $converters = $this->get_document_converter_classes($from, $format); $currentconverter = $this->get_next_converter($converters, $conversion->get('converter')); if (!$currentconverter) { // No more converters available. $conversion->set('status', conversion::STATUS_FAILED); $conversion->update(); return $this; } do { $conversion ->set('converter', $currentconverter) ->set('status', conversion::STATUS_IN_PROGRESS) ->update(); $instance = $conversion->get_converter_instance(); $instance->start_document_conversion($conversion); $failed = $conversion->get('status') === conversion::STATUS_FAILED; $currentconverter = $this->get_next_converter($converters, $currentconverter); } while ($failed && $currentconverter); $conversion->update(); } return $this; } /** * Fetch the next converter to try. * * @param array $converters The list of converters to try * @param string|null $currentconverter The converter currently in use * @return string|false Name of next converter if present */ protected function get_next_converter($converters, $currentconverter = null) { if ($currentconverter) { $keys = moodle_array_keys_filter($converters, $currentconverter); $key = $keys[0]; if (isset($converters[$key + 1])) { return $converters[$key + 1]; } else { return false; } } else if (!empty($converters)) { return $converters[0]; } else { return false; } } /** * Fetch the class for the preferred document converter. * * @param string $from The source target file (file extension) * @param string $to The desired target file format (file extension) * @return string The class for document conversion */ protected function get_document_converter_classes($from, $to) { $classes = []; $converters = $this->get_enabled_plugins(); foreach ($converters as $plugin => $classname) { if (!class_exists($classname)) { continue; } if (!$classname::are_requirements_met()) { continue; } if ($classname::supports($from, $to)) { $classes[] = $classname; } } return $classes; } /** * Check whether document conversion is supported for this file and target format. * * @param stored_file $file The file to convert * @param string $to The desired target file format (file extension) * @return bool Whether the target type can be converted */ public function can_convert_storedfile_to(stored_file $file, $to) { if ($file->is_directory()) { // Directories cannot be converted. return false; } if (!$file->get_filesize()) { // Empty files cannot be converted. return false; } $from = pathinfo($file->get_filename(), PATHINFO_EXTENSION); if (!$from) { // No file extension could be found. Unable to determine converter. return false; } return $this->can_convert_format_to($from, $to); } /** * Check whether document conversion is supported for this file and target format. * * @param string $from The source target file (file extension) * @param string $to The desired target file format (file extension) * @return bool Whether the target type can be converted */ public function can_convert_format_to($from, $to) { return !empty($this->get_document_converter_classes($from, $to)); } } PK b<�\螯P0 0 classes/conversion.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Classes for converting files between different file formats. * * @package core_files * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files; defined('MOODLE_INTERNAL') || die(); use stored_file; /** * Class representing a conversion currently in progress. * * @package core_files * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class conversion extends \core\persistent { /** * Status value representing a conversion waiting to start. */ const STATUS_PENDING = 0; /** * Status value representing a conversion in progress. */ const STATUS_IN_PROGRESS = 1; /** * Status value representing a successful conversion. */ const STATUS_COMPLETE = 2; /** * Status value representing a failed conversion. */ const STATUS_FAILED = -1; /** * Table name for this persistent. */ const TABLE = 'file_conversion'; /** * Define properties. * * @return array */ protected static function define_properties() { return array( 'sourcefileid' => [ 'type' => PARAM_INT, ], 'targetformat' => [ 'type' => PARAM_ALPHANUMEXT, ], 'status' => [ 'type' => PARAM_INT, 'choices' => [ self::STATUS_PENDING, self::STATUS_IN_PROGRESS, self::STATUS_COMPLETE, self::STATUS_FAILED, ], 'default' => self::STATUS_PENDING, ], 'statusmessage' => [ 'type' => PARAM_RAW, 'null' => NULL_ALLOWED, 'default' => null, ], 'converter' => [ 'type' => PARAM_RAW, 'null' => NULL_ALLOWED, 'default' => null, ], 'destfileid' => [ 'type' => PARAM_INT, 'null' => NULL_ALLOWED, 'default' => null, ], 'data' => [ 'type' => PARAM_RAW, 'null' => NULL_ALLOWED, 'default' => null, ], ); } /** * Fetch all conversions relating to the specified file. * * Only conversions which have a valid file are returned. * * @param stored_file $file The source file being converted * @param string $format The targetforamt to filter to * @return conversion[] */ public static function get_conversions_for_file(stored_file $file, $format) { global $DB; $instances = []; // Conversion records are intended for tracking a conversion in progress or recently completed. // The record is removed periodically, but the destination file is not. // We need to fetch all conversion records which match the source file and target, and also all source and // destination files which do not have a conversion record. $sqlfields = self::get_sql_fields('c', 'conversion'); // Fetch actual conversions which relate to the specified source file, and have a matching conversion record, // and either have a valid destination file which still exists, or do not have a destination file at all. $sql = "SELECT {$sqlfields} FROM {" . self::TABLE . "} c JOIN {files} conversionsourcefile ON conversionsourcefile.id = c.sourcefileid LEFT JOIN {files} conversiondestfile ON conversiondestfile.id = c.destfileid WHERE conversionsourcefile.contenthash = :ccontenthash AND c.targetformat = :cformat AND (c.destfileid IS NULL OR conversiondestfile.id IS NOT NULL)"; // Fetch a empty conversion record for each source/destination combination that we find to match where the // destination file is in the correct filearea/filepath/filename combination to meet the requirements. // This ensures that existing conversions are used where possible, even if there is no 'conversion' record for // them. $sql .= " UNION ALL SELECT NULL AS conversionid, orphanedsourcefile.id AS conversionsourcefileid, :oformat AS conversiontargetformat, 2 AS conversionstatus, NULL AS conversionstatusmessage, NULL AS conversionconverter, orphaneddestfile.id AS conversiondestfileid, NULL AS conversiondata, 0 AS conversiontimecreated, 0 AS conversiontimemodified, 0 AS conversionusermodified FROM {files} orphanedsourcefile INNER JOIN {files} orphaneddestfile ON ( orphaneddestfile.filename = orphanedsourcefile.contenthash AND orphaneddestfile.component = 'core' AND orphaneddestfile.filearea = 'documentconversion' AND orphaneddestfile.filepath = :ofilepath ) LEFT JOIN {" . self::TABLE . "} orphanedconversion ON orphanedconversion.destfileid = orphaneddestfile.id WHERE orphanedconversion.id IS NULL AND orphanedsourcefile.id = :osourcefileid "; $records = $DB->get_records_sql($sql, [ 'ccontenthash' => $file->get_contenthash(), 'osourcefileid' => $file->get_id(), 'ofilepath' => "/{$format}/", 'cformat' => $format, 'oformat' => $format, ]); foreach ($records as $record) { $data = self::extract_record($record, 'conversion'); $newrecord = new static(0, $data); $instances[] = $newrecord; } return $instances; } /** * Remove all old conversion records. */ public static function remove_old_conversion_records() { global $DB; $DB->delete_records_select(self::TABLE, 'timemodified <= :weekagosecs', [ 'weekagosecs' => time() - WEEKSECS, ]); } /** * Remove orphan records. * * Records are considered orphans when their source file not longer exists. * In this scenario we do not want to keep the converted file any longer, * in particular to be compliant with privacy laws. */ public static function remove_orphan_records() { global $DB; $sql = " SELECT c.id FROM {" . self::TABLE . "} c LEFT JOIN {files} f ON f.id = c.sourcefileid WHERE f.id IS NULL"; $ids = $DB->get_fieldset_sql($sql, []); if (empty($ids)) { return; } list($insql, $inparams) = $DB->get_in_or_equal($ids, SQL_PARAMS_NAMED); $DB->delete_records_select(self::TABLE, "id $insql", $inparams); } /** * Set the source file id for the conversion. * * @param stored_file $file The file to convert * @return $this */ public function set_sourcefile(stored_file $file) { $this->raw_set('sourcefileid', $file->get_id()); return $this; } /** * Fetch the source file. * * @return stored_file|false The source file */ public function get_sourcefile() { $fs = get_file_storage(); return $fs->get_file_by_id($this->get('sourcefileid')); } /** * Set the destination file for this conversion. * * @param string $filepath The path to the converted file * @return $this */ public function store_destfile_from_path($filepath) { if ($record = $this->get_file_record()) { $fs = get_file_storage(); $existing = $fs->get_file( $record['contextid'], $record['component'], $record['filearea'], $record['itemid'], $record['filepath'], $record['filename'] ); if ($existing) { $existing->delete(); } $file = $fs->create_file_from_pathname($record, $filepath); $this->raw_set('destfileid', $file->get_id()); } return $this; } /** * Set the destination file for this conversion. * * @param string $content The content of the converted file * @return $this */ public function store_destfile_from_string($content) { if ($record = $this->get_file_record()) { $fs = get_file_storage(); $existing = $fs->get_file( $record['contextid'], $record['component'], $record['filearea'], $record['itemid'], $record['filepath'], $record['filename'] ); if ($existing) { $existing->delete(); } $file = $fs->create_file_from_string($record, $content); $this->raw_set('destfileid', $file->get_id()); } return $this; } /** * Get the destination file. * * @return stored_file|bool Destination file */ public function get_destfile() { $fs = get_file_storage(); return $fs->get_file_by_id($this->get('destfileid')); } /** * Helper to ensure that the returned status is always an int. * * @return int status */ protected function get_status() { return (int) $this->raw_get('status'); } /** * Get an instance of the current converter. * * @return converter_interface|false current converter instance */ public function get_converter_instance() { $currentconverter = $this->get('converter'); if ($currentconverter && class_exists($currentconverter)) { return new $currentconverter(); } else { return false; } } /** * Transform data into a storable format. * * @param \stdClass $data The data to be stored * @return $this */ protected function set_data($data) { $this->raw_set('data', json_encode($data)); return $this; } /** * Transform data into a storable format. * * @return \stdClass The stored data */ protected function get_data() { $data = $this->raw_get('data'); if (!empty($data)) { return json_decode($data); } return (object) []; } /** * Return the file record base for use in the files table. * * @return array|bool */ protected function get_file_record() { $file = $this->get_sourcefile(); if (!$file) { // If the source file was removed before we completed, we must return early. return false; } return [ 'contextid' => \context_system::instance()->id, 'component' => 'core', 'filearea' => 'documentconversion', 'itemid' => 0, 'filepath' => "/" . $this->get('targetformat') . "/", 'filename' => $file->get_contenthash(), ]; } } PK b<�\ ӇQ� � * classes/reportbuilder/datasource/files.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. declare(strict_types=1); namespace core_files\reportbuilder\datasource; use core\reportbuilder\local\entities\context; use core_files\reportbuilder\local\entities\file; use core_reportbuilder\datasource; use core_reportbuilder\local\entities\user; use core_reportbuilder\local\filters\boolean_select; /** * Files datasource * * @package core_files * @copyright 2022 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class files extends datasource { /** * Return user friendly name of the report source * * @return string */ public static function get_name(): string { return get_string('files'); } /** * Initialise report */ protected function initialise(): void { $fileentity = new file(); $filesalias = $fileentity->get_table_alias('files'); $this->set_main_table('files', $filesalias); $this->add_entity($fileentity); // Join the context entity. $contextentity = new context(); $contextalias = $contextentity->get_table_alias('context'); $this->add_entity($contextentity ->add_join("LEFT JOIN {context} {$contextalias} ON {$contextalias}.id = {$filesalias}.contextid") ); // Join the user entity. $userentity = new user(); $useralias = $userentity->get_table_alias('user'); $this->add_entity($userentity ->add_join("LEFT JOIN {user} {$useralias} ON {$useralias}.id = {$filesalias}.userid") ); // Add report elements from each of the entities we added to the report. $this->add_all_from_entities(); } /** * Return the columns that will be added to the report upon creation * * @return string[] */ public function get_default_columns(): array { return [ 'context:name', 'user:fullname', 'file:name', 'file:type', 'file:size', 'file:timecreated', ]; } /** * Return the column sorting that will be added to the report upon creation * * @return int[] */ public function get_default_column_sorting(): array { return [ 'context:name' => SORT_ASC, 'file:timecreated' => SORT_ASC, ]; } /** * Return the filters that will be added to the report upon creation * * @return string[] */ public function get_default_filters(): array { return [ 'file:size', 'file:timecreated', ]; } /** * Return the conditions that will be added to the report upon creation * * @return string[] */ public function get_default_conditions(): array { return ['file:directory']; } /** * Return the condition values that will be set for the report upon creation * * @return array */ public function get_default_condition_values(): array { return ['file:directory_operator' => boolean_select::NOT_CHECKED]; } } PK b<�\]y���> �> - classes/reportbuilder/local/entities/file.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. declare(strict_types=1); namespace core_files\reportbuilder\local\entities; use context; use context_helper; use core_collator; use core_filetypes; use html_writer; use lang_string; use license_manager; use stdClass; use core_reportbuilder\local\entities\base; use core_reportbuilder\local\helpers\format; use core_reportbuilder\local\filters\{boolean_select, date, filesize, select, text}; use core_reportbuilder\local\report\{column, filter}; /** * File entity * * @package core_files * @copyright 2022 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class file extends base { /** * Database tables that this entity uses * * @return string[] */ protected function get_default_tables(): array { return [ 'files', 'context', ]; } /** * The default title for this entity * * @return lang_string */ protected function get_default_entity_title(): lang_string { return new lang_string('file'); } /** * Initialise the entity * * @return base */ public function initialise(): base { $columns = $this->get_all_columns(); foreach ($columns as $column) { $this->add_column($column); } // All the filters defined by the entity can also be used as conditions. $filters = $this->get_all_filters(); foreach ($filters as $filter) { $this ->add_filter($filter) ->add_condition($filter); } return $this; } /** * Returns list of all available columns * * @return column[] */ protected function get_all_columns(): array { $filesalias = $this->get_table_alias('files'); $contextalias = $this->get_table_alias('context'); // Name. $columns[] = (new column( 'name', new lang_string('filename', 'core_repository'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.filename") ->set_is_sortable(true); // Size. $columns[] = (new column( 'size', new lang_string('size'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_INTEGER) ->add_field("{$filesalias}.filesize") ->add_field("CASE WHEN {$filesalias}.filename = '.' THEN 1 ELSE 0 END", 'directory') ->set_is_sortable(true) ->add_callback(static function($filesize, stdClass $fileinfo): string { // Absent file size and/or directory should not return output. if ($fileinfo->filesize === null || $fileinfo->directory) { return ''; } return display_size($fileinfo->filesize); }); // Path. $columns[] = (new column( 'path', new lang_string('path'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.filepath") ->set_is_sortable(true); // Type. $columns[] = (new column( 'type', new lang_string('type', 'core_repository'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.mimetype") ->add_field("CASE WHEN {$filesalias}.filename = '.' THEN 1 ELSE 0 END", 'directory') ->set_is_sortable(true) ->add_callback(static function($mimetype, stdClass $fileinfo): string { global $CFG; require_once("{$CFG->libdir}/filelib.php"); // Absent mime type and/or directory has pre-determined output. if ($fileinfo->mimetype === null && !$fileinfo->directory) { return ''; } else if ($fileinfo->directory) { return get_string('directory'); } return get_mimetype_description($fileinfo->mimetype); }); // Icon. $columns[] = (new column( 'icon', new lang_string('icon'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.mimetype") ->add_field("CASE WHEN {$filesalias}.filename = '.' THEN 1 ELSE 0 END", 'directory') ->set_disabled_aggregation_all() ->add_callback(static function($mimetype, stdClass $fileinfo): string { global $CFG, $OUTPUT; require_once("{$CFG->libdir}/filelib.php"); if ($fileinfo->mimetype === null && !$fileinfo->directory) { return ''; } if ($fileinfo->directory) { $icon = file_folder_icon(); $description = get_string('directory'); } else { $icon = file_file_icon($fileinfo); $description = get_mimetype_description($fileinfo->mimetype); } return $OUTPUT->pix_icon($icon, $description, 'moodle', ['class' => 'iconsize-medium']); }); // Author. $columns[] = (new column( 'author', new lang_string('author', 'core_repository'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.author") ->set_is_sortable(true); // License. $columns[] = (new column( 'license', new lang_string('license', 'core_repository'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.license") ->set_is_sortable(true) ->add_callback(static function(?string $license): string { global $CFG; require_once("{$CFG->libdir}/licenselib.php"); $licenses = license_manager::get_licenses(); if ($license === null || !array_key_exists($license, $licenses)) { return ''; } return $licenses[$license]->fullname; }); // Context. $columns[] = (new column( 'context', new lang_string('context'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_join("LEFT JOIN {context} {$contextalias} ON {$contextalias}.id = {$filesalias}.contextid") ->add_fields("{$filesalias}.contextid, " . context_helper::get_preload_record_columns_sql($contextalias)) // Sorting may not order alphabetically, but will at least group contexts together. ->set_is_sortable(true) ->set_is_deprecated('See \'context:name\' for replacement') ->add_callback(static function($contextid, stdClass $context): string { if ($contextid === null) { return ''; } context_helper::preload_from_record($context); return context::instance_by_id($contextid)->get_context_name(); }); // Context link. $columns[] = (new column( 'contexturl', new lang_string('contexturl'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_join("LEFT JOIN {context} {$contextalias} ON {$contextalias}.id = {$filesalias}.contextid") ->add_fields("{$filesalias}.contextid, " . context_helper::get_preload_record_columns_sql($contextalias)) // Sorting may not order alphabetically, but will at least group contexts together. ->set_is_sortable(true) ->set_is_deprecated('See \'context:link\' for replacement') ->add_callback(static function($contextid, stdClass $context): string { if ($contextid === null) { return ''; } context_helper::preload_from_record($context); $context = context::instance_by_id($contextid); return html_writer::link($context->get_url(), $context->get_context_name()); }); // Content hash. $columns[] = (new column( 'contenthash', new lang_string('contenthash', 'core_files'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_field("{$filesalias}.contenthash") ->set_is_sortable(true); // Component. $columns[] = (new column( 'component', new lang_string('plugin'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_fields("{$filesalias}.component") ->set_is_sortable(true); // Area. $columns[] = (new column( 'area', new lang_string('pluginarea'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TEXT) ->add_fields("{$filesalias}.filearea") ->set_is_sortable(true); // Item ID. $columns[] = (new column( 'itemid', new lang_string('pluginitemid'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->add_fields("{$filesalias}.itemid") ->set_is_sortable(true); // Time created. $columns[] = (new column( 'timecreated', new lang_string('timecreated', 'core_reportbuilder'), $this->get_entity_name() )) ->add_joins($this->get_joins()) ->set_type(column::TYPE_TIMESTAMP) ->add_field("{$filesalias}.timecreated") ->add_callback([format::class, 'userdate']) ->set_is_sortable(true); return $columns; } /** * Return list of all available filters * * @return filter[] */ protected function get_all_filters(): array { $filesalias = $this->get_table_alias('files'); // Directory. $filters[] = (new filter( boolean_select::class, 'directory', new lang_string('directory'), $this->get_entity_name(), "CASE WHEN {$filesalias}.filename = '.' THEN 1 ELSE 0 END" )) ->add_joins($this->get_joins()); // Draft. $filters[] = (new filter( boolean_select::class, 'draft', new lang_string('areauserdraft', 'core_repository'), $this->get_entity_name(), "CASE WHEN {$filesalias}.component = 'user' AND {$filesalias}.filearea = 'draft' THEN 1 ELSE 0 END" )) ->add_joins($this->get_joins()); // Name. $filters[] = (new filter( text::class, 'name', new lang_string('filename', 'core_repository'), $this->get_entity_name(), "{$filesalias}.filename" )) ->add_joins($this->get_joins()); // Size. $filters[] = (new filter( filesize::class, 'size', new lang_string('size'), $this->get_entity_name(), "{$filesalias}.filesize" )) ->add_joins($this->get_joins()); // Type. $filters[] = (new filter( select::class, 'type', new lang_string('type', 'core_repository'), $this->get_entity_name(), "{$filesalias}.mimetype" )) ->add_joins($this->get_joins()) ->set_options_callback(static function(): array { $mimetypenames = array_column(core_filetypes::get_types(), 'type'); // Convert the names into a map of name => description. $mimetypes = array_combine($mimetypenames, array_map(static function(string $mimetype): string { return get_mimetype_description($mimetype); }, $mimetypenames)); core_collator::asort($mimetypes); return $mimetypes; }); // Author. $filters[] = (new filter( text::class, 'author', new lang_string('author', 'core_repository'), $this->get_entity_name(), "{$filesalias}.author" )) ->add_joins($this->get_joins()); // License (consider null = 'unknown/license not specified' for filtering purposes). $filters[] = (new filter( select::class, 'license', new lang_string('license', 'core_repository'), $this->get_entity_name(), "COALESCE({$filesalias}.license, 'unknown')" )) ->add_joins($this->get_joins()) ->set_options_callback(static function(): array { global $CFG; require_once("{$CFG->libdir}/licenselib.php"); $licenses = license_manager::get_licenses(); return array_map(static function(stdClass $license): string { return $license->fullname; }, $licenses); }); // Content hash. $filters[] = (new filter( text::class, 'contenthash', new lang_string('contenthash', 'core_files'), $this->get_entity_name(), "{$filesalias}.contenthash" )) ->add_joins($this->get_joins()); // Component. $filters[] = (new filter( text::class, 'component', new lang_string('plugin'), $this->get_entity_name(), "{$filesalias}.component" )) ->add_joins($this->get_joins()); // Area. $filters[] = (new filter( text::class, 'area', new lang_string('pluginarea'), $this->get_entity_name(), "{$filesalias}.filearea" )) ->add_joins($this->get_joins()); // Time created. $filters[] = (new filter( date::class, 'timecreated', new lang_string('timecreated', 'core_reportbuilder'), $this->get_entity_name(), "{$filesalias}.timecreated" )) ->add_joins($this->get_joins()) ->set_limited_operators([ date::DATE_ANY, date::DATE_RANGE, date::DATE_LAST, date::DATE_CURRENT, ]); return $filters; } } PK b<�\�� ��@ �@ 1 classes/redactor/services/exifremover_service.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor\services; use admin_setting_configcheckbox; use admin_setting_configexecutable; use admin_setting_configselect; use admin_setting_configtextarea; use admin_setting_heading; use core\exception\moodle_exception; use core\output\html_writer; /** * Remove EXIF data from supported image files using PHP GD, or ExifTool if it is configured. * * The PHP GD stripping has minimal configuration and removes all EXIF data. * More stripping is made available when using ExifTool. * * @package core_files * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class exifremover_service extends service implements file_redactor_service_interface { /** @var array REMOVE_TAGS Tags to remove and their corresponding values. */ const REMOVE_TAGS = [ "gps" => '"-gps*="', "all" => "-all=", ]; /** @var string DEFAULT_REMOVE_TAGS Default tags that will be removed. */ const DEFAULT_REMOVE_TAGS = "gps"; /** @var string DEFAULT_MIMETYPE Default MIME type for images. */ const DEFAULT_MIMETYPE = "image/jpeg"; /** * PRESERVE_TAGS Tag to preserve when stripping EXIF data. * * To add a new tag, add the tag with space as a separator. * For example, if the model tag is preserved, then the value is "-Orientation -Model". * * @var string */ const PRESERVE_TAGS = "-Orientation"; /** @var int DEFAULT_JPEG_COMPRESSION Default JPEG compression quality. */ const DEFAULT_JPEG_COMPRESSION = 90; /** @var bool $useexiftool Flag indicating whether to use ExifTool. */ private bool $useexiftool = false; /** @var int Normal orientation (no rotation). */ private const TOP_LEFT = 1; /** @var int Mirrored horizontally. */ private const TOP_RIGHT = 2; /** @var int Rotated 180° (upside down). */ private const BOTTOM_RIGHT = 3; /** @var int Mirrored vertically. */ private const BOTTOM_LEFT = 4; /** @var int Mirrored horizontally and rotated 270° clockwise. */ private const LEFT_TOP = 5; /** @var int Rotated 90° clockwise. */ private const RIGHT_TOP = 6; /** @var int Mirrored horizontally and rotated 90° clockwise. */ private const RIGHT_BOTTOM = 7; /** @var int Rotated 270° clockwise. */ private const LEFT_BOTTOM = 8; /** * Initialise the EXIF remover service. */ public function __construct() { // To decide whether to use ExifTool or PHP GD, check the ExifTool path. if (!empty($this->get_exiftool_path())) { $this->useexiftool = true; } } #[\Override] public function redact_file_by_path( string $mimetype, string $filepath, ): ?string { if (!$this->is_mimetype_supported($mimetype)) { return null; } if ($this->useexiftool) { // Use the ExifTool executable to remove the desired EXIF tags. return $this->execute_exiftool($filepath); } else { // Use PHP GD lib to remove all EXIF tags. return $this->execute_gd($filepath); } } #[\Override] public function redact_file_by_content( string $mimetype, string $filecontent, ): ?string { if (!$this->is_mimetype_supported($mimetype)) { return null; } if ($this->useexiftool) { // Use the ExifTool executable to remove the desired EXIF tags. return $this->execute_exiftool_on_content($filecontent); } else { // Use PHP GD lib to remove all EXIF tags. return $this->execute_gd_on_content($filecontent); } } /** * Executes ExifTool to remove metadata from the original file. * * @param string $sourcefile The file path of the file to redact * @return string The destination path of the recreated content * @throws moodle_exception If the ExifTool process fails or the destination file is not created. */ private function execute_exiftool(string $sourcefile): string { $destinationfile = make_request_directory() . '/' . basename($sourcefile); // Prepare the ExifTool command. $command = $this->get_exiftool_command($sourcefile, $destinationfile); // Run the command. exec($command, $output, $resultcode); // If the return code was not zero or the destination file was not successfully created. if ($resultcode !== 0 || !file_exists($destinationfile)) { throw new moodle_exception( errorcode: 'redactor:exifremover:failedprocessexiftool', module: 'core_files', a: get_class($this), debuginfo: implode($output), ); } return $destinationfile; } /** * Executes ExifTool to remove metadata from the original file content. * * @param string $filecontent The file content to redact. * @return string The redacted updated content * @throws moodle_exception If the ExifTool process fails or the destination file is not created. */ private function execute_exiftool_on_content(string $filecontent): string { $sourcefile = make_request_directory() . '/input'; file_put_contents($sourcefile, $filecontent); $destinationfile = $this->execute_exiftool($sourcefile); return file_get_contents($destinationfile); } /** * Executes GD library to remove metadata from the original file. * * @param string $sourcefile The source file to redact. * @return string The destination path of the recreated content * @throws moodle_exception If the image data is not successfully recreated. */ private function execute_gd(string $sourcefile): string { // Read EXIF data from the temporary file. $exifdata = @exif_read_data($sourcefile); $orientation = isset($exifdata['Orientation']) ? $exifdata['Orientation'] : self::TOP_LEFT; $filecontent = file_get_contents($sourcefile); $destinationfile = $this->recreate_image_gd($filecontent, $orientation); if (!$destinationfile) { throw new moodle_exception( errorcode: 'redactor:exifremover:failedprocessgd', module: 'core_files', a: get_class($this), ); } return $destinationfile; } /** * Executes GD library to remove metadata from the original file. * * @param string $filecontent The source file content to redact. * @return string The redacted file content * @throws moodle_exception If the image data is not successfully recreated. */ private function execute_gd_on_content(string $filecontent): string { $destinationfile = $this->recreate_image_gd($filecontent); if (!$destinationfile) { throw new moodle_exception( errorcode: 'redactor:exifremover:failedprocessgd', module: 'core_files', a: get_class($this), ); } return file_get_contents($destinationfile); } /** * Gets the ExifTool command to strip the file of EXIF data. * * @param string $source The source path of the file. * @param string $destination The destination path of the file. * @return string The command to use to remove EXIF data from the file. */ private function get_exiftool_command(string $source, string $destination): string { $exiftoolexec = escapeshellarg($this->get_exiftool_path()); $removetags = $this->get_remove_tags(); $tempdestination = escapeshellarg($destination); $tempsource = escapeshellarg($source); $preservetagsoption = "-tagsfromfile @ " . self::PRESERVE_TAGS; $command = "$exiftoolexec $removetags $preservetagsoption -o $tempdestination -- $tempsource"; $command .= " 2> /dev/null"; // Do not output any errors. return $command; } /** * Retrieves the remove tag options based on configuration. * * @return string The remove tag options. */ private function get_remove_tags(): string { $removetags = get_config('core', 'file_redactor_exifremoverremovetags'); // If the remove tags value is empty or not empty but does not exist in the array, then set the default. if (!$removetags || ($removetags && !array_key_exists($removetags, self::REMOVE_TAGS))) { $removetags = self::DEFAULT_REMOVE_TAGS; } return self::REMOVE_TAGS[$removetags]; } /** * Retrieves the path to the ExifTool executable. * * @return string The path to the ExifTool executable. */ private function get_exiftool_path(): string { $toolpathconfig = get_config('core', 'file_redactor_exifremovertoolpath'); if (!empty($toolpathconfig) && is_executable($toolpathconfig)) { return $toolpathconfig; } return ''; } /** * Recreate the image using PHP GD library to strip all EXIF data. * * @param string $content The source file content. * @param int $orientation The orientation value. The default is 1, which means no rotation. * @return null|string The path to the recreated image, or null on failure. */ private function recreate_image_gd( string $content, int $orientation = self::TOP_LEFT, ): ?string { // Fetch the image information for this image. $imageinfo = @getimagesizefromstring($content); if (empty($imageinfo)) { return null; } // Create a new image from the file. $image = @imagecreatefromstring($content); $this->flip_gd($image, $orientation); $destinationfile = make_request_directory() . '/output'; // Capture the image as a string object, rather than straight to file. $result = imagejpeg( image: $image, file: $destinationfile, quality: self::DEFAULT_JPEG_COMPRESSION, ); imagedestroy($image); if ($result) { return $destinationfile; } return null; } /** * Flips the given GD image resource based on the specified orientation. * * @param \GDImage $image The GD image resource to be flipped. * @param int $orientation The orientation value indicating how the image should be flipped. * * @return void */ private function flip_gd(\GDImage &$image, int $orientation): void { switch ($orientation) { case self::TOP_LEFT: break; case self::TOP_RIGHT: imageflip($image, IMG_FLIP_HORIZONTAL); break; case self::BOTTOM_RIGHT: $image = imagerotate($image, 180, 0); break; case self::BOTTOM_LEFT: imageflip($image, IMG_FLIP_VERTICAL); break; case self::LEFT_TOP: $image = imagerotate($image, -90, 0); imageflip($image, IMG_FLIP_HORIZONTAL); break; case self::RIGHT_TOP: $image = imagerotate($image, -90, 0); break; case self::RIGHT_BOTTOM: $image = imagerotate($image, 90, 0); imageflip($image, IMG_FLIP_HORIZONTAL); break; case self::LEFT_BOTTOM: $image = imagerotate($image, 90, 0); break; } } /** * Returns true if the service is enabled, and false if it is not. * * @return bool */ public function is_enabled(): bool { return (bool) get_config('core', 'file_redactor_exifremoverenabled'); } /** * Determines whether a certain mime-type is supported by the service. * It will return true if the mime-type is supported, and false if it is not. * * @param string $mimetype The mime type of file. * @return bool */ public function is_mimetype_supported(string $mimetype): bool { if ($mimetype === self::DEFAULT_MIMETYPE) { return true; } if ($this->useexiftool) { // Get the supported MIME types from the config if using ExifTool. $supportedmimetypesconfig = get_config('core', 'file_redactor_exifremovermimetype'); $supportedmimetypes = array_filter(array_map('trim', explode("\n", $supportedmimetypesconfig))); return in_array($mimetype, $supportedmimetypes) ?? false; } return false; } /** * Adds settings to the provided admin settings page. * * @param \admin_settingpage $settings The admin settings page to which settings are added. */ public static function add_settings(\admin_settingpage $settings): void { global $OUTPUT; // Enabled for a fresh install, disabled for an upgrade. $defaultenabled = 1; if (empty(get_config('core', 'file_redactor_exifremoverenabled'))) { if (PHPUNIT_TEST || !during_initial_install()) { $defaultenabled = 0; } } $icon = $OUTPUT->pix_icon('i/externallink', get_string('opensinnewwindow')); $a = (object) [ 'link' => html_writer::link( url: 'https://exiftool.sourceforge.net/install.html', text: "https://exiftool.sourceforge.net/install.html $icon", attributes: ['role' => 'opener', 'rel' => 'noreferrer', 'target' => '_blank'], ), ]; $settings->add( new admin_setting_configcheckbox( name: 'file_redactor_exifremoverenabled', visiblename: get_string('redactor:exifremover:enabled', 'core_files'), description: get_string('redactor:exifremover:enabled_desc', 'core_files', $a), defaultsetting: $defaultenabled, ), ); $settings->add( new admin_setting_heading( name: 'exifremoverheading', heading: get_string('redactor:exifremover:heading', 'core_files'), information: '', ) ); $settings->add( new admin_setting_configexecutable( name: 'file_redactor_exifremovertoolpath', visiblename: get_string('redactor:exifremover:toolpath', 'core_files'), description: get_string('redactor:exifremover:toolpath_desc', 'core_files'), defaultdirectory: '', ) ); foreach (array_keys(self::REMOVE_TAGS) as $key) { $removedtagchoices[$key] = get_string("redactor:exifremover:tag:$key", 'core_files'); } $settings->add( new admin_setting_configselect( name: 'file_redactor_exifremoverremovetags', visiblename: get_string('redactor:exifremover:removetags', 'core_files'), description: get_string('redactor:exifremover:removetags_desc', 'core_files'), defaultsetting: self::DEFAULT_REMOVE_TAGS, choices: $removedtagchoices, ), ); $mimetypedefault = <<<EOF image/jpeg image/tiff EOF; $settings->add( new admin_setting_configtextarea( name: 'file_redactor_exifremovermimetype', visiblename: get_string('redactor:exifremover:mimetype', 'core_files'), description: get_string('redactor:exifremover:mimetype_desc', 'core_files'), defaultsetting: $mimetypedefault, ), ); } } PK b<�\e~]� � = classes/redactor/services/file_redactor_service_interface.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor\services; /** * Class file_redactor_service_interface * * @package core_files * @copyright 2024 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface file_redactor_service_interface { /** * Performs redaction on the specified stored_file. * * @param string $mimetype The mime-type of the file * @param string $filepath The path of the file to redact * @return string|null The path to the redacted file, or null if redaction was not attempted */ public function redact_file_by_path( string $mimetype, string $filepath, ): ?string; /** * Performs redaction on the specified stored_file. * * @param string $mimetype The mime-type of the file * @param string $filecontent The content of the file to redact * @return string|null The redacted content, or null if redaction was not attempted */ public function redact_file_by_content( string $mimetype, string $filecontent, ): ?string; /** * Determines whether a certain mime-type is supported by the service. * * @param string $mimetype * @return bool */ public function is_mimetype_supported(string $mimetype): bool; } PK b<�\Ǝ� � � % classes/redactor/services/service.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor\services; use stored_file; /** * The interface of the redaction service outlines the necessary methods for each redaction blueprint. * * @package core * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ abstract class service { /** * Returns true if the service is enabled, and false if it is not. * * @return bool */ abstract public function is_enabled(): bool; /** * Adds settings to the provided admin settings page. * * @param \admin_settingpage $settings The admin settings page to which settings are added. */ abstract public static function add_settings(\admin_settingpage $settings): void; } PK b<�\V+��� � classes/redactor/manager.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor; /** * Fileredact manager. * * Manages and executes redaction services. * * @package core_files * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class manager { /** @var array Holds an array of error messages. */ private array $errors = []; /** * Redacts the given file. * * @param string $mimetype The mime-type of the file * @param string $filepath The path to the file to redact * @return string|null The path to the redacted file or null if no redaction services are available. */ public function redact_file( string $mimetype, string $filepath, ): ?string { // Get the file redact services. $services = $this->get_service_classnames(); $serviceinstances = array_filter( array_map(fn($serviceclass) => new $serviceclass(), $services), fn($service) => $service->is_enabled() && $service->is_mimetype_supported($mimetype) ); if (count($serviceinstances) === 0) { return null; } foreach ($serviceinstances as $servicename => $service) { try { return $service->redact_file_by_path($mimetype, $filepath); } catch (\Throwable $e) { $this->errors[] = $e; } } return null; } /** * Redacts the given file content. * * @param string $mimetype The mime-type of the file * @param string $filecontent The file content to redact * @return string|null The content of the redacted file */ public function redact_file_content( string $mimetype, string $filecontent, ): ?string { // Get the file redact services. $services = $this->get_file_services_for_mimetype($mimetype); foreach ($services as $servicename => $service) { try { return $service->redact_file_by_content($mimetype, $filecontent); } catch (\Throwable $e) { $this->errors[] = $e; } } return null; } /** * Returns a list of applicable redaction services. * * @return string[] list of service classnames. */ public function get_service_classnames(): array { global $CFG; $servicesdir = "{$CFG->dirroot}/files/classes/redactor/services/"; $servicefiles = glob("{$servicesdir}*_service.php"); $services = []; foreach ($servicefiles as $servicefile) { $servicename = basename($servicefile, '_service.php'); $serviceclass = services::class . "\\{$servicename}_service"; if (!is_a($serviceclass, services\service::class, true)) { continue; } $services[$servicename] = $serviceclass; } return $services; } /** * Returns a list of file redaction services that support the given mime-type. * * @param string $mimetype The mime-type to filter by * @return services\file_redactor_service_interface[] An array of file redaction services that support the given mime-type. */ protected function get_file_services_for_mimetype(string $mimetype): array { return array_filter(array_map( function(string $serviceclass) use ($mimetype): ?services\file_redactor_service_interface { if (!is_a($serviceclass, services\file_redactor_service_interface::class, true)) { return null; } $service = new $serviceclass(); if ($service->is_mimetype_supported($mimetype)) { return $service; } return null; }, $this->get_service_classnames(), ), fn ($service) => $service !== null); } /** * Retrieves an array of error messages. * * @return array An array of error messages. */ public function get_errors(): array { return $this->errors; } } PK b<�\� -3� � " classes/redactor/hook_listener.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor; use core_files\hook\before_file_created; /** * Allow the plugin to call as soon as possible before the file is created. * * @package core * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class hook_listener { /** * Execute the before_file_created hook listener for file redaction. * * @param before_file_created $hook */ public static function file_redaction_handler(before_file_created $hook): void { // The file mime-type must be present. Otherwise, bypass the process. if (empty($hook->get_filerecord()) || empty($hook->get_filerecord()->mimetype)) { return; } $manager = \core\di::get(manager::class); if ($hook->has_filepath()) { $file = $manager->redact_file( $hook->get_filerecord()->mimetype, $hook->get_filepath(), ); if ($file !== null) { $hook->update_filepath($file); } } else { $data = $manager->redact_file_content( $hook->get_filerecord()->mimetype, $hook->get_filecontent(), ); if ($data !== null) { $hook->update_filecontent($data); } } // Iterates through the errors returned by the manager and outputs each error message. foreach ($manager->get_errors() as $e) { debugging($e->getMessage()); } } } PK b<�\� � � ( classes/task/conversion_cleanup_task.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * A scheduled task to clear up old conversion records. * * @package core_files * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\task; defined('MOODLE_INTERNAL') || die(); /** * A scheduled task to clear up old conversion records. * * @package core_files * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class conversion_cleanup_task extends \core\task\scheduled_task { /** * Get a descriptive name for this task (shown to admins). * * @return string */ public function get_name() { return get_string('fileconversioncleanuptask', 'admin'); } /** * Run task. */ public function execute() { \core_files\conversion::remove_old_conversion_records(); \core_files\conversion::remove_orphan_records(); } } PK b<�\i�`�c c 8 classes/local/archive_writer/stream_writer_interface.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Interface used by archives that write to streams. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\local\archive_writer; /** * Interface used by archives that write to streams. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface stream_writer_interface { /** * Return the stream instance. * * @param string $filename * @return static */ public static function stream_instance(string $filename): self; } PK b<�\�&�� � 6 classes/local/archive_writer/file_writer_interface.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Interface used by archives that write to files. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\local\archive_writer; /** * Interface used by archives that write to files. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ interface file_writer_interface { /** * Return the file instance. * * @param string $filename * @return static */ public static function file_instance(string $filename): self; /** * Get the path of the zip. * * @return string */ public function get_path_to_zip(): string; } PK b<�\�Y�4a a + classes/local/archive_writer/zip_writer.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class used for creating ZIP archives. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\local\archive_writer; use ZipStream\ZipStream; use core_files\archive_writer; use core_files\local\archive_writer\file_writer_interface as file_writer_interface; use core_files\local\archive_writer\stream_writer_interface as stream_writer_interface; /** * Class used for creating ZIP archives. * * @package core_files * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class zip_writer extends archive_writer implements file_writer_interface, stream_writer_interface { /** * @var resource File resource for the file handle for a file-based zip stream */ private $zipfilehandle = null; /** * @var String The location of the zip file. */ private $zipfilepath = null; /** * @var ZipStream The zip stream. */ private $archive; /** * The zip_writer constructor. * * @param ZipStream $archive */ protected function __construct(ZipStream $archive) { parent::__construct(); $this->archive = $archive; } public static function stream_instance(string $filename): stream_writer_interface { $zipwriter = new ZipStream( outputName: $filename, ); return new static($zipwriter); } public static function file_instance(string $filename): file_writer_interface { $dir = make_request_directory(); $filepath = "$dir/$filename"; $fh = fopen($filepath, 'w'); $zipstream = new ZipStream( outputName: $filename, outputStream: $fh, sendHttpHeaders: false, ); $zipwriter = new static($zipstream); // ZipStream only takes a file handle resource. // It does not close this resource itself, and it does not know the location of this resource on disk. // Store references to the filehandle, and the location of the filepath in the new class so that the `finish()` // function can close the fh, and move the temporary file into place. // The filehandle must be closed when finishing the archive. ZipStream does not close it automatically. $zipwriter->zipfilehandle = $fh; $zipwriter->zipfilepath = $filepath; return $zipwriter; } public function add_file_from_filepath(string $name, string $path): void { $this->archive->addFileFromPath($this->sanitise_filepath($name), $path); } public function add_file_from_string(string $name, string $data): void { $this->archive->addFile($this->sanitise_filepath($name), $data); } public function add_file_from_stream(string $name, $stream): void { $this->archive->addFileFromStream($this->sanitise_filepath($name), $stream); fclose($stream); } public function add_file_from_stored_file(string $name, \stored_file $file): void { $datetime = new \DateTime(); $datetime->setTimestamp($file->get_timemodified()); $filehandle = $file->get_content_file_handle(); $this->archive->addFileFromStream( fileName: $this->sanitise_filepath($name), stream: $filehandle, lastModificationDateTime: $datetime, ); fclose($filehandle); } public function finish(): void { $this->archive->finish(); if ($this->zipfilehandle) { fclose($this->zipfilehandle); } } public function get_path_to_zip(): string { return $this->zipfilepath; } } PK b<�\"O�_R@ R@ externallib.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * External files API * * @package core_files * @category external * @copyright 2010 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ use core_external\external_api; use core_external\external_function_parameters; use core_external\external_multiple_structure; use core_external\external_single_structure; use core_external\external_value; defined('MOODLE_INTERNAL') || die(); require_once("{$CFG->libdir}/filelib.php"); /** * Files external functions * * @package core_files * @category external * @copyright 2011 Jerome Mouneyrac * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.2 */ class core_files_external extends external_api { /** * Returns description of get_files parameters * * @return external_function_parameters * @since Moodle 2.2 */ public static function get_files_parameters() { return new external_function_parameters([ 'contextid' => new external_value(PARAM_INT, 'context id Set to -1 to use contextlevel and instanceid.'), 'component' => new external_value(PARAM_TEXT, 'component'), 'filearea' => new external_value(PARAM_TEXT, 'file area'), 'itemid' => new external_value(PARAM_INT, 'associated id'), 'filepath' => new external_value(PARAM_PATH, 'file path'), 'filename' => new external_value(PARAM_TEXT, 'file name'), 'modified' => new external_value( PARAM_INT, 'timestamp to return files changed after this time.', VALUE_DEFAULT, null ), 'contextlevel' => new external_value(PARAM_ALPHA, 'The context level for the file location.', VALUE_DEFAULT, null), 'instanceid' => new external_value(PARAM_INT, 'The instance id for where the file is located.', VALUE_DEFAULT, null), ]); } /** * Return moodle files listing * * @param int $contextid context id * @param int $component component * @param int $filearea file area * @param int $itemid item id * @param string $filepath file path * @param string $filename file name * @param int $modified timestamp to return files changed after this time. * @param string $contextlevel The context level for the file location. * @param int $instanceid The instance id for where the file is located. * @return array * @since Moodle 2.9 Returns additional fields (timecreated, filesize, author, license) * @since Moodle 2.2 */ public static function get_files($contextid, $component, $filearea, $itemid, $filepath, $filename, $modified = null, $contextlevel = null, $instanceid = null) { $parameters = [ 'contextid' => $contextid, 'component' => $component, 'filearea' => $filearea, 'itemid' => $itemid, 'filepath' => $filepath, 'filename' => $filename, 'modified' => $modified, 'contextlevel' => $contextlevel, 'instanceid' => $instanceid, ]; $fileinfo = self::validate_parameters(self::get_files_parameters(), $parameters); $browser = get_file_browser(); // We need to preserve backwards compatibility. Zero will use the system context and minus one will // use the addtional parameters to determine the context. // TODO MDL-40489 get_context_from_params should handle this logic. if ($fileinfo['contextid'] == 0) { $context = context_system::instance(); } else { if ($fileinfo['contextid'] == -1) { $fileinfo['contextid'] = null; } $context = self::get_context_from_params($fileinfo); } self::validate_context($context); if (empty($fileinfo['component'])) { $fileinfo['component'] = null; } if (empty($fileinfo['filearea'])) { $fileinfo['filearea'] = null; } if (empty($fileinfo['filename'])) { $fileinfo['filename'] = null; } if (empty($fileinfo['filepath'])) { $fileinfo['filepath'] = null; } $return = array(); $return['parents'] = array(); $return['files'] = array(); $list = array(); if ($file = $browser->get_file_info( $context, $fileinfo['component'], $fileinfo['filearea'], $fileinfo['itemid'], $fileinfo['filepath'], $fileinfo['filename'])) { $level = $file->get_parent(); while ($level) { $params = $level->get_params(); $params['filename'] = $level->get_visible_name(); array_unshift($return['parents'], $params); $level = $level->get_parent(); } $children = $file->get_children(); foreach ($children as $child) { $params = $child->get_params(); $timemodified = $child->get_timemodified(); $timecreated = $child->get_timecreated(); if ($child->is_directory()) { if ((is_null($modified)) or ($modified < $timemodified)) { $node = [ 'contextid' => $params['contextid'], 'component' => $params['component'], 'filearea' => $params['filearea'], 'itemid' => $params['itemid'], 'filepath' => $params['filepath'], 'filename' => $child->get_visible_name(), 'url' => null, 'isdir' => true, 'timemodified' => $timemodified, 'timecreated' => $timecreated, 'filesize' => 0, 'author' => null, 'license' => null, ]; $list[] = $node; } } else { if ((is_null($modified)) or ($modified < $timemodified)) { $node = [ 'contextid' => $params['contextid'], 'component' => $params['component'], 'filearea' => $params['filearea'], 'itemid' => $params['itemid'], 'filepath' => $params['filepath'], 'filename' => $child->get_visible_name(), 'url' => $child->get_url(), 'isdir' => false, 'timemodified' => $timemodified, 'timecreated' => $timecreated, 'filesize' => $child->get_filesize(), 'author' => $child->get_author(), 'license' => $child->get_license(), ]; $list[] = $node; } } } } $return['files'] = $list; return $return; } /** * Returns description of get_files returns * * @return external_single_structure * @since Moodle 2.9 Returns additional fields for files (timecreated, filesize, author, license) * @since Moodle 2.2 */ public static function get_files_returns() { return new external_single_structure([ 'parents' => new external_multiple_structure( new external_single_structure([ 'contextid' => new external_value(PARAM_INT, ''), 'component' => new external_value(PARAM_COMPONENT, ''), 'filearea' => new external_value(PARAM_AREA, ''), 'itemid' => new external_value(PARAM_INT, ''), 'filepath' => new external_value(PARAM_TEXT, ''), 'filename' => new external_value(PARAM_TEXT, ''), ]) ), 'files' => new external_multiple_structure( new external_single_structure([ 'contextid' => new external_value(PARAM_INT, ''), 'component' => new external_value(PARAM_COMPONENT, ''), 'filearea' => new external_value(PARAM_AREA, ''), 'itemid' => new external_value(PARAM_INT, ''), 'filepath' => new external_value(PARAM_TEXT, ''), 'filename' => new external_value(PARAM_TEXT, ''), 'isdir' => new external_value(PARAM_BOOL, ''), 'url' => new external_value(PARAM_TEXT, ''), 'timemodified' => new external_value(PARAM_INT, ''), 'timecreated' => new external_value(PARAM_INT, 'Time created', VALUE_OPTIONAL), 'filesize' => new external_value(PARAM_INT, 'File size', VALUE_OPTIONAL), 'author' => new external_value(PARAM_TEXT, 'File owner', VALUE_OPTIONAL), 'license' => new external_value(PARAM_TEXT, 'File license', VALUE_OPTIONAL), ]) ), ]); } /** * Returns description of upload parameters * * @return external_function_parameters * @since Moodle 2.2 */ public static function upload_parameters() { return new external_function_parameters([ 'contextid' => new external_value(PARAM_INT, 'context id', VALUE_DEFAULT, null), 'component' => new external_value(PARAM_COMPONENT, 'component'), 'filearea' => new external_value(PARAM_AREA, 'file area'), 'itemid' => new external_value(PARAM_INT, 'associated id'), 'filepath' => new external_value(PARAM_PATH, 'file path'), 'filename' => new external_value(PARAM_FILE, 'file name'), 'filecontent' => new external_value(PARAM_TEXT, 'file content'), 'contextlevel' => new external_value( PARAM_ALPHA, 'The context level to put the file in, (block, course, coursecat, system, user, module)', VALUE_DEFAULT, null ), 'instanceid' => new external_value(PARAM_INT, 'The Instance id of item associated with the context level', VALUE_DEFAULT, null), ]); } /** * Uploading a file to moodle * * @param int $contextid context id * @param string $component component * @param string $filearea file area * @param int $itemid item id * @param string $filepath file path * @param string $filename file name * @param string $filecontent file content * @param string $contextlevel Context level (block, course, coursecat, system, user or module) * @param int $instanceid Instance id of the item associated with the context level * @return array * @since Moodle 2.2 */ public static function upload( $contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid ) { global $USER, $CFG; $fileinfo = self::validate_parameters(self::upload_parameters(), [ 'contextid' => $contextid, 'component' => $component, 'filearea' => $filearea, 'itemid' => $itemid, 'filepath' => $filepath, 'filename' => $filename, 'filecontent' => $filecontent, 'contextlevel' => $contextlevel, 'instanceid' => $instanceid, ]); if (!isset($fileinfo['filecontent'])) { throw new moodle_exception('nofile'); } // Saving file. $dir = make_temp_directory('wsupload'); if (empty($fileinfo['filename'])) { $filename = uniqid('wsupload', true).'_'.time().'.tmp'; } else { $filename = $fileinfo['filename']; } if (file_exists($dir.$filename)) { $savedfilepath = $dir.uniqid('m').$filename; } else { $savedfilepath = $dir.$filename; } file_put_contents($savedfilepath, base64_decode($fileinfo['filecontent'])); @chmod($savedfilepath, $CFG->filepermissions); unset($fileinfo['filecontent']); if (!empty($fileinfo['filepath'])) { $filepath = $fileinfo['filepath']; } else { $filepath = '/'; } // Only allow uploads to draft area. if (!($fileinfo['component'] == 'user' and $fileinfo['filearea'] == 'draft')) { throw new coding_exception('File can be uploaded to user draft area only'); } else { $component = 'user'; $filearea = $fileinfo['filearea']; } $itemid = 0; if (isset($fileinfo['itemid'])) { $itemid = $fileinfo['itemid']; } if ($filearea == 'draft' && $itemid <= 0) { // Generate a draft area for the files. $itemid = file_get_unused_draft_itemid(); } else if ($filearea == 'private') { // TODO MDL-31116 in user private area, itemid is always 0. $itemid = 0; } // We need to preserve backword compatibility. Context id is no more a required. if (empty($fileinfo['contextid'])) { unset($fileinfo['contextid']); } // Get and validate context. $context = self::get_context_from_params($fileinfo); self::validate_context($context); if (($fileinfo['component'] == 'user' and $fileinfo['filearea'] == 'private')) { throw new moodle_exception('privatefilesupload'); } $browser = get_file_browser(); // Check existing file. if ($file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename)) { throw new moodle_exception('fileexist'); } // Move file to filepool. if ($dir = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, '.')) { $info = $dir->create_file_from_pathname($filename, $savedfilepath); $params = $info->get_params(); unlink($savedfilepath); return [ 'contextid' => $params['contextid'], 'component' => $params['component'], 'filearea' => $params['filearea'], 'itemid' => $params['itemid'], 'filepath' => $params['filepath'], 'filename' => $params['filename'], 'url' => $info->get_url(), ]; } else { throw new moodle_exception('nofile'); } } /** * Returns description of upload returns * * @return external_single_structure * @since Moodle 2.2 */ public static function upload_returns() { return new external_single_structure([ 'contextid' => new external_value(PARAM_INT, ''), 'component' => new external_value(PARAM_COMPONENT, ''), 'filearea' => new external_value(PARAM_AREA, ''), 'itemid' => new external_value(PARAM_INT, ''), 'filepath' => new external_value(PARAM_TEXT, ''), 'filename' => new external_value(PARAM_FILE, ''), 'url' => new external_value(PARAM_TEXT, ''), ]); } } PK b<�\� �� � UPGRADING.mdnu �[��� # core_files (subsystem) Upgrade notes ## 4.5.4 ### Added - A new function `file_clear_draft_area()` has been added to delete the files in a draft area. For more information see [MDL-72050](https://tracker.moodle.org/browse/MDL-72050) ## 4.5 ### Added - A new hook, `\core_files\hook\after_file_created`, has been created to allow the inspection of files after they have been saved in the filesystem. For more information see [MDL-75850](https://tracker.moodle.org/browse/MDL-75850) - A new hook, `\core_files\hook\before_file_created`, has been created to allow modification of a file immediately before it is stored in the file system. For more information see [MDL-83245](https://tracker.moodle.org/browse/MDL-83245) PK b<�\}�k�a a renderer.phpnu �[��� <?php /////////////////////////////////////////////////////////////////////////// // // // This file is part of Moodle - http://moodle.org/ // // Moodle - Modular Object-Oriented Dynamic Learning Environment // // // // Moodle is free software: you can redistribute it and/or modify // // it under the terms of the GNU General Public License as published by // // the Free Software Foundation, either version 3 of the License, or // // (at your option) any later version. // // // // Moodle is distributed in the hope that it will be useful, // // but WITHOUT ANY WARRANTY; without even the implied warranty of // // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // // GNU General Public License for more details. // // // // You should have received a copy of the GNU General Public License // // along with Moodle. If not, see <http://www.gnu.org/licenses/>. // // // /////////////////////////////////////////////////////////////////////////// defined('MOODLE_INTERNAL') || die(); /** * Rendering of files viewer related widgets. * @package core * @subpackage file * @copyright 2010 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.0 */ /** * File browser render * * @copyright 2010 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.0 */ class core_files_renderer extends plugin_renderer_base { public function files_tree_viewer(file_info $file_info, ?array $options = null) { $tree = new files_tree_viewer($file_info, $options); return $this->render($tree); } public function render_files_tree_viewer(files_tree_viewer $tree) { $html = $this->output->heading_with_help(get_string('coursefiles'), 'courselegacyfiles', 'moodle'); $html .= $this->output->container_start('coursefilesbreadcrumb'); foreach($tree->path as $path) { $html .= $path; $html .= ' / '; } $html .= $this->output->container_end(); $html .= $this->output->box_start(); $table = new html_table(); $table->head = array(get_string('name'), get_string('lastmodified'), get_string('size', 'repository'), get_string('type', 'repository')); $table->align = array('left', 'left', 'left', 'left'); $table->width = '100%'; $table->data = array(); foreach ($tree->tree as $file) { $filedate = $filesize = $filetype = ''; if ($file['filedate']) { $filedate = userdate($file['filedate'], get_string('strftimedatetimeshort', 'langconfig')); } if (empty($file['isdir'])) { if ($file['filesize']) { $filesize = display_size($file['filesize']); } $fileicon = file_file_icon($file); $filetype = get_mimetype_description($file); } else { $fileicon = file_folder_icon(); } $table->data[] = array( html_writer::link($file['url'], $this->output->pix_icon($fileicon, get_string('icon')) . ' ' . $file['filename']), $filedate, $filesize, $filetype ); } $html .= html_writer::table($table); $html .= $this->output->single_button(new moodle_url('/files/coursefilesedit.php', array('contextid'=>$tree->context->id)), get_string('coursefilesedit'), 'get'); $html .= $this->output->box_end(); return $html; } /** * Prints the file manager and initializes all necessary libraries * * <pre> * $fm = new form_filemanager($options); * $output = get_renderer('core', 'files'); * echo $output->render($fm); * </pre> * * @param form_filemanager $fm File manager to render * @return string HTML fragment */ public function render_form_filemanager($fm) { $html = $this->fm_print_generallayout($fm); $module = array( 'name'=>'form_filemanager', 'fullpath'=>'/lib/form/filemanager.js', 'requires' => array('moodle-core-notification-dialogue', 'core_filepicker', 'base', 'io-base', 'node', 'json', 'core_dndupload', 'panel', 'resize-plugin', 'dd-plugin'), 'strings' => array( array('error', 'moodle'), array('info', 'moodle'), array('confirmdeletefile', 'repository'), array('draftareanofiles', 'repository'), array('entername', 'repository'), array('enternewname', 'repository'), array('invalidjson', 'repository'), array('popupblockeddownload', 'repository'), array('unknownoriginal', 'repository'), array('confirmdeletefolder', 'repository'), array('confirmdeletefilewithhref', 'repository'), array('confirmrenamefolder', 'repository'), array('confirmrenamefile', 'repository'), array('newfolder', 'repository'), array('edit', 'moodle'), array('originalextensionchange', 'repository'), array('originalextensionremove', 'repository'), array('aliaseschange', 'repository'), ['nofilesselected', 'repository'], ['confirmdeleteselectedfile', 'repository'], ['selectall', 'moodle'], ['deselectall', 'moodle'], ['selectallornone', 'form'], ) ); if ($this->page->requires->should_create_one_time_item_now('core_file_managertemplate')) { $this->page->requires->js_init_call('M.form_filemanager.set_templates', array($this->filemanager_js_templates()), true, $module); } $this->page->requires->js_call_amd('core/checkbox-toggleall', 'init'); $this->page->requires->js_init_call('M.form_filemanager.init', array($fm->options), true, $module); // non javascript file manager $html .= '<noscript>'; $html .= "<div><object type='text/html' data='".$fm->get_nonjsurl()."' height='160' width='600' style='border:1px solid #000'></object></div>"; $html .= '</noscript>'; return $html; } /** * Returns html for displaying one file manager * * @param form_filemanager $fm * @return string */ protected function fm_print_generallayout($fm) { $context = [ 'client_id' => $fm->options->client_id, 'helpicon' => $this->help_icon('setmainfile', 'repository'), 'restrictions' => $this->fm_print_restrictions($fm) ]; return $this->render_from_template('core/filemanager_page_generallayout', $context); } /** * FileManager JS template for displaying one file in 'icon view' mode. * * Except for elements described in fp_js_template_iconfilename, this template may also * contain element with class 'fp-contextmenu'. If context menu is available for this * file, the top element will receive the additional class 'fp-hascontextmenu' and * the element with class 'fp-contextmenu' will hold onclick event for displaying * the context menu. * * @see fp_js_template_iconfilename() * @return string */ protected function fm_js_template_iconfilename() { $rv = ' <div class="fp-file"> <a href="#" class="d-block aabtn"> <div style="position:relative;"> <div class="fp-thumbnail"></div> <div class="fp-reficons1"></div> <div class="fp-reficons2"></div> </div> <div class="fp-filename-field"> <div class="fp-filename text-truncate"></div> </div> </a> <a class="fp-contextmenu btn btn-icon btn-light border icon-no-margin icon-size-3" href="#"> <span>'.$this->pix_icon('i/menu', '▶').'</span></a> </div>'; return $rv; } /** * FileManager JS template for displaying file name in 'table view' and 'tree view' modes. * * Except for elements described in fp_js_template_listfilename, this template may also * contain element with class 'fp-contextmenu'. If context menu is available for this * file, the top element will receive the additional class 'fp-hascontextmenu' and * the element with class 'fp-contextmenu' will hold onclick event for displaying * the context menu. * * @todo MDL-32736 remove onclick="return false;" * @see fp_js_template_listfilename() * @return string */ protected function fm_js_template_listfilename() { $rv = ' <span class="fp-filename-icon"> <a href="#"> <span class="fp-icon"></span> <span class="fp-reficons1"></span> <span class="fp-reficons2"></span> <span class="fp-filename"></span> </a> <a class="fp-contextmenu" href="#" onclick="return false;">'.$this->pix_icon('i/menu', '▶').'</a> </span>'; return $rv; } /** * FileManager JS template for displaying 'Make new folder' dialog. * * Must be wrapped in an element, CSS for this element must define width and height of the window; * * Must have one input element with type="text" (for users to enter the new folder name); * * content of element with class 'fp-dlg-curpath' will be replaced with current path where * new folder is about to be created; * elements with classes 'fp-dlg-butcreate' and 'fp-dlg-butcancel' will hold onclick events; * * @return string */ protected function fm_js_template_mkdir() { $rv = ' <div class="filemanager fp-mkdir-dlg" role="dialog" aria-live="assertive" aria-labelledby="fp-mkdir-dlg-title"> <div class="fp-mkdir-dlg-text"> <label id="fp-mkdir-dlg-title">' . get_string('newfoldername', 'repository') . '</label><br/> <input type="text" class="form-control"/> </div> <button class="fp-dlg-butcreate btn-primary btn">'.get_string('makeafolder').'</button> <button class="fp-dlg-butcancel btn-cancel btn">'.get_string('cancel').'</button> </div>'; return $rv; } /** * FileManager JS template for error/info message displayed as a separate popup window. * * @see fp_js_template_message() * @return string */ protected function fm_js_template_message() { return $this->fp_js_template_message(); } /** * FileManager JS template for window with file information/actions. * */ protected function fm_js_template_fileselectlayout() { $context = [ 'helpicon' => $this->help_icon('setmainfile', 'repository'), 'licensehelpicon' => $this->create_license_help_icon_context(), 'columns' => true ]; return $this->render_from_template('core/filemanager_fileselect', $context); } /** * FileManager JS template for popup confirm dialogue window. * * @return string */ protected function fm_js_template_confirmdialog() { return $this->render_from_template('core/filemanager_confirmdialog', []); } /** * Returns all FileManager JavaScript templates as an array. * * @return array */ public function filemanager_js_templates() { $class_methods = get_class_methods($this); $templates = array(); foreach ($class_methods as $method_name) { if (preg_match('/^fm_js_template_(.*)$/', $method_name, $matches)) $templates[$matches[1]] = $this->$method_name(); } return $templates; } /** * Displays restrictions for the file manager * * @param form_filemanager $fm * @return string */ protected function fm_print_restrictions($fm) { $maxbytes = display_size($fm->options->maxbytes, 0); $strparam = (object) array('size' => $maxbytes, 'attachments' => $fm->options->maxfiles, 'areasize' => display_size($fm->options->areamaxbytes, 0)); $hasmaxfiles = !empty($fm->options->maxfiles) && $fm->options->maxfiles > 0; $hasarealimit = !empty($fm->options->areamaxbytes) && $fm->options->areamaxbytes != -1; if ($hasmaxfiles && $hasarealimit) { $maxsize = get_string('maxsizeandattachmentsandareasize', 'moodle', $strparam); } else if ($hasmaxfiles) { $maxsize = get_string('maxsizeandattachments', 'moodle', $strparam); } else if ($hasarealimit) { $maxsize = get_string('maxsizeandareasize', 'moodle', $strparam); } else { $maxsize = get_string('maxfilesize', 'moodle', $maxbytes); } return '<span>'. $maxsize . '</span>'; } /** * Template for FilePicker with general layout (not QuickUpload). * * * @return string */ protected function fp_js_template_generallayout() { return $this->render_from_template('core/filemanager_modal_generallayout', []); } /** * FilePicker JS template for displaying one file in 'icon view' mode. * * the element with class 'fp-thumbnail' will be resized to the repository thumbnail size * (both width and height, unless min-width and/or min-height is set in CSS) and the content of * an element will be replaced with an appropriate img; * * the width of element with class 'fp-filename' will be set to the repository thumbnail width * (unless min-width is set in css) and the content of an element will be replaced with filename * supplied by repository; * * top element(s) will have class fp-folder if the element is a folder; * * List of files will have parent <div> element with class 'fp-iconview' * * @return string */ protected function fp_js_template_iconfilename() { $rv = ' <a class="fp-file" href="#" > <div style="position:relative;"> <div class="fp-thumbnail"></div> <div class="fp-reficons1"></div> <div class="fp-reficons2"></div> </div> <div class="fp-filename-field"> <p class="fp-filename text-truncate"></p> </div> </a>'; return $rv; } /** * FilePicker JS template for displaying file name in 'table view' and 'tree view' modes. * * content of the element with class 'fp-icon' will be replaced with an appropriate img; * * content of element with class 'fp-filename' will be replaced with filename supplied by * repository; * * top element(s) will have class fp-folder if the element is a folder; * * Note that tree view and table view are the YUI widgets and therefore there are no * other templates. The widgets will be wrapped in <div> with class fp-treeview or * fp-tableview (respectfully). * * @return string */ protected function fp_js_template_listfilename() { $rv = ' <span class="fp-filename-icon"> <a href="#"> <span class="fp-icon"></span> <span class="fp-filename"></span> </a> </span>'; return $rv; } /** * FilePicker JS template for displaying link/loading progress for fetching of the next page * * This text is added to .fp-content AFTER .fp-iconview/.fp-treeview/.fp-tableview * * Must have one parent element with class 'fp-nextpage'. It will be assigned additional * class 'loading' during loading of the next page (it is recommended that in this case the link * becomes unavailable). Also must contain one element <a> or <button> that will hold * onclick event for displaying of the next page. The event will be triggered automatically * when user scrolls to this link. * * @return string */ protected function fp_js_template_nextpage() { $rv = ' <div class="fp-nextpage"> <div class="fp-nextpage-link"><a href="#">'.get_string('more').'</a></div> <div class="fp-nextpage-loading"> ' . $this->pix_icon('i/loading_small', '') . ' </div> </div>'; return $rv; } /** * FilePicker JS template for window appearing to select a file. * * @return string */ protected function fp_js_template_selectlayout() { $context = [ 'licensehelpicon' => $this->create_license_help_icon_context() ]; return $this->render_from_template('core/filemanager_selectlayout', $context); } /** * FilePicker JS template for 'Upload file' repository * * @return string */ protected function fp_js_template_uploadform() { $context = [ 'licensehelpicon' => $this->create_license_help_icon_context() ]; return $this->render_from_template('core/filemanager_uploadform', $context); } /** * FilePicker JS template to display during loading process (inside element with class 'fp-content'). * * @return string */ protected function fp_js_template_loading() { return ' <div class="fp-content-loading"> <div class="fp-content-center"> ' . $this->pix_icon('i/loading_small', '') . ' </div> </div>'; } /** * FilePicker JS template for error (inside element with class 'fp-content'). * * must have element with class 'fp-error', its content will be replaced with error text * and the error code will be assigned as additional class to this element * used errors: invalidjson, nofilesavailable, norepositoriesavailable * * @return string */ protected function fp_js_template_error() { $rv = ' <div class="fp-content-error" ><div class="fp-error"></div></div>'; return $rv; } /** * FilePicker JS template for error/info message displayed as a separate popup window. * * Must be wrapped in one element, CSS for this element must define * width and height of the window. It will be assigned with an additional class 'fp-msg-error' * or 'fp-msg-info' depending on message type; * * content of element with class 'fp-msg-text' will be replaced with error/info text; * * element with class 'fp-msg-butok' will hold onclick event * * @return string */ protected function fp_js_template_message() { $rv = ' <div class="file-picker fp-msg" role="alertdialog" aria-live="assertive" aria-labelledby="fp-msg-labelledby"> <p class="fp-msg-text" id="fp-msg-labelledby"></p> <button class="fp-msg-butok btn-primary btn">'.get_string('ok').'</button> </div>'; return $rv; } /** * FilePicker JS template for popup dialogue window asking for action when file with the same name already exists. * * @return string */ protected function fp_js_template_processexistingfile() { return $this->render_from_template('core/filemanager_processexistingfile', []); } /** * FilePicker JS template for popup dialogue window asking for action when file with the same name already exists * (multiple-file version). * * @return string */ protected function fp_js_template_processexistingfilemultiple() { return $this->render_from_template('core/filemanager_processexistingfilemultiple', []); } /** * FilePicker JS template for repository login form including templates for each element type * * @return string */ protected function fp_js_template_loginform() { return $this->render_from_template('core/filemanager_loginform', []); } /** * Returns all FilePicker JavaScript templates as an array. * * @return array */ public function filepicker_js_templates() { $class_methods = get_class_methods($this); $templates = array(); foreach ($class_methods as $method_name) { if (preg_match('/^fp_js_template_(.*)$/', $method_name, $matches)) $templates[$matches[1]] = $this->$method_name(); } return $templates; } /** * Returns HTML for default repository searchform to be passed to Filepicker * * This will be used as contents for search form defined in generallayout template * (form with id {TOOLSEARCHID}). * Default contents is one text input field with name="s" */ public function repository_default_searchform() { return $this->render_from_template('core/filemanager_default_searchform', []); } /** * Create the context for rendering help icon with license links displaying all licenses and sources. * * @return \stdClass $iconcontext the context for rendering license help info. */ protected function create_license_help_icon_context(): stdClass { $licensecontext = new stdClass(); $licenses = []; // Discard licenses without a name or source from enabled licenses. foreach (license_manager::get_active_licenses() as $license) { if (!empty($license->fullname) && !empty($license->source)) { $licenses[] = $license; } } $licensecontext->licenses = $licenses; $helptext = $this->render_from_template('core/filemanager_licenselinks', $licensecontext); $iconcontext = new stdClass(); $iconcontext->text = $helptext; $iconcontext->alt = get_string('helpprefix2', 'moodle', get_string('chooselicense', 'repository')); return $iconcontext; } } /** * Data structure representing a general moodle file tree viewer * * @copyright 2010 Dongsheng Cai * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.0 */ class files_tree_viewer implements renderable { public $tree; public $path; public $context; /** @var array file tree viewer options. */ protected array $options = []; /** * Constructor of moodle_file_tree_viewer class * @param file_info $file_info * @param array $options */ public function __construct(file_info $file_info, ?array $options = null) { global $CFG; //note: this MUST NOT use get_file_storage() !!!!!!!!!!!!!!!!!!!!!!!!!!!! $this->options = (array)$options; $this->context = $options['context']; $this->tree = array(); $children = $file_info->get_children(); $current_file_params = $file_info->get_params(); $parent_info = $file_info->get_parent(); $level = $parent_info; $this->path = array(); while ($level) { $params = $level->get_params(); $context = context::instance_by_id($params['contextid']); // $this->context is current context if ($context->id != $this->context->id or empty($params['filearea'])) { break; } // unset unused parameters unset($params['component']); unset($params['filearea']); unset($params['filename']); unset($params['itemid']); $url = new moodle_url('/files/index.php', $params); $this->path[] = html_writer::link($url, $level->get_visible_name()); $level = $level->get_parent(); } $this->path = array_reverse($this->path); if ($current_file_params['filepath'] != '/') { $this->path[] = $file_info->get_visible_name(); } foreach ($children as $child) { $filedate = $child->get_timemodified(); $filesize = $child->get_filesize(); $mimetype = $child->get_mimetype(); $params = $child->get_params(); unset($params['component']); unset($params['filearea']); unset($params['filename']); unset($params['itemid']); $fileitem = array( 'params' => $params, 'filename' => $child->get_visible_name(), 'mimetype' => $child->get_mimetype(), 'filedate' => $filedate ? $filedate : '', 'filesize' => $filesize ? $filesize : '' ); $url = new moodle_url('/files/index.php', $params); if ($child->is_directory()) { $fileitem['isdir'] = true; $fileitem['url'] = $url->out(false); } else { $fileitem['url'] = $child->get_url(); } $this->tree[] = $fileitem; } } } PK b<�\���l� � index.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Moodle file tree viewer based on YUI2 Treeview * * @package core * @subpackage file * @copyright 2010 Dongsheng Cai <dongsheng@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require('../config.php'); $contextid = optional_param('contextid', 0, PARAM_INT); $filepath = optional_param('filepath', '', PARAM_PATH); $filename = optional_param('filename', '', PARAM_FILE); // hard-coded to course legacy area $component = 'course'; $filearea = 'legacy'; $itemid = 0; if (empty($contextid)) { $contextid = context_course::instance(SITEID)->id; } $PAGE->set_url('/files/index.php', array('contextid'=>$contextid, 'filepath'=>$filepath, 'filename'=>$filename)); navigation_node::override_active_url(new moodle_url('/files/index.php', array('contextid'=>$contextid))); if ($filepath === '') { $filepath = null; } if ($filename === '') { $filename = null; } list($context, $course, $cm) = get_context_info_array($contextid); $PAGE->set_context($context); require_login($course, false, $cm); require_capability('moodle/course:managefiles', $context); $browser = get_file_browser(); $file_info = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $strfiles = get_string("files"); if ($node = $PAGE->settingsnav->find('coursefiles', navigation_node::TYPE_SETTING)) { $node->make_active(); } else { $PAGE->navbar->add($strfiles); } $PAGE->set_title("$course->shortname: $strfiles"); $PAGE->set_heading($course->fullname); $PAGE->set_pagelayout('incourse'); $output = $PAGE->get_renderer('core', 'files'); echo $output->header(); echo $output->box_start(); if ($file_info) { $options = array(); $options['context'] = $context; //$options['visible_areas'] = array('backup'=>array('section', 'course'), 'course'=>array('legacy'), 'user'=>array('backup')); echo $output->files_tree_viewer($file_info, $options); } else { echo $output->notification(get_string('nofilesavailable', 'repository')); } echo $output->box_end(); echo $output->footer(); PK b<�\&ٸ� � coursefilesedit_form.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. require_once($CFG->libdir.'/formslib.php'); class coursefiles_edit_form extends moodleform { function definition() { global $CFG; $maxfiles = 0; $subdirs = 0; if ($CFG->legacyfilesaddallowed) { $maxfiles = -1; $subdirs = 1; } $mform =& $this->_form; $contextid = $this->_customdata['contextid']; $options = array('subdirs' => $subdirs, 'maxfiles' => $maxfiles, 'accepted_types'=>'*'); $mform->addElement('filemanager', 'files_filemanager', '', null, $options); $mform->addElement('hidden', 'contextid', $this->_customdata['contextid']); $mform->setType('contextid', PARAM_INT); $this->set_data($this->_customdata['data']); $this->add_action_buttons(true); } } PK b<�\K�C � � ( tests/behat/add_custom_file_type.featurenu �[��� @core @core_files @_file_upload Feature: Add a new custom file type In order to add files of a custom type As an admin I need to add a new custom file type @javascript Scenario: Add custom file type Given the following "courses" exist: | fullname | shortname | category | legacyfiles | | Course 1 | C1 | 0 | 2 | And the following "users" exist: | username | firstname | lastname | email | | teacher1 | Teacher | 1 | teacher1@example.com | And the following "course enrolments" exist: | user | course | role | | teacher1 | C1 | editingteacher | And I log in as "admin" And I navigate to "Server > File types" in site administration And I press "Add a new file type" And I set the following fields to these values: | Extension | mdlr | | MIME type | application/x-moodle-rules | | File icon | document | | Description type | Custom description specified in this form | | Custom description | Moodle rules | And I press "Save changes" And I should see "application/x-moodle-rules" And I log in as "teacher1" When I add a resource activity to course "Course 1" section "1" and I fill the form with: | Name | Test file | | Select files | files/tests/fixtures/custom_filetype.mdlr | | Show size | 1 | | Show type | 1 | | Display resource description | 1 | And I am on "Course 1" course homepage Then I should see "Test file" And I should see "MDLR" in the "span.activitybadge" "css_element" And I should not see "MDLR" in the "span.resourcelinkdetails" "css_element" PK b<�\Ʀ� � � & tests/behat/license_help_modal.featurenu �[��� @core @core_files Feature: View licence links In order to get select the applicable licence when uploading a file As a user I need to be able to navigate to a page containing licence terms from the file manager Background: Given the following "blocks" exist: | blockname | contextlevel | reference | pagetypepattern | defaultregion | | private_files | System | 1 | my-index | side-post | @javascript Scenario: Uploading a file displays licence list modal Given I log in as "admin" And I follow "Manage private files..." And I follow "Add..." And I follow "Upload a file" And I click on "Help with Choose licence" "icon" in the "File picker" "dialogue" Then I should see "Follow these links for further information on the available licence options:" @javascript @_file_upload Scenario: Altering a file should display licence list modal Given I log in as "admin" And I follow "Manage private files..." And I upload "lib/tests/fixtures/empty.txt" file to "Files" filemanager And I press "Save changes" And I follow "Manage private files..." And I click on "empty.txt" "link" in the "Manage private files" "dialogue" And I click on "Help with Choose licence" "icon" Then I should see "Follow these links for further information on the available licence options:" @javascript @_file_upload Scenario: Recent files should display licence list modal Given I log in as "admin" And I follow "Manage private files..." And I upload "lib/tests/fixtures/empty.txt" file to "Files" filemanager And I press "Save changes" And I follow "Manage private files..." And I follow "Add..." And I click on "Recent files" "link" in the "File picker" "dialogue" And I click on "empty.txt" "link" in the "File picker" "dialogue" And I click on "Help with Choose licence" "icon" in the ".fp-setlicense" "css_element" Then I should see "Follow these links for further information on the available licence options:" @javascript @_file_upload Scenario: Private files should display licence list modal Given I log in as "admin" And I follow "Manage private files..." And I upload "lib/tests/fixtures/empty.txt" file to "Files" filemanager And I press "Save changes" And I follow "Manage private files..." And I follow "Add..." And I click on "Private files" "link" in the "File picker" "dialogue" And I click on "empty.txt" "link" in the "File picker" "dialogue" And I click on "Help with Choose licence" "icon" in the ".fp-setlicense" "css_element" Then I should see "Follow these links for further information on the available licence options:" PK b<�\.K8� tests/behat/course_files.featurenu �[��� @core @core_files Feature: Course files In order to add legacy files As a user I need to upload files @javascript Scenario: Add legacy files Given the following "courses" exist: | fullname | shortname | category | legacyfiles | | Course 1 | C1 | 0 | 2 | And the following config values are set as admin: | legacyfilesinnewcourses | 1 | | legacyfilesaddallowed | 1 | When I log in as "admin" And I am on "Course 1" course homepage Then I navigate to "Legacy course files" in current page administration And I press "Edit legacy course files" And "Add..." "link" should be visible And "Create folder" "link" should be visible @javascript Scenario: Add legacy file disabled Given the following "courses" exist: | fullname | shortname | category | legacyfiles | | Course 1 | C1 | 0 | 2 | And the following config values are set as admin: | legacyfilesinnewcourses | 1 | | legacyfilesaddallowed | 0 | When I log in as "admin" And I am on "Course 1" course homepage Then I navigate to "Legacy course files" in current page administration And I press "Edit legacy course files" And "Add..." "link" should not be visible And "Create folder" "link" should not be visible PK b<�\�J�� � 4 tests/classes/hook/before_file_created_callbacks.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\tests\hook; /** * Helper class for before_file_created hooks. * * @package core_files * @copyright 2024 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class before_file_created_callbacks { /** * Before file created hook callback for testing. * * @param \core_files\hook\before_file_created $hook */ public static function before_file_created(\core_files\hook\before_file_created $hook): void { // phpcs:disable moodle.NamingConventions.ValidVariableName.VariableNameLowerCase global $TESTCALLBACK; if (!isset($TESTCALLBACK)) { return; } call_user_func($TESTCALLBACK, $hook); } } PK b<�\d�t_ 6 tests/classes/redactor/services/dummy_file_service.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\tests\redactor\services; use core_files\redactor\services\file_redactor_service_interface; use core_files\redactor\services\service; /** * Dummy service for testing only. * * @package core * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class dummy_file_service extends service implements file_redactor_service_interface { #[\Override] public function redact_file_by_content(string $mimetype, string $filecontent): string { return "redacted:{$filecontent}"; } #[\Override] public function redact_file_by_path(string $mimetype, string $filepath): string { return "/redacted{$filepath}"; } /** * Returns true if the service is enabled, and "false" if it is not. * * @return bool */ public function is_enabled(): bool { return true; } /** * Determines whether a certain mime-type is supported by the service. * It will return true if the mime-type is supported, and false if it is not. * * @param string $mimetype * @return bool */ public function is_mimetype_supported(string $mimetype): bool { if (str_starts_with($mimetype, 'image/')) { return true; } return false; } /** * Adds settings to the provided admin settings page. * * @param \admin_settingpage $settings The admin settings page to which settings are added. */ public static function add_settings(\admin_settingpage $settings): void { // The function body. } } PK b<�\{���/ / , tests/external/stored_file_exporter_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\external; use advanced_testcase; use context_user; /** * Unit tests for stored file exporter * * @package core_files * @covers \core_files\external\stored_file_exporter * @copyright 2023 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class stored_file_exporter_test extends advanced_testcase { /** * Test exported data structure */ public function test_export(): void { global $PAGE, $USER, $CFG; $this->resetAfterTest(); $this->setAdminUser(); $contextuser = context_user::instance($USER->id); $file = get_file_storage()->create_file_from_string([ 'contextid' => $contextuser->id, 'userid' => $USER->id, 'component' => 'user', 'filearea' => 'draft', 'itemid' => file_get_unused_draft_itemid(), 'filepath' => '/', 'filename' => 'Hi.txt', ], 'Hello'); $exporter = new stored_file_exporter($file, ['context' => $contextuser]); $export = $exporter->export($PAGE->get_renderer('core')); $this->assertEquals((object) [ 'contextid' => $file->get_contextid(), 'component' => $file->get_component(), 'filearea' => $file->get_filearea(), 'itemid' => $file->get_itemid(), 'filepath' => $file->get_filepath(), 'filename' => $file->get_filename(), 'isdir' => false, 'isimage' => false, 'timemodified' => $file->get_timemodified(), 'timecreated' => $file->get_timecreated(), 'filesize' => $file->get_filesize(), 'author' => $file->get_author(), 'license' => $file->get_license(), 'filenameshort' => $file->get_filename(), 'filesizeformatted' => display_size($file->get_filesize()), 'icon' => 'f/text', 'timecreatedformatted' => userdate($file->get_timecreated()), 'timemodifiedformatted' => userdate($file->get_timemodified()), 'url' => "{$CFG->wwwroot}/pluginfile.php/{$contextuser->id}/user/draft/{$file->get_itemid()}/Hi.txt?forcedownload=1", ], $export); } /** * Data provider for {@see test_export_filenameshort} * * @return array[] */ public static function export_filenameshort_provider(): array { return [ // Long filenames (30 characters), with extensions of varying length. ['Lorem ipsum dolor sit amet sit.c', 'Lorem ipsum dolor sit...c'], ['Lorem ipsum dolor sit amet sit.txt', 'Lorem ipsum dolor s...txt'], ['Lorem ipsum dolor sit amet sit.docx', 'Lorem ipsum dolor ...docx'], // Multi-byte filenames. ['Мазитов А.З. практика тусур.py', 'Мазитов А.З. практик...py'], ]; } /** * Test exporting shortened filename * * @param string $filename * @param string $expected * * @dataProvider export_filenameshort_provider */ public function test_export_filenameshort(string $filename, string $expected): void { global $PAGE, $USER; $this->resetAfterTest(); $this->setAdminUser(); $contextuser = context_user::instance($USER->id); $file = get_file_storage()->create_file_from_string([ 'contextid' => $contextuser->id, 'userid' => $USER->id, 'component' => 'user', 'filearea' => 'draft', 'itemid' => file_get_unused_draft_itemid(), 'filepath' => '/', 'filename' => $filename, ], 'Hello'); $exporter = new stored_file_exporter($file, ['context' => $contextuser]); $export = $exporter->export($PAGE->get_renderer('core')); $this->assertEquals($expected, $export->filenameshort); } } PK b<�\�G� � ' tests/hook/before_file_created_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\hook; use coding_exception; /** * Tests for before_file_created hook. * * @package core_files * @category test * @copyright 2024 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \core_files\hook\before_file_created */ final class before_file_created_test extends \advanced_testcase { public function test_init_with_file_and_content_throws_exception(): void { $this->expectException(\InvalidArgumentException::class); $this->expectExceptionMessage('Only one of $filepath or $filecontent can be set'); new before_file_created(new \stdClass(), 'path', 'content'); } public function test_init_with_no_file_and_no_content_throws_exception(): void { $this->expectException(\InvalidArgumentException::class); $this->expectExceptionMessage('Either $filepath or $filecontent must be set'); new before_file_created(new \stdClass()); } public function test_content_updated(): void { $hook = new before_file_created(new \stdClass(), filecontent: 'data'); $this->assertFalse($hook->has_changed()); $this->assertTrue($hook->has_filecontent()); $this->assertFalse($hook->has_filepath()); $hook->update_filecontent('data'); $this->assertEquals('data', $hook->get_filecontent()); $this->assertFalse($hook->has_changed()); $this->assertNull($hook->get_filepath()); $hook->update_filecontent('new data'); $this->assertEquals('new data', $hook->get_filecontent()); $this->assertTrue($hook->has_changed()); $this->assertNull($hook->get_filepath()); } public function test_file_updated(): void { $initialdata = self::get_fixture_path('core_files', 'hook/before_file_created_hooks.php'); $newdata = __FILE__; $hook = new before_file_created( new \stdClass(), filepath: $initialdata, ); $this->assertFalse($hook->has_changed()); $this->assertFalse($hook->has_filecontent()); $this->assertTrue($hook->has_filepath()); $hook->update_filepath($initialdata); $this->assertNull($hook->get_filecontent()); $this->assertEquals($initialdata, $hook->get_filepath()); $this->assertFalse($hook->has_changed()); $hook->update_filepath($newdata); $this->assertNull($hook->get_filecontent()); $this->assertEquals($newdata, $hook->get_filepath()); $this->assertTrue($hook->has_changed()); } public function test_cannot_update_file_when_content_set(): void { $hook = new before_file_created(new \stdClass(), filecontent: 'data'); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Cannot update file path when the file path is not set'); $hook->update_filepath('new path'); } public function test_cannot_update_content_when_file_ste(): void { $hook = new before_file_created(new \stdClass(), filepath: __FILE__); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Cannot update file content when the file content is not set'); $hook->update_filecontent('new path'); } } PK b<�\_v0S� � 1 tests/fixtures/hook/before_file_created_hooks.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * A hook listener for tests realting to the before_file_created hook. * * @package core_files * @copyright 2024 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $callbacks = [ [ 'hook' => \core_files\hook\before_file_created::class, 'callback' => [ \core_files\tests\hook\before_file_created_callbacks::class, 'before_file_created', ], ], ]; PK b<�\�zq�, , tests/fixtures/awesome_file.txtnu �[��� Hey, this is an awesome text file. Hello! :)PK b<�\̱��I I # tests/fixtures/redactor/topleft.jpgnu �[��� ��� JFIF � � �� "Exif II* ��`ICC_PROFILE Plcms0 mntrRGB XYZ � &acspAPPL �� �-lcms desc 8cprt @ Nwtpt � chad � ,rXYZ � bXYZ � gXYZ � rTRC gTRC bTRC chrm , $mluc enUS s R G B b u i l t - i n mluc enUS 2 N o c o p y r i g h t , u s e f r e e l y XYZ �� �-sf32 J ��* � ���������� � ��XYZ o� 8� �XYZ $� � ��XYZ b� �� �para ff � Y � [chrm �� T{ L� �� &f \�� C % # , #&')*) -0-(0%()(�� P 0 �� �� �� ? ʀ � �b� �`*��`*��b� �b� �b� �b� ��PK b<�\��/� � $ tests/fixtures/redactor/righttop.jpgnu �[��� ��� JFIF � � �� "Exif II* �� C # %&# , )*)'-0- %0()((�� 0 P �� �� � } !1AQa"q2���#B��R��$3br� %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz������������������������������������������������������������������������ ? �R��T��(��+�T��(��+�T��*��J(��*��J+�T��+�(��(��(��(��(���PK b<�\z���$ �$ ! tests/fixtures/redactor/dummy.jpgnu �[��� ��� JFIF ,, ���Exif II* � � � � � ( 1 � 2 � i� %� � NIKON COOLPIX P6000 , , Nikon Transfer 1.1 W 2008:11:01 21:15:08 �� � �� � "� '� @ � 0220� � � � � � � � � � � � � |� � � �� � � 0100� � � � � � � � � � � � � M � � � � � � ` / 2008:10:22 16:38:20 2008:10:22 16:38:20 � P S Nikon II* # 0210 � � � � � � � � � � ! � " ) / � � � � � � � � � * � � < � � B � � V � b � j � p � : z � � " � COLOR FINE AUTO NORMAL AF-S i$ � AUTO 1.0 a1 R� 0h k +X +X � (� � � @/ 3+ 3C."7 H � �k' $ """" ������6�� ���^ �pF R < � < � < H �V��A :3���6 ��� � � � � �D� �f n� �� ! �`?� !$_&>&6 wwww �J �Nf =T d ������ X �, � �rZXY ( �. �2 �2�2 r -2 , � e�A �� �f �� ��������������������`?� �� ���� j j j � /. 1~ ���� ��� ���� ES]qd <Nesk �Y�� x�CV AO]cd �T�Gj 5v��� ���� �J=> .n�{k � ���� ���� �� ��������������� �� ���: �l��6 � 0 peo� � � � � * �4 � � � � � � * �4 � �)! � ' �" � � �1; �$ �' � �'/ � � * � � �( � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � qJkRAfzq_[l�mJPqJkRAfzq_[l�mJP��[PbS�[z8mw{X<T�|A�y��y3��edDL�jd�=@lrf8||�qFQ�n��>NAK46\BxiGTYSVYA<1S52^TNPMRCB:FE;.T:,ZXLFQRSS;WZ<]_XYXYNPPRZ[9]T<XW`Z_[baY[bc9^T;TZ\YPWSOTU?M<>N;QRNNKKHHGGAA:?=<?>>>?=??=>BB>?D>@DBAACAA?@ABBDDDBCB@@D??=>AAA@BADCBCBBAB>? @� NORMAL NORMAL OFF DC OFF NORMAL VR-ON NORMAL 0100STANDARD STANDARD � ������COOLPIX P6000V1.0 ASCII N h E � � 06 � � + � � 5 y � $ s d WGS-84 2008:10:23 ���http://ns.adobe.com/xap/1.0/ <?xpacket begin='' id='W5M0MpCehiHzreSzNTczkc9d'?> <x:xmpmeta xmlns:x='adobe:ns:meta/'> <rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'> <rdf:Description rdf:about='' xmlns:MicrosoftPhoto='http://ns.microsoft.com/photo/1.0'> <MicrosoftPhoto:Rating>0</MicrosoftPhoto:Rating> </rdf:Description> <rdf:Description rdf:about='' xmlns:exif='http://ns.adobe.com/exif/1.0/'> <exif:ComponentsConfiguration> <rdf:Seq> <rdf:li>1</rdf:li> <rdf:li>2</rdf:li> <rdf:li>3</rdf:li> <rdf:li>0</rdf:li> </rdf:Seq> </exif:ComponentsConfiguration> <exif:Flash rdf:parseType='Resource'> <exif:Fired>False</exif:Fired> <exif:Function>False</exif:Function> <exif:Mode>2</exif:Mode> <exif:RedEyeMode>False</exif:RedEyeMode> <exif:Return>0</exif:Return> </exif:Flash> <exif:GPSTimeStamp>2008-10-23T14:36:47.23Z</exif:GPSTimeStamp> </rdf:Description> <rdf:Description rdf:about='' xmlns:exifEX='http://cipa.jp/exif/1.0/'> <exifEX:InteroperabilityIndex>R98</exifEX:InteroperabilityIndex> </rdf:Description> <rdf:Description rdf:about='' xmlns:tiff='http://ns.adobe.com/tiff/1.0/'> <tiff:BitsPerSample> <rdf:Seq> <rdf:li>8</rdf:li> </rdf:Seq> </tiff:BitsPerSample> <tiff:Compression>6</tiff:Compression> <tiff:ImageLength>480</tiff:ImageLength> <tiff:ImageWidth>640</tiff:ImageWidth> <tiff:YCbCrPositioning>1</tiff:YCbCrPositioning> <tiff:YCbCrSubSampling> <rdf:Seq> <rdf:li>2</rdf:li> <rdf:li>1</rdf:li> </rdf:Seq> </tiff:YCbCrSubSampling> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end='w'?>�� C % # , #&')*) -0-(0%()(�� C (((((((((((((((((((((((((((((((((((((((((((((((((((�� 2 d" �� �� ) !1A2"Qa3q�� �� �� ? �" """ """ """ "" ߦ^��y�W$���3�#�=��� ���" ��zk]��C��3�g)R�Qt���i����v@���쎤tw�����p����8��vFk\o(���NV1����l��;0F�~<|�l�|~��={#�ʾ�{Ƹ�X�rGfG�o��f�� �!2�� ��:�길�^z� � `qԿ�`?���z\3�.X�*���� 3M+��[ ��J_��w��}�� �������|��<�>�?� �ר�/�˸h�Zl��1��#�z�Ք��>w��� k^���E �Cc�Kl���=�3���� ��]��'cy��s-K>F�7CR ��H���� �λ�H�Ccg�[�U�eL��̔�ܯ.z|t՞\�`5����Jo�<� �9~2���ؚ�L� �����f�:iZ� K}'�a�� ��NrWA� o�8�� �_�Z6��${�wpD� ��綔8}3�re.��68l�|Q�g� Q��7X�<5�x���v������g��C;!�|�f) $�X{aq%�u�'D��|��%�p��ff/�Q�� [ R��K5�{E��X�&�[�} |��s�X|��vB6�r��r��5�\>F�H� ��捤�[����:_���va�� �������T���������������������������������PK b<�\&��� # tests/fixtures/custom_filetype.mdlrnu �[��� empty file for testing purposesPK b<�\ ��^! ^! tests/privacy/provider_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Base class for unit tests for core_cohort. * * @package core_files * @category test * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_files\privacy; defined('MOODLE_INTERNAL') || die(); use core_files\privacy\provider; use core_privacy\local\request\approved_contextlist; use core_privacy\local\request\writer; use core_privacy\tests\provider_testcase; use core_privacy\local\request\approved_userlist; /** * Unit tests for files\classes\privacy\provider.php * * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class provider_test extends provider_testcase { /** * Test getting the context for the user ID related to this plugin. */ public function test_get_contexts_for_userid(): void { $this->resetAfterTest(); // Create a user. $user = $this->getDataGenerator()->create_user(); $userctx = \context_user::instance($user->id); create_user_key('core_files', $user->id); $contextlist = provider::get_contexts_for_userid($user->id); $this->assertCount(1, (array) $contextlist->get_contextids()); $this->assertContainsEquals($userctx->id, $contextlist->get_contextids()); } /** * Test that data is exported correctly for this plugin. */ public function test_export_user_data(): void { global $DB; $this->resetAfterTest(); // Create a user. $user = $this->getDataGenerator()->create_user(); $usercontext = \context_user::instance($user->id); $keyvalue = get_user_key('core_files', $user->id); $key = $DB->get_record('user_private_key', ['value' => $keyvalue]); // Validate exported data. $this->setUser($user); $writer = writer::with_context($usercontext); $this->assertFalse($writer->has_any_data()); $this->export_context_data_for_user($user->id, $usercontext, 'core_files'); $subcontext = [ get_string('files') ]; $userkeydata = $writer->get_related_data($subcontext, 'userkeys'); $this->assertCount(1, $userkeydata->keys); $this->assertEquals($key->script, reset($userkeydata->keys)->script); } /** * Test for provider::delete_data_for_all_users_in_context(). */ public function test_delete_data_for_all_users_in_context(): void { global $DB; $this->resetAfterTest(); // Create a user. $user = $this->getDataGenerator()->create_user(); $usercontext = \context_user::instance($user->id); create_user_key('core_files', $user->id); // Before deletion, we should have 1 user_private_key. $count = $DB->count_records('user_private_key', ['script' => 'core_files']); $this->assertEquals(1, $count); // Delete data. provider::delete_data_for_all_users_in_context($usercontext); // After deletion, the user_private_key entries should have been deleted. $count = $DB->count_records('user_private_key', ['script' => 'core_files']); $this->assertEquals(0, $count); } /** * Test for provider::delete_data_for_user(). */ public function test_delete_data_for_user(): void { global $DB; $this->resetAfterTest(); // Create a user. $user = $this->getDataGenerator()->create_user(); create_user_key('core_files', $user->id); // Before deletion, we should have 1 user_private_key. $count = $DB->count_records('user_private_key', ['script' => 'core_files']); $this->assertEquals(1, $count); // Delete data. $contextlist = provider::get_contexts_for_userid($user->id); $approvedcontextlist = new approved_contextlist($user, 'core_files', $contextlist->get_contextids()); provider::delete_data_for_user($approvedcontextlist); // After deletion, the user_private_key entries should have been deleted. $count = $DB->count_records('user_private_key', ['script' => 'core_files']); $this->assertEquals(0, $count); } /** * Test that only users within a course context are fetched. */ public function test_get_users_in_context(): void { $this->resetAfterTest(); $component = 'core_files'; // Create a user. $user = $this->getDataGenerator()->create_user(); $userctx = \context_user::instance($user->id); $userlist = new \core_privacy\local\request\userlist($userctx, $component); provider::get_users_in_context($userlist); $this->assertCount(0, $userlist); create_user_key('core_files', $user->id); // The list of users within the userctx context should contain user. provider::get_users_in_context($userlist); $this->assertCount(1, $userlist); $expected = [$user->id]; $actual = $userlist->get_userids(); $this->assertEquals($expected, $actual); // The list of users within contexts different than user should be empty. $systemctx = \context_system::instance(); $userlist = new \core_privacy\local\request\userlist($systemctx, $component); provider::get_users_in_context($userlist); $this->assertCount(0, $userlist); } /** * Test that data for users in approved userlist is deleted. */ public function test_delete_data_for_users(): void { $this->resetAfterTest(); $component = 'core_files'; // Create user1. $user1 = $this->getDataGenerator()->create_user(); $userctx1 = \context_user::instance($user1->id); // Create user2. $user2 = $this->getDataGenerator()->create_user(); $userctx2 = \context_user::instance($user2->id); create_user_key('core_files', $user1->id); create_user_key('core_files', $user2->id); $userlist1 = new \core_privacy\local\request\userlist($userctx1, $component); provider::get_users_in_context($userlist1); $this->assertCount(1, $userlist1); $userlist2 = new \core_privacy\local\request\userlist($userctx2, $component); provider::get_users_in_context($userlist2); $this->assertCount(1, $userlist2); // Convert $userlist1 into an approved_contextlist. $approvedlist1 = new approved_userlist($userctx1, $component, $userlist1->get_userids()); // Delete using delete_data_for_user. provider::delete_data_for_users($approvedlist1); // Re-fetch users in userctx1. $userlist1 = new \core_privacy\local\request\userlist($userctx1, $component); provider::get_users_in_context($userlist1); // The user data in coursecategoryctx should be deleted. $this->assertCount(0, $userlist1); // Re-fetch users in userctx2. $userlist2 = new \core_privacy\local\request\userlist($userctx2, $component); provider::get_users_in_context($userlist2); // The user data in userctx2 should be still present. $this->assertCount(1, $userlist2); // Convert $userlist2 into an approved_contextlist in the system context. $systemctx = \context_system::instance(); $approvedlist3 = new approved_userlist($systemctx, $component, $userlist2->get_userids()); // Delete using delete_data_for_user. provider::delete_data_for_users($approvedlist3); // Re-fetch users in userctx2. $userlist3 = new \core_privacy\local\request\userlist($userctx2, $component); provider::get_users_in_context($userlist3); // The user data in userctx2 should not be deleted. $this->assertCount(1, $userlist3); } } PK b<�\Q r0�C �C tests/externallib_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files; use core_external\external_api; use core_files\external\delete\draft; use core_files\external\get\unused_draft; use core_files_external; defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/webservice/tests/helpers.php'); require_once($CFG->dirroot . '/files/externallib.php'); /** * PHPunit tests for external files API. * * @package core_files * @category external * @copyright 2013 Ankit Agarwal * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.6 */ final class externallib_test extends \advanced_testcase { /* * Test core_files_external::upload(). */ public function test_upload(): void { global $USER; $this->resetAfterTest(); $this->setAdminUser(); $context = \context_user::instance($USER->id); $contextid = $context->id; $component = "user"; $filearea = "draft"; $itemid = 0; $filepath = "/"; $filename = "Simple.txt"; $filecontent = base64_encode("Let us create a nice simple file"); $contextlevel = null; $instanceid = null; $browser = get_file_browser(); // Make sure no file exists. $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertEmpty($file); // Call the api to create a file. $fileinfo = core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid); $fileinfo = external_api::clean_returnvalue(core_files_external::upload_returns(), $fileinfo); // Get the created draft item id. $itemid = $fileinfo['itemid']; // Make sure the file was created. $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertNotEmpty($file); // Make sure no file exists. $filename = "Simple2.txt"; $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertEmpty($file); // Call the api to create a file. $fileinfo = core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid); $fileinfo = external_api::clean_returnvalue(core_files_external::upload_returns(), $fileinfo); $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertNotEmpty($file); // Let us try creating a file using contextlevel and instance id. $filename = "Simple5.txt"; $contextid = 0; $contextlevel = "user"; $instanceid = $USER->id; $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertEmpty($file); $fileinfo = core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid); $fileinfo = external_api::clean_returnvalue(core_files_external::upload_returns(), $fileinfo); $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertNotEmpty($file); // Make sure the same file cannot be created again. $this->expectException("moodle_exception"); core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid); } /* * Make sure only user component is allowed in core_files_external::upload(). */ public function test_upload_param_component(): void { global $USER; $this->resetAfterTest(); $this->setAdminUser(); $context = \context_user::instance($USER->id); $contextid = $context->id; $component = "backup"; $filearea = "draft"; $itemid = 0; $filepath = "/"; $filename = "Simple3.txt"; $filecontent = base64_encode("Let us create a nice simple file"); $contextlevel = null; $instanceid = null; // Make sure exception is thrown. $this->expectException("coding_exception"); core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, $contextlevel, $instanceid); } /* * Make sure only draft areas are allowed in core_files_external::upload(). */ public function test_upload_param_area(): void { global $USER; $this->resetAfterTest(); $this->setAdminUser(); $context = \context_user::instance($USER->id); $contextid = $context->id; $component = "user"; $filearea = "draft"; $itemid = file_get_unused_draft_itemid(); $filepath = "/"; $filename = "Simple4.txt"; $filecontent = base64_encode("Let us create a nice simple file"); $contextlevel = null; $instanceid = null; // Make sure the file is created. $fileinfo = core_files_external::upload($contextid, $component, $filearea, $itemid, $filepath, $filename, $filecontent, 'user', $USER->id); $fileinfo = external_api::clean_returnvalue(core_files_external::upload_returns(), $fileinfo); $browser = get_file_browser(); $file = $browser->get_file_info($context, $component, $filearea, $itemid, $filepath, $filename); $this->assertNotEmpty($file); } /** * Test getting a list of files with and without a context ID. */ public function test_get_files(): void { global $USER, $DB; $this->resetAfterTest(); // Set the current user to be the administrator. $this->setAdminUser(); $USER->email = 'test@example.com'; // Create a course. $course = $this->getDataGenerator()->create_course(); $record = new \stdClass(); $record->course = $course->id; $record->name = "Mod data upload test"; $record->intro = "Some intro of some sort"; // Create a database module. $module = $this->getDataGenerator()->create_module('data', $record); // Create a new field in the database activity. $field = data_get_field_new('file', $module); // Add more detail about the field. $fielddetail = new \stdClass(); $fielddetail->d = $module->id; $fielddetail->mode = 'add'; $fielddetail->type = 'file'; $fielddetail->sesskey = sesskey(); $fielddetail->name = 'Upload file'; $fielddetail->description = 'Some description'; $fielddetail->param3 = '0'; $field->define_field($fielddetail); $field->insert_field(); $recordid = data_add_record($module); // File information for the database module record. $datacontent = array(); $datacontent['fieldid'] = $field->field->id; $datacontent['recordid'] = $recordid; $datacontent['content'] = 'Simple4.txt'; // Insert the information about the file. $contentid = $DB->insert_record('data_content', $datacontent); // Required information for uploading a file. $context = \context_module::instance($module->cmid); $usercontext = \context_user::instance($USER->id); $component = 'mod_data'; $filearea = 'content'; $itemid = $contentid; $filename = $datacontent['content']; $filecontent = base64_encode("Let us create a nice simple file."); $filerecord = array(); $filerecord['contextid'] = $context->id; $filerecord['component'] = $component; $filerecord['filearea'] = $filearea; $filerecord['itemid'] = $itemid; $filerecord['filepath'] = '/'; $filerecord['filename'] = $filename; // Create an area to upload the file. $fs = get_file_storage(); // Create a file from the string that we made earlier. $file = $fs->create_file_from_string($filerecord, $filecontent); $timemodified = $file->get_timemodified(); $timecreated = $file->get_timemodified(); $filesize = $file->get_filesize(); // Use the web service function to return the information about the file that we just uploaded. // The first time is with a valid context ID. $filename = ''; $testfilelisting = core_files_external::get_files($context->id, $component, $filearea, $itemid, '/', $filename); $testfilelisting = external_api::clean_returnvalue(core_files_external::get_files_returns(), $testfilelisting); // With the information that we have provided we should get an object exactly like the one below. $coursecontext = \context_course::instance($course->id); $testdata = array(); $testdata['parents'] = array(); $testdata['parents']['0'] = array('contextid' => 1, 'component' => null, 'filearea' => null, 'itemid' => null, 'filepath' => null, 'filename' => 'System'); $testdata['parents']['1'] = array('contextid' => 3, 'component' => null, 'filearea' => null, 'itemid' => null, 'filepath' => null, 'filename' => get_string('defaultcategoryname')); $testdata['parents']['2'] = array('contextid' => $coursecontext->id, 'component' => null, 'filearea' => null, 'itemid' => null, 'filepath' => null, 'filename' => 'Test course 1'); $testdata['parents']['3'] = array('contextid' => $context->id, 'component' => null, 'filearea' => null, 'itemid' => null, 'filepath' => null, 'filename' => 'Mod data upload test (Database)'); $testdata['parents']['4'] = array('contextid' => $context->id, 'component' => 'mod_data', 'filearea' => 'content', 'itemid' => null, 'filepath' => null, 'filename' => 'Fields'); $testdata['files'] = array(); $testdata['files']['0'] = array('contextid' => $context->id, 'component' => 'mod_data', 'filearea' => 'content', 'itemid' => $itemid, 'filepath' => '/', 'filename' => 'Simple4.txt', 'url' => 'https://www.example.com/moodle/pluginfile.php/'.$context->id.'/mod_data/content/'.$itemid.'/Simple4.txt', 'isdir' => false, 'timemodified' => $timemodified, 'timecreated' => $timecreated, 'filesize' => $filesize, 'author' => null, 'license' => null ); // Make sure that they are the same. $this->assertEquals($testdata, $testfilelisting); // Try again but without the context. Minus one signals the function to use other variables to obtain the context. $nocontext = -1; $modified = 0; // Context level and instance ID are used to determine what the context is. $contextlevel = 'module'; $instanceid = $module->cmid; $testfilelisting = core_files_external::get_files($nocontext, $component, $filearea, $itemid, '/', $filename, $modified, $contextlevel, $instanceid); $testfilelisting = external_api::clean_returnvalue(core_files_external::get_files_returns(), $testfilelisting); $this->assertEquals($testfilelisting, $testdata); } /** * Test delete draft files */ public function test_delete_draft_files(): void { global $USER; $this->resetAfterTest(); $this->setAdminUser(); // Add files to user draft area. $draftitemid = file_get_unused_draft_itemid(); $context = \context_user::instance($USER->id); $filerecordinline = array( 'contextid' => $context->id, 'component' => 'user', 'filearea' => 'draft', 'itemid' => $draftitemid, 'filepath' => '/', 'filename' => 'faketxt.txt', ); $fs = get_file_storage(); $fs->create_file_from_string($filerecordinline, 'fake txt contents 1.'); // Now create a folder with a file inside. $fs->create_directory($context->id, 'user', 'draft', $draftitemid, '/fakefolder/'); $filerecordinline['filepath'] = '/fakefolder/'; $filerecordinline['filename'] = 'fakeimage.png'; $fs->create_file_from_string($filerecordinline, 'img...'); // Check two files were created (one file and one directory). $files = core_files_external::get_files($context->id, 'user', 'draft', $draftitemid, '/', ''); $files = external_api::clean_returnvalue(core_files_external::get_files_returns(), $files); $this->assertCount(2, $files['files']); // Check the folder has one file. $files = core_files_external::get_files($context->id, 'user', 'draft', $draftitemid, '/fakefolder/', ''); $files = external_api::clean_returnvalue(core_files_external::get_files_returns(), $files); $this->assertCount(1, $files['files']); // Delete a file and a folder. $filestodelete = [ ['filepath' => '/', 'filename' => 'faketxt.txt'], ['filepath' => '/fakefolder/', 'filename' => ''], ]; $paths = draft::execute($draftitemid, $filestodelete); $paths = external_api::clean_returnvalue(draft::execute_returns(), $paths); // Check everything was deleted. $files = core_files_external::get_files($context->id, 'user', 'draft', $draftitemid, '/', ''); $files = external_api::clean_returnvalue(core_files_external::get_files_returns(), $files); $this->assertCount(0, $files['files']); } /** * Test get_unused_draft_itemid. */ public function test_get_unused_draft_itemid(): void { global $USER; $this->resetAfterTest(); $this->setAdminUser(); // Add files to user draft area. $result = unused_draft::execute(); $result = external_api::clean_returnvalue(unused_draft::execute_returns(), $result); $filerecordinline = [ 'contextid' => $result['contextid'], 'component' => $result['component'], 'filearea' => $result['filearea'], 'itemid' => $result['itemid'], 'filepath' => '/', 'filename' => 'faketxt.txt', ]; $fs = get_file_storage(); $fs->create_file_from_string($filerecordinline, 'fake txt contents 1.'); // Now create a folder with a file inside. $fs->create_directory($result['contextid'], $result['component'], $result['filearea'], $result['itemid'], '/fakefolder/'); $filerecordinline['filepath'] = '/fakefolder/'; $filerecordinline['filename'] = 'fakeimage.png'; $fs->create_file_from_string($filerecordinline, 'img...'); $context = \context_user::instance($USER->id); // Check two files were created (one file and one directory). $files = core_files_external::get_files($context->id, 'user', 'draft', $result['itemid'], '/', ''); $files = external_api::clean_returnvalue(core_files_external::get_files_returns(), $files); $this->assertCount(2, $files['files']); } } PK b<�\ŀ:`} `} tests/converter_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * PHPUnit tests for fileconverter API. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); global $CFG; use core_files\conversion; use core_files\converter; /** * PHPUnit tests for fileconverter API. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class converter_test extends advanced_testcase { /** * Get a testable mock of the abstract files_converter class. * * @param array $mockedmethods A list of methods you intend to override * If no methods are specified, only abstract functions are mocked. * @return \core_files\converter */ protected function get_testable_mock($mockedmethods = []) { $converter = $this->getMockBuilder(\core_files\converter::class) ->onlyMethods($mockedmethods) ->getMockForAbstractClass(); return $converter; } /** * Get a testable mock of the conversion. * * @param array $mockedmethods A list of methods you intend to override * @return \core_files\conversion */ protected function get_testable_conversion($mockedmethods = []) { $conversion = $this->getMockBuilder(\core_files\conversion::class) ->onlyMethods($mockedmethods) ->setConstructorArgs([0, (object) []]) ->getMock(); return $conversion; } /** * Get a testable mock of the abstract files_converter class. * * @param array $mockedmethods A list of methods you intend to override * If no methods are specified, only abstract functions are mocked. * @return \core_files\converter_interface */ protected function get_mocked_converter($mockedmethods = []) { $converter = $this->getMockBuilder(\core_files\converter_interface::class) ->onlyMethods($mockedmethods) ->getMockForAbstractClass(); return $converter; } /** * Helper to create a stored file objectw with the given supplied content. * * @param string $filecontent The content of the mocked file * @param string $filename The file name to use in the stored_file * @param array $mockedmethods A list of methods you intend to override * If no methods are specified, only abstract functions are mocked. * @return stored_file */ protected function get_stored_file($filecontent = 'content', $filename = null, $filerecord = [], $mockedmethods = []) { global $CFG; $contenthash = sha1($filecontent); if (empty($filename)) { $filename = $contenthash; } $filerecord['contenthash'] = $contenthash; $filerecord['filesize'] = strlen($filecontent); $filerecord['filename'] = $filename; $filerecord['id'] = 42; $file = $this->getMockBuilder(stored_file::class) ->onlyMethods($mockedmethods) ->setConstructorArgs([get_file_storage(), (object) $filerecord]) ->getMock(); return $file; } /** * Helper to create a stored file object with the given supplied content. * * @param string $filecontent The content of the mocked file * @param string $filename The file name to use in the stored_file * @param string $filerecord Any overrides to the filerecord * @return stored_file */ protected function create_stored_file($filecontent = 'content', $filename = 'testfile.txt', $filerecord = []) { $filerecord = array_merge([ 'contextid' => context_system::instance()->id, 'component' => 'core', 'filearea' => 'unittest', 'itemid' => 0, 'filepath' => '/', 'filename' => $filename, ], $filerecord); $fs = get_file_storage(); $file = $fs->create_file_from_string($filerecord, $filecontent); return $file; } /** * Get a mock of the file_storage API. * * @param array $mockedmethods A list of methods you intend to override * @return file_storage */ protected function get_file_storage_mock($mockedmethods = []) { $fs = $this->getMockBuilder(\file_storage::class) ->onlyMethods($mockedmethods) ->disableOriginalConstructor() ->getMock(); return $fs; } /** * Test the start_conversion function. */ public function test_start_conversion_existing_single(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $first = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $first->create(); $converter = $this->get_testable_mock(['poll_conversion']); $conversion = $converter->start_conversion($sourcefile, 'pdf', false); // The old conversions should still be present and match the one returned. $this->assertEquals($first->get('id'), $conversion->get('id')); } /** * Test the start_conversion function. */ public function test_start_conversion_existing_multiple(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $first = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $first->create(); $second = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $second->create(); $converter = $this->get_testable_mock(['poll_conversion']); $conversion = $converter->start_conversion($sourcefile, 'pdf', false); // The old conversions should have been removed. $this->assertFalse(conversion::get_record(['id' => $first->get('id')])); $this->assertFalse(conversion::get_record(['id' => $second->get('id')])); } /** * Test the start_conversion function. */ public function test_start_conversion_no_existing(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $converter = $this->get_testable_mock(['poll_conversion']); $conversion = $converter->start_conversion($sourcefile, 'pdf', false); $this->assertInstanceOf(\core_files\conversion::class, $conversion); } /** * Test the get_document_converter_classes function with no enabled plugins. */ public function test_get_document_converter_classes_no_plugins(): void { $converter = $this->get_testable_mock(['get_enabled_plugins']); $converter->method('get_enabled_plugins')->willReturn([]); $method = new ReflectionMethod(\core_files\converter::class, 'get_document_converter_classes'); $result = $method->invokeArgs($converter, ['docx', 'pdf']); $this->assertEmpty($result); } /** * Test the get_document_converter_classes function when no class was found. */ public function test_get_document_converter_classes_plugin_class_not_found(): void { $converter = $this->get_testable_mock(['get_enabled_plugins']); $converter->method('get_enabled_plugins')->willReturn([ 'noplugin' => '\not\a\real\plugin', ]); $method = new ReflectionMethod(\core_files\converter::class, 'get_document_converter_classes'); $result = $method->invokeArgs($converter, ['docx', 'pdf']); $this->assertEmpty($result); } /** * Test the get_document_converter_classes function when the returned classes do not meet requirements. */ public function test_get_document_converter_classes_plugin_class_requirements_not_met(): void { $plugin = $this->getMockBuilder(\core_file_converter_requirements_not_met::class) ->onlyMethods([]) ->getMock(); $converter = $this->get_testable_mock(['get_enabled_plugins']); $converter->method('get_enabled_plugins')->willReturn([ 'test_plugin' => get_class($plugin), ]); $method = new ReflectionMethod(\core_files\converter::class, 'get_document_converter_classes'); $result = $method->invokeArgs($converter, ['docx', 'pdf']); $this->assertEmpty($result); } /** * Test the get_document_converter_classes function when the returned classes do not meet requirements. */ public function test_get_document_converter_classes_plugin_class_met_not_supported(): void { $plugin = $this->getMockBuilder(\core_file_converter_type_not_supported::class) ->onlyMethods([]) ->getMock(); $converter = $this->get_testable_mock(['get_enabled_plugins']); $converter->method('get_enabled_plugins')->willReturn([ 'test_plugin' => get_class($plugin), ]); $method = new ReflectionMethod(\core_files\converter::class, 'get_document_converter_classes'); $result = $method->invokeArgs($converter, ['docx', 'pdf']); $this->assertEmpty($result); } /** * Test the get_document_converter_classes function when the returned classes do not meet requirements. */ public function test_get_document_converter_classes_plugin_class_met_and_supported(): void { $plugin = $this->getMockBuilder(\core_file_converter_type_supported::class) ->onlyMethods([]) ->getMock(); $classname = get_class($plugin); $converter = $this->get_testable_mock(['get_enabled_plugins']); $converter->method('get_enabled_plugins')->willReturn([ 'test_plugin' => $classname, ]); $method = new ReflectionMethod(\core_files\converter::class, 'get_document_converter_classes'); $result = $method->invokeArgs($converter, ['docx', 'pdf']); $this->assertCount(1, $result); $this->assertNotFalse(array_search($classname, $result)); } /** * Test the can_convert_storedfile_to function with a directory. */ public function test_can_convert_storedfile_to_directory(): void { $converter = $this->get_testable_mock(); // A file with filename '.' is a directory. $file = $this->get_stored_file('', '.'); $this->assertFalse($converter->can_convert_storedfile_to($file, 'target')); } /** * Test the can_convert_storedfile_to function with an empty file. */ public function test_can_convert_storedfile_to_emptyfile(): void { $converter = $this->get_testable_mock(); // A file with filename '.' is a directory. $file = $this->get_stored_file(''); $this->assertFalse($converter->can_convert_storedfile_to($file, 'target')); } /** * Test the can_convert_storedfile_to function with a file with indistinguished mimetype. */ public function test_can_convert_storedfile_to_no_mimetype(): void { $converter = $this->get_testable_mock(); // A file with filename '.' is a directory. $file = $this->get_stored_file('example content', 'example', [ 'mimetype' => null, ]); $this->assertFalse($converter->can_convert_storedfile_to($file, 'target')); } /** * Test the can_convert_storedfile_to function with a file with a known mimetype and extension. */ public function test_can_convert_storedfile_to_docx(): void { $returnvalue = (object) []; $converter = $this->get_testable_mock([ 'can_convert_format_to' ]); $types = \core_filetypes::get_types(); $file = $this->get_stored_file('example content', 'example.docx', [ 'mimetype' => $types['docx']['type'], ]); $converter->expects($this->once()) ->method('can_convert_format_to') ->willReturn($returnvalue); $result = $converter->can_convert_storedfile_to($file, 'target'); $this->assertEquals($returnvalue, $result); } /** * Test the can_convert_format_to function. */ public function test_can_convert_format_to_found(): void { $converter = $this->get_testable_mock(['get_document_converter_classes']); $mock = $this->get_mocked_converter(); $converter->method('get_document_converter_classes') ->willReturn([$mock]); $result = $converter->can_convert_format_to('from', 'to'); $this->assertTrue($result); } /** * Test the can_convert_format_to function. */ public function test_can_convert_format_to_not_found(): void { $converter = $this->get_testable_mock(['get_document_converter_classes']); $converter->method('get_document_converter_classes') ->willReturn([]); $result = $converter->can_convert_format_to('from', 'to'); $this->assertFalse($result); } /** * Test the can_convert_storedfile_to function with an empty file. */ public function test_poll_conversion_in_progress(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', 'get_next_converter', ]); $converter->method('get_document_converter_classes')->willReturn([]); $converter->method('get_next_converter')->willReturn(false); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $this->get_testable_conversion([ 'get_converter_instance', ]); $conversion->set_sourcefile($file); $conversion->set('targetformat', 'target'); $conversion->set('status', conversion::STATUS_IN_PROGRESS); $conversion->create(); $converterinstance = $this->get_mocked_converter([ 'poll_conversion_status', ]); $converterinstance->expects($this->once()) ->method('poll_conversion_status'); $conversion->method('get_converter_instance')->willReturn($converterinstance); $converter->poll_conversion($conversion); $this->assertEquals(conversion::STATUS_IN_PROGRESS, $conversion->get('status')); } /** * Test poll_conversion with an in-progress conversion where we are * unable to instantiate the converter instance. */ public function test_poll_conversion_in_progress_fail(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', 'get_next_converter', ]); $converter->method('get_document_converter_classes')->willReturn([]); $converter->method('get_next_converter')->willReturn(false); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $this->get_testable_conversion([ 'get_converter_instance', ]); $conversion->set_sourcefile($file); $conversion->set('targetformat', 'target'); $conversion->set('status', conversion::STATUS_IN_PROGRESS); $conversion->create(); $conversion->method('get_converter_instance')->willReturn(false); $converter->poll_conversion($conversion); $this->assertEquals(conversion::STATUS_FAILED, $conversion->get('status')); } /** * Test the can_convert_storedfile_to function with an empty file. */ public function test_poll_conversion_none_supported(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', 'get_next_converter', ]); $converter->method('get_document_converter_classes')->willReturn([]); $converter->method('get_next_converter')->willReturn(false); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = new conversion(0, (object) [ 'sourcefileid' => $file->get_id(), 'targetformat' => 'target', ]); $conversion->create(); $converter->poll_conversion($conversion); $this->assertEquals(conversion::STATUS_FAILED, $conversion->get('status')); } /** * Test the can_convert_storedfile_to function with an empty file. */ public function test_poll_conversion_pick_first(): void { $this->resetAfterTest(); $converterinstance = $this->get_mocked_converter([ 'start_document_conversion', 'poll_conversion_status', ]); $converter = $this->get_testable_mock([ 'get_document_converter_classes', 'get_next_converter', ]); $converter->method('get_document_converter_classes')->willReturn([]); $converter->method('get_next_converter')->willReturn(get_class($converterinstance)); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $this->get_testable_conversion([ 'get_converter_instance', ]); $conversion->set_sourcefile($file); $conversion->set('targetformat', 'target'); $conversion->set('status', conversion::STATUS_PENDING); $conversion->create(); $conversion->method('get_converter_instance')->willReturn($converterinstance); $converterinstance->expects($this->once()) ->method('start_document_conversion'); $converterinstance->expects($this->never()) ->method('poll_conversion_status'); $converter->poll_conversion($conversion); $this->assertEquals(conversion::STATUS_IN_PROGRESS, $conversion->get('status')); } /** * Test the can_convert_storedfile_to function with an empty file. */ public function test_poll_conversion_pick_subsequent(): void { $this->resetAfterTest(); $converterinstance = $this->get_mocked_converter([ 'start_document_conversion', 'poll_conversion_status', ]); $converterinstance2 = $this->get_mocked_converter([ 'start_document_conversion', 'poll_conversion_status', ]); $converter = $this->get_testable_mock([ 'get_document_converter_classes', 'get_next_converter', ]); $converter->method('get_document_converter_classes')->willReturn([]); $getinvocations = $this->any(); $converter ->expects($getinvocations) ->method('get_next_converter') ->willReturnCallback(fn (): string => match (self::getInvocationCount($getinvocations)) { 1 => get_class($converterinstance), default => get_class($converterinstance2), }); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $this->get_testable_conversion([ 'get_converter_instance', 'get_status', ]); $conversion->set_sourcefile($file); $conversion->set('targetformat', 'target'); $conversion->set('status', conversion::STATUS_PENDING); $conversion->create(); $statusinvocations = $this->atLeast(4); $conversion ->expects($statusinvocations) ->method('get_status') ->willReturnCallback(fn (): int => match (self::getInvocationCount($statusinvocations)) { // Initial status check. 1 => conversion::STATUS_PENDING, // Second check to make sure it's still pending after polling. 2 => conversion::STATUS_PENDING, // First one fails. 3 => conversion::STATUS_FAILED, // Second one succeeds. 4 => conversion::STATUS_COMPLETE, // And the final result checked in this unit test. default => conversion::STATUS_COMPLETE, }); $instanceinvocations = $this->any(); $conversion ->expects($instanceinvocations) ->method('get_converter_instance') ->willReturnCallback(fn (): object => match (self::getInvocationCount($instanceinvocations)) { 1 => $converterinstance, default => $converterinstance2, }); $converterinstance->expects($this->once()) ->method('start_document_conversion'); $converterinstance->expects($this->never()) ->method('poll_conversion_status'); $converterinstance2->expects($this->once()) ->method('start_document_conversion'); $converterinstance2->expects($this->never()) ->method('poll_conversion_status'); $converter->poll_conversion($conversion); $this->assertEquals(conversion::STATUS_COMPLETE, $conversion->get('status')); } /** * Test the start_conversion with a single converter which succeeds. */ public function test_start_conversion_one_supported_success(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', ]); $converter->method('get_document_converter_classes') ->willReturn([\core_file_converter_type_successful::class]); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $converter->start_conversion($file, 'target'); $this->assertEquals(conversion::STATUS_COMPLETE, $conversion->get('status')); } /** * Test the start_conversion with a single converter which failes. */ public function test_start_conversion_one_supported_failure(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', ]); $mock = $this->get_mocked_converter(['start_document_conversion']); $converter->method('get_document_converter_classes') ->willReturn([\core_file_converter_type_failed::class]); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $converter->start_conversion($file, 'target'); $this->assertEquals(conversion::STATUS_FAILED, $conversion->get('status')); } /** * Test the start_conversion with two converters - fail, then succeed. */ public function test_start_conversion_two_supported(): void { $this->resetAfterTest(); $converter = $this->get_testable_mock([ 'get_document_converter_classes', ]); $mock = $this->get_mocked_converter(['start_document_conversion']); $converter->method('get_document_converter_classes') ->willReturn([ \core_file_converter_type_failed::class, \core_file_converter_type_successful::class, ]); $file = $this->create_stored_file('example content', 'example', [ 'mimetype' => null, ]); $conversion = $converter->start_conversion($file, 'target'); $this->assertEquals(conversion::STATUS_COMPLETE, $conversion->get('status')); } /** * Ensure that get_next_converter returns false when no converters are available. */ public function test_get_next_converter_no_converters(): void { $rcm = new \ReflectionMethod(converter::class, 'get_next_converter'); $converter = new \core_files\converter(); $result = $rcm->invoke($converter, [], null); $this->assertFalse($result); } /** * Ensure that get_next_converter returns false when already on the * only converter. */ public function test_get_next_converter_only_converters(): void { $rcm = new \ReflectionMethod(converter::class, 'get_next_converter'); $converter = new converter(); $result = $rcm->invoke($converter, ['example'], 'example'); $this->assertFalse($result); } /** * Ensure that get_next_converter returns false when already on the * last converter. */ public function test_get_next_converter_last_converters(): void { $rcm = new \ReflectionMethod(converter::class, 'get_next_converter'); $converter = new converter(); $result = $rcm->invoke($converter, ['foo', 'example'], 'example'); $this->assertFalse($result); } /** * Ensure that get_next_converter returns the next vlaue when in a * current converter. */ public function test_get_next_converter_middle_converters(): void { $rcm = new \ReflectionMethod(converter::class, 'get_next_converter'); $converter = new converter(); $result = $rcm->invoke($converter, ['foo', 'bar', 'baz', 'example'], 'bar'); $this->assertEquals('baz', $result); } /** * * Ensure that get_next_converter returns the next vlaue when in a * current converter. */ public function test_get_next_converter_first(): void { $rcm = new \ReflectionMethod(converter::class, 'get_next_converter'); $converter = new converter(); $result = $rcm->invoke($converter, ['foo', 'bar', 'baz', 'example']); $this->assertEquals('foo', $result); } } class core_file_converter_requirements_base implements \core_files\converter_interface { /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { return false; } /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param conversion $conversion The file to be converted * @return conversion */ public function start_document_conversion(conversion $conversion) { } /** * Poll an existing conversion for status update. * * @param conversion $conversion The file to be converted * @return conversion */ public function poll_conversion_status(conversion $conversion) { } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { return false; } /** * A list of the supported conversions. * * @return string */ public function get_supported_conversions() { return []; } } /** * Test class for converter support with requirements are not met. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class core_file_converter_requirements_not_met extends core_file_converter_requirements_base { } /** * Test class for converter support with requirements met and conversion not supported. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class core_file_converter_type_not_supported extends core_file_converter_requirements_base { /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { return true; } } /** * Test class for converter support with requirements met and conversion supported. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class core_file_converter_type_supported extends core_file_converter_requirements_base { /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { return true; } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { return true; } } /** * Test class for converter support with requirements met and successful conversion. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class core_file_converter_type_successful extends core_file_converter_requirements_base { /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param conversion $conversion The file to be converted * @return conversion */ public function start_document_conversion(conversion $conversion) { $conversion->set('status', conversion::STATUS_COMPLETE); return $conversion; } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { return true; } } /** * Test class for converter support with requirements met and failed conversion. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class core_file_converter_type_failed extends core_file_converter_requirements_base { /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { return true; } /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param conversion $conversion The file to be converted * @return conversion */ public function start_document_conversion(conversion $conversion) { $conversion->set('status', conversion::STATUS_FAILED); return $conversion; } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { return true; } } PK b<�\� �YC YC - tests/reportbuilder/datasource/files_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. declare(strict_types=1); namespace core_files\reportbuilder\datasource; use core\context\{course, coursecat, user}; use core_reportbuilder_generator; use core_reportbuilder\local\filters\{boolean_select, date, filesize, select, text}; use core_reportbuilder\tests\core_reportbuilder_testcase; /** * Unit tests for files datasource * * @package core_files * @covers \core_files\reportbuilder\datasource\files * @copyright 2022 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class files_test extends core_reportbuilder_testcase { /** * Test default datasource */ public function test_datasource_default(): void { $this->resetAfterTest(); $course = $this->getDataGenerator()->create_course(); $coursecontext = course::instance($course->id); $user = $this->getDataGenerator()->create_user(); $usercontext = user::instance($user->id); $this->setUser($user); $this->generate_test_files($coursecontext); /** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); $report = $generator->create_report(['name' => 'Files', 'source' => files::class, 'default' => 1]); $content = $this->get_custom_report_content($report->get('id')); $content = $this->filter_custom_report_content($content, static function(array $row): bool { return $row['c0_ctxid'] !== 'System'; }); $this->assertCount(2, $content); // Default columns are context, user, name, type, size, time created. Sorted by context and time created. [$contextname, $userfullname, $filename, $mimetype, $filesize, $timecreated] = array_values($content[0]); $this->assertEquals($coursecontext->get_context_name(), $contextname); $this->assertEquals(fullname($user), $userfullname); $this->assertEquals('Hello.txt', $filename); $this->assertEquals('Text file', $mimetype); $this->assertEquals("5\xc2\xa0bytes", $filesize); $this->assertNotEmpty($timecreated); [$contextname, $userfullname, $filename, $mimetype, $filesize, $timecreated] = array_values($content[1]); $this->assertEquals($usercontext->get_context_name(), $contextname); $this->assertEquals(fullname($user), $userfullname); $this->assertEquals('Hello.txt', $filename); $this->assertEquals('Text file', $mimetype); $this->assertEquals("5\xc2\xa0bytes", $filesize); $this->assertNotEmpty($timecreated); } /** * Test datasource columns that aren't added by default */ public function test_datasource_non_default_columns(): void { global $OUTPUT; $this->resetAfterTest(); $category = $this->getDataGenerator()->create_category(); $categorycontext = coursecat::instance($category->id); $course = $this->getDataGenerator()->create_course(['category' => $category->id]); $coursecontext = course::instance($course->id); $user = $this->getDataGenerator()->create_user(); $usercontext = user::instance($user->id); $this->setUser($user); $draftitemid = $this->generate_test_files($coursecontext); /** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); $report = $generator->create_report(['name' => 'Files', 'source' => files::class, 'default' => 0]); // Consistent order, sorted by context and content hash. $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:link', 'sortenabled' => 1, 'sortorder' => 1]); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:name']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:level']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:path']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:parent']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:icon']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:path']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:author']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:license']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:contenthash', 'sortenabled' => 1, 'sortorder' => 2]); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:component']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:area']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'file:itemid']); $content = $this->get_custom_report_content($report->get('id')); $content = $this->filter_custom_report_content($content, static function(array $row): bool { return stripos($row['c0_ctxid'], 'System') === false; }); // There should be two entries (directory & file) for each context. $this->assertEquals([ [ "<a href=\"{$coursecontext->get_url()}\">{$coursecontext->get_context_name()}</a>", $coursecontext->get_context_name(), 'Course', $coursecontext->path, $categorycontext->get_context_name(), '<img class="icon iconsize-medium" alt="Directory" title="Directory" src="' . $OUTPUT->image_url('f/folder')->out() . '" />', '/', null, '', 'da39a3ee5e6b4b0d3255bfef95601890afd80709', 'course', 'summary', 0, ], [ "<a href=\"{$coursecontext->get_url()}\">{$coursecontext->get_context_name()}</a>", $coursecontext->get_context_name(), 'Course', $coursecontext->path, $categorycontext->get_context_name(), '<img class="icon iconsize-medium" alt="Text file" title="Text file" src="' . $OUTPUT->image_url('f/text')->out() . '" />', '/', null, '', 'f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0', 'course', 'summary', 0, ], [ "<a href=\"{$usercontext->get_url()}\">{$usercontext->get_context_name()}</a>", $usercontext->get_context_name(), 'User', $usercontext->path, 'System', '<img class="icon iconsize-medium" alt="Directory" title="Directory" src="' . $OUTPUT->image_url('f/folder')->out() . '" />', '/', null, '', 'da39a3ee5e6b4b0d3255bfef95601890afd80709', 'user', 'draft', $draftitemid, ], [ "<a href=\"{$usercontext->get_url()}\">{$usercontext->get_context_name()}</a>", $usercontext->get_context_name(), 'User', $usercontext->path, 'System', '<img class="icon iconsize-medium" alt="Text file" title="Text file" src="' . $OUTPUT->image_url('f/text')->out() . '" />', '/', null, '', 'f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0', 'user', 'draft', $draftitemid, ], ], array_map('array_values', $content)); } /** * Data provider for {@see test_datasource_filters} * * @return array[] */ public static function datasource_filters_provider(): array { return [ // File. 'Filter directory' => ['file:directory', [ 'file:directory_operator' => boolean_select::CHECKED, ], 2], 'Filter draft' => ['file:draft', [ 'file:draft_operator' => boolean_select::CHECKED, ], 2], 'Filter name' => ['file:name', [ 'file:name_operator' => text::IS_EQUAL_TO, 'file:name_value' => 'Hello.txt', ], 2], 'Filter size' => ['file:size', [ 'file:size_operator' => filesize::GREATER_THAN, 'file:size_value1' => 2, 'file:size_unit' => filesize::SIZE_UNIT_BYTE, ], 2], 'Filter type' => ['file:type', [ 'file:type_operator' => select::EQUAL_TO, 'file:type_value' => 'text/plain', ], 2], 'Filter type (non match)' => ['file:type', [ 'file:type_operator' => select::EQUAL_TO, 'file:type_value' => 'image/png', ], 0], 'Filter author' => ['file:author', [ 'file:author_operator' => text::IS_EMPTY, ], 4], 'Filter author (non match)' => ['file:author', [ 'file:author_operator' => text::IS_NOT_EMPTY, ], 0], 'Filter license' => ['file:license', [ 'file:license_operator' => select::EQUAL_TO, 'file:license_value' => 'unknown', ], 4], 'Filter license (non match)' => ['file:license', [ 'file:license_operator' => select::EQUAL_TO, 'file:license_value' => 'public', ], 0], 'Filter content hash' => ['file:contenthash', [ 'file:contenthash_operator' => text::IS_EQUAL_TO, 'file:contenthash_value' => 'f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0', ], 2], 'Filter content hash (no match)' => ['file:contenthash', [ 'file:contenthash_operator' => text::IS_EQUAL_TO, 'file:contenthash_value' => 'f00f', ], 0], 'Filter component' => ['file:component', [ 'file:component_operator' => text::IS_EQUAL_TO, 'file:component_value' => 'course', ], 2], 'Filter component (no match)' => ['file:component', [ 'file:component_operator' => text::IS_EQUAL_TO, 'file:component_value' => 'reportbuilder', ], 0], 'Filter area' => ['file:area', [ 'file:area_operator' => text::IS_EQUAL_TO, 'file:area_value' => 'summary', ], 2], 'Filter area (no match)' => ['file:area', [ 'file:area_operator' => text::IS_EQUAL_TO, 'file:area_value' => 'report', ], 0], 'Filter time created' => ['file:timecreated', [ 'file:timecreated_operator' => date::DATE_RANGE, 'file:timecreated_from' => 1622502000, ], 4], 'Filter time created (non match)' => ['file:timecreated', [ 'file:timecreated_operator' => date::DATE_RANGE, 'file:timecreated_to' => 1622502000, ], 0], // Context. 'Context level' => ['context:level', [ 'context:level_operator' => select::EQUAL_TO, 'context:level_value' => CONTEXT_COURSE, ], 2], 'Context level (no match)' => ['context:level', [ 'context:level_operator' => select::EQUAL_TO, 'context:level_value' => CONTEXT_BLOCK, ], 0], 'Context path' => ['context:path', [ 'context:path_operator' => text::STARTS_WITH, 'context:path_value' => '/1/', ], 4], 'Context path (no match)' => ['context:path', [ 'context:path_operator' => text::STARTS_WITH, 'context:path_value' => '/1/2/3/', ], 0], // User. 'Filter user' => ['user:username', [ 'user:username_operator' => text::IS_EQUAL_TO, 'user:username_value' => 'alfie', ], 4], 'Filter user (no match)' => ['user:username', [ 'user:username_operator' => text::IS_EQUAL_TO, 'user:username_value' => 'lionel', ], 0], ]; } /** * Test datasource filters * * @param string $filtername * @param array $filtervalues * @param int $expectmatchcount * * @dataProvider datasource_filters_provider */ public function test_datasource_filters( string $filtername, array $filtervalues, int $expectmatchcount ): void { $this->resetAfterTest(); $this->setAdminUser(); $user = $this->getDataGenerator()->create_user(['username' => 'alfie']); $this->setUser($user); $course = $this->getDataGenerator()->create_course(); $coursecontext = course::instance($course->id); $this->generate_test_files($coursecontext); /** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); // Create report containing single column, and given filter. $report = $generator->create_report(['name' => 'Files', 'source' => files::class, 'default' => 0]); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'context:name']); // Add filter, set it's values. $generator->create_filter(['reportid' => $report->get('id'), 'uniqueidentifier' => $filtername]); $content = $this->get_custom_report_content($report->get('id'), 0, $filtervalues); $content = $this->filter_custom_report_content($content, static function(array $row): bool { return stripos($row['c0_ctxid'], 'System') === false; }); $this->assertCount($expectmatchcount, $content); } /** * Stress test datasource * * In order to execute this test PHPUNIT_LONGTEST should be defined as true in phpunit.xml or directly in config.php */ public function test_stress_datasource(): void { if (!PHPUNIT_LONGTEST) { $this->markTestSkipped('PHPUNIT_LONGTEST is not defined'); } $this->resetAfterTest(); $this->setAdminUser(); $course = $this->getDataGenerator()->create_course(); $coursecontext = course::instance($course->id); $this->generate_test_files($coursecontext); $this->datasource_stress_test_columns(files::class); $this->datasource_stress_test_columns_aggregation(files::class); $this->datasource_stress_test_conditions(files::class, 'file:path'); } /** * Ensuring report content only includes files we have explicitly created within the test * * @param array $content * @param callable $callback * @return array */ protected function filter_custom_report_content(array $content, callable $callback): array { $content = array_filter($content, $callback); return array_values($content); } /** * Helper method to generate some test files (a user draft and course summary file) for reporting on * * @param course $context * @return int Draft item ID */ protected function generate_test_files(course $context): int { global $USER; $draftitemid = file_get_unused_draft_itemid(); // Populate user draft. get_file_storage()->create_file_from_string([ 'contextid' => user::instance($USER->id)->id, 'userid' => $USER->id, 'component' => 'user', 'filearea' => 'draft', 'itemid' => $draftitemid, 'filepath' => '/', 'filename' => 'Hello.txt', ], 'Hello'); // Save draft to course summary file area. file_save_draft_area_files($draftitemid, $context->id, 'course', 'summary', 0); return $draftitemid; } } PK b<�\���F �F tests/conversion_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files; /** * PHPUnit tests for conversion persistent. * * @package core_files * @copyright 2017 Andrew nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class conversion_test extends \advanced_testcase { /** * Helper to create a stored file object with the given supplied content. * * @param string $filecontent The content of the mocked file * @param string $filename The file name to use in the stored_file * @param string $filerecord Any overrides to the filerecord * @return \stored_file */ protected function create_stored_file($filecontent = 'content', $filename = 'testfile.txt', $filerecord = []) { $filerecord = array_merge([ 'contextid' => \context_system::instance()->id, 'component' => 'core', 'filearea' => 'unittest', 'itemid' => 0, 'filepath' => '/', 'filename' => $filename, ], $filerecord); $fs = get_file_storage(); $file = $fs->create_file_from_string($filerecord, $filecontent); return $file; } /** * Ensure that get_conversions_for_file returns an existing conversion * record with matching sourcefileid and targetformat. */ public function test_get_conversions_for_file_existing_conversion_incomplete(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $existing = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $existing->create(); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $conversionfile = $conversion->get_sourcefile(); $this->assertEquals($sourcefile->get_id(), $conversionfile->get_id()); $this->assertFalse($conversion->get_destfile()); } /** * Ensure that get_conversions_for_file returns an existing conversion * record with matching sourcefileid and targetformat when a file with the same * contenthash is uploaded several times. * * @covers \core_files\conversion::get_conversions_for_file */ public function test_get_conversions_for_multiple_files_existing_conversion_incomplete(): void { $this->resetAfterTest(); // Create a bunch of files with the same content. for ($i = 0; $i < 5; $i++) { $sourcefiles[] = $this->create_stored_file('test content', 'testfile' . $i . '.txt'); } // Use only one file for the conversion. // Pick some file in the middle. $sourcefile = $sourcefiles[count($sourcefiles) - 2]; $existing = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $existing->create(); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $conversionfile = $conversion->get_sourcefile(); $this->assertEquals($sourcefile->get_id(), $conversionfile->get_id()); $this->assertFalse($conversion->get_destfile()); // Check that getting the conversion for a different file record with the same contenthash // returns the same conversion as above. $conversions = conversion::get_conversions_for_file($sourcefiles[count($sourcefiles) - 1], 'pdf'); $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $conversionfile = $conversion->get_sourcefile(); $this->assertEquals($existing->get('id'), $conversion->get('id')); $this->assertEquals($sourcefile->get_id(), $conversionfile->get_id()); $this->assertFalse($conversion->get_destfile()); } /** * Ensure that get_conversions_for_file returns an existing conversion * record with matching sourcefileid and targetformat when a second * conversion to a different format exists. */ public function test_get_conversions_for_file_existing_conversion_multiple_formats_incomplete(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $existing = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $existing->create(); $second = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'doc', ]); $second->create(); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $conversionfile = $conversion->get_sourcefile(); $this->assertEquals($sourcefile->get_id(), $conversionfile->get_id()); $this->assertFalse($conversion->get_destfile()); } /** * Ensure that get_conversions_for_file returns an existing conversion * record with matching sourcefileid and targetformat. */ public function test_get_conversions_for_file_existing_conversion_complete(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $destfile = $this->create_stored_file( 'example content', $sourcefile->get_contenthash(), [ 'component' => 'core', 'filearea' => 'documentconversion', 'filepath' => '/pdf/', ]); $existing = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', 'destfileid' => $destfile->get_id(), ]); $existing->create(); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); // Only one file should be returned. $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $this->assertEquals($existing->get('id'), $conversion->get('id')); $this->assertEquals($sourcefile->get_id(), $conversion->get_sourcefile()->get_id()); $this->assertEquals($destfile->get_id(), $conversion->get_destfile()->get_id()); } /** * Ensure that get_conversions_for_file returns an existing conversion * record with matching sourcefileid and targetformat. */ public function test_get_conversions_for_file_existing_conversion_multiple_formats_complete(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $destfile = $this->create_stored_file( 'example content', $sourcefile->get_contenthash(), [ 'component' => 'core', 'filearea' => 'documentconversion', 'filepath' => '/pdf/', ]); $existing = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', 'destfileid' => $destfile->get_id(), ]); $existing->create(); $second = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'doc', ]); $second->create(); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); // Only one file should be returned. $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $this->assertEquals($sourcefile->get_id(), $conversion->get_sourcefile()->get_id()); $this->assertEquals($destfile->get_id(), $conversion->get_destfile()->get_id()); } /** * Ensure that get_conversions_for_file returns an existing conversion * record does not exist, but the file has previously been converted. */ public function test_get_conversions_for_file_existing_target(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $destfile = $this->create_stored_file( 'example content', $sourcefile->get_contenthash(), [ 'component' => 'core', 'filearea' => 'documentconversion', 'filepath' => '/pdf/', ]); $conversions = conversion::get_conversions_for_file($sourcefile, 'pdf'); $this->assertCount(1, $conversions); $conversion = array_shift($conversions); $conversionsource = $conversion->get_sourcefile(); $this->assertEquals($sourcefile->get_id(), $conversionsource->get_id()); $conversiondest = $conversion->get_destfile(); $this->assertEquals($destfile->get_id(), $conversiondest->get_id()); } /** * Ensure that set_sourcefile sets the correct fileid. */ public function test_set_sourcefile(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) []); $conversion->set_sourcefile($sourcefile); $this->assertEquals($sourcefile->get_id(), $conversion->get('sourcefileid')); $this->assertNull($conversion->get('destfileid')); } /** * Ensure that store_destfile_from_path stores the file as expected. */ public function test_store_destfile_from_path(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $fixture = __FILE__; $conversion->store_destfile_from_path($fixture); $destfile = $conversion->get_destfile(); $this->assertEquals(file_get_contents($fixture), $destfile->get_content()); } /** * Ensure that store_destfile_from_path stores the file as expected. */ public function test_store_destfile_from_path_delete_existing(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $record = [ 'contextid' => \context_system::instance()->id, 'component' => 'core', 'filearea' => 'documentconversion', 'itemid' => 0, 'filepath' => '/pdf/', ]; $existingfile = $this->create_stored_file('foo', $sourcefile->get_contenthash(), $record); $fixture = __FILE__; $conversion->store_destfile_from_path($fixture); $destfile = $conversion->get_destfile(); $this->assertEquals(file_get_contents($fixture), $destfile->get_content()); } /** * Ensure that store_destfile_from_path stores the file as expected. */ public function test_store_destfile_from_string(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $fixture = 'Example content'; $conversion->store_destfile_from_string($fixture); $destfile = $conversion->get_destfile(); $this->assertEquals($fixture, $destfile->get_content()); } /** * Ensure that store_destfile_from_string stores the file as expected when * an existing destfile is found. */ public function test_store_destfile_from_string_delete_existing(): void { $this->resetAfterTest(); $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $record = [ 'contextid' => \context_system::instance()->id, 'component' => 'core', 'filearea' => 'documentconversion', 'itemid' => 0, 'filepath' => '/pdf/', ]; $existingfile = $this->create_stored_file('foo', $sourcefile->get_contenthash(), $record); $fixture = 'Example content'; $conversion->store_destfile_from_string($fixture); $destfile = $conversion->get_destfile(); $this->assertEquals($fixture, $destfile->get_content()); } /** * Ensure that the get_status functions cast the status to integer correctly. */ public function test_get_status(): void { $conversion = new conversion(0, (object) [ 'status' => (string) 1, ]); $this->assertIsInt($conversion->get('status')); } /** * Ensure that get_converter_instance returns false when no converter is set. */ public function test_get_converter_instance_none_set(): void { $conversion = new conversion(0, (object) []); $this->assertFalse($conversion->get_converter_instance()); } /** * Ensure that get_converter_instance returns false when no valid converter is set. */ public function test_get_converter_instance_invalid_set(): void { $conversion = new conversion(0, (object) [ 'converter' => '\\fileconverter_not_a_valid_converter\\converter', ]); $this->assertFalse($conversion->get_converter_instance()); } /** * Ensure that get_converter_instance returns an instance when a valid converter is set. */ public function test_get_converter_instance_valid_set(): void { $conversion = new conversion(0, (object) [ 'converter' => \fileconverter_unoconv\converter::class, ]); $this->assertInstanceOf(\fileconverter_unoconv\converter::class, $conversion->get_converter_instance()); } /** * Test that all old conversion records are removed periodically. */ public function test_remove_old_conversion_records_old(): void { $this->resetAfterTest(); global $DB; $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $conversion->create(); $DB->set_field(conversion::TABLE, 'timemodified', time() - YEARSECS); conversion::remove_old_conversion_records(); $this->assertEquals(0, $DB->count_records(conversion::TABLE)); } /** * Test that all old conversion records are removed periodically. */ public function test_remove_old_conversion_records_young(): void { $this->resetAfterTest(); global $DB; $sourcefile = $this->create_stored_file(); $conversion = new conversion(0, (object) [ 'sourcefileid' => $sourcefile->get_id(), 'targetformat' => 'pdf', ]); $conversion->create(); $DB->set_field(conversion::TABLE, 'timemodified', time() - DAYSECS); conversion::remove_old_conversion_records(); $this->assertEquals(1, $DB->count_records(conversion::TABLE)); } /** * Test orphan records are removed. */ public function test_remove_orphan_records(): void { global $DB; $this->resetAfterTest(); $sf1 = $this->create_stored_file('1', '1'); $sf2 = $this->create_stored_file('2', '2'); $sf3 = $this->create_stored_file('3', '3'); $c1 = new conversion(0, (object) ['sourcefileid' => $sf1->get_id(), 'targetformat' => 'pdf']); $c1->create(); $c2 = new conversion(0, (object) ['sourcefileid' => $sf2->get_id(), 'targetformat' => 'pdf']); $c2->create(); $c3 = new conversion(0, (object) ['sourcefileid' => $sf3->get_id(), 'targetformat' => 'pdf']); $c3->create(); $this->assertTrue(conversion::record_exists($c1->get('id'))); $this->assertTrue(conversion::record_exists($c2->get('id'))); $this->assertTrue(conversion::record_exists($c3->get('id'))); // Nothing should happen here. conversion::remove_orphan_records(); $this->assertTrue(conversion::record_exists($c1->get('id'))); $this->assertTrue(conversion::record_exists($c2->get('id'))); $this->assertTrue(conversion::record_exists($c3->get('id'))); // Delete file #2. $sf2->delete(); conversion::remove_orphan_records(); $this->assertTrue(conversion::record_exists($c1->get('id'))); $this->assertFalse(conversion::record_exists($c2->get('id'))); $this->assertTrue(conversion::record_exists($c3->get('id'))); // Delete file #1, #3. $sf1->delete(); $sf3->delete(); conversion::remove_orphan_records(); $this->assertFalse(conversion::record_exists($c1->get('id'))); $this->assertFalse(conversion::record_exists($c2->get('id'))); $this->assertFalse(conversion::record_exists($c3->get('id'))); } } PK b<�\��j� � tests/archive_writer_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files; use advanced_testcase; use core_files\local\archive_writer\zip_writer; /** * Unit tests for \core_files\archive_writer. * * @package core_files * @category test * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU Public License * @covers \core_files\archive_writer */ final class archive_writer_test extends advanced_testcase { /** * Test get_file_writer(). */ public function test_get_file_writer(): void { $zipwriter = archive_writer::get_file_writer('file.zip', archive_writer::ZIP_WRITER); $this->assertInstanceOf(zip_writer::class, $zipwriter); $this->assertTrue(file_exists($zipwriter->get_path_to_zip())); } /** * Test get_stream_writer(). */ public function test_get_stream_writer(): void { $zipwriter = archive_writer::get_stream_writer('path/to/file.txt', archive_writer::ZIP_WRITER); $this->assertInstanceOf(zip_writer::class, $zipwriter); } } PK b<�\@,��3 �3 4 tests/redactor/services/exifremover_service_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor\services; /** * Tests for the EXIF remover service. * * If you wish to use these unit tests all you need to do is add the following definition to * your config.php file: * * define('TEST_PATH_TO_EXIFTOOL', '/usr/bin/exiftool'); * * @package core_files * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * * @covers \core_files\redactor\services\exifremover_service */ final class exifremover_service_test extends \advanced_testcase { /** * Tests the `exifremover_service` functionality using PHP GD. * * This test verifies the ability of the `exifremover_service` to remove all EXIF * tags from an image file when using PHP GD. It ensures that all tags, including * GPSLatitude, GPSLongitude, and Orientation, are removed from the EXIF data. * * @return void */ public function test_exifremover_service_with_gd(): void { $this->resetAfterTest(true); // Ensure that the exif remover tool path is not set. set_config('exifremovertoolpath', null, 'core_files'); $sourcepath = self::get_fixture_path('core_files', 'redactor/dummy.jpg'); // Get the EXIF data from the original file. $currentexif = $this->get_exif_data_from_file($sourcepath); $this->assertStringContainsString('GPSLatitude', $currentexif); $this->assertStringContainsString('GPSLongitude', $currentexif); $this->assertStringContainsString('Orientation', $currentexif); // Redact the file. $service = new exifremover_service(); $newfile = $service->redact_file_by_path('image/jpeg', $sourcepath); // Get the EXIF data from the new file. $newexif = $this->get_exif_data_from_file($newfile); // Removing the "all" tags will result in removing all existing tags. $this->assertStringNotContainsString('GPSLatitude', $newexif); $this->assertStringNotContainsString('GPSLongitude', $newexif); $this->assertStringNotContainsString('Orientation', $newexif); } /** * Tests the `exifremover_service` functionality to flip orientation. * * @dataProvider exifremover_service_flip_orientation_provider * @param string $sourcepath the path to the source image. * @param string $expectedpath the path to the expected image. * @param bool $expectedresult the expected result of the comparison. */ public function test_exifremover_service_flip_orientation_with_gd( string $sourcepath, string $expectedpath, bool $expectedresult ): void { $this->resetAfterTest(true); // Ensure that the exif remover tool path is not set. set_config('exifremovertoolpath', null, 'core_files'); // Flip the orientation. $service = new exifremover_service(); $newfile = $service->redact_file_by_path('image/jpeg', $sourcepath); // Compare the actual and expected images. $this->assertEquals($expectedresult, $this->compare_images($newfile, $expectedpath)); } /** * Data provider for test_exifremover_service_flip_orientation(). * * @return array */ public static function exifremover_service_flip_orientation_provider(): array { return [ 'Flip right-top' => [ 'sourcepath' => self::get_fixture_path('core_files', 'redactor/righttop.jpg'), 'expectedpath' => self::get_fixture_path('core_files', 'redactor/topleft.jpg'), 'expectedresult' => true, ], 'The image will not be the same after the flip process' => [ 'sourcepath' => self::get_fixture_path('core_files', 'redactor/righttop.jpg'), 'expectedpath' => self::get_fixture_path('core_files', 'redactor/righttop.jpg'), 'expectedresult' => false, ], ]; } /** * Compares two images pixel by pixel. * * @param string $image1path the path to the first image. * @param string $image2path the path to the second image. * @return bool True if the images are identical, false otherwise. */ private function compare_images(string $image1path, string $image2path): bool { $image1 = imagecreatefromjpeg($image1path); $image2 = imagecreatefromjpeg($image2path); if (!$image1 || !$image2) { return false; } $width1 = imagesx($image1); $height1 = imagesy($image1); $width2 = imagesx($image2); $height2 = imagesy($image2); if ($width1 !== $width2 || $height1 !== $height2) { return false; } for ($x = 0; $x < $width1; $x++) { for ($y = 0; $y < $height1; $y++) { if (imagecolorat($image1, $x, $y) !== imagecolorat($image2, $x, $y)) { return false; } } } return true; } /** * Tests the `exifremover_service` functionality using ExifTool. * * This test verifies the ability of the `exifremover_service` to remove specific * EXIF tags from an image file when configured to use ExifTool. The test includes * scenarios for removing all EXIF tags and for removing only GPS tags. */ public function test_exifremover_service_with_exiftool(): void { $this->require_exiftool(); $this->resetAfterTest(true); $sourcepath = self::get_fixture_path('core_files', 'redactor/dummy.jpg'); set_config('file_redactor_exifremovertoolpath', TEST_PATH_TO_EXIFTOOL); // Remove All tags. set_config('file_redactor_exifremoverremovetags', 'all'); $service = new exifremover_service(); $newfile = $service->redact_file_by_path('image/jpeg', $sourcepath); // Get the EXIF data from the new file. $newexif = $this->get_exif_data_from_file($newfile); // Removing the "all" tags will result in removing all existing tags. $this->assertStringNotContainsString('GPSLatitude', $newexif); $this->assertStringNotContainsString('GPSLongitude', $newexif); $this->assertStringNotContainsString('Aperture', $newexif); // Orientation is a preserve tag. Ensure it always exists. $this->assertStringContainsString('Orientation', $newexif); // Remove the GPS tag only. set_config('file_redactor_exifremoverremovetags', 'gps'); $service = new exifremover_service(); $newfile = $service->redact_file_by_path('image/jpeg', $sourcepath); // Get the EXIF data from the new file. $newexif = $this->get_exif_data_from_file($newfile); // The GPS tag only removal will remove the tag containing "GPS" keyword. $this->assertStringNotContainsString('GPSLatitude', $newexif); $this->assertStringNotContainsString('GPSLongitude', $newexif); // And keep the other tags remaining. $this->assertStringContainsString('Aperture', $newexif); // Orientation is a preserve tag. Ensure it always exists. $this->assertStringContainsString('Orientation', $newexif); } /** * Tests the `is_mimetype_supported` method. * * This test initializes the `exifremover_service` and verifies if the given * MIME types are supported for EXIF removal using both PHP GD and ExifTool. */ public function test_exifremover_service_is_mimetype_supported_generic(): void { $service = new exifremover_service(); // Ensure that an unsupported mimetype is not accepted. $this->assertFalse($service->is_mimetype_supported('application/binary')); // An unsupported mimetype will just return null. $sourcepath = self::get_fixture_path('core_files', 'redactor/dummy.jpg'); $this->assertNull($service->redact_file_by_path('application/binary', $sourcepath)); $this->assertNull($service->redact_file_by_content('application/binary', $sourcepath)); } /** * Tests the `is_mimetype_supported` method. * * This test initializes the `exifremover_service` and verifies if the given * MIME types are supported for EXIF removal using both PHP GD and ExifTool. */ public function test_exifremover_service_is_mimetype_supported_gd(): void { $this->resetAfterTest(true); // Ensure that the exif remover tool path is not set. set_config('file_redactor_exifremovertoolpath', null); $service = new exifremover_service(); // The default MIME type is supported. $this->assertTrue($service->is_mimetype_supported(exifremover_service::DEFAULT_MIMETYPE)); // Other than the default, the function will returns false. $this->assertFalse($service->is_mimetype_supported('image/tiff')); } /** * Tests the `is_mimetype_supported` method. * * This test initializes the `exifremover_service` and verifies if the given * MIME types are supported for EXIF removal using both PHP GD and ExifTool. */ public function test_exifremover_service_is_mimetype_supported_exiftool(): void { $this->require_exiftool(); $this->resetAfterTest(true); set_config('file_redactor_exifremovertoolpath', TEST_PATH_TO_EXIFTOOL); // Set the supported mime types to only redact image/tiff. set_config('file_redactor_exifremovermimetype', 'image/tiff'); $service = new exifremover_service(); $this->assertTrue($service->is_mimetype_supported('image/tiff')); // Other image formats are not supported. $this->assertFalse($service->is_mimetype_supported('image/png')); } /** * Tests the EXIF remover service with an unknown filename and an invalid EXIF tool path. */ public function test_exiftool_notfound_filename_unknown(): void { $this->resetAfterTest(true); set_config('file_redactor_exifremovertoolpath', 'fakeexiftool'); $service = new exifremover_service(); $this->expectException(\core\exception\moodle_exception::class); $this->expectExceptionMessage(get_string('redactor:exifremover:failedprocessgd', 'core_files')); $service->redact_file_by_content('image/jpeg', 'content'); } /** * Retrieves the EXIF metadata of a file. * * @param string $content the content of file. * @return string The EXIF metadata as a string. */ private function get_exif_data_from_content(string $content): string { $logpath = make_request_directory() . '/temp.jpg'; file_put_contents($logpath, $content); return $this->get_exif_data_from_file($logpath); } /** * Retrieves the EXIF metadata of a file. * * @param string $filepath the path to the file. * @return string The EXIF metadata as a string. */ private function get_exif_data_from_file(string $filepath): string { $exif = exif_read_data($filepath); $string = ""; foreach ($exif as $key => $value) { if (is_array($value)) { foreach ($value as $subkey => $subvalue) { $string .= "$subkey: $subvalue\n"; } } else { $string .= "$key: $value\n"; } } return $string; } /** * Data provider for test_exifremover_service_clean_filename(). * * @return array */ public static function exifremover_service_clean_filename_provider(): array { return [ 'Hyphen minus -' => [ 'filename' => '-if \'$LensModel eq "18-35mm"\'', 'expected' => 'if $LensModel eq 18-35mm', ], 'Minus −' => [ 'filename' => '−filename.jpg', 'expected' => 'filename.jpg', ], ]; } /** * Helper to require valid testing exiftool configuration. */ private function require_exiftool(): void { if (!defined('TEST_PATH_TO_EXIFTOOL')) { $this->markTestSkipped('Could not test the EXIF remover service, missing configuration.'); } if (!TEST_PATH_TO_EXIFTOOL) { $this->markTestSkipped('Could not test the EXIF remover service, configuration invalid.'); } if (!is_executable(TEST_PATH_TO_EXIFTOOL)) { $this->markTestSkipped('Could not test the EXIF remover service, exiftool not executable.'); } } } PK b<�\'��Du u tests/redactor/manager_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\redactor; /** * Tests for file redactor manager class. * * @package core_files * @copyright Meirza <meirza.arson@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @covers \core_files\redactor\manager */ final class manager_test extends \advanced_testcase { /** * Helper to get a manager with a dummy file service. * * @return \core_files\redactor\manager */ private function get_manager_with_dummy_file_service(): manager { $manager = $this->getMockBuilder(\core_files\redactor\manager::class) ->onlyMethods(['get_service_classnames']) ->getMock(); $manager->method('get_service_classnames') ->willReturn([\core_files\tests\redactor\services\dummy_file_service::class]); return $manager; } /** * Test file redaction by path. */ public function test_redact_file(): void { $manager = $this->get_manager_with_dummy_file_service(); // Test redaction for a binary (not supported). $redactedfile = $manager->redact_file("application/binary", "/path/to/binary"); $this->assertNull($redactedfile); $redactedfile = $manager->redact_file_content("application/binary", "Binary content here"); $this->assertNull($redactedfile); // Test redaction for an image. $redactedfile = $manager->redact_file("image/jpeg", "/path/to/image.jpg"); $this->assertEquals('/redacted/path/to/image.jpg', $redactedfile); $redactedfile = $manager->redact_file_content("image/jpeg", "Example picture goes here"); $this->assertEquals('redacted:Example picture goes here', $redactedfile); } } PK b<�\\�f� � . tests/local/archive_writer/zip_writer_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace core_files\local\archive_writer; use advanced_testcase; use context_module; use core_files\archive_writer; use ZipArchive; /** * Unit tests for \core_files\local\archive_writer\zip_writer. * * @package core_files * @category test * @copyright 2020 Mark Nelson <mdjnelson@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU Public License * @covers \core_files\local\archive_writer\zip_writer */ final class zip_writer_test extends advanced_testcase { /** * Test add_file_from_filepath(). */ public function test_add_file_from_filepath(): void { global $CFG; $pathtofileinzip = '/some/made/up/name.txt'; $filetoadd = $CFG->dirroot . '/files/tests/fixtures/awesome_file.txt'; $zipwriter = archive_writer::get_file_writer('test.zip', archive_writer::ZIP_WRITER); $zipwriter->add_file_from_filepath($pathtofileinzip, $filetoadd); $zipwriter->finish(); $pathtozip = $zipwriter->get_path_to_zip(); $zip = new ZipArchive(); $opened = $zip->open($pathtozip); $this->assertTrue($opened); // Filename that has been sanitized by Zipstream. $pathtofileinzip = ltrim($pathtofileinzip, '/'); $this->assertEquals("Hey, this is an awesome text file. Hello! :)", $zip->getFromName($pathtofileinzip)); } /** * Test add_file_from_string(). */ public function test_add_file_from_string(): void { $pathtofileinzip = "/path/to/my/awesome/file.txt"; $mycontent = "This is some real awesome content, ya dig?"; $zipwriter = archive_writer::get_file_writer('test.zip', archive_writer::ZIP_WRITER); $zipwriter->add_file_from_string($pathtofileinzip, $mycontent); $zipwriter->finish(); $pathtozip = $zipwriter->get_path_to_zip(); $zip = new ZipArchive(); $opened = $zip->open($pathtozip); $this->assertTrue($opened); // Filename that has been sanitized by Zipstream. $pathtofileinzip = ltrim($pathtofileinzip, '/'); $this->assertEquals($mycontent, $zip->getFromName($pathtofileinzip)); } /** * Test add_file_from_stream(). */ public function test_add_file_from_stream(): void { $this->resetAfterTest(true); $this->setAdminUser(); $course = $this->getDataGenerator()->create_course(); $assign = $this->getDataGenerator()->create_module('assign', ['course' => $course->id]); // Add a file to the intro. $filerecord = [ 'contextid' => context_module::instance($assign->cmid)->id, 'component' => 'mod_assign', 'filearea' => 'intro', 'itemid' => 0, 'filepath' => '/', 'filename' => 'fileintro.txt', ]; $fs = get_file_storage(); $storedfile = $fs->create_file_from_string($filerecord, 'Contents for the assignment, yeow!'); $pathtofileinzip = $storedfile->get_filepath() . $storedfile->get_filename(); $zipwriter = archive_writer::get_file_writer('test.zip', archive_writer::ZIP_WRITER); $zipwriter->add_file_from_stream($pathtofileinzip, $storedfile->get_content_file_handle()); $zipwriter->finish(); $pathtozip = $zipwriter->get_path_to_zip(); $zip = new ZipArchive(); $opened = $zip->open($pathtozip); $this->assertTrue($opened); // Filename that has been sanitized by Zipstream. $pathtofileinzip = ltrim($pathtofileinzip, '/'); $this->assertEquals($storedfile->get_content(), $zip->getFromName($pathtofileinzip)); } /** * Test add_file_from_stored_file(). */ public function test_add_file_from_stored_file(): void { $this->resetAfterTest(true); $this->setAdminUser(); $course = $this->getDataGenerator()->create_course(); $assign = $this->getDataGenerator()->create_module('assign', ['course' => $course->id]); // Add a file to the intro. $filerecord = [ 'contextid' => context_module::instance($assign->cmid)->id, 'component' => 'mod_assign', 'filearea' => 'intro', 'itemid' => 0, 'filepath' => '/', 'filename' => 'fileintro.txt', ]; $fs = get_file_storage(); $storedfile = $fs->create_file_from_string($filerecord, 'Contents for the assignment, yeow!'); $pathtofileinzip = $storedfile->get_filepath() . $storedfile->get_filename(); $zipwriter = archive_writer::get_file_writer('test.zip', archive_writer::ZIP_WRITER); $zipwriter->add_file_from_stored_file($pathtofileinzip, $storedfile); $zipwriter->finish(); $pathtozip = $zipwriter->get_path_to_zip(); $zip = new ZipArchive(); $opened = $zip->open($pathtozip); $this->assertTrue($opened); // Filename that has been sanitized by Zipstream. $pathtofileinzip = ltrim($pathtofileinzip, '/'); $this->assertEquals($storedfile->get_content(), $zip->getFromName($pathtofileinzip)); } } PK b<�\��Wy y coursefilesedit.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. require_once('../config.php'); require_once(__DIR__ . '/coursefilesedit_form.php'); require_once($CFG->dirroot . '/repository/lib.php'); // current context $contextid = required_param('contextid', PARAM_INT); $component = 'course'; $filearea = 'legacy'; $itemid = 0; list($context, $course, $cm) = get_context_info_array($contextid); $url = new moodle_url('/files/coursefilesedit.php', array('contextid'=>$contextid)); require_login($course); require_capability('moodle/course:managefiles', $context); $PAGE->set_url($url); $heading = get_string('coursefiles') . ': ' . format_string($course->fullname, true, array('context' => $context)); $strfiles = get_string("files"); if ($node = $PAGE->settingsnav->find('coursefiles', navigation_node::TYPE_SETTING)) { $node->make_active(); } else { $PAGE->navbar->add($strfiles); } $PAGE->set_context($context); $PAGE->set_title($heading); $PAGE->set_heading($heading); $PAGE->set_pagelayout('incourse'); $data = new stdClass(); $options = array('subdirs'=>1, 'maxfiles'=>-1, 'accepted_types'=>'*', 'return_types'=>FILE_INTERNAL); file_prepare_standard_filemanager($data, 'files', $options, $context, $component, $filearea, $itemid); $form = new coursefiles_edit_form(null, array('data'=>$data, 'contextid'=>$contextid)); $returnurl = new moodle_url('/files/index.php', array('contextid'=>$contextid)); if ($form->is_cancelled()) { redirect($returnurl); } if ($data = $form->get_data()) { $data = file_postupdate_standard_filemanager($data, 'files', $options, $context, $component, $filearea, $itemid); redirect($returnurl); } echo $OUTPUT->header(); echo $OUTPUT->container_start(); $form->display(); echo $OUTPUT->container_end(); echo $OUTPUT->footer(); PK b<�\�\�� � & converter/classes/privacy/provider.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Data provider. * * @package core_fileconverter * @copyright 2018 Frédéric Massart * @author Frédéric Massart <fred@branchup.tech> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_fileconverter\privacy; defined('MOODLE_INTERNAL') || die(); use context; use core_privacy\local\metadata\collection; use core_privacy\local\request\approved_contextlist; use core_privacy\local\request\userlist; use core_privacy\local\request\approved_userlist; /** * Data provider class. * * @package core_fileconverter * @copyright 2018 Frédéric Massart * @author Frédéric Massart <fred@branchup.tech> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements \core_privacy\local\metadata\provider, \core_privacy\local\request\core_userlist_provider, \core_privacy\local\request\subsystem\provider { /** * Returns metadata. * * @param collection $collection The initialised collection to add items to. * @return collection A listing of user data stored through this system. */ public static function get_metadata(collection $collection): collection { $collection->add_plugintype_link('fileconverter', [], 'privacy:metadata:plugintypefileconverter'); return $collection; } /** * Get the list of contexts that contain user information for the specified user. * * @param int $userid The user to search. * @return \contextlist $contextlist The contextlist containing the list of contexts used in this plugin. */ public static function get_contexts_for_userid(int $userid): \core_privacy\local\request\contextlist { // We cannot associate files with a particular user as it would require to know all the details about // the source file, which only the component owning it knows about. And, the 'usermodified' attribute // of the conversion class is not an identifier of data ownership, merely that this user was logged in // when the conversion was requested. As such, as the owning component should declare the source file, // and we can't make sense of 'usermodified', we will not be reporting anything here. Also note that // the clean up task will ensure that whenever a source file is delete, its conversions also are. return new \core_privacy\local\request\contextlist(); } /** * Get the list of users who have data within a context. * * @param userlist $userlist The userlist containing the list of users who have data in this context/plugin combination. */ public static function get_users_in_context(userlist $userlist) { } /** * Export all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts to export information for. */ public static function export_user_data(approved_contextlist $contextlist) { } /** * Delete all data for all users in the specified context. * * @param context $context The specific context to delete data for. */ public static function delete_data_for_all_users_in_context(context $context) { } /** * Delete multiple users within a single context. * * @param approved_userlist $userlist The approved context and user information to delete information for. */ public static function delete_data_for_users(approved_userlist $userlist) { } /** * Delete all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts and user information to delete information for. */ public static function delete_data_for_user(approved_contextlist $contextlist) { } } PK b<�\5��� . converter/unoconv/classes/privacy/provider.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Privacy provider implementation for fileconverter_unoconv. * * @package fileconverter_unoconv * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_unoconv\privacy; defined('MOODLE_INTERNAL') || die(); /** * Privacy provider implementation for fileconverter_unoconv. * * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements \core_privacy\local\metadata\null_provider { /** * Get the language string identifier with the component's language * file to explain why this plugin stores no data. * * @return string */ public static function get_reason(): string { return 'privacy:metadata'; } } PK b<�\��7L5 L5 ' converter/unoconv/classes/converter.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class for converting files between different file formats using unoconv. * * @package fileconverter_unoconv * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_unoconv; defined('MOODLE_INTERNAL') || die(); require_once($CFG->libdir . '/filelib.php'); use stored_file; use \core_files\conversion; /** * Class for converting files between different formats using unoconv. * * @package fileconverter_unoconv * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class converter implements \core_files\converter_interface { /** No errors */ const UNOCONVPATH_OK = 'ok'; /** Not set */ const UNOCONVPATH_EMPTY = 'empty'; /** Does not exist */ const UNOCONVPATH_DOESNOTEXIST = 'doesnotexist'; /** Is a dir */ const UNOCONVPATH_ISDIR = 'isdir'; /** Not executable */ const UNOCONVPATH_NOTEXECUTABLE = 'notexecutable'; /** Test file missing */ const UNOCONVPATH_NOTESTFILE = 'notestfile'; /** Version not supported */ const UNOCONVPATH_VERSIONNOTSUPPORTED = 'versionnotsupported'; /** Any other error */ const UNOCONVPATH_ERROR = 'error'; /** * @var bool $requirementsmet Whether requirements have been met. */ protected static $requirementsmet = null; /** * @var array $formats The list of formats supported by unoconv. */ protected static $formats; /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param conversion $conversion The file to be converted * @return $this */ public function start_document_conversion(\core_files\conversion $conversion) { global $CFG; if (!self::are_requirements_met()) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion failed to verify the configuraton meets the minimum requirements. " . "Please check the unoconv installation configuration." ); return $this; } $file = $conversion->get_sourcefile(); $filepath = $file->get_filepath(); // Sanity check that the conversion is supported. $fromformat = pathinfo($file->get_filename(), PATHINFO_EXTENSION); if (!self::is_format_supported($fromformat)) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion for '" . $filepath . "' found input '" . $fromformat . "' " . "file extension to convert from is not supported." ); return $this; } $format = $conversion->get('targetformat'); if (!self::is_format_supported($format)) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion for '" . $filepath . "' found output '" . $format . "' " . "file extension to convert to is not supported." ); return $this; } // Copy the file to the tmp dir. $uniqdir = make_unique_writable_directory(make_temp_directory('core_file/conversions')); \core_shutdown_manager::register_function('remove_dir', array($uniqdir)); $localfilename = $file->get_id() . '.' . $fromformat; $filename = $uniqdir . '/' . $localfilename; try { // This function can either return false, or throw an exception so we need to handle both. if ($file->copy_content_to($filename) === false) { throw new \file_exception('storedfileproblem', 'Could not copy file contents to temp file.'); } } catch (\file_exception $fe) { error_log( "Unoconv conversion for '" . $filepath . "' encountered disk permission error when copying " . "submitted file contents to unique temp file: '" . $filename . "'." ); throw $fe; } // The temporary file to copy into. $newtmpfile = pathinfo($filename, PATHINFO_FILENAME) . '.' . $format; $newtmpfile = $uniqdir . '/' . clean_param($newtmpfile, PARAM_FILE); $cmd = escapeshellcmd(trim($CFG->pathtounoconv)) . ' ' . escapeshellarg('-f') . ' ' . escapeshellarg($format) . ' ' . escapeshellarg('-o') . ' ' . escapeshellarg($newtmpfile) . ' ' . escapeshellarg($filename); $output = null; $currentdir = getcwd(); chdir($uniqdir); $result = exec($cmd, $output, $returncode); chdir($currentdir); touch($newtmpfile); if ($returncode != 0) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion for '" . $filepath . "' from '" . $fromformat . "' to '" . $format . "' " . "was unsuccessful; returned with exit status code (" . $returncode . "). Please check the unoconv " . "configuration and conversion file content / format." ); return $this; } if (!file_exists($newtmpfile)) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion for '" . $filepath . "' from '" . $fromformat . "' to '" . $format . "' " . "was unsuccessful; the output file was not found in '" . $newtmpfile . "'. Please check the disk " . "permissions." ); return $this; } if (filesize($newtmpfile) === 0) { $conversion->set('status', conversion::STATUS_FAILED); error_log( "Unoconv conversion for '" . $filepath . "' from '" . $fromformat . "' to '" . $format . "' " . "was unsuccessful; the output file size has 0 bytes in '" . $newtmpfile . "'. Please check the " . "conversion file content / format with the command: [ " . $cmd . " ]" ); return $this; } $conversion ->store_destfile_from_path($newtmpfile) ->set('status', conversion::STATUS_COMPLETE) ->update(); return $this; } /** * Poll an existing conversion for status update. * * @param conversion $conversion The file to be converted * @return $this */ public function poll_conversion_status(conversion $conversion) { // Unoconv does not support asynchronous conversion. return $this; } /** * Generate and serve the test document. * * @return void */ public function serve_test_document() { global $CFG; require_once($CFG->libdir . '/filelib.php'); $format = 'pdf'; $filerecord = [ 'contextid' => \context_system::instance()->id, 'component' => 'test', 'filearea' => 'fileconverter_unoconv', 'itemid' => 0, 'filepath' => '/', 'filename' => 'unoconv_test.docx' ]; // Get the fixture doc file content and generate and stored_file object. $fs = get_file_storage(); $testdocx = $fs->get_file($filerecord['contextid'], $filerecord['component'], $filerecord['filearea'], $filerecord['itemid'], $filerecord['filepath'], $filerecord['filename']); if (!$testdocx) { $fixturefile = dirname(__DIR__) . '/tests/fixtures/unoconv-source.docx'; $testdocx = $fs->create_file_from_pathname($filerecord, $fixturefile); } $conversions = conversion::get_conversions_for_file($testdocx, $format); foreach ($conversions as $conversion) { if ($conversion->get('id')) { $conversion->delete(); } } $conversion = new conversion(0, (object) [ 'sourcefileid' => $testdocx->get_id(), 'targetformat' => $format, ]); $conversion->create(); // Convert the doc file to the target format and send it direct to the browser. $this->start_document_conversion($conversion); do { sleep(1); $this->poll_conversion_status($conversion); $status = $conversion->get('status'); } while ($status !== conversion::STATUS_COMPLETE && $status !== conversion::STATUS_FAILED); readfile_accel($conversion->get_destfile(), 'application/pdf', true); } /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { if (self::$requirementsmet === null) { $requirementsmet = self::test_unoconv_path()->status === self::UNOCONVPATH_OK; $requirementsmet = $requirementsmet && self::is_minimum_version_met(); self::$requirementsmet = $requirementsmet; } return self::$requirementsmet; } /** * Whether the minimum version of unoconv has been met. * * @return bool */ protected static function is_minimum_version_met() { global $CFG; $currentversion = 0; $supportedversion = 0.7; $unoconvbin = \escapeshellarg($CFG->pathtounoconv); $command = "$unoconvbin --version"; exec($command, $output); // If the command execution returned some output, then get the unoconv version. if ($output) { foreach ($output as $response) { if (preg_match('/unoconv (\\d+\\.\\d+)/', $response, $matches)) { $currentversion = (float) $matches[1]; } } if ($currentversion < $supportedversion) { return false; } else { return true; } } return false; } /** * Whether the plugin is fully configured. * * @return \stdClass */ public static function test_unoconv_path() { global $CFG; $unoconvpath = $CFG->pathtounoconv; $ret = new \stdClass(); $ret->status = self::UNOCONVPATH_OK; $ret->message = null; if (empty($unoconvpath)) { $ret->status = self::UNOCONVPATH_EMPTY; return $ret; } if (!file_exists($unoconvpath)) { $ret->status = self::UNOCONVPATH_DOESNOTEXIST; return $ret; } if (is_dir($unoconvpath)) { $ret->status = self::UNOCONVPATH_ISDIR; return $ret; } if (!\file_is_executable($unoconvpath)) { $ret->status = self::UNOCONVPATH_NOTEXECUTABLE; return $ret; } if (!self::is_minimum_version_met()) { $ret->status = self::UNOCONVPATH_VERSIONNOTSUPPORTED; return $ret; } return $ret; } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { return self::is_format_supported($from) && self::is_format_supported($to); } /** * Whether the specified file format is supported. * * @param string $format Whether conversions between this format and another are supported * @return bool */ protected static function is_format_supported($format) { $formats = self::fetch_supported_formats(); $format = trim(\core_text::strtolower($format)); return in_array($format, $formats); } /** * Fetch the list of supported file formats. * * @return array */ protected static function fetch_supported_formats() { global $CFG; if (!isset(self::$formats)) { // Ask unoconv for it's list of supported document formats. $cmd = escapeshellcmd(trim($CFG->pathtounoconv)) . ' --show'; $pipes = array(); $pipesspec = array(2 => array('pipe', 'w')); $proc = proc_open($cmd, $pipesspec, $pipes); $programoutput = stream_get_contents($pipes[2]); fclose($pipes[2]); proc_close($proc); $matches = array(); preg_match_all('/\[\.(.*)\]/', $programoutput, $matches); $formats = $matches[1]; self::$formats = array_unique($formats); } return self::$formats; } /** * A list of the supported conversions. * * @return string */ public function get_supported_conversions() { return implode(', ', self::fetch_supported_formats()); } } PK b<�\ �ye> > 3 converter/unoconv/lang/en/fileconverter_unoconv.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Strings for plugin 'fileconverter_unoconv' * * @package fileconverter_unoconv * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $string['pathtounoconv'] = 'Path to unoconv document converter'; $string['pathtounoconv_help'] = 'Path to unoconv document converter. This is an executable that is capable of converting between document formats supported by LibreOffice. This is optional, but if specified, Moodle will use it to automatically convert between document formats. This is used to support a wider range of input files for the assignment annotate PDF feature.'; $string['pluginname'] = 'Unoconv'; $string['privacy:metadata'] = 'The Unoconv document converter plugin does not store any personal data.'; $string['test_unoconv'] = 'Test unoconv path'; $string['test_unoconvdoesnotexist'] = 'The unoconv path does not point to the unoconv program. Please review your path settings.'; $string['test_unoconvdownload'] = 'Download the converted pdf test file.'; $string['test_unoconvempty'] = 'The unoconv path is not set. Please review your path settings.'; $string['test_unoconvisdir'] = 'The unoconv path points to a folder, please include the unoconv program in the path you specify'; $string['test_unoconvnotestfile'] = 'The test document to be converted to PDF is missing.'; $string['test_unoconvnotexecutable'] = 'The unoconv path points to a file that is not executable'; $string['test_unoconvok'] = 'The unoconv path appears to be properly configured.'; $string['test_unoconvversionnotsupported'] = 'The version of unoconv you have installed is not supported.'; PK b<�\��z� � converter/unoconv/version.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Version details * * @package fileconverter_unoconv * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $plugin->version = 2024100700; // The current plugin version (Date: YYYYMMDDXX). $plugin->requires = 2024100100; // Requires this Moodle version. $plugin->component = 'fileconverter_unoconv'; // Full name of the plugin (used for diagnostics). PK b<�\=W�A� � converter/unoconv/db/install.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. defined('MOODLE_INTERNAL') || die(); /** * Installation for unoconv. * * @package fileconverter_unoconv * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ function xmldb_fileconverter_unoconv_install() { global $CFG; $unoconvpresent = !empty($CFG->pathtounoconv); $unoconvpresent = $unoconvpresent && file_exists($CFG->pathtounoconv); $unoconvpresent = $unoconvpresent && !is_dir($CFG->pathtounoconv); $unoconvpresent = $unoconvpresent && file_is_executable($CFG->pathtounoconv); if ($unoconvpresent) { // Unoconv is currently configured correctly. // Enable it. $plugins = \core_plugin_manager::instance()->get_plugins_of_type('fileconverter'); $plugins['unoconv']->set_enabled(true); } } PK b<�\y�x�h h 4 converter/unoconv/tests/fixtures/unoconv-source.htmlnu �[��� <!DOCTYPE html> <html> <body> <h1>My First Heading</h1> <p>My first paragraph.</p> </body> </html> PK b<�\��9+ 9+ 4 converter/unoconv/tests/fixtures/unoconv-source.docxnu �[��� PK ! ��7f [Content_Types].xml �(� �T�n�0�W�?D�V����� �8�H� `� X�K��nDU A*�)Y����ă�ښl 1i�J�/z,'��nV���K~ϲ��)a���m ���j0�Hu�T�9bx�<�9X� �Q��� ��8�A�O1~���q� �� k 6 <A%��5}�*�`� �k�����I)_:��%�1�ٜIs � �`� C]9N��{#k�V��E�WaI_����rai���N_UZB�_���%�D�[S�+���?�#��@�[�.z�9�>$N{9� ��+P9Y ��vu�GD����oR��w�ͳ� �Iʊ~���8��W�Z�"V0}���������>����uQw H o�� �� PK ! ��� N _rels/.rels �(� ���JA ���a�}7� "���H�w"����w̤ھ�� �P�^����O֛���;�<�aYՠ؛`G�kxm��PY�[��g Gΰino�/<���<�1��ⳆA$>"f3��\�ȾT�� I S����������W����Y ig�@��X6_�]7~ f��ˉ�ao�.b*lI�r�j)�,l0�%��b� 6�i��D�_���, � ���|u�Z^t٢yǯ; !Y,}{�C��/h> �� PK ! �d�Q� 1 word/_rels/document.xml.rels �(� ���j�0���{-;���ȹ�@��� �����$���~� CR���`Fh擴��wo�'�U�%)���:�(x/vw� ����q H��oo6�h4�C�v�DL���e�k)�l�ה8�6��.� ��� �U�>�0̀�"S�+a_݃( ���vuݕ���c���T�/<�!s� �X d3�� �����?'g![�?� 4��%�9����R�k6��$C�,�`& g�!/=� �� PK ! [ \� � word/document.xml�W�n�8}_��@蹱d;U �v��b��� @Sc��Hjy�� �Vݸn�}(D!������G��=hÕ��A�L�\�����$ �R��\I�0��ً�^�I�� -A�${�f�I���f� �(�*-�šޅ�ꏮ�bJ�� Ϲ=��(��F��NˤQq%8�ʨ��[��rͧݡ/�[�\4.WC 9����xaZm��0ĬU�?�^����Z�i��y�v�tZh��]��N�0:g�Ы�v\�B�f뉠\vj��$�]����� zU��X��,mTz�߂� ���~D�"��7A;��D�L.`K]nO%+?u3_�F��b�+k{�U�i> ��<�@���]+y�~�a#�o�F֩K����=d���Ă�ބ� U�0^�Ƌۻ�����*�e<�����}M$:c�Q� �(U�|9��2Z,?�l?������Gȫl2�+��*�7K�㡳�K0��i`����.�M��0<�4 a���<q&�� /`����C0�Ki�� �Vhn `_���Y�Д�0dH�/����� "�tB �䛌��*%�K�S���,�)[�"�NR�Z�W�C� �ˏ��_��'�ˬհj���f����<�9��K��I��jQ��aQ�a�ů r4�'������ ݾ���mǬ �RưW�6�a�uFS$�����[f |��L�<��{�28A�����I���:�)��'�� ��h�.� ����9\VU4��p!rR�� D�#! �W xdPX�%��J��ڿ|KSU��ZI�J�Δ祿X��;^�e�ߚ����_�5n�K��E�ۭ�EpJ|� o�c�L2�?��'5J��o��XU��n>�.CM�p��U��� �G� �b�pᓨL�J٣���j�4x! .j���R%��(ɹ�� � ��&��F�j ���k9� �� PK ! ���� P word/theme/theme1.xml�YOo�6��w toc'vu�ر�-M�n� i���P�@�I}��úa��m�a[�إ�4�:l Я�GR��X^�6؊�>$�� ����� !)O�^�r�C$�y@���� �/�yH*��)�����UDb�`}"�qۋ�Jח���X^�)I`n�E���p)���li�V[]�1M<������O�P��6r�=���z�gb�Ig��u��S�e b��O������R�D۫����qu �g��Z����o~ٺlAp�lx�pT0���+[}`j ���zA� �V�2�F���i�@�q�v�֬5\|��ʜ̭N��le�X�d s���jcs���7���f���� ��W��+�Ն�7����`� ��g� Ș��J���j|��h(�K��D-���� dX��iJ�؇(��x$(� �:��;�˹!� I_�T��S 1�����?E�� ?�����?ZBΪm���U/����� �?�~����xY���'���y5�g&/����ɋ�>���G�M�Ge���D�����3Vq%'#q�����$�8��K��� ��)f�w 9:ĵ� � x}r�x����w���r�:\TZaG�*�y8I�j�bR��c|XŻ�ǿ�I u3KG�nD 1�NIB�s��� ��R��u���K>V�.E L+M2�#'�f��i ~�V� �vl�{u8��z� �H� �*� ��:�( W� ☕ ~��J�T�e\O*�tHG��HY�� }KN�P�*ݾ˦��� TѼ�9/#��A7�qZ� �$*c?���qU��n��w�N��%��O��i�4 =3ڗP�� ����1�P�m \\9���������Mؓ�2a�D�]�;Yt�\��[x����]�}Wr��|�]��g-��� eW� �)6-r��C S�j�� i�d �DЇA�ΜIqbJ#x�꺃 6k���#��A�Sh��&ʌt(Q�% ��p%m��&]�caS l=�X�����\P�1�Mh�9�M��V�dDA��aV�B��[݈fJ�íP|8� քA�V^��f �H��n���-� �"�d>�z��n��NJ� �ة�>�b���&����2��v����Kyϼ��D:����,AGm��\nz��i�Ù ��.uχYC�6�OMf��3o�r��$��5�����N H�T[XF64�T,ќ���M0�E)`#�5�XY�`�פ ;��%�1�U�٥m;���R>QD ����D�cp�U�'��&LE�/p���m���%]�����8fi��r�S4�d 7y\�`�J�n���ί�I� R� �3U�~7+���#��m� q�BiD���������i*�L6�9�m�Y&���i���HE��=(K&�N!V�.K�e�LD�ĕ�{D ����vEꦚde��NƟ��e�(�MN9ߜR�6����&3(��a���/D��U�z�<�{ˊ�Y��ȳ����V���)�9�Z[��4^n��5���!J��?��Q�3�eBo�C����M ����m<�.�vp�� ���IY�f���Z�Y_p�[�=al-�Y�}Nc͙���ŋ4vfa��vl����'S��A�8�|�*u�{��-�ߟ0%M0�7%��� �<�� �ҍ� �� PK ! �R \: � word/settings.xml�U�r�0}�L��Ṏ�i��/q/���:}� �h��H� ����d��t���j��\^?1� ��D� ^��y!J�w3���z0�=m/ ����w��Lcc�L{ �u&f�^�LfH)��bk�`��nI�ۏ�z��_#��u�sP� Ő�B톍�J{��FA���@��"R;5��jpT�D�]��;��k��u�B�� o �:H% �5d��� �d4}�N��[�+�N/D���~ ��c&�* ���A�-Q�-�S��L���N�¼�/(��Q��E�* V� �~)�Q�:�R� �L*�\�;d곡�Jm��� B��4ͣ�ò L�y�F��L'Q��-�t<�e�j=�c�Q0��U���E�[|L��>�d����L�FQҫ6��x ���'�8�'���\�u�j�y�$�?;�(��}j�y�Hz�X��-��sV�h���^{�T�l�~Wn����XS�K�rE�wg�J�e�z\� �0�/��>w�`��!J�P����m��h���Z��!��닱L���K_��l�a�I��lT� �/�� �q�G��%��z�o��^~A�y���K�130~���-�;�+��o��1+����Ц`��Oɮ2�[���z��jv��7��7�va �%X��9l�a���K �tX��b0����?�(tK�o�������@Mt�$�w�� Ld5�@� 2�����O�����? ��uo�):��9���5�g�W"�`��Ou� O���X� .����n|~h�D� �0i�Pp�zD��� �� �� PK ! ��R| word/fontTable.xml��_o�0�ߗ�;��O*� �s�q�� W,҄������P�g�+ 紇ˏ3���"� ���u;�B�f#�6a߫�˘�@o�0Z$� �ͦ�O�*Όv�y��MX�\�!��P� S M^f�G�v�,��x7�N ��ahE�ލ�,��i�=i���ҚT Ұ��y �f�v���5(�z�\[�%h��K� ���/�������:!��p����(Y �*V��ti~�`%� �-�[2v�� �sZ�ǒy���~-��[�D4T�Z�w��M�����B9�S4~����T�OQ_F�GuM$�C"1 5��CDl�����G���Ld|��g"�Ɔ�m"��D��p�5O�&�X7 '�w78�O7ڒ�� �� PK ! J؊�� word/webSettings.xml��j�0 ��{a�t_��0JHR(�/�\Gi �d$m��5l��z����_im>Q42 �m�A <E� py?=�Q�4�� �F����KW�zF���MUH;`1˝sL^����6�$o����y��8|$$s��}u���Z�K� ZyD+,S�ZC��% ����b�?xb9 Eqc��w �� PK ! ӆ � docProps/app.xml �(� �RMO�0 �#� ��Y:��6!|I+p���H�(���8t늸����<?n�zS|b���E9�Ue�V:�m�(_뻓˲�IX%���(��~|/�y Ic,���E٥����^��-Uz������WNnz���V�ï�V�:�#a90^���*'���Vo= �Pc�Hȟ� 3S.���,�. S� ��G /���� �]P�� !,;�L� ���q���{��H�-�2��T<��P��-@άQn�N[^�BxЖ�\ RD��v�Fk) .i|��!K�{a�|� ���pCڋ��H3�� ���n����NN xש[{!I�Uv�`Ťk2 Ͷ�;$��L~���վ�o!��6�[>?�Ut~���he��� �� PK ! ���/� G docProps/core.xml �(� ��Mk�0����-+���:����P�KKo�4Y��%#������uwi]F���; ���eo��n�e^pN{c�~˿ٚ����z[~��o��Oݗ��|-DF$K�oy�ؗBD�@�bN G� :����~U{�E�Yt��(T"�~!�#����� F h��Q�\��Z��� L�3eg��SMG��l���~�v�㘏���������Tjf]�^m�.�b U ��zHf7b�O�8<���t����P� �ݩ��j'�)�f� �� q�@��H����FFG1<�����i��3�!�a虁�S!A!��i: mC>}}�L߷*⎶�ł�;|`�_Mz�ͦ��֓�%��LC��'7�r �)�cu�P?�:�� �_j)˂N�+Y�x��0_tG��A�E-W���$� s�/W�� �� PK ! 6�� �B word/styles.xml�[�r�H}ߪ��wǺؒ튒�u�Z'q"��y#����/����!� )W�� }��{N��9�?>/}�QF����g[2pB� �'����ޑmʼn\ᇁ��/2�?~��O'q����A|M�E��N��cg!�"~�d ��a� \F���|�9�"tҥ ��A�7ڏ�/ ��*�3kOkOa䮢Бq �.}mo)��� s!�"��X]F7Qv�]��U$��t"b��n�qq�a��4�=�H'��'��\����q�`��s={_!ƿ���'�`���+6�|��c��wvY�db�`�n��f`wb�hoz���c��g!��F�p����f�<��@ȇ2�{*у�(����0 �$�@� ���ei�!��婮�+�ס� �i7&6b����� #/y���� �r�}�\W������2���� �~�%�Yt�4H��������gG�T���@� U/��l\�A�Ro� (���9d_�p+�B ��,�'F������]���&ڛ8lo���\��{��6#�6 UIOj:����0<�Q��J5�Q)��7*5�F�$ߨT@���7�Q�o��t�|�H\�*�l�����R�����-�.k5֍��}$V K5ֲۻ�r����H��'�i��}�@wVK�՜|�\-D��a�-��V�|i�yn#ԡ.�JL�1���n|��E�2�n��(��5ջ�F�Z��ڻ_$�t�-�lT3�3��_{1���4� ��8)�����7�E�^�̧��i>g���.����j�B%��n��>��\��U�)��V�J��u�z�}���e3ͅ� ,�����y��<��5�Hc� 6�؋��'�Ę��7��:u �ˍR��\�y���N�F��F������T�0��q-�M�?䣧���m��f�ٸ��53 -������I� zP�yT����$� mX��hY=�~��q��� j�@�Z!��>�<�'�A�7G��Mò#3�����:ꛄ�W��j�$��T�vvJ���MVg}��U�5�sT�TNP�Y2;BDݐ7��& uC����� � y���`8�H� |��*�7�� ���}����&��T%o ;;u�M��G8�P�2TG�ꆼ @ݐ7��& uC��nț Ԟ��A�#o� �ɛ ĦT$o>�ᆭ䍫���7���*yP��)�٤�� *a�&`�#�bȰ��9AuCބ��!oP7�M ꆼ @�ɻ�;�&`���pj�� @lz0@E�& ��a+y�b���M@a'�J�vvJ�jx���NP ː7 �5y���q"ꆼ uC��nț Ԟ��A�#o� �ɛ ĦT$o���7���N�v���M@ag�D��� X��� ���!ofk�& �#� �U�IS7�M���& �'�f��ț���éE�& �� ɛ ��u�����k��z� ?�@ �$� ��C�eJ&�|:�%` !��<�!���E;�=�)2�7��t��)��a8ޡ$��vn}���{XR�'o@=T� �<I ����e��U~�\Y���ue ԡ}A�@�&"�?J�Ϣ�*��O�0~ٛ�?�� \����2�Zm�� � ��е��fTKߔ ]Z;�w8]]s �X�-t������#���;�c r�Y�{�r���uq ��b#�I�A ��ׯL1��~�i�Dc~��� 15� �Ï�r;�s��Nݼ�$x*����7;5�V����� u4�r8:�:��b=$a�������"?��|G�HA��c9� �5u�@��;J= 5�bϗ ���C��jz�J2!�z����8 C��'Jt@� �~�[� -�.�)��R@��Is��Nf�.5��9Pk��X��F�g���s�_f�� ��\-M0���ޫdj&I��?BiB���3�RQ?�A�����;R𗔁���Zy�d�Z�B� ���_��W�����tCW:!HD�Ő uB�z�� ���87��ՙ�ubR�3�dǙ������P��XR%��_ ��.�6�_`"s�k��v�!�=�JVd�)�UXpz�9I���m2��!�nn �[� �9n�p��tkZ���ރ�L' �K�p��Z��\s��IcX�S�)o6օV^_x�Z�`]]WY �k�=��W2���ML�z߲�_�nv`�� ��M�q;��P�z�7�^�սe�g���Zyg�?� �� PK- ! ��7f [Content_Types].xmlPK- ! ��� N � _rels/.relsPK- ! �d�Q� 1 � word/_rels/document.xml.relsPK- ! [ \� � � word/document.xmlPK- ! ���� P � word/theme/theme1.xmlPK- ! �R \: � � word/settings.xmlPK- ! ��R| word/fontTable.xmlPK- ! J؊�� � word/webSettings.xmlPK- ! ӆ � � docProps/app.xmlPK- ! ���/� G k docProps/core.xmlPK- ! 6�� �B S word/styles.xmlPK � b( PK b<�\6ŚH` ` * converter/unoconv/tests/converter_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. namespace fileconverter_unoconv; /** * A set of tests for some of the unoconv functionality within Moodle. * * @package fileconverter_unoconv * @copyright 2016 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class converter_test extends \advanced_testcase { /** * Helper to skip tests which _require_ unoconv. */ protected function require_unoconv() { global $CFG; if (empty($CFG->pathtounoconv) || !file_is_executable(trim($CFG->pathtounoconv))) { // No conversions are possible, sorry. $this->markTestSkipped(); } } /** * Get a testable mock of the fileconverter_unoconv class. * * @param array $mockedmethods A list of methods you intend to override * If no methods are specified, only abstract functions are mocked. * @return \fileconverter_unoconv\converter */ protected function get_testable_mock($mockedmethods = []) { $converter = $this->getMockBuilder(\fileconverter_unoconv\converter::class) ->onlyMethods($mockedmethods) ->getMock(); return $converter; } /** * Tests for the start_document_conversion function. */ public function test_start_document_conversion(): void { $this->resetAfterTest(); $this->require_unoconv(); // Mock the file to be converted. $filerecord = [ 'contextid' => \context_system::instance()->id, 'component' => 'test', 'filearea' => 'unittest', 'itemid' => 0, 'filepath' => '/', 'filename' => 'test.docx', ]; $fs = get_file_storage(); $source = __DIR__ . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'unoconv-source.docx'; $testfile = $fs->create_file_from_pathname($filerecord, $source); $converter = $this->get_testable_mock(); $conversion = new \core_files\conversion(0, (object) [ 'targetformat' => 'pdf', ]); $conversion->set_sourcefile($testfile); $conversion->create(); // Convert the document. $converter->start_document_conversion($conversion); $result = $conversion->get_destfile(); $this->assertNotFalse($result); $this->assertSame('application/pdf', $result->get_mimetype()); $this->assertGreaterThan(0, $result->get_filesize()); } /** * Tests for the test_unoconv_path function. * * @dataProvider provider_test_unoconv_path * @param string $path The path to test * @param int $status The expected status */ public function test_test_unoconv_path($path, $status): void { global $CFG; $this->resetAfterTest(); // Set the current path. $CFG->pathtounoconv = $path; // Run the tests. $result = \fileconverter_unoconv\converter::test_unoconv_path(); $this->assertEquals($status, $result->status); } /** * Provider for test_unoconv_path. * * @return array */ public static function provider_test_unoconv_path(): array { return [ 'Empty path' => [ 'path' => null, 'status' => \fileconverter_unoconv\converter::UNOCONVPATH_EMPTY, ], 'Invalid file' => [ 'path' => '/path/to/nonexistent/file', 'status' => \fileconverter_unoconv\converter::UNOCONVPATH_DOESNOTEXIST, ], 'Directory' => [ 'path' => __DIR__, 'status' => \fileconverter_unoconv\converter::UNOCONVPATH_ISDIR, ], ]; } } PK b<�\�2 2 ! converter/unoconv/testunoconv.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Test that unoconv is configured correctly * * @package fileconverter_unoconv * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require(__DIR__ . '/../../../config.php'); require_once($CFG->libdir . '/filelib.php'); $sendpdf = optional_param('sendpdf', 0, PARAM_BOOL); $PAGE->set_url(new moodle_url('/files/converter/unoconv/testunoconv.php')); $PAGE->set_context(context_system::instance()); require_login(); require_capability('moodle/site:config', context_system::instance()); $strheading = get_string('test_unoconv', 'fileconverter_unoconv'); $PAGE->navbar->add(get_string('administrationsite')); $PAGE->navbar->add(get_string('plugins', 'admin')); $PAGE->navbar->add(get_string('assignmentplugins', 'mod_assign')); $PAGE->navbar->add(get_string('feedbackplugins', 'mod_assign')); $PAGE->navbar->add(get_string('pluginname', 'fileconverter_unoconv'), new moodle_url('/admin/settings.php', array('section' => 'fileconverterunoconv'))); $PAGE->navbar->add($strheading); $PAGE->set_heading($strheading); $PAGE->set_title($strheading); $converter = new \fileconverter_unoconv\converter(); if ($sendpdf) { require_sesskey(); $converter->serve_test_document(); die(); } $result = \fileconverter_unoconv\converter::test_unoconv_path(); switch ($result->status) { case \fileconverter_unoconv\converter::UNOCONVPATH_OK: $msg = $OUTPUT->notification(get_string('test_unoconvok', 'fileconverter_unoconv'), 'success'); $pdflink = new moodle_url($PAGE->url, array('sendpdf' => 1, 'sesskey' => sesskey())); $msg .= html_writer::link($pdflink, get_string('test_unoconvdownload', 'fileconverter_unoconv')); $msg .= html_writer::empty_tag('br'); break; default: $msg = $OUTPUT->notification(get_string("test_unoconv{$result->status}", 'fileconverter_unoconv'), 'warning'); break; } $returl = new moodle_url('/admin/settings.php', array('section' => 'fileconverterunoconv')); $msg .= $OUTPUT->continue_button($returl); echo $OUTPUT->header(); echo $OUTPUT->box($msg, 'generalbox'); echo $OUTPUT->footer(); PK b<�\MzyS� � converter/unoconv/settings.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Settings for unoconv. * * @package fileconverter_unoconv * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); // Unoconv setting. $settings->add(new admin_setting_configexecutable('pathtounoconv', new lang_string('pathtounoconv', 'fileconverter_unoconv'), new lang_string('pathtounoconv_help', 'fileconverter_unoconv'), '/usr/bin/unoconv') ); $url = new moodle_url('/files/converter/unoconv/testunoconv.php'); $link = html_writer::link($url, get_string('test_unoconv', 'fileconverter_unoconv')); $settings->add(new admin_setting_heading('test_unoconv', '', $link)); PK b<�\���H. . converter/googledrive/lib.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * This plugin is used to convert documents with google drive. * * @package fileconverter_googledrive * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); /** * Callback to get the required scopes for system account. * * @param \core\oauth2\issuer $issuer * @return string */ function fileconverter_googledrive_oauth2_system_scopes(\core\oauth2\issuer $issuer) { if ($issuer->get('id') == get_config('fileconverter_googledrive', 'issuerid')) { return 'https://www.googleapis.com/auth/drive'; } return ''; } PK b<�\�Y� & converter/googledrive/classes/rest.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Google Drive Rest API. * * @package fileconverter_googledrive * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_googledrive; defined('MOODLE_INTERNAL') || die(); /** * Google Drive Rest API. * * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class rest extends \core\oauth2\rest { /** * Define the functions of the rest API. * * @return array Example: * [ 'listFiles' => [ 'method' => 'get', 'endpoint' => 'http://...', 'args' => [ 'folder' => PARAM_STRING ] ] ] */ public function get_api_functions() { return [ 'upload' => [ 'endpoint' => 'https://www.googleapis.com/upload/drive/v3/files', 'method' => 'post', 'args' => [ 'uploadType' => PARAM_RAW, 'fields' => PARAM_RAW ], 'response' => 'headers' ], 'upload_content' => [ 'endpoint' => '{uploadurl}', 'method' => 'put', 'args' => [ 'uploadurl' => PARAM_URL ], 'response' => 'json' ], 'create' => [ 'endpoint' => 'https://www.googleapis.com/drive/v3/files', 'method' => 'post', 'args' => [ 'fields' => PARAM_RAW ], 'response' => 'json' ], 'delete' => [ 'endpoint' => 'https://www.googleapis.com/drive/v3/files/{fileid}', 'method' => 'delete', 'args' => [ 'fileid' => PARAM_RAW ], 'response' => 'json' ], ]; } } PK b<�\�#� � 2 converter/googledrive/classes/privacy/provider.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Privacy class for requesting user data. * * @package fileconverter_googledrive * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_googledrive\privacy; defined('MOODLE_INTERNAL') || die(); use \core_privacy\local\metadata\collection; use \core_privacy\local\request\contextlist; use \core_privacy\local\request\approved_contextlist; use \core_privacy\local\request\userlist; use \core_privacy\local\request\approved_userlist; /** * Privacy class for requesting user data. * * @package fileconverter_googledrive * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class provider implements \core_privacy\local\metadata\provider, \core_privacy\local\request\core_userlist_provider, \core_privacy\local\request\plugin\provider { /** * Returns meta data about this system. * * @param collection $collection The initialised collection to add items to. * @return collection A listing of user data stored through this system. */ public static function get_metadata(collection $collection): collection { $collection->add_external_location_link('googledrive', [ 'params' => 'privacy:metadata:fileconverter_googledrive:params', 'filecontent' => 'privacy:metadata:fileconverter_googledrive:filecontent', 'filemimetype' => 'privacy:metadata:fileconverter_googledrive:filemimetype', ], 'privacy:metadata:fileconverter_googledrive:externalpurpose'); return $collection; } /** * Get the list of contexts that contain user information for the specified user. * * @param int $userid The user to search. * @return contextlist $contextlist The contextlist containing the list of contexts used in this plugin. */ public static function get_contexts_for_userid(int $userid): contextlist { $contextlist = new contextlist(); return $contextlist; } /** * Get the list of users who have data within a context. * * @param userlist $userlist The userlist containing the list of users who have data in this context/plugin combination. */ public static function get_users_in_context(userlist $userlist) { } /** * Export all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts to export information for. */ public static function export_user_data(approved_contextlist $contextlist) { } /** * Delete all use data which matches the specified deletion_criteria. * * @param \context $context A user context. */ public static function delete_data_for_all_users_in_context(\context $context) { } /** * Delete multiple users within a single context. * * @param approved_userlist $userlist The approved context and user information to delete information for. */ public static function delete_data_for_users(approved_userlist $userlist) { } /** * Delete all user data for the specified user, in the specified contexts. * * @param approved_contextlist $contextlist The approved contexts and user information to delete information for. */ public static function delete_data_for_user(approved_contextlist $contextlist) { } } PK b<�\�|E"�# �# + converter/googledrive/classes/converter.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class for converting files between different file formats using google drive. * * @package fileconverter_googledrive * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_googledrive; defined('MOODLE_INTERNAL') || die(); use stored_file; use moodle_exception; use moodle_url; use \core_files\conversion; /** * Class for converting files between different formats using unoconv. * * @package fileconverter_googledrive * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class converter implements \core_files\converter_interface { /** @var array $imports List of supported import file formats */ private static $imports = [ 'doc' => 'application/vnd.google-apps.document', 'docx' => 'application/vnd.google-apps.document', 'rtf' => 'application/vnd.google-apps.document', 'xls' => 'application/vnd.google-apps.spreadsheet', 'xlsx' => 'application/vnd.google-apps.spreadsheet', 'ppt' => 'application/vnd.google-apps.presentation', 'pptx' => 'application/vnd.google-apps.presentation', 'html' => 'application/vnd.google-apps.document' ]; /** @var array $export List of supported export file formats */ private static $exports = [ 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'rtf' => 'application/rtf', 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', 'pdf' => 'application/pdf', 'txt' => 'text/plain' ]; /** * Convert a document to a new format and return a conversion object relating to the conversion in progress. * * @param \core_files\conversion $conversion The file to be converted * @return this */ public function start_document_conversion(\core_files\conversion $conversion) { global $CFG; $file = $conversion->get_sourcefile(); $format = $conversion->get('targetformat'); $issuerid = get_config('fileconverter_googledrive', 'issuerid'); if (empty($issuerid)) { $conversion->set('status', conversion::STATUS_FAILED); return $this; } $issuer = \core\oauth2\api::get_issuer($issuerid); if (empty($issuer)) { $conversion->set('status', conversion::STATUS_FAILED); return $this; } $client = \core\oauth2\api::get_system_oauth_client($issuer); $service = new \fileconverter_googledrive\rest($client); $contenthash = $file->get_contenthash(); $originalname = $file->get_filename(); if (strpos($originalname, '.') === false) { $conversion->set('status', conversion::STATUS_FAILED); return $this; } $importextension = substr($originalname, strrpos($originalname, '.') + 1); $importformat = self::$imports[$importextension]; $exportformat = self::$exports[$format]; $metadata = [ 'name' => $contenthash, 'mimeType' => $importformat ]; $filecontent = $file->get_content(); $filesize = $file->get_filesize(); $filemimetype = $file->get_mimetype(); // Start resumable upload. // First create empty file. $params = [ 'uploadType' => 'resumable', 'fields' => 'id,name' ]; $client->setHeader('X-Upload-Content-Type: ' . $filemimetype); $client->setHeader('X-Upload-Content-Length: ' . $filesize); $headers = $service->call('upload', $params, json_encode($metadata)); $uploadurl; // Google returns a location header with the location for the upload. foreach ($headers as $header) { if (stripos($header, 'Location:') === 0) { $uploadurl = trim(substr($header, strpos($header, ':') + 1)); } } if (empty($uploadurl)) { $conversion->set('status', conversion::STATUS_FAILED); return $this; } $params = [ 'uploadurl' => $uploadurl ]; $result = $service->call('upload_content', $params, $filecontent, $filemimetype); $fileid = $result->id; // Now export it again. $params = ['mimeType' => $exportformat]; $sourceurl = new moodle_url('https://www.googleapis.com/drive/v3/files/' . $fileid . '/export', $params); $source = $sourceurl->out(false); $tmp = make_request_directory(); $downloadto = $tmp . '/' . $fileid . '.' . $format; $options = ['filepath' => $downloadto, 'timeout' => 15, 'followlocation' => true, 'maxredirs' => 5]; $success = $client->download_one($source, null, $options); if ($success) { $conversion->store_destfile_from_path($downloadto); $conversion->set('status', conversion::STATUS_COMPLETE); $conversion->update(); } else { $conversion->set('status', conversion::STATUS_FAILED); } // Cleanup. $params = [ 'fileid' => $fileid ]; $service->call('delete', $params); return $this; } /** * Generate and serve the test document. * * @return stored_file */ public function serve_test_document() { global $CFG; require_once($CFG->libdir . '/filelib.php'); $filerecord = [ 'contextid' => \context_system::instance()->id, 'component' => 'test', 'filearea' => 'fileconverter_googledrive', 'itemid' => 0, 'filepath' => '/', 'filename' => 'conversion_test.docx' ]; // Get the fixture doc file content and generate and stored_file object. $fs = get_file_storage(); $testdocx = $fs->get_file($filerecord['contextid'], $filerecord['component'], $filerecord['filearea'], $filerecord['itemid'], $filerecord['filepath'], $filerecord['filename']); if (!$testdocx) { $fixturefile = dirname(__DIR__) . '/tests/fixtures/source.docx'; $testdocx = $fs->create_file_from_pathname($filerecord, $fixturefile); } $conversion = new \core_files\conversion(0, (object) [ 'targetformat' => 'pdf', ]); $conversion->set_sourcefile($testdocx); $conversion->create(); // Convert the doc file to pdf and send it direct to the browser. $this->start_document_conversion($conversion); $testfile = $conversion->get_destfile(); readfile_accel($testfile, 'application/pdf', true); } /** * Poll an existing conversion for status update. * * @param conversion $conversion The file to be converted * @return $this; */ public function poll_conversion_status(conversion $conversion) { return $this; } /** * Whether the plugin is configured and requirements are met. * * @return bool */ public static function are_requirements_met() { $issuerid = get_config('fileconverter_googledrive', 'issuerid'); if (empty($issuerid)) { return false; } $issuer = \core\oauth2\api::get_issuer($issuerid); if (empty($issuer)) { return false; } if (!$issuer->get('enabled')) { return false; } if (!$issuer->is_system_account_connected()) { return false; } return true; } /** * Whether a file conversion can be completed using this converter. * * @param string $from The source type * @param string $to The destination type * @return bool */ public static function supports($from, $to) { // This is not a one-liner because of php 5.6. $imports = self::$imports; $exports = self::$exports; return isset($imports[$from]) && isset($exports[$to]); } /** * A list of the supported conversions. * * @return string */ public function get_supported_conversions() { return implode(', ', ['rtf', 'doc', 'xls', 'docx', 'xlsx', 'ppt', 'pptx', 'pdf', 'html']); } } PK b<�\>e�$� � ; converter/googledrive/lang/en/fileconverter_googledrive.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Strings for plugin 'fileconverter_googledrive' * * @package fileconverter_googledrive * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $string['pluginname'] = 'Google Drive'; $string['disabled'] = 'Disabled'; $string['issuer'] = 'OAuth 2 service'; $string['issuer_help'] = 'The OAuth 2 service used to access Google Drive.'; $string['privacy:metadata:fileconverter_googledrive:externalpurpose'] = 'This information is sent to Google Drive API in order the file to be converted to an alternative format. The file is temporarily kept on Google Drive and gets deleted after the conversion is done.'; $string['privacy:metadata:fileconverter_googledrive:filecontent'] = 'The content of the file.'; $string['privacy:metadata:fileconverter_googledrive:filemimetype'] = 'The MIME type of the file.'; $string['privacy:metadata:fileconverter_googledrive:params'] = 'The query parameters passed to Google Drive API.'; $string['test_converter'] = 'Test this converter is working properly.'; $string['test_conversion'] = 'Test document conversion'; $string['test_conversionready'] = 'This document converter is configured properly.'; $string['test_conversionnotready'] = 'This document converter is not configured properly.'; $string['test_issuerinvalid'] = 'The OAuth service in the document converter settings is set to an invalid value.'; $string['test_issuernotenabled'] = 'The OAuth service set in the document converter settings is not enabled.'; $string['test_issuernotconnected'] = 'The OAuth service set in the document converter settings does not have a system account connected.'; $string['test_issuernotset'] = 'The OAuth service needs to be set in the document converter settings.'; PK b<�\���� � converter/googledrive/test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Test that googledrive is configured correctly * * @package fileconverter_googledrive * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require(__DIR__ . '/../../../config.php'); require_once($CFG->libdir . '/filelib.php'); $sendpdf = optional_param('sendpdf', 0, PARAM_BOOL); $PAGE->set_url(new moodle_url('/files/converter/googledrive/test.php')); $PAGE->set_context(context_system::instance()); require_login(); require_capability('moodle/site:config', context_system::instance()); $strheading = get_string('test_conversion', 'fileconverter_googledrive'); $PAGE->navbar->add(get_string('administrationsite')); $PAGE->navbar->add(get_string('plugins', 'admin')); $PAGE->navbar->add(get_string('pluginname', 'fileconverter_googledrive'), new moodle_url('/admin/settings.php', array('section' => 'fileconvertergoogledrive'))); $PAGE->navbar->add($strheading); $PAGE->set_heading($strheading); $PAGE->set_title($strheading); $converter = new \fileconverter_googledrive\converter(); if ($sendpdf) { require_sesskey(); $converter->serve_test_document(); die(); } $result = $converter->are_requirements_met(); if ($result) { $msg = $OUTPUT->notification(get_string('test_conversionready', 'fileconverter_googledrive'), 'success'); $pdflink = new moodle_url($PAGE->url, array('sendpdf' => 1, 'sesskey' => sesskey())); $msg .= html_writer::link($pdflink, get_string('test_conversion', 'fileconverter_googledrive')); $msg .= html_writer::empty_tag('br'); } else { // Diagnostics time. $issuerid = get_config('fileconverter_googledrive', 'issuerid'); $msg = ''; if (empty($issuerid)) { $msg = $OUTPUT->notification(get_string('test_issuernotset', 'fileconverter_googledrive'), 'warning'); } if (empty($msg)) { $issuer = \core\oauth2\api::get_issuer($issuerid); if (empty($issuer)) { $msg = $OUTPUT->notification(get_string('test_issuerinvalid', 'fileconverter_googledrive'), 'warning'); } } if (empty($msg)) { if (!$issuer->get('enabled')) { $msg = $OUTPUT->notification(get_string('test_issuernotenabled', 'fileconverter_googledrive'), 'warning'); } } if (empty($msg)) { if (!$issuer->is_system_account_connected()) { $msg = $OUTPUT->notification(get_string('test_issuernotconnected', 'fileconverter_googledrive'), 'warning'); } } if (empty($msg)) { $msg = $OUTPUT->notification(get_string('test_conversionnotready', 'fileconverter_googledrive'), 'warning'); } } $returl = new moodle_url('/admin/settings.php', array('section' => 'fileconvertergoogledrive')); $msg .= $OUTPUT->continue_button($returl); echo $OUTPUT->header(); echo $OUTPUT->box($msg, 'generalbox'); echo $OUTPUT->footer(); PK b<�\d;O�� � ! converter/googledrive/version.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Version details * * @package fileconverter_googledrive * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); $plugin->version = 2024100700; // The current plugin version (Date: YYYYMMDDXX). $plugin->requires = 2024100100; // Requires this Moodle version. $plugin->component = 'fileconverter_googledrive'; // Full name of the plugin (used for diagnostics). PK b<�\��9+ 9+ 0 converter/googledrive/tests/fixtures/source.docxnu �[��� PK ! ��7f [Content_Types].xml �(� �T�n�0�W�?D�V����� �8�H� `� X�K��nDU A*�)Y����ă�ښl 1i�J�/z,'��nV���K~ϲ��)a���m ���j0�Hu�T�9bx�<�9X� �Q��� ��8�A�O1~���q� �� k 6 <A%��5}�*�`� �k�����I)_:��%�1�ٜIs � �`� C]9N��{#k�V��E�WaI_����rai���N_UZB�_���%�D�[S�+���?�#��@�[�.z�9�>$N{9� ��+P9Y ��vu�GD����oR��w�ͳ� �Iʊ~���8��W�Z�"V0}���������>����uQw H o�� �� PK ! ��� N _rels/.rels �(� ���JA ���a�}7� "���H�w"����w̤ھ�� �P�^����O֛���;�<�aYՠ؛`G�kxm��PY�[��g Gΰino�/<���<�1��ⳆA$>"f3��\�ȾT�� I S����������W����Y ig�@��X6_�]7~ f��ˉ�ao�.b*lI�r�j)�,l0�%��b� 6�i��D�_���, � ���|u�Z^t٢yǯ; !Y,}{�C��/h> �� PK ! �d�Q� 1 word/_rels/document.xml.rels �(� ���j�0���{-;���ȹ�@��� �����$���~� CR���`Fh擴��wo�'�U�%)���:�(x/vw� ����q H��oo6�h4�C�v�DL���e�k)�l�ה8�6��.� ��� �U�>�0̀�"S�+a_݃( ���vuݕ���c���T�/<�!s� �X d3�� �����?'g![�?� 4��%�9����R�k6��$C�,�`& g�!/=� �� PK ! [ \� � word/document.xml�W�n�8}_��@蹱d;U �v��b��� @Sc��Hjy�� �Vݸn�}(D!������G��=hÕ��A�L�\�����$ �R��\I�0��ً�^�I�� -A�${�f�I���f� �(�*-�šޅ�ꏮ�bJ�� Ϲ=��(��F��NˤQq%8�ʨ��[��rͧݡ/�[�\4.WC 9����xaZm��0ĬU�?�^����Z�i��y�v�tZh��]��N�0:g�Ы�v\�B�f뉠\vj��$�]����� zU��X��,mTz�߂� ���~D�"��7A;��D�L.`K]nO%+?u3_�F��b�+k{�U�i> ��<�@���]+y�~�a#�o�F֩K����=d���Ă�ބ� U�0^�Ƌۻ�����*�e<�����}M$:c�Q� �(U�|9��2Z,?�l?������Gȫl2�+��*�7K�㡳�K0��i`����.�M��0<�4 a���<q&�� /`����C0�Ki�� �Vhn `_���Y�Д�0dH�/����� "�tB �䛌��*%�K�S���,�)[�"�NR�Z�W�C� �ˏ��_��'�ˬհj���f����<�9��K��I��jQ��aQ�a�ů r4�'������ ݾ���mǬ �RưW�6�a�uFS$�����[f |��L�<��{�28A�����I���:�)��'�� ��h�.� ����9\VU4��p!rR�� D�#! �W xdPX�%��J��ڿ|KSU��ZI�J�Δ祿X��;^�e�ߚ����_�5n�K��E�ۭ�EpJ|� o�c�L2�?��'5J��o��XU��n>�.CM�p��U��� �G� �b�pᓨL�J٣���j�4x! .j���R%��(ɹ�� � ��&��F�j ���k9� �� PK ! ���� P word/theme/theme1.xml�YOo�6��w toc'vu�ر�-M�n� i���P�@�I}��úa��m�a[�إ�4�:l Я�GR��X^�6؊�>$�� ����� !)O�^�r�C$�y@���� �/�yH*��)�����UDb�`}"�qۋ�Jח���X^�)I`n�E���p)���li�V[]�1M<������O�P��6r�=���z�gb�Ig��u��S�e b��O������R�D۫����qu �g��Z����o~ٺlAp�lx�pT0���+[}`j ���zA� �V�2�F���i�@�q�v�֬5\|��ʜ̭N��le�X�d s���jcs���7���f���� ��W��+�Ն�7����`� ��g� Ș��J���j|��h(�K��D-���� dX��iJ�؇(��x$(� �:��;�˹!� I_�T��S 1�����?E�� ?�����?ZBΪm���U/����� �?�~����xY���'���y5�g&/����ɋ�>���G�M�Ge���D�����3Vq%'#q�����$�8��K��� ��)f�w 9:ĵ� � x}r�x����w���r�:\TZaG�*�y8I�j�bR��c|XŻ�ǿ�I u3KG�nD 1�NIB�s��� ��R��u���K>V�.E L+M2�#'�f��i ~�V� �vl�{u8��z� �H� �*� ��:�( W� ☕ ~��J�T�e\O*�tHG��HY�� }KN�P�*ݾ˦��� TѼ�9/#��A7�qZ� �$*c?���qU��n��w�N��%��O��i�4 =3ڗP�� ����1�P�m \\9���������Mؓ�2a�D�]�;Yt�\��[x����]�}Wr��|�]��g-��� eW� �)6-r��C S�j�� i�d �DЇA�ΜIqbJ#x�꺃 6k���#��A�Sh��&ʌt(Q�% ��p%m��&]�caS l=�X�����\P�1�Mh�9�M��V�dDA��aV�B��[݈fJ�íP|8� քA�V^��f �H��n���-� �"�d>�z��n��NJ� �ة�>�b���&����2��v����Kyϼ��D:����,AGm��\nz��i�Ù ��.uχYC�6�OMf��3o�r��$��5�����N H�T[XF64�T,ќ���M0�E)`#�5�XY�`�פ ;��%�1�U�٥m;���R>QD ����D�cp�U�'��&LE�/p���m���%]�����8fi��r�S4�d 7y\�`�J�n���ί�I� R� �3U�~7+���#��m� q�BiD���������i*�L6�9�m�Y&���i���HE��=(K&�N!V�.K�e�LD�ĕ�{D ����vEꦚde��NƟ��e�(�MN9ߜR�6����&3(��a���/D��U�z�<�{ˊ�Y��ȳ����V���)�9�Z[��4^n��5���!J��?��Q�3�eBo�C����M ����m<�.�vp�� ���IY�f���Z�Y_p�[�=al-�Y�}Nc͙���ŋ4vfa��vl����'S��A�8�|�*u�{��-�ߟ0%M0�7%��� �<�� �ҍ� �� PK ! �R \: � word/settings.xml�U�r�0}�L��Ṏ�i��/q/���:}� �h��H� ����d��t���j��\^?1� ��D� ^��y!J�w3���z0�=m/ ����w��Lcc�L{ �u&f�^�LfH)��bk�`��nI�ۏ�z��_#��u�sP� Ő�B톍�J{��FA���@��"R;5��jpT�D�]��;��k��u�B�� o �:H% �5d��� �d4}�N��[�+�N/D���~ ��c&�* ���A�-Q�-�S��L���N�¼�/(��Q��E�* V� �~)�Q�:�R� �L*�\�;d곡�Jm��� B��4ͣ�ò L�y�F��L'Q��-�t<�e�j=�c�Q0��U���E�[|L��>�d����L�FQҫ6��x ���'�8�'���\�u�j�y�$�?;�(��}j�y�Hz�X��-��sV�h���^{�T�l�~Wn����XS�K�rE�wg�J�e�z\� �0�/��>w�`��!J�P����m��h���Z��!��닱L���K_��l�a�I��lT� �/�� �q�G��%��z�o��^~A�y���K�130~���-�;�+��o��1+����Ц`��Oɮ2�[���z��jv��7��7�va �%X��9l�a���K �tX��b0����?�(tK�o�������@Mt�$�w�� Ld5�@� 2�����O�����? ��uo�):��9���5�g�W"�`��Ou� O���X� .����n|~h�D� �0i�Pp�zD��� �� �� PK ! ��R| word/fontTable.xml��_o�0�ߗ�;��O*� �s�q�� W,҄������P�g�+ 紇ˏ3���"� ���u;�B�f#�6a߫�˘�@o�0Z$� �ͦ�O�*Όv�y��MX�\�!��P� S M^f�G�v�,��x7�N ��ahE�ލ�,��i�=i���ҚT Ұ��y �f�v���5(�z�\[�%h��K� ���/�������:!��p����(Y �*V��ti~�`%� �-�[2v�� �sZ�ǒy���~-��[�D4T�Z�w��M�����B9�S4~����T�OQ_F�GuM$�C"1 5��CDl�����G���Ld|��g"�Ɔ�m"��D��p�5O�&�X7 '�w78�O7ڒ�� �� PK ! J؊�� word/webSettings.xml��j�0 ��{a�t_��0JHR(�/�\Gi �d$m��5l��z����_im>Q42 �m�A <E� py?=�Q�4�� �F����KW�zF���MUH;`1˝sL^����6�$o����y��8|$$s��}u���Z�K� ZyD+,S�ZC��% ����b�?xb9 Eqc��w �� PK ! ӆ � docProps/app.xml �(� �RMO�0 �#� ��Y:��6!|I+p���H�(���8t늸����<?n�zS|b���E9�Ue�V:�m�(_뻓˲�IX%���(��~|/�y Ic,���E٥����^��-Uz������WNnz���V�ï�V�:�#a90^���*'���Vo= �Pc�Hȟ� 3S.���,�. S� ��G /���� �]P�� !,;�L� ���q���{��H�-�2��T<��P��-@άQn�N[^�BxЖ�\ RD��v�Fk) .i|��!K�{a�|� ���pCڋ��H3�� ���n����NN xש[{!I�Uv�`Ťk2 Ͷ�;$��L~���վ�o!��6�[>?�Ut~���he��� �� PK ! ���/� G docProps/core.xml �(� ��Mk�0����-+���:����P�KKo�4Y��%#������uwi]F���; ���eo��n�e^pN{c�~˿ٚ����z[~��o��Oݗ��|-DF$K�oy�ؗBD�@�bN G� :����~U{�E�Yt��(T"�~!�#����� F h��Q�\��Z��� L�3eg��SMG��l���~�v�㘏���������Tjf]�^m�.�b U ��zHf7b�O�8<���t����P� �ݩ��j'�)�f� �� q�@��H����FFG1<�����i��3�!�a虁�S!A!��i: mC>}}�L߷*⎶�ł�;|`�_Mz�ͦ��֓�%��LC��'7�r �)�cu�P?�:�� �_j)˂N�+Y�x��0_tG��A�E-W���$� s�/W�� �� PK ! 6�� �B word/styles.xml�[�r�H}ߪ��wǺؒ튒�u�Z'q"��y#����/����!� )W�� }��{N��9�?>/}�QF����g[2pB� �'����ޑmʼn\ᇁ��/2�?~��O'q����A|M�E��N��cg!�"~�d ��a� \F���|�9�"tҥ ��A�7ڏ�/ ��*�3kOkOa䮢Бq �.}mo)��� s!�"��X]F7Qv�]��U$��t"b��n�qq�a��4�=�H'��'��\����q�`��s={_!ƿ���'�`���+6�|��c��wvY�db�`�n��f`wb�hoz���c��g!��F�p����f�<��@ȇ2�{*у�(����0 �$�@� ���ei�!��婮�+�ס� �i7&6b����� #/y���� �r�}�\W������2���� �~�%�Yt�4H��������gG�T���@� U/��l\�A�Ro� (���9d_�p+�B ��,�'F������]���&ڛ8lo���\��{��6#�6 UIOj:����0<�Q��J5�Q)��7*5�F�$ߨT@���7�Q�o��t�|�H\�*�l�����R�����-�.k5֍��}$V K5ֲۻ�r����H��'�i��}�@wVK�՜|�\-D��a�-��V�|i�yn#ԡ.�JL�1���n|��E�2�n��(��5ջ�F�Z��ڻ_$�t�-�lT3�3��_{1���4� ��8)�����7�E�^�̧��i>g���.����j�B%��n��>��\��U�)��V�J��u�z�}���e3ͅ� ,�����y��<��5�Hc� 6�؋��'�Ę��7��:u �ˍR��\�y���N�F��F������T�0��q-�M�?䣧���m��f�ٸ��53 -������I� zP�yT����$� mX��hY=�~��q��� j�@�Z!��>�<�'�A�7G��Mò#3�����:ꛄ�W��j�$��T�vvJ���MVg}��U�5�sT�TNP�Y2;BDݐ7��& uC����� � y���`8�H� |��*�7�� ���}����&��T%o ;;u�M��G8�P�2TG�ꆼ @ݐ7��& uC��nț Ԟ��A�#o� �ɛ ĦT$o>�ᆭ䍫���7���*yP��)�٤�� *a�&`�#�bȰ��9AuCބ��!oP7�M ꆼ @�ɻ�;�&`���pj�� @lz0@E�& ��a+y�b���M@a'�J�vvJ�jx���NP ː7 �5y���q"ꆼ uC��nț Ԟ��A�#o� �ɛ ĦT$o���7���N�v���M@ag�D��� X��� ���!ofk�& �#� �U�IS7�M���& �'�f��ț���éE�& �� ɛ ��u�����k��z� ?�@ �$� ��C�eJ&�|:�%` !��<�!���E;�=�)2�7��t��)��a8ޡ$��vn}���{XR�'o@=T� �<I ����e��U~�\Y���ue ԡ}A�@�&"�?J�Ϣ�*��O�0~ٛ�?�� \����2�Zm�� � ��е��fTKߔ ]Z;�w8]]s �X�-t������#���;�c r�Y�{�r���uq ��b#�I�A ��ׯL1��~�i�Dc~��� 15� �Ï�r;�s��Nݼ�$x*����7;5�V����� u4�r8:�:��b=$a�������"?��|G�HA��c9� �5u�@��;J= 5�bϗ ���C��jz�J2!�z����8 C��'Jt@� �~�[� -�.�)��R@��Is��Nf�.5��9Pk��X��F�g���s�_f�� ��\-M0���ޫdj&I��?BiB���3�RQ?�A�����;R𗔁���Zy�d�Z�B� ���_��W�����tCW:!HD�Ő uB�z�� ���87��ՙ�ubR�3�dǙ������P��XR%��_ ��.�6�_`"s�k��v�!�=�JVd�)�UXpz�9I���m2��!�nn �[� �9n�p��tkZ���ރ�L' �K�p��Z��\s��IcX�S�)o6օV^_x�Z�`]]WY �k�=��W2���ML�z߲�_�nv`�� ��M�q;��P�z�7�^�սe�g���Zyg�?� �� PK- ! ��7f [Content_Types].xmlPK- ! ��� N � _rels/.relsPK- ! �d�Q� 1 � word/_rels/document.xml.relsPK- ! [ \� � � word/document.xmlPK- ! ���� P � word/theme/theme1.xmlPK- ! �R \: � � word/settings.xmlPK- ! ��R| word/fontTable.xmlPK- ! J؊�� � word/webSettings.xmlPK- ! ӆ � � docProps/app.xmlPK- ! ���/� G k docProps/core.xmlPK- ! 6�� �B S word/styles.xmlPK � b( PK b<�\{�� � 5 converter/googledrive/tests/privacy/provider_test.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Base class for unit tests for fileconverter_googledrive. * * @package fileconverter_googledrive * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace fileconverter_googledrive\privacy; defined('MOODLE_INTERNAL') || die(); use core_privacy\tests\provider_testcase; /** * Unit tests for files/converter/googledrive/classes/privacy/provider.php * * @copyright 2018 Mihail Geshoski <mihail@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ final class provider_test extends provider_testcase { /** * Test getting the context for the user ID related to this plugin. */ public function test_get_contexts_for_userid(): void { $this->resetAfterTest(); $user = $this->getDataGenerator()->create_user(); $contextlist = \fileconverter_googledrive\privacy\provider::get_contexts_for_userid($user->id); $this->assertEmpty($contextlist); } } PK b<�\�C�U U " converter/googledrive/settings.phpnu �[��� <?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Link to the OAuth 2 service we will use. * * @package fileconverter_googledrive * @copyright 2017 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); if ($hassiteconfig) { $options = []; $issuers = \core\oauth2\api::get_all_issuers(); $options[''] = get_string('disabled', 'fileconverter_googledrive'); foreach ($issuers as $issuer) { $options[$issuer->get('id')] = s($issuer->get('name')); } $settings->add(new admin_setting_configselect('fileconverter_googledrive/issuerid', get_string('issuer', 'fileconverter_googledrive'), get_string('issuer_help', 'fileconverter_googledrive'), '', $options)); $url = new moodle_url('/files/converter/googledrive/test.php'); $link = html_writer::link($url, get_string('test_converter', 'fileconverter_googledrive')); $settings->add(new admin_setting_heading('test_converter', '', $link)); } PK b<�\�G;� � upgrade.txtnu �[��� === 4.5 Onwards === This file has been replaced by UPGRADING.md. See MDL-81125 for further information. === This files describes API changes in /files/*, information provided here is intended especially for developers. === 2.9 === * External function core_files_external::get_files returns additional optional fields: - timecreated: Time created. - filesize: File size. - author: File owner. - license: File license. PK b<�\��� classes/converter_interface.phpnu �[��� PK b<�\ ��X� � ! o classes/external/delete/draft.phpnu �[��� PK b<�\�Q % � classes/external/get/unused_draft.phpnu �[��� PK b<�\=�s?� � ) s' classes/external/stored_file_exporter.phpnu �[��� PK b<�\�c�� � $ �= classes/hook/before_file_created.phpnu �[��� PK b<�\����Q Q # �P classes/hook/after_file_created.phpnu �[��� PK b<�\�0�<V V _Y classes/privacy/provider.phpnu �[��� PK b<�\R�l� � x classes/archive_writer.phpnu �[��� PK b<�\���7! 7! � classes/converter.phpnu �[��� PK b<�\螯P0 0 b� classes/conversion.phpnu �[��� PK b<�\ ӇQ� � * �� classes/reportbuilder/datasource/files.phpnu �[��� PK b<�\]y���> �> - �� classes/reportbuilder/local/entities/file.phpnu �[��� PK b<�\�� ��@ �@ 1 * classes/redactor/services/exifremover_service.phpnu �[��� PK b<�\e~]� � = k classes/redactor/services/file_redactor_service_interface.phpnu �[��� PK b<�\Ǝ� � � % ds classes/redactor/services/service.phpnu �[��� PK b<�\V+��� � fy classes/redactor/manager.phpnu �[��� PK b<�\� -3� � " �� classes/redactor/hook_listener.phpnu �[��� PK b<�\� � � ( �� classes/task/conversion_cleanup_task.phpnu �[��� PK b<�\i�`�c c 8 �� classes/local/archive_writer/stream_writer_interface.phpnu �[��� PK b<�\�&�� � 6 N� classes/local/archive_writer/file_writer_interface.phpnu �[��� PK b<�\�Y�4a a + �� classes/local/archive_writer/zip_writer.phpnu �[��� PK b<�\"O�_R@ R@ F� externallib.phpnu �[��� PK b<�\� �� � � UPGRADING.mdnu �[��� PK b<�\}�k�a a � renderer.phpnu �[��� PK b<�\���l� � I_ index.phpnu �[��� PK b<�\&ٸ� � \j coursefilesedit_form.phpnu �[��� PK b<�\K�C � � ( vp tests/behat/add_custom_file_type.featurenu �[��� PK b<�\Ʀ� � � & �x tests/behat/license_help_modal.featurenu �[��� PK b<�\.K8� ă tests/behat/course_files.featurenu �[��� PK b<�\�J�� � 4 "� tests/classes/hook/before_file_created_callbacks.phpnu �[��� PK b<�\d�t_ 6 .� tests/classes/redactor/services/dummy_file_service.phpnu �[��� PK b<�\{���/ / , �� tests/external/stored_file_exporter_test.phpnu �[��� PK b<�\�G� � ' +� tests/hook/before_file_created_test.phpnu �[��� PK b<�\_v0S� � 1 � tests/fixtures/hook/before_file_created_hooks.phpnu �[��� PK b<�\�zq�, , +� tests/fixtures/awesome_file.txtnu �[��� PK b<�\̱��I I # �� tests/fixtures/redactor/topleft.jpgnu �[��� PK b<�\��/� � $ B� tests/fixtures/redactor/righttop.jpgnu �[��� PK b<�\z���$ �$ ! H� tests/fixtures/redactor/dummy.jpgnu �[��� PK b<�\&��� # 0� tests/fixtures/custom_filetype.mdlrnu �[��� PK b<�\ ��^! ^! �� tests/privacy/provider_test.phpnu �[��� PK b<�\Q r0�C �C O tests/externallib_test.phpnu �[��� PK b<�\ŀ:`} `} �Q tests/converter_test.phpnu �[��� PK b<�\� �YC YC - 3� tests/reportbuilder/datasource/files_test.phpnu �[��� PK b<�\���F �F � tests/conversion_test.phpnu �[��� PK b<�\��j� � �Y tests/archive_writer_test.phpnu �[��� PK b<�\@,��3 �3 4 �` tests/redactor/services/exifremover_service_test.phpnu �[��� PK b<�\'��Du u )� tests/redactor/manager_test.phpnu �[��� PK b<�\\�f� � . � tests/local/archive_writer/zip_writer_test.phpnu �[��� PK b<�\��Wy y � coursefilesedit.phpnu �[��� PK b<�\�\�� � & �� converter/classes/privacy/provider.phpnu �[��� PK b<�\5��� . �� converter/unoconv/classes/privacy/provider.phpnu �[��� PK b<�\��7L5 L5 ' M� converter/unoconv/classes/converter.phpnu �[��� PK b<�\ �ye> > 3 � converter/unoconv/lang/en/fileconverter_unoconv.phpnu �[��� PK b<�\��z� � � converter/unoconv/version.phpnu �[��� PK b<�\=W�A� � f converter/unoconv/db/install.phpnu �[��� PK b<�\y�x�h h 4 �" converter/unoconv/tests/fixtures/unoconv-source.htmlnu �[��� PK b<�\��9+ 9+ 4 y# converter/unoconv/tests/fixtures/unoconv-source.docxnu �[��� PK b<�\6ŚH` ` * O converter/unoconv/tests/converter_test.phpnu �[��� PK b<�\�2 2 ! �` converter/unoconv/testunoconv.phpnu �[��� PK b<�\MzyS� � Sl converter/unoconv/settings.phpnu �[��� PK b<�\���H. . %r converter/googledrive/lib.phpnu �[��� PK b<�\�Y� & �w converter/googledrive/classes/rest.phpnu �[��� PK b<�\�#� � 2 � converter/googledrive/classes/privacy/provider.phpnu �[��� PK b<�\�|E"�# �# + �� converter/googledrive/classes/converter.phpnu �[��� PK b<�\>e�$� � ; ?� converter/googledrive/lang/en/fileconverter_googledrive.phpnu �[��� PK b<�\���� � [� converter/googledrive/test.phpnu �[��� PK b<�\d;O�� � ! �� converter/googledrive/version.phpnu �[��� PK b<�\��9+ 9+ 0 � converter/googledrive/tests/fixtures/source.docxnu �[��� PK b<�\{�� � 5 converter/googledrive/tests/privacy/provider_test.phpnu �[��� PK b<�\�C�U U " 4 converter/googledrive/settings.phpnu �[��� PK b<�\�G;� � � upgrade.txtnu �[��� PK G G � �
| ver. 1.4 |
Github
|
.
| PHP 8.3.30 | Generation time: 0.08 |
proxy
|
phpinfo
|
Settings