Last updated: Dec 19, 2016

Document owner: Unplag.com

Admin guide: installation of Unplag plugin (Moodle LMS)

  1. The Unplag Plugin for Moodle LMS
  2. Download the plugin
  3. Install the plugin
  4. Update the plugin to a latest version
  5. Configure the Unplag plugin defaults
  6. Test the Unplag plugin
  1. Create a test assignment
  2. Submit test assignment
  1. Configuring System Settings at Unplag.com
  1. About Store original documents feature
  2. About Store in Unplag global index feature
  3. About Similarity sources feature
  1. Adding logo to Unplag PDF reports
  2. I want to suggest a feature, provide feedback

The Unplag Plugin for Moodle LMS

Designed based on educators’ feedback, Unplag is a plagiarism detection engine helping educators spot plagiarism.

To start using the app, please register at https://unplag.com or get in touch with the sales team via sales@unplag.com.

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

Download the plugin

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.

Install the plugin

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!

Update the plugin to a latest version

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.

Configure the Unplag plugin defaults

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):

Enable UNPLAG

Enabling the Unplag plugin in Moodle LMS

Client ID & API Secret

Obtain Client ID and API secret from admin account at unplag.com:

  1. Click the link (indicated by arrow) to open API SETTINGS at Unplag.com for your account. You may be asked to log in.
  2. Copy API Key from the Unplag account and paste it into the Client ID field in Moodle.
  3. Copy API Secret in the Unplag account and insert it into the API Secret field in Moodle.


Please, note, you may create additional pair of keys for testing or different LMS. Use
Generate New App button on the API SETTINGS tab in the Unplag.com account. Alternatively, you may request this information from the Unplag account manager.

Familiarize students with the UNPLAG Privacy Policy

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 UNPLAG

Enable the Unplag plugin by default for the Assignment activity

Check types for plagiarism

  • Doc vs Internet - scans submission vs Internet (pages and files)
  • Doc vs Library - scans submission vs institution’s Unplag account (previous submissions as well as documents uploaded to Unplag.com account)
  • Doc vs Internet + Library (recommended) - scans submission vs Internet and Library at the same time and produces combined report.

Show similarity score to student

  • Never - similarity score will never be shown to students.
  • Always - similarity score will always be shown to students after submitted paper is scanned by Unplag.

Show similarity report to student

  • Never - similarity report will never be shown to students.
  • Always - similarity report will always be shown to students after submitted paper is scanned by Unplag.

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.

Test the Unplag plugin

This step helps verify that the plugin is activated, all the settings are correct and that the Unplag report is successfully generated.

Create a test assignment

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.

Submit test assignment

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.

Configuring System Settings at Unplag.com

Go to unplag.com and log in as admin. Click on the profile icon → System settings.

About Store original documents feature

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.

About Store in Unplag global index feature

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.

About Similarity sources feature

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.

Adding logo to Unplag PDF reports

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.

I want to suggest a feature, provide feedback

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.