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

/**
 * Contains helper class for digital consent.
 *
 * @package     core_auth
 * @copyright   2018 Mihail Geshoski <mihail@moodle.com>
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace core_auth;

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

/**
 * Helper class for digital consent.
 *
 * @copyright 2018 Mihail Geshoski <mihail@moodle.com>
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class digital_consent {

    /**
     * Returns true if age and location verification is enabled in the site.
     *
     * @return bool
     */
    public static function is_age_digital_consent_verification_enabled() {
        global $CFG;

        return !empty($CFG->agedigitalconsentverification);
    }

    /**
     * Checks if a user is a digital minor.
     *
     * @param int $age
     * @param string $country The country code (ISO 3166-2)
     * @return bool
     */
    public static function is_minor($age, $country) {
        global $CFG;

        $ageconsentmap = $CFG->agedigitalconsentmap;
        $agedigitalconsentmap = self::parse_age_digital_consent_map($ageconsentmap);

        return array_key_exists($country, $agedigitalconsentmap) ?
            $age < $agedigitalconsentmap[$country] : $age < $agedigitalconsentmap['*'];
    }

    /**
     * Parse the agedigitalconsentmap setting into an array.
     *
     * @param  string $ageconsentmap The value of the agedigitalconsentmap setting
     * @return array $ageconsentmapparsed
     */
    public static function parse_age_digital_consent_map($ageconsentmap) {

        $ageconsentmapparsed = array();
        $countries = get_string_manager()->get_list_of_countries(true);
        $isdefaultvaluepresent = false;
        $lines = preg_split('/\r|\n/', $ageconsentmap, -1, PREG_SPLIT_NO_EMPTY);
        foreach ($lines as $line) {
            $arr = explode(",", $line);
            // Handle if there is more or less than one comma separator.
            if (count($arr) != 2) {
                throw new \moodle_exception('agedigitalconsentmapinvalidcomma', 'error', '', $line);
            }
            $country = trim($arr[0]);
            $age = trim($arr[1]);
            // Check if default.
            if ($country == "*") {
                $isdefaultvaluepresent = true;
            }
            // Handle if the presented value for country is not valid.
            if ($country !== "*" && !array_key_exists($country, $countries)) {
                throw new \moodle_exception('agedigitalconsentmapinvalidcountry', 'error', '', $country);
            }
            // Handle if the presented value for age is not valid.
            if (!is_numeric($age)) {
                throw new \moodle_exception('agedigitalconsentmapinvalidage', 'error', '', $age);
            }
            $ageconsentmapparsed[$country] = $age;
        }
        // Handle if a default value does not exist.
        if (!$isdefaultvaluepresent) {
            throw new \moodle_exception('agedigitalconsentmapinvaliddefault');
        }

        return $ageconsentmapparsed;
    }
}