Plagiarism Prevention URKUND Settings: Difference between revisions
Dan Marsden (talk | contribs) (→Global Configuration of URKUND: add instruction to enable log store) |
Dan Marsden (talk | contribs) (add details about possible upgrade failure.) |
||
Line 16: | Line 16: | ||
Then Extract these files into a new folder under /plagiarism/urkund and visit the Admin > Notifications page in Moodle to trigger the upgrade scripts | Then Extract these files into a new folder under /plagiarism/urkund and visit the Admin > Notifications page in Moodle to trigger the upgrade scripts | ||
=== Installation failed due to unprocessed data === | |||
This error may occur when you try to upgrade to a version of the URKUND plugin that uses the new Moodle events API - it occurs when your installation contains unprocessed events related to the old API. If we ignored these events and upgraded then it is possible that some previously submitted files will not be sent to Urkund for processing. | |||
This is most likely to have occurred if a user has submitted an assignment since the last time your scheduled task process was run. | |||
There was also a recent issue related to group-based assignments that could cause a backlog of events - you may want to apply [https://github.com/danmarsden/moodle-plagiarism_urkund/issues/44 this fix] to your old version of the code to address this. Alternatively use [https://github.com/danmarsden/moodle-plagiarism_urkund/archive/3fe13052eb368faf2bfcb9ccf81aff21263192a7.zip this link] to download an complete version of the URKUND plugin that includes the fix related to the backlog of events. | |||
You can see a list of the queued events in your database by running the following sql query(eventdata is [https://github.com/danmarsden/moodle-plagiarism_urkund/blob/310b498a9e6fcf9e757c0f925878121a78381e95/urkund_debug.php#L171 base64 encoded and serialized]): | |||
SELECT qh.id, qh.status, qh.timemodified, eq.eventdata, eq.stackdump, eq.userid, eh.eventname, | |||
eh.component, eh.handlerfile, eh.handlerfunction | |||
FROM mdl_events_queue_handlers qh | |||
JOIN mdl_events_queue eq ON eq.id = qh.queuedeventid | |||
JOIN mdl_events_handlers eh ON eh.id = qh.handlerid | |||
WHERE (eh.eventname = 'assessable_file_uploaded' or eh.eventname = 'assessable_content_uploaded' or eh.eventname = 'assessable_submitted') | |||
If you are not concerned about these events and it does not matter if these submissions do not get posted to URKUND for processing you can run the following SQL command to clear the queue and allow the upgrade to continue. | |||
DELETE FROM mdl_events_queue_handlers WHERE handlerid IN (SELECT id FROM mdl_events_handlers WHERE component = 'plagiarism_urkund') | |||
==Global Configuration of URKUND== | ==Global Configuration of URKUND== | ||
# Go to ''Admin > Advanced Features'' find the setting “Enable plagiarism plugins” - make sure the box is ticked.[[File:Enableplagiarism.png]] | # Go to ''Admin > Advanced Features'' find the setting “Enable plagiarism plugins” - make sure the box is ticked.[[File:Enableplagiarism.png]] |
Revision as of 08:40, 24 November 2015
Activation of your URKUND Account
- obtain a URKUND Subscription from www.urkund.com
Installation of the plugin
Installation using Git
from the root of your install:
git clone git://github.com/danmarsden/moodle-plagiarism_urkund.git plagiarism/urkund
then add plagairism/urkund to your .gitignore Visit the Admin > Notifications page in Moodle to trigger the upgrade scripts
Installation using a Zip file
Download the zip: https://github.com/danmarsden/moodle-plagiarism_urkund/zipball/master or the tar.gz: https://github.com/danmarsden/moodle-plagiarism_urkund/tarball/master
Then Extract these files into a new folder under /plagiarism/urkund and visit the Admin > Notifications page in Moodle to trigger the upgrade scripts
Installation failed due to unprocessed data
This error may occur when you try to upgrade to a version of the URKUND plugin that uses the new Moodle events API - it occurs when your installation contains unprocessed events related to the old API. If we ignored these events and upgraded then it is possible that some previously submitted files will not be sent to Urkund for processing.
This is most likely to have occurred if a user has submitted an assignment since the last time your scheduled task process was run.
There was also a recent issue related to group-based assignments that could cause a backlog of events - you may want to apply this fix to your old version of the code to address this. Alternatively use this link to download an complete version of the URKUND plugin that includes the fix related to the backlog of events.
You can see a list of the queued events in your database by running the following sql query(eventdata is base64 encoded and serialized):
SELECT qh.id, qh.status, qh.timemodified, eq.eventdata, eq.stackdump, eq.userid, eh.eventname, eh.component, eh.handlerfile, eh.handlerfunction FROM mdl_events_queue_handlers qh JOIN mdl_events_queue eq ON eq.id = qh.queuedeventid JOIN mdl_events_handlers eh ON eh.id = qh.handlerid WHERE (eh.eventname = 'assessable_file_uploaded' or eh.eventname = 'assessable_content_uploaded' or eh.eventname = 'assessable_submitted')
If you are not concerned about these events and it does not matter if these submissions do not get posted to URKUND for processing you can run the following SQL command to clear the queue and allow the upgrade to continue.
DELETE FROM mdl_events_queue_handlers WHERE handlerid IN (SELECT id FROM mdl_events_handlers WHERE component = 'plagiarism_urkund')
Global Configuration of URKUND
- Go to Admin > Advanced Features find the setting “Enable plagiarism plugins” - make sure the box is ticked.
- Go to Admin > Site administration >Plugins >Logging > Manage log stores. - make sure the "legacy log" store is enabled:
- Go to Admin > Plugins > Plagiarism Prevention > URKUND
- in the page Admin > Modules > Activities > URKUND click on the tab "URKUND Defaults"
Advanced Configuration
The ability to enable/disable URKUND within a Moodle module such as an assignment is managed using a capability that is by default given to all managers and editing teachers on the site. If you want to force all assignments on your site to use URKUND and prevent your teachers from changing these settings you can set the defaults above and then remove the capability “moodle/plagiarism_urkund:enable” from your teacher roles.
You can also use this capability to selectively allow certain teachers to use URKUND by setting the default above “Enable URKUND” to “No” - and giving the capabiltiy “moodle/plagiarism_urkund:enable” only to the teachers you want to be able to use URKUND