Last updated: Dec 19, 2016
Document owner: Unplag.com
Admin guide: installation of Unplag plugin (Moodle LMS)
Designed based on educators’ feedback, Unplag is a plagiarism detection engine helping educators spot plagiarism.
It takes a few minutes to set up your account and get the ball rolling. This plugin integrates with assignment, forum and
workshop activities in Moodle to check user-submitted content for plagiarism.
For more information about the Unplag plugin, please visit the Moodle plugin database page https://moodle.org/plugins/plagiarism_unplag
Go to https://moodle.org/plugins/ and search for Unplag.
Open the plugin page and download the latest version of the plugin. To download the latest version, click Download (when new
version is released, simply update the plugin from the Moodle’s admin interface).
Save the plugin locally on your computer and note the path to the saved file.
Note: Alternatively, you can use Install now button to install Unplag app directly without downloading the zip file.
Log in to Moodle LMS as Admin. Go to Site administration and then to the Plugins sections. Select Install plugins.
Note: Ensure Enable plagiarism plugins option is checked in Site administration → Advanced features. This will allow
administrators to configure plagiarism plugins (if installed).
Upload a .zip file (the Unplag plugin) to Moodle and click Install plugin from ZIP file.
After the plugin is uploaded, make sure that you see Validation successful message. If you encounter any problems at this stage,
please contact your Unplag account manager.
Click Continue. Then click Upgrade Moodle database now to finish the installation.
You then will see the Success message. Click Continue.
Installation is complete!
Go to Site administration → Plugins → Plugins overview and review available updates (it is recommended to check for
updates once a month or when you experience technical issues):
Click Install this update and follow the installation steps. Unplag plugin configuration is preserved after update - you do not need
to update the key/secret or change settings.
Go to the admin page for plagiarism plugins: Site administration → Plugins → Plagiarism → Manage plagiarism plugins.
You should see the Unplag plugin in the list of the available plugins. Click Settings.
Configure the default global settings for the Unplag plugin as in example below:
The Unplag plugin (global settings):
Enabling the Unplag plugin in Moodle LMS
Client ID & API Secret
Obtain Client ID and API secret from admin account at unplag.com:
Update the default message if necessary. The message will be displayed to all students on the file upload page.
Enable UNPLAG for the Assignment
Enable Unplag for the Assignment activity in Moodle (online text and file submission supported).
Enable UNPLAG for Forum
Enable Unplag for the Forum activity in Moodle (text reply and file submission supported).
Enable UNPLAG for Workshop
Enable Unplag for the Workshop activity in Moodle (text and file submission supported).
Click Save changes.
Switch to the Unplag defaults tab and configure default settings for the Assignment module.
Enable the Unplag plugin by default for the Assignment activity
Check types for plagiarism
Show similarity score to student
Show similarity report to student
Hide sources with a match less than (%)
(0% recommended) Unplag similarity detection algorithm can find resources where as small as 8 words phrase coincidence can be detected. Use this feature to make search less sensible.
For example, entering "1" will display only those sources, where the percentage of similarity is 1% or more.
Auto exclude Citations & References
(ON recommended) Enable this option to find and exclude properly formatted citations and references. Identified citations and references will not be scanned for similarity.
Click Save changes.
This step helps verify that the plugin is activated, all the settings are correct and that the Unplag report is successfully generated.
Log in as a teacher (can use Log in as feature; do not use Switch role to) and create test assignment. Open settings for the
assignment and go to the UNPLAG plagiarism plugin settings. Enable the Unplag plugin.
Note: to use Unplag plugin, first set option Require students click submit button to YES (Submissions settings).
Save the settings.
Login as a student (can use Log in as feature) and Add submission to the assignment that has been created previously:
If a score and report have been set to be visible for the student, you will be able to see the score and a link to the Unplag report:
Click on the chain icon (HTTP link) to view the Unplag report:
Alternatively, log in as a teacher and go to Assignment. Click View/Grade all submissions to view the test submission.
Click on the chain icon to open the report:
The installation is successful if you can view the Unplag report and similarity score.
Go to unplag.com and log in as admin. Click on the profile icon → System settings.
When the option is OFF, we do not store copies of submitted files in your Unplag.com account, and hence, option
Download original files (student files) will be disabled. We will still be able to find similarity matches with the files, however, you
will not be able to export student submissions as a zip file. By setting this option to ON (default; recommended), you give us
permission to store original documents, submitted by students.
Unplag global index is a central database that will be shared at some time in the future with all Unplag customers. Customers will
be able to search against this database and spot similarities. By default, this option is disabled. Users from other organizations will
not be able to view the full text of the documents, we will only highlight the similarities in the users’ submissions.
This setting only effects Unplag.com admin account at the https://unplag.com. This setting does not effect Unplag LTI app or
instructor accounts. Keep this option at 0% unless you know what you are doing.
Go to Unplag.com and log in as admin. Open profile icon → System Settings. Upload the logo in the Design settings section,
click Save all.
Once the logo is uploaded, it will appear in all new Unplag PDF reports.
Feel free to contact Unplag account manager and suggest improvements or provide feedback. We’ll do our best to improve the product/service based on your suggestions.