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

/**

 * Lib functions, mostly callbacks.

 *

 * @package    tool_mobile

 * @copyright  2017 Juan Leyva

 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

defined('MOODLE_INTERNAL') || die();

/**

 * Generate the app download url to promote moodle mobile.

 *

 * @return moodle_url|void App download moodle_url object or return if setuplink is not set.

 */

function tool_mobile_create_app_download_url() {

    global $CFG;

    $mobilesettings = get_config('tool_mobile');

    if (empty($mobilesettings->setuplink)) {

        return;

    }

    $downloadurl = new moodle_url($mobilesettings->setuplink);

    // Do not update the URL if it is a custom one (we may break it completely).

    if ($mobilesettings->setuplink != 'https://download.moodle.org/mobile') {

        return $downloadurl;

    }

    $downloadurl->param('version', $CFG->version);

    $downloadurl->param('lang', current_language());

    if (!empty($mobilesettings->iosappid)) {

        $downloadurl->param('iosappid', $mobilesettings->iosappid);

    }

    if (!empty($mobilesettings->androidappid)) {

        $downloadurl->param('androidappid', $mobilesettings->androidappid);

    }

    // For privacy reasons, add siteurl param only if the site is registered.

    // This is to implement Google Play Referrer (so the site url is automatically populated in the app after installation).

    if (\core\hub\registration::is_registered()) {

        $downloadurl->param('siteurl', $CFG->wwwroot);

    }

    return $downloadurl;

}

/**

 * Return the user mobile app WebService access token.

 *

 * @param  int $userid the user to return the token from

 * @return stdClass|false the token or false if the token doesn't exists

 * @since  3.10

 */

function tool_mobile_get_token($userid) {

    global $DB;

    $sql = "SELECT t.*

              FROM {external_tokens} t, {external_services} s

             WHERE t.externalserviceid = s.id

               AND s.enabled = 1

               AND s.shortname IN ('moodle_mobile_app', 'local_mobile')

               AND t.userid = ?";

    return $DB->get_record_sql($sql, [$userid], IGNORE_MULTIPLE);

}

/**

 * Checks if the given user has a mobile token (has used recently the app).

 *

 * @param  int $userid the user to check

 * @return bool true if the user has a token, false otherwise.

 */

function tool_mobile_user_has_token($userid) {

    return !empty(tool_mobile_get_token($userid));

}

/**

 * User profile page callback.

 *

 * Used add a section about the moodle mobile app.

 *

 * @param \core_user\output\myprofile\tree $tree My profile tree where the setting will be added.

 * @param stdClass $user The user object.

 * @param bool $iscurrentuser Is this the current user viewing

 * @return void Return if the mobile web services setting is disabled or if not the current user.

 */

function tool_mobile_myprofile_navigation(\core_user\output\myprofile\tree $tree, $user, $iscurrentuser) {

    global $CFG;

    if (empty($CFG->enablemobilewebservice)) {

        return;

    }

    $newnodes = [];

    $mobilesettings = get_config('tool_mobile');

    // Check if we should display a QR code.

    if ($iscurrentuser && !empty($mobilesettings->qrcodetype)) {

        $mobileqr = null;

        $qrcodeforappstr = get_string('qrcodeformobileappaccess', 'tool_mobile');

        if ($mobilesettings->qrcodetype == tool_mobile\api::QR_CODE_LOGIN && is_https()) {

            if (is_siteadmin() || \core\session\manager::is_loggedinas()) {

                $mobileqr = get_string('qrsiteadminsnotallowed', 'tool_mobile');

            } else {

                $qrcodeimg = tool_mobile\api::generate_login_qrcode($mobilesettings);

                $qrkeyttl = !empty($mobilesettings->qrkeyttl) ? $mobilesettings->qrkeyttl : tool_mobile\api::LOGIN_QR_KEY_TTL;

                $mobileqr = html_writer::tag('p', get_string('qrcodeformobileapploginabout', 'tool_mobile',

                    format_time($qrkeyttl)));

                $mobileqr .= html_writer::link('#qrcode', get_string('viewqrcode', 'tool_mobile'),

                    ['class' => 'btn btn-primary mt-2', 'data-toggle' => 'collapse',

                    'role' => 'button', 'aria-expanded' => 'false']);

                $mobileqr .= html_writer::div(html_writer::img($qrcodeimg, $qrcodeforappstr), 'collapse mt-4', ['id' => 'qrcode']);

            }

        } else if ($mobilesettings->qrcodetype == tool_mobile\api::QR_CODE_URL) {

            $qrcodeimg = tool_mobile\api::generate_login_qrcode($mobilesettings);

            $mobileqr = get_string('qrcodeformobileappurlabout', 'tool_mobile');

            $mobileqr .= html_writer::div(html_writer::img($qrcodeimg, $qrcodeforappstr));

        }

        if ($mobileqr) {

            $newnodes[] = new core_user\output\myprofile\node('mobile', 'mobileappqr', $qrcodeforappstr, null, null, $mobileqr);

        }

    }

    // Check if the user is using the app, encouraging him to use it otherwise.

    if ($iscurrentuser || is_siteadmin()) {

        $usertoken = tool_mobile_get_token($user->id);

        $mobilestrconnected = null;

        $mobilelastaccess = null;

        if ($usertoken) {

            $mobilestrconnected = get_string('lastsiteaccess');

            if ($usertoken->lastaccess) {

                $mobilelastaccess = userdate($usertoken->lastaccess) . "  (" . format_time(time() - $usertoken->lastaccess) . ")";

                // Logout link.

                $validtoken = empty($usertoken->validuntil) || time() < $usertoken->validuntil;

                if ($iscurrentuser && $validtoken) {

                    $url = new moodle_url('/'.$CFG->admin.'/tool/mobile/logout.php', ['sesskey' => sesskey()]);

                    $logoutlink = html_writer::link($url, get_string('logout'));

                    $mobilelastaccess .= "  ($logoutlink)";

                }

            } else {

                // We should not reach this point.

                $mobilelastaccess = get_string("never");

            }

        } else if ($url = tool_mobile_create_app_download_url()) {

             $mobilestrconnected = get_string('mobileappenabled', 'tool_mobile', $url->out());

        }

        if ($mobilestrconnected) {

            $newnodes[] = new core_user\output\myprofile\node('mobile', 'mobileappnode', $mobilestrconnected, null, null,

                $mobilelastaccess);

        }

    }

    // Add nodes, if any.

    if (!empty($newnodes)) {

        $mobilecat = new core_user\output\myprofile\category('mobile', get_string('mobileapp', 'tool_mobile'), 'loginactivity');

        $tree->add_category($mobilecat);

        foreach ($newnodes as $node) {

            $tree->add_node($node);

        }

    }

}

/**

 * Callback to be able to change a message/notification data per processor.

 *

 * @param  str $procname    processor name

 * @param  stdClass $data   message or notification data

 */

function tool_mobile_pre_processor_message_send($procname, $data) {

    global $CFG;

    if (empty($CFG->enablemobilewebservice)) {

        return;

    }

    if (empty($data->userto)) {

        return;

    }

    // Only hack email.

    if ($procname == 'email') {

        // Send a message only when there is an HTML version of the email, mobile services are enabled,

        // the user receiving the message has not used the app and there is an app download URL set.

        if (empty($data->fullmessagehtml)) {

            return;

        }

        if (!$url = tool_mobile_create_app_download_url()) {

            return;

        }

        $userto = is_object($data->userto) ? $data->userto->id : $data->userto;

        if (tool_mobile_user_has_token($userto)) {

            return;

        }

        $data->fullmessagehtml .= html_writer::tag('p', get_string('readingthisemailgettheapp', 'tool_mobile', $url->out()));

    }

}