. /** * @package plagiarism_pchkorg * @category plagiarism * @copyright PlagiarismCheck.org, https://plagiarismcheck.org/ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/plagiarism/lib.php'); require_once($CFG->libdir . '/filelib.php'); require_once($CFG->libdir . '/accesslib.php'); require_once(__DIR__ . '/classes/plagiarism_pchkorg_config_model.php'); require_once(__DIR__ . '/classes/plagiarism_pchkorg_url_generator.php'); require_once(__DIR__ . '/classes/plagiarism_pchkorg_api_provider.php'); /** * Class plagiarism_plugin_pchkorg */ class plagiarism_plugin_pchkorg extends plagiarism_plugin { /** * hook to allow plagiarism specific information to be displayed beside a submission * * @param array $linkarraycontains all relevant information for the plugin to generate a link * @return string * */ public function get_links($linkarray) { global $DB, $USER; $pchkorgconfigmodel = new plagiarism_pchkorg_config_model(); $urlgenerator = new plagiarism_pchkorg_url_generator(); $apitoken = $pchkorgconfigmodel->get_system_config('pchkorg_token'); $apiprovider = new plagiarism_pchkorg_api_provider($apitoken); $cmid = $linkarray['cmid']; $file = $linkarray['file']; // We can do nothing with submissions which we can not handle. if (!$apiprovider->is_supported_mime($file->get_mimetype())) { return ''; } // SQL will be called only once, result is static. $config = $pchkorgconfigmodel->get_system_config('pchkorg_use'); if ('1' !== $config) { return ''; } $context = null; if (!empty($cmid)) { $context = context_module::instance($cmid);// Get context of course. } // SQL will be called only once per page. There is static result inside. if (!$pchkorgconfigmodel->is_enabled_for_module($cmid)) { return ''; } // Only for some type of account, method will call a remote HTTP API. // The API will be called only once, because result is static. // Also, there is timeout 2 seconds for response. // Even if service is unavailable, method will try call only once. // Also, we don't use use raw user email. if (!$apiprovider->is_group_member($USER->email)) { return ''; } $isgranted = !empty($context) && has_capability('mod/assign:view', $context, null); if (!$isgranted) { return ''; } $where = new \stdClass(); $where->cm = $cmid; $where->fileid = $file->get_id(); $filerecord = $DB->get_record('plagiarism_pchkorg_files', (array) $where); $checkurl = $urlgenerator->get_check_url($cmid, $file->get_id()); if ($filerecord) { $label = sprintf('%.2f', $filerecord->score) . '%'; $link = sprintf(' ( %s ) ', $checkurl->__toString(), $label); } else { $label = get_string('pchkorg_check_for_plagiarism', 'plagiarism_pchkorg'); $link = sprintf(' ( %s ) ', $checkurl->__toString(), $label); } return $link; } /* hook to save plagiarism specific settings on a module settings page * @param object $data - data from an mform submission. */ /** * @param $data * @throws dml_exception */ public function save_form_elements($data) { global $DB; $pchkorgconfigmodel = new plagiarism_pchkorg_config_model(); $config = $pchkorgconfigmodel->get_system_config('pchkorg_use'); if ('1' != $config) { return; } if (!isset($data->pchkorg_module_use)) { return; } $records = $DB->get_records('plagiarism_pchkorg_config', array( 'cm' => $data->coursemodule )); if (empty($records)) { $insert = new \stdClass(); $insert->cm = $data->coursemodule; $insert->name = 'pchkorg_module_use'; $insert->value = $data->pchkorg_module_use; $DB->insert_record('plagiarism_pchkorg_config', $insert); } else { foreach ($records as $record) { $record->value = $data->{$record->name}; $DB->update_record('plagiarism_pchkorg_config', $record); } } } /** * @param object $mform * @param object $context * @param string $modulename * @throws coding_exception * @throws dml_exception */ public function get_form_elements_module($mform, $context, $modulename = '') { if (!$context || !isset($modulename) || 'mod_assign' !== $modulename) { return; } global $DB; $pchkorgconfigmodel = new plagiarism_pchkorg_config_model(); $config = $pchkorgconfigmodel->get_system_config('pchkorg_use'); if ('1' == $config) { $defaultcmid = null; $cm = optional_param('update', $defaultcmid, PARAM_INT); if (null !== $cm) { $records = $DB->get_records('plagiarism_pchkorg_config', array( 'cm' => $cm, )); if (!empty($records)) { $mform->setDefault($records[0]->name, $records[0]->value); } } $mform->addElement('header', 'plagiarism_pchkorg', get_string('pluginname', 'plagiarism_pchkorg')); $mform->addElement( 'select', $setting = 'pchkorg_module_use', get_string('pchkorg_module_use', 'plagiarism_pchkorg'), array(get_string('no'), get_string('yes')) ); $mform->addHelpButton('pchkorg_module_use', 'pchkorg_module_use', 'plagiarism_pchkorg'); if (!isset($mform->exportValues()[$setting]) || is_null($mform->exportValues()[$setting])) { $mform->setDefault($setting, '1'); } } } /** * hook to allow a disclosure to be printed notifying users what will happen with their submission * * @param int $cmid - course module id * @return string */ public function print_disclosure($cmid) { global $OUTPUT; if (empty($cmid)) { return ''; } // Get course details. $cm = get_coursemodule_from_id('', $cmid); if ($cm->modname != 'assign') { return ''; } $configmodel = new plagiarism_pchkorg_config_model(); $enabled = $configmodel->get_system_config('pchkorg_use'); if ($enabled !== '1') { return ''; } if ($configmodel->is_enabled_for_module($cmid) != '1') { return ''; } $result = ''; $result .= $OUTPUT->box_start('generalbox boxaligncenter', 'intro'); $formatoptions = new stdClass; $formatoptions->noclean = true; $formatoptions->cmid = $cmid; $result .= format_text(get_string('pchkorg_disclosure', 'plagiarism_pchkorg'), FORMAT_MOODLE, $formatoptions); $result .= $OUTPUT->box_end(); return $result; } }