Proyectos de Subversion Moodle

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

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

 */

 */

namespace core_competency;

namespace core_competency;

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

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

use core\invalid_persistent_exception;

use stdClass;

use stdClass;

use cm_info;

use cm_info;

use context;

use context;

use context_helper;

use context_helper;

                    OR c.id IS NOT NULL";

                    OR c.id IS NOT NULL";

        return $DB->record_exists_sql($sql, ['scaleid1' => $scaleid, 'scaleid2' => $scaleid]);

        return $DB->record_exists_sql($sql, ['scaleid1' => $scaleid, 'scaleid2' => $scaleid]);

    }

    }

     * Validate if current user have acces to the course_module if hidden.

     * Validate if current user has access to the course_module if hidden.

     *

     *

     * @param mixed $cmmixed The cm_info class, course module record or its ID.

     * @param mixed $cmmixed The cm_info class, course module record or its ID.

     * @param bool $throwexception Throw an exception or not.

     * @param bool $throwexception Throw an exception or not.

     * @return bool

     * @return bool

        return true;

        return true;

    }

    }

    /**

    /**

     * Validate if current user have acces to the course if hidden.

     * Validate if current user has access to the course if hidden.

     *

     *

     * @param mixed $courseorid The course or it ID.

     * @param mixed $courseorid The course or it ID.

     * @param bool $throwexception Throw an exception or not.

     * @param bool $throwexception Throw an exception or not.

        return $result;

        return $result;

    }

    }

    /**

    /**

     * Read a the details for a single competency and return a record.

     * Read the details for a single competency and return a record.

     *

     *

     * Requires moodle/competency:competencyview capability at the system context.

     * Requires moodle/competency:competencyview capability at the system context.

     *

     *

        return $competency;

        return $competency;

    }

    }

    /**

    /**

     * Perform a text search based and return all results and their parents.

     * Perform a search based on a text and return all results and their parents.

     *

     *

     * Requires moodle/competency:competencyview capability at the framework context.

     * Requires moodle/competency:competencyview capability at the framework context.

     *

     *

            // Adding the suffix copy to the shortname.

            // Adding the suffix copy to the shortname.

            $framework->set('shortname', get_string('duplicateditemname', 'core_competency', $framework->get('shortname')));

            $framework->set('shortname', get_string('duplicateditemname', 'core_competency', $framework->get('shortname')));

            $framework->set('id', 0);

            $framework->set('id', 0);

            $framework = $framework->create();

            $framework = $framework->create();

            // Array that match the old competencies ids with the new one to use when copying related competencies.

            // Array that matches the old competencies ids with the new one to use when copying related competencies.

            $frameworkcompetency = competency::get_framework_tree($id);

            $frameworkcompetency = competency::get_framework_tree($id);

            $matchids = self::duplicate_competency_tree($framework->get('id'), $frameworkcompetency, 0, 0);

            $matchids = self::duplicate_competency_tree($framework->get('id'), $frameworkcompetency, 0, 0);

        }

        }

        // Commit the transaction.

        // Commit the transaction.

        // If all operations are successfull then trigger the delete event.

        // If all operations are successful then trigger the delete event.

        $event->trigger();

        $event->trigger();

        return $framework->update();

        return $framework->update();

    }

    }

    /**

    /**

     * Read a the details for a single competency framework and return a record.

     * Read the details for a single competency framework and return a record.

     *

     *

     * Requires moodle/competency:competencyview capability at the system context.

     * Requires moodle/competency:competencyview capability at the system context.

     *

     *

        }

        }

        return $framework;

        return $framework;

    }

    }

     * Logg the competency framework viewed event.

     * Log the competency framework viewed event.

     *

     *

     * @param competency_framework|int $frameworkorid The competency_framework object or competency framework id

     * @param competency_framework|int $frameworkorid The competency_framework object or competency framework id

     * @return bool

     * @return bool

     */

     */

        \core\event\competency_framework_viewed::create_from_framework($framework)->trigger();

        \core\event\competency_framework_viewed::create_from_framework($framework)->trigger();

        return true;

        return true;

    }

    }

     * Logg the competency viewed event.

     * Log the competency viewed event.

     *

     *

     * @param competency|int $competencyorid The competency object or competency id

     * @param competency|int $competencyorid The competency object or competency id

     * @return bool

     * @return bool

     */

     */

     *                          - parents: All parents, grand parents, etc...

     *                          - parents: All parents, grand parents, etc...

     *                          - self: Context passed only.

     *                          - self: Context passed only.

     * @param array $hasanycapability Array of capabilities passed to {@link has_any_capability()} in each context.

     * @param array $hasanycapability Array of capabilities passed to {@link has_any_capability()} in each context.

     * @return context[] An array of contexts where keys are context IDs.

     * @return context[] An array of contexts where keys are context IDs.

     */

     */

        global $DB;

        global $DB;

        static::require_enabled();

        static::require_enabled();

        if (!in_array($includes, array('children', 'parents', 'self'))) {

        if (!in_array($includes, array('children', 'parents', 'self'))) {

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        // Check the user have access to the course module.

        // Check the user has access to the course module.

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        $context = context_module::instance($cm->id);

        $context = context_module::instance($cm->id);

     * @param int $userid The id of the user to check.

     * @param int $userid The id of the user to check.

     * @return int

     * @return int

     */

     */

    public static function count_proficient_competencies_in_course_for_user($courseid, $userid) {

    public static function count_proficient_competencies_in_course_for_user($courseid, $userid) {

        static::require_enabled();

        static::require_enabled();

        self::validate_course($courseid);

        self::validate_course($courseid);

        // First we do a permissions check.

        // First we do a permissions check.

     * @param int $courseid The id of the course to check.

     * @param int $courseid The id of the course to check.

     * @return int

     * @return int

     */

     */

    public static function count_competencies_in_course($courseid) {

    public static function count_competencies_in_course($courseid) {

        static::require_enabled();

        static::require_enabled();

        self::validate_course($courseid);

        self::validate_course($courseid);

        // First we do a permissions check.

        // First we do a permissions check.

        $course = $courseorid;

        $course = $courseorid;

        if (!is_object($courseorid)) {

        if (!is_object($courseorid)) {

            $course = get_course($courseorid);

            $course = get_course($courseorid);

        }

        }

        // Check the user have access to the course.

        // Check the user has access to the course.

        self::validate_course($course);

        self::validate_course($course);

        $context = context_course::instance($course->id);

        $context = context_course::instance($course->id);

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        // Check the user have access to the course module.

        // Check the user has access to the course module.

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        $context = context_module::instance($cm->id);

        $context = context_module::instance($cm->id);

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        // Check the user have access to the course module.

        // Check the user has access to the course module.

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        $context = context_module::instance($cm->id);

        $context = context_module::instance($cm->id);

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        // Check the user have access to the course module.

        // Check the user has access to the course module.

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        static::require_enabled();

        static::require_enabled();

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        // First we do a permissions check.

        // First we do a permissions check.

        static::require_enabled();

        static::require_enabled();

        $cm = $cmorid;

        $cm = $cmorid;

        if (!is_object($cmorid)) {

        if (!is_object($cmorid)) {

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

            $cm = get_coursemodule_from_id('', $cmorid, 0, true, MUST_EXIST);

        }

        }

        self::validate_course_module($cm);

        self::validate_course_module($cm);

        // First we do a permissions check.

        // First we do a permissions check.

     * @param int $competencyid The id of the competency

     * @param int $competencyid The id of the competency

     * @return bool

     * @return bool

     */

     */

    public static function add_competency_to_course($courseid, $competencyid) {

    public static function add_competency_to_course($courseid, $competencyid) {

        static::require_enabled();

        static::require_enabled();

        self::validate_course($courseid);

        self::validate_course($courseid);

        // First we do a permissions check.

        // First we do a permissions check.

        $record->courseid = $courseid;

        $record->courseid = $courseid;

        $record->competencyid = $competencyid;

        $record->competencyid = $competencyid;

        // Can not add a competency that belong to a hidden framework.

        // Can not add a competency that belongs to a hidden framework.

        if ($competency->get_framework()->get('visible') == false) {

        if ($competency->get_framework()->get('visible') == false) {

            throw new coding_exception('A competency belonging to hidden framework can not be linked to course');

            throw new coding_exception('A competency belonging to hidden framework can not be linked to course');

     * @param int $competencyid The id of the competency

     * @param int $competencyid The id of the competency

     * @return bool

     * @return bool

     */

     */

    public static function remove_competency_from_course($courseid, $competencyid) {

    public static function remove_competency_from_course($courseid, $competencyid) {

        static::require_enabled();

        static::require_enabled();

        self::validate_course($courseid);

        self::validate_course($courseid);

        // First we do a permissions check.

        // First we do a permissions check.

     * @param int $competencyidto The id of the competency we are moving to.

     * @param int $competencyidto The id of the competency we are moving to.

     * @return boolean

     * @return boolean

     */

     */

    public static function reorder_course_competency($courseid, $competencyidfrom, $competencyidto) {

    public static function reorder_course_competency($courseid, $competencyidfrom, $competencyidto) {

        static::require_enabled();

        static::require_enabled();

        self::validate_course($courseid);

        self::validate_course($courseid);

        // First we do a permissions check.

        // First we do a permissions check.

        return $success;

        return $success;

    }

    }

    /**

    /**

     * Read a the details for a single learning plan template and return a record.

     * Read the details for a single learning plan template and return a record.

     *

     *

     * Requires moodle/competency:templateview capability at the system context.

     * Requires moodle/competency:templateview capability at the system context.

     *

     *

        $record->templateid = $templateid;

        $record->templateid = $templateid;

        $record->competencyid = $competencyid;

        $record->competencyid = $competencyid;

        // Can not add a competency that belong to a hidden framework.

        // Can not add a competency that belongs to a hidden framework.

        if ($competency->get_framework()->get('visible') == false) {

        if ($competency->get_framework()->get('visible') == false) {

            throw new coding_exception('A competency belonging to hidden framework can not be added');

            throw new coding_exception('A competency belonging to hidden framework can not be added');

        // The user must be allowed to manage the plans of the user, nothing about the template.

        // The user must be allowed to manage the plans of the user, nothing about the template.

        if (!$plan->can_manage()) {

        if (!$plan->can_manage()) {

            throw new required_capability_exception($plan->get_context(), 'moodle/competency:planmanage', 'nopermissions', '');

            throw new required_capability_exception($plan->get_context(), 'moodle/competency:planmanage', 'nopermissions', '');

        }

        }

        // Only plan with status DRAFT or ACTIVE can be unliked..

        // Only plan with status DRAFT or ACTIVE can be unlinked..

            throw new coding_exception('Only draft or active plan can be unliked from a template');

            throw new coding_exception('Only draft or active plan can be unlinked from a template');

        }

        }

        // Early exit, it's already done...

        // Early exit, it's already done...

        } else if ($plan->is_based_on_template()) {

        } else if ($plan->is_based_on_template()) {

            throw new coding_exception('A competency can not be added to a learning plan based on a template');

            throw new coding_exception('A competency can not be added to a learning plan based on a template');

        }

        }

            throw new coding_exception('A competency can not be added to a learning plan completed');

            throw new coding_exception('A competency can not be added to a completed learning plan');

        }

        }

        } else if ($plan->is_based_on_template()) {

        } else if ($plan->is_based_on_template()) {

            throw new coding_exception('A competency can not be removed from a learning plan based on a template');

            throw new coding_exception('A competency can not be removed from a learning plan based on a template');

        }

        }

            throw new coding_exception('A competency can not be removed from a learning plan completed');

            throw new coding_exception('A competency can not be removed from a completed learning plan');

        }

        }

        $link = plan_competency::get_record(array('planid' => $planid, 'competencyid' => $competencyid));

        $link = plan_competency::get_record(array('planid' => $planid, 'competencyid' => $competencyid));

        } else if ($plan->is_based_on_template()) {

        } else if ($plan->is_based_on_template()) {

            throw new coding_exception('A competency can not be reordered in a learning plan based on a template');

            throw new coding_exception('A competency can not be reordered in a learning plan based on a template');

        }

        }

            throw new coding_exception('A competency can not be reordered in a learning plan completed');

            throw new coding_exception('A competency can not be reordered in a completed learning plan');

        }

        }

        $down = true;

        $down = true;

        $context = context_user::instance($userid);

        $context = context_user::instance($userid);

        $uc = user_competency::get_record(array('userid' => $userid, 'competencyid' => $competencyid));

        $uc = user_competency::get_record(array('userid' => $userid, 'competencyid' => $competencyid));

        if (!$uc || !$uc->can_read()) {

        if (!$uc || !$uc->can_read()) {

            throw new required_capability_exception($context, 'moodle/competency:usercompetencyview', 'nopermissions', '');

            throw new required_capability_exception($context, 'moodle/competency:usercompetencyview', 'nopermissions', '');

        } else if ($uc->get('status') != user_competency::STATUS_WAITING_FOR_REVIEW) {

        } else if ($uc->get('status') != user_competency::STATUS_WAITING_FOR_REVIEW) {

        } else if (!$uc->can_request_review()) {

        } else if (!$uc->can_request_review()) {

            throw new required_capability_exception($context, 'moodle/competency:usercompetencyrequestreview', 'nopermissions', '');

            throw new required_capability_exception($context, 'moodle/competency:usercompetencyrequestreview', 'nopermissions', '');

        }

        }

            throw new required_capability_exception($uc->get_context(), 'moodle/competency:usercompetencyview',

            throw new required_capability_exception($uc->get_context(), 'moodle/competency:usercompetencyview',

                'nopermissions', '');

                'nopermissions', '');

        }

        }

        $plan = new plan($planid);

        $plan = new plan($planid);

        if ($plan->get('status') == plan::STATUS_COMPLETE) {

        if ($plan->get('status') == plan::STATUS_COMPLETE) {

        }

        }

        \core\event\competency_user_competency_viewed_in_plan::create_from_user_competency_viewed_in_plan($uc, $planid)->trigger();

        \core\event\competency_user_competency_viewed_in_plan::create_from_user_competency_viewed_in_plan($uc, $planid)->trigger();

        return true;

        return true;

     */

     */

    public static function remove_related_competency($competencyid, $relatedcompetencyid) {

    public static function remove_related_competency($competencyid, $relatedcompetencyid) {

        static::require_enabled();

        static::require_enabled();

        $competency = new competency($competencyid);

        $competency = new competency($competencyid);

        // This only check if we have the permission in either competency because both competencies

        // This only checks if we have the permission in either competency because both competencies

        // should belong to the same framework.

        // should belong to the same framework.

        require_capability('moodle/competency:competencymanage', $competency->get_context());

        require_capability('moodle/competency:competencymanage', $competency->get_context());

                // The logic here goes like this:

                // The logic here goes like this:

                //

                //

                // if rating outside a course

                // if rating outside a course

                // - set the default grade and proficiency ONLY if there is no current grade

                // - set the default grade and proficiency ONLY if there is no current grade

                // else we are in a course

                // else we are in a course

                // - then check the course settings to see if we should push the rating outside the course

                // - then check the course settings to see if we should push the rating outside the course

                // - if we should push it

                // - if we should push it

                // --- push it only if the user_competency (outside the course) has no grade

                // --- push it only if the user_competency (outside the course) has no grade

                // Done.

                // Done.

     * @param  user_competency $usercompetency The user competency recently completed.

     * @param  user_competency $usercompetency The user competency recently completed.

     * @param  competency|null $competency     The competency of the user competency, useful to avoid unnecessary read.

     * @param  competency|null $competency     The competency of the user competency, useful to avoid unnecessary read.

     * @return void

     * @return void

     */

     */

    protected static function apply_competency_rules_from_usercompetency(user_competency $usercompetency,

    protected static function apply_competency_rules_from_usercompetency(user_competency $usercompetency,

        // Perform some basic checks.

        // Perform some basic checks.

        if (!$usercompetency->get('proficiency')) {

        if (!$usercompetency->get('proficiency')) {

            throw new coding_exception('The user competency passed is not completed.');

            throw new coding_exception('The user competency passed is not completed.');