Installing the Unicheck LTI app
In this section we will review how to install Unicheck LTI app for entire Schoology account. This means all instructors in the account will get access to the application. During trial or pilot phase, you may install the tool at the course level (Course → Course Options → External Tool Providers) in one or more courses. Installation details (External Tool Provider form) are the same in global setup procedure.
First, a Schoology integration should be created in the Unicheck Admin account.
Creating a Schoology integration in the Unicheck account
Go to https://unicheck.com/login/education and log in to your Unicheck Admin account. Then go to Integration → Create New.
STEP 1: Name the integration
Click Create Integration under the Schoology icon, then choose a name for the integration (e.g., “Schoology”), and click Next Step.
STEP 2: Review integration settings
Review the default integration settings (only Administrator can change them).
Recommended settings are shown on the images below.
- Store original documents.
If the setting is ON, instructors will be able to download originally submitted files. If the setting is OFF, originally submitted documents will be unavailable, but their content (text) will still be stored in the user’s local database and used by Unicheck for comparison with other submissions.
- Show custom logo in Unicheck Reports.
Click Upload to upload a logo to be displayed in Online and PDF similarity reports. Recommended file formats: PNG or JPG. You do not need to crop or resize the picture before uploading it.
- Exclude Quotes & References.
If this option is enabled, Unicheck will search and highlight in-text citations and references (APA, MLA, Chicago/Turabian, Harvard).
Excluding quotes means highlighting them in the submitted document. Detected quotes will not be checked for plagiarism.
Excluding references means highlighting them in the submitted document. Detected references will not be checked for plagiarism.
- Exclude sources.
This filter allows to automatically exclude matched sources based on the set parameters. The minimum value for “Words” is “8” (set a higher value to omit sources with longer matches). Sources with combined matched word count less than the set value will be excluded.
- Student's precheck.
If this option is enabled, the default student precheck setting will be set to ON. Instructors will be able to allow draft submissions. With this option, students can check their submissions before submitting the final version. Instructors will still be able to switch the setting OFF.
- Number of drafts to check.
Set the maximum number of draft submissions prior to final submission. Instructors can change this value.
- Precheck only.
Enable this setting to let instructors configure any particular assignment exclusively for student precheck.
- Show similarity reports to students.
Enable this setting to let students access their similarity reports.
Click Next Step.
STEP 3: Generate API keys
Your API credentials are generated automatically (you may copy them later). Consumer Key and Consumer Secret will be needed while adding Unicheck app in Schoology LMS.
After the integration setup is over, you will see a newly created integration in the list of active integrations. Take note of Consumer key, Consumer secret (Shared secret) and Launch URL (you may return to this view to copy these keys later).
Click Finish and then click View Active Integrations.
STEP 4: Review instructor permissions
Click Permissions under your integration's name and review the default instructor permissions. Recommended settings are shown on the images below.
Important: Set Grade submissions from Unicheck Report interface to ON to allow grading student submissions directly in Unicheck Assignment and Unicheck Report.
Option 1: Installation from the App Center (account level)
Log into LMS as an Administrator and find the Unicheck app in the App Center:
--
Open the app’s details and click Install LTI app:
Select Add to Organization:
Click Install / Remove:
--
Select All Courses and Course admins only checkboxes:
--
Click Configure:
1:
2:
--
You can obtain Consumer key and Shared Secret from you Unicheck Admin account (see STEP 3 of Creating a Schoology integration in the Unicheck account).
Option 2: Manual installation (account level)
Log into LMS as an Administrator. Navigate to System Settings → Integration → External Tools. Click Add External Tool Provider and fill out the form, as suggested below, and submit it to register new LTI application.
--
Add External Tool Provider form:
|
Tool Name |
Unicheck |
|
Consumer key, |
You can obtain Consumer key and Shared Secret from you Unicheck Admin account (see STEP 3 of Creating a Schoology integration in the Unicheck account).
|
|
Privacy |
Privacy options (option 4 is recommended): (1) Do not send any user information; (2) Only send name of user who launches the tool; (3) Only send Email/Username of user who launches the tool; (4) Send Name and Email/Username of user who launches the tool;
Explanation:
|
|
Configuration Type |
Manual |
|
Match By |
URL |
|
Domain/URL |
Copy the Launch URL from the Active Integrations page in the Unicheck account:
|
|
Custom Parameters |
auto_grade=off |
Upon form submission, new app will be registered - installation is complete. Next step is to test the installation.
Testing the Unicheck LTI app
Create a course (or use existing one). If you decide to create a new course, make sure that you enroll at least 1 teacher and 1 student. Grant a teacher Admin rights in the course (this is required for LTI application to function properly when used by teachers).
1:
2:
--
Create a new Unicheck assignment. Click Add Materials → Add File/Link/External Tool, then select External Tool. In the pop-up window, specify Unicheck Plagiarism Checker as a Tool Provider and enter the Title. Submit the form.
Open the assignment to view Unicheck submissions (there will not be any submissions yet).
Login as a student and open the assignment. Add the file and click Final submission:
--
If you see File(s) successfully submitted! notice, then everything’s has been setup correctly:
--
Log in as a teacher, and open the assignment to view submissions:
--
Make sure a teacher has admin rights in the course
|
Note: In order for LTI app to function properly for the teacher, an account must have admin rights in the course. Therefore, when enabling Unicheck LTI tool for instructors, make sure that you assign admin roles to teachers’ accounts in specific courses (when a user has admin rights, there will be a crown icon displayed next to the user name in the Members area): |
--
With correct permissions, teacher will see Settings button on the home page for the Unicheck assignment:
Configuring global settings for Unicheck assignments
Upon installation of Unicheck app, default settings for new Unicheck assignments are:
-
Exclude submissions from the Institutional Library = OFF (recommended; controlled by instructor)
-
Auto Exclude Citations & References = ON (recommended)
-
Student precheck = OFF (recommended; controlled by instructor)
-
Omit sources, where percentage of similarity is less than = 0% (recommended)
-
Omit sources, where the number of words that match is less than = 8
-
Show or hide similarity results from students = ON (recommended; controlled by instructor)
To change global defaults, open any Unicheck assignment (in any course) and then open Settings:
Please, refer to Configuring Unicheck Settings in Schoology Assignment section of the Instructor guide for more details.
I want to suggest a feature, provide feedback
Feel free to contact Unicheck account manager and suggest improvements or provide feedback. We’ll do our best to improve the product/service based on your suggestions.
Comments
0 comments
Please sign in to leave a comment.