Proyectos de Subversion Moodle

<?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/>.

/**
 * Amanote file helper functions.
 *
 * @package     filter_amanote
 * @copyright   2021 Amaplex Software
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

/**
 * Try to guess the mimetype from an URL.
 *
 * @param string $url The url.
 *
 * @return string The mimetype if one is found, application/unknown otherwise.
 */
function guess_url_mimetype($url) {

    $mimetype = 'application/unknown';

    if (!$url) {
        return $mimetype;
    }

    // Check if the url matches a supported video provider (youtube or vimeo).
    preg_match("/^(https?\:\/\/)?(www\.)?(youtube|youtu|vimeo)\.(com|be)\/.+$/", $url, $matches);
    if ($matches && count($matches) > 3) {
        return strpos($matches[3], 'youtu') !== false ? 'video/youtube' : 'video/vimeo';
    }

    // Check if the url ends with a file format.
    preg_match("/\.(\w{3,4})($|\?|\#)/", $url, $matches);
    if (!$matches || count($matches) < 2) {
        return $mimetype;
    }

    $extension = $matches[1];
    $types = core_filetypes::get_types();

    if (isset($types[$extension])) {
        $mimetype = $types[$extension]['type'];
    }

    return $mimetype;
}

/**
 * Get the content kind from a mimetype.
 *
 * @param string $mimetype The mimetype.
 *
 * @return string The content kind if one is found, unknown otherwise.
 */
function get_content_kind_from_mimetype($mimetype) {

    if ($mimetype === 'video/youtube' || $mimetype === 'video/vimeo') {
        return 'video';
    }

    $types = core_filetypes::get_types();

    foreach ($types as $type) {
        if ($type['type'] === $mimetype && isset($type['groups']) && !empty($type['groups'])) {
            return $type['groups'][0];
        }
    }

    return 'unknown';
}

/**
 * Get the supported mimetypes for a given (optional) content kind. If no
 * content kind is given, all the supported mimtypes are returned.
 *
 * @param string $contentkind The content kind if any.
 *
 * @return string The supported mimetypes.
 */
function get_supported_mimetypes($contentkind = null) {
    $documentmimetypes = [
        'application/pdf',
        'application/vnd.ms-powerpoint',
        'application/vnd.openxmlformats-officedocument.presentationml.presentation',
        'application/epub+zip',
        'application/vnd.oasis.opendocument.text',
        'application/msword',
        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
    ];

    $videomimetypes = [
        'video/quicktime',
        'video/mp4',
        'video/mpeg',
        'video/ogg',
        'video/youtube',
        'video/vimeo',
    ];

    if ($contentkind === 'video') {
        return $videomimetypes;
    } else if ($contentkind === 'document') {
        return $documentmimetypes;
    }

    return array_merge($documentmimetypes, $videomimetypes);
}

/**
 * Get the user's notes for a given course.
 *
 * @param string $userid The user id.
 * @param string $courseid The course id.
 *
 * @return array An array of filename.
 */
function get_user_notes_for_course($userid, $courseid) {
    global $DB;

    $sql = "SELECT filename FROM {files} WHERE filepath = '/Amanote/'
        AND filearea = 'private'
        AND userid = :userid
        AND filename LIKE :courseid";

    return $DB->get_records_sql($sql, ['userid' => $userid, 'courseid' => $courseid . '.%']);
}

/**
 * Get the annotatable for a given file.
 *
 * @param file $file The file.
 * @param string $courseid The course id.
 * @param string $cmid The course module id.
 * @param string $modinstance The module instance id.
 *
 * @return annotatable The annotatable.
 */
function get_annotatable_for_file($file, $courseid, $cmid, $modinstance) {
    $annotatable = new annotatable();

    // Generate the annotable id for the file.
    if ($cmid) {
        $annotatable->id = $courseid . '.' . $cmid;
    } else {
        $annotatable->id = $courseid . '.' . $modinstance  . '.' . $file->id;
    }

    $annotatable->cmid = $cmid;

    if ($file->component === 'mod_resource' || $file->component === 'mod_folder') {
        $annotatable->legacyid = $courseid . '.' . $modinstance  . '.' . $file->id;
    }

    // Use the legacy id for folder as all files in the folder has the same cmid.
    if ($file->component === 'mod_folder') {
        $annotatable->id = $annotatable->legacyid;
    }

    // Set the content's kind.
    $annotatable->kind = get_content_kind_from_mimetype($file->mimetype);
    if ($annotatable->kind !== 'video') {
        $annotatable->kind = 'document';
    }

    $annotatable->mimetype = $file->mimetype;
    $annotatable->internal = true;
    $filepath = (empty($file->filepath) ? '/' : $file->filepath) . $file->filename;
    $annotatable->url = "/$file->contextid/$file->component/$file->filearea/1$filepath";

    if ($file->filearea === 'intro') {
        $annotatable->url = str_replace('intro/1', 'intro', $annotatable->url);
    }

    return $annotatable;
}

/**
 * Get the annotatable for a given url.
 *
 * @param string $url The url.
 * @param string $courseid The course id.
 * @param string $cmid The course module id.
 *
 * @return annotatable The annotatable.
 */
function get_annotatable_for_url($url, $courseid, $cmid) {

    $annotatable = new annotatable();

    // Generate the annotable id for the url.
    $annotatable->id = $courseid . '.' . $cmid;
    $annotatable->cmid = $cmid;

    $mimetype = guess_url_mimetype($url->externalurl);

    // Set the content's kind.
    $annotatable->kind = get_content_kind_from_mimetype($mimetype);
    if ($annotatable->kind !== 'video') {
        $annotatable->kind = 'document';
    }

    $annotatable->mimetype = $mimetype;
    $annotatable->internal = false;
    $annotatable->url = $url->externalurl;

    return $annotatable;
}