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

/**

 * Privacy class for requesting user data.

 *

 * @package    gradingform_guide

 * @copyright  2018 Sara Arjona <sara@moodle.com>

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

 */

namespace gradingform_guide\privacy;

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

use \core_privacy\local\metadata\collection;

use \core_privacy\local\request\transform;

use \core_privacy\local\request\writer;

/**

 * Privacy class for requesting user data.

 *

 * @copyright  2018 Sara Arjona <sara@moodle.com>

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

 */

class provider implements

        \core_privacy\local\metadata\provider,

        \core_grading\privacy\gradingform_provider_v2,

        \core_privacy\local\request\user_preference_provider {

    /**

     * Return the fields which contain personal data.

     *

     * @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('gradingform_guide_fillings', [

            'instanceid' => 'privacy:metadata:instanceid',

            'criterionid' => 'privacy:metadata:criterionid',

            'remark' => 'privacy:metadata:remark',

            'score' => 'privacy:metadata:score'

        ], 'privacy:metadata:fillingssummary');

        $collection->add_user_preference(

            'gradingform_guide-showmarkerdesc',

            'privacy:metadata:preference:showmarkerdesc'

        );

        $collection->add_user_preference(

            'gradingform_guide-showstudentdesc',

            'privacy:metadata:preference:showstudentdesc'

        );

        return $collection;

    }

    /**

     * Export user data relating to an instance ID.

     *

     * @param  \context $context Context to use with the export writer.

     * @param  int $instanceid The instance ID to export data for.

     * @param  array $subcontext The directory to export this data to.

     */

    public static function export_gradingform_instance_data(\context $context, int $instanceid, array $subcontext) {

        global $DB;

        // Get records from the provided params.

        $params = ['instanceid' => $instanceid];

        $sql = "SELECT gc.shortname, gc.description, gc.maxscore, gf.score, gf.remark

                  FROM {gradingform_guide_fillings} gf

                  JOIN {gradingform_guide_criteria} gc ON gc.id = gf.criterionid

                 WHERE gf.instanceid = :instanceid";

        $records = $DB->get_records_sql($sql, $params);

        if ($records) {

            $subcontext = array_merge($subcontext, [get_string('guide', 'gradingform_guide'), $instanceid]);

            writer::with_context($context)->export_data($subcontext, (object) $records);

        }

    }

    /**

     * Deletes all user data related to the provided instance IDs.

     *

     * @param  array  $instanceids The instance IDs to delete information from.

     */

    public static function delete_gradingform_for_instances(array $instanceids) {

        global $DB;

        $DB->delete_records_list('gradingform_guide_fillings', 'instanceid', $instanceids);

    }

    /**

     * Store all user preferences for the plugin.

     *

     * @param int $userid The userid of the user whose data is to be exported.

     */

    public static function export_user_preferences(int $userid) {

        $prefvalue = get_user_preferences('gradingform_guide-showmarkerdesc', null, $userid);

        if ($prefvalue !== null) {

            $transformedvalue = transform::yesno($prefvalue);

            writer::export_user_preference(

                'gradingform_guide',

                'gradingform_guide-showmarkerdesc',

                $transformedvalue,

                get_string('privacy:metadata:preference:showmarkerdesc', 'gradingform_guide')

            );

        }

        $prefvalue = get_user_preferences('gradingform_guide-showstudentdesc', null, $userid);

        if ($prefvalue !== null) {

            $transformedvalue = transform::yesno($prefvalue);

            writer::export_user_preference(

                'gradingform_guide',

                'gradingform_guide-showstudentdesc',

                $transformedvalue,

                get_string('privacy:metadata:preference:showstudentdesc', 'gradingform_guide')

            );

        }

    }

}