MoodleDocs - User contributions [en]

Turnitin

2010-10-13T15:42:50Z

Paul.dawson: /* Moodle Direct Plugin */

==Turnitin Plagiarism Prevention==
Turnitin is a commercial plagiarism detection system and there are currently 3 different options available to use within Moodle.
===Plagiarism Prevention Plugins(Moodle 2.0)===
A new [[Plagiarism Prevention]] plugin system is available in Moodle 2.0 written by [http://moodle.org/user/view.php?id=21591&course=5 Dan Marsden] from [http://www.catalyst.net.nz Catalyst IT] which allows existing Modules to "call" the plagiarism service. It has been added to the upload and uploadsingle assignment types, but eventually support will be added to other areas. This is a generic plugin system and other Plagiarism products will be added in future. An older more limited version of this plugin for Moodle 1.9 is available here: http://moodle.org/mod/data/view.php?d=13&rid=1562

===Moodle Direct Plugin===
The [[Turnitin's Moodle Direct Integration|Moodle Direct Integration]] was developed by [http://www.nlearning.co.uk nlearning Ltd] (now iParadigms Europe Ltd) - This module is similar to the advanced assignment type in Moodle, however it adds a range of Turnitin specific functionality. It is packaged as a stand alone activity module and supports Moodle 1.8, 1.9 and the current Moodle 2.0 preview. The current version is available as a module from [[http://www.moodle.org/modules Modules and Plugins]]. The key aim of the development is to represent all features of Turnitin within the Moodle workflow as and when they become exposed through the Turnitin API.

The integration works on the principle of mapping a Turnitin Assignment in Moodle with an assignment in Turnitin, once mapped all submissions made on either side are synchronised reflecting any changes on both platforms. It is therefore possible to access the assignments created using the plugin by logging in to either system. There is the option to disable emails sent out to students which means login details and welcome emails are not sent which encourages students to submit only through Moodle. GradeMark grades are represented in the Moodle gradebook and originality scores are displayed in the Moodle Turnitin Assignment Inbox.

For more detail see: http://moodle.org/mod/forum/discuss.php?d=149575

===Moodle Basic Plugin===
The original Assignment type developed by Iparadigms (Turnitin Development team) which is very basic and provides SSO into Turnitin, keeping the Moodle sites header, and opening their site in a frame underneath. - this means that all assignments are stored in the Turnitin system, if you canceled your Turnitin subscription, there is no way in Moodle to retrieve the files submitted.

Official Turnitin Deep Integration Module

2010-10-13T15:42:14Z

Paul.dawson: Redirecting to Turnitin's Moodle Direct Integration

#REDIRECT [[Turnitin's Moodle Direct Integration]]

Turnitin's Moodle Direct Integration

2010-10-13T15:37:33Z

Paul.dawson:

{{Turnitin Moodle Direct}}
==Introduction==
Turnitin's Moodle Direct integration activity module is a standalone Moodle module with the aim of representing the full suite of Turnitin's features within the standard Moodle workflow. The module is actively developed and managed by iParadigms, the developers of Turnitin.
==Key Features==
*'''Multi Part Assignments'''
:Each Turnitin Assignment may consist of up to 5 parts, parts can be configured to have start dates, due dates and post dates independent of one another.
*'''Real Turnitin Users'''
:The integration maps Moodle users to real Turnitin user accounts for both Instructors and Students, there is the option to disable student emails should an institution not wish to have students log in to Turnitin rather than Moodle.
*'''GradeMark / Moodle Grade Book integration'''
:Grades are synchronised between Turnitin's GradeMark and the Moodle grade book
*'''Anonymous Marking (UK Only)'''
:Anonymous marking allows student names to be masked from instructors up until the post date
*'''Troubleshooting / Diagnostics'''
:Diagnostic mode allows administrators to identify bugs and communication issues by enabling API call logs and displaying line numbers within error messages
==Integration Video Walkthroughs==
*[http://www.youtube.com/watch?v=0GLaq9TflyA Turnitin Moodle Direct - Configure the Activity Module]
*[http://www.youtube.com/watch?v=ICYf9lC1f_I Turnitin Moodle Direct - Creating an Assignment]
*[http://www.youtube.com/watch?v=7j2RS4AOXz8 Turnitin Moodle Direct - Submitting Work as a Student]
*[http://www.youtube.com/watch?v=U8b0evdNnTc Turnitin Moodle Direct - Submission on behalf of a Student]

Turnitin

2010-10-13T15:36:19Z

Paul.dawson: /* Moodle Direct Plugin */

==Turnitin Plagiarism Prevention==
Turnitin is a commercial plagiarism detection system and there are currently 3 different options available to use within Moodle.
===Plagiarism Prevention Plugins(Moodle 2.0)===
A new [[Plagiarism Prevention]] plugin system is available in Moodle 2.0 written by [http://moodle.org/user/view.php?id=21591&course=5 Dan Marsden] from [http://www.catalyst.net.nz Catalyst IT] which allows existing Modules to "call" the plagiarism service. It has been added to the upload and uploadsingle assignment types, but eventually support will be added to other areas. This is a generic plugin system and other Plagiarism products will be added in future. An older more limited version of this plugin for Moodle 1.9 is available here: http://moodle.org/mod/data/view.php?d=13&rid=1562

===Moodle Direct Plugin===
The [[Turnitin's Moodle Direct Integration|Moodle Direct Integration]] has been developed by [http://www.nlearning.co.uk nlearning Ltd] (now iParadigms Europe Ltd) - This module is similar to the advanced assignment type in Moodle, however it adds a range of Turnitin specific functionality. It is packaged as a stand alone activity module and supports Moodle 1.8, 1.9 and the current Moodle 2.0 preview. The current version is available as a module from [[http://www.moodle.org/modules Modules and Plugins]]. The key aim of the development is to represent all features of Turnitin within the Moodle workflow as and when they become exposed through the Turnitin API.

The integration works on the principle of mapping a Turnitin Assignment in Moodle with an assignment in Turnitin, once mapped all submissions made on either side are synchronised reflecting any changes on both platforms. It is therefore possible to access the assignments created using the plugin by logging in to either system. There is the option to disable emails sent out to students which means login details and welcome emails are not sent which encourages students to submit only through Moodle. GradeMark grades are represented in the Moodle gradebook and originality scores are displayed in the Moodle Turnitin Assignment Inbox.

For more detail see: http://moodle.org/mod/forum/discuss.php?d=149575

===Moodle Basic Plugin===
The original Assignment type developed by Iparadigms (Turnitin Development team) which is very basic and provides SSO into Turnitin, keeping the Moodle sites header, and opening their site in a frame underneath. - this means that all assignments are stored in the Turnitin system, if you canceled your Turnitin subscription, there is no way in Moodle to retrieve the files submitted.

Turnitin

2010-10-13T15:35:05Z

Paul.dawson:

==Turnitin Plagiarism Prevention==
Turnitin is a commercial plagiarism detection system and there are currently 3 different options available to use within Moodle.
===Plagiarism Prevention Plugins(Moodle 2.0)===
A new [[Plagiarism Prevention]] plugin system is available in Moodle 2.0 written by [http://moodle.org/user/view.php?id=21591&course=5 Dan Marsden] from [http://www.catalyst.net.nz Catalyst IT] which allows existing Modules to "call" the plagiarism service. It has been added to the upload and uploadsingle assignment types, but eventually support will be added to other areas. This is a generic plugin system and other Plagiarism products will be added in future. An older more limited version of this plugin for Moodle 1.9 is available here: http://moodle.org/mod/data/view.php?d=13&rid=1562

===Moodle Direct Plugin===
The [[Turnitin's Moodle Direct Integration|Moodle Direct Integration]] has been developed by [[http://www.nlearning.co.uk nlearning Ltd]] (now iParadigms Europe Ltd) - This module is similar to the advanced assignment type in Moodle, however it adds a range of Turnitin specific functionality. It is packaged as a stand alone activity module and supports Moodle 1.8, 1.9 and the current Moodle 2.0 preview. The current version is available as a module from [[http://www.moodle.org/modules Modules and Plugins]]. The key aim of the development is to represent all features of Turnitin within the Moodle workflow as and when they become exposed through the Turnitin API.

The integration works on the principle of mapping a Turnitin Assignment in Moodle with an assignment in Turnitin, once mapped all submissions made on either side are synchronised reflecting any changes on both platforms. It is therefore possible to access the assignments created using the plugin by logging in to either system. There is the option to disable emails sent out to students which means login details and welcome emails are not sent which encourages students to submit only through Moodle. GradeMark grades are represented in the Moodle gradebook and originality scores are displayed in the Moodle Turnitin Assignment Inbox.

For more detail see: http://moodle.org/mod/forum/discuss.php?d=149575

===Moodle Basic Plugin===
The original Assignment type developed by Iparadigms (Turnitin Development team) which is very basic and provides SSO into Turnitin, keeping the Moodle sites header, and opening their site in a frame underneath. - this means that all assignments are stored in the Turnitin system, if you canceled your Turnitin subscription, there is no way in Moodle to retrieve the files submitted.

Template:Turnitin Moodle Direct

2010-09-16T16:27:20Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin's Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
* [[Turnitin's Moodle Direct Integration - Frequently Asked Questions|FAQs]]
* [http://download.moodle.org/download.php/plugins/mod/turnitintool.zip Download Latest Build]
</div>
</div>

<includeonly>[[Category:Turnitin's Moodle Direct Integration]][[Category:Turnitin]]</includeonly>
__FORCETOC__

Template:Turnitin Moodle Direct

2010-09-13T17:06:19Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin's Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
* [[Turnitin's Moodle Direct Integration - Frequently Asked Questions|Frequently Asked Questions]]
</div>
</div>

<includeonly>[[Category:Turnitin's Moodle Direct Integration]][[Category:Turnitin]]</includeonly>
__FORCETOC__

Template:Turnitin Moodle Direct

2010-09-13T17:05:12Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
* [[Turnitin's Moodle Direct Integration - Frequently Asked Questions|Frequently Asked Questions]]
</div>
</div>

<includeonly>[[Category:Turnitin's Moodle Direct Integration]][[Category:Turnitin]]</includeonly>
__FORCETOC__

Turnitin's Moodle Direct Integration

2010-09-13T17:01:03Z

Paul.dawson:

{{Turnitin Moodle Direct}}
==Introduction==
Turnitin's Moodle Direct integration activity module is a standalone Moodle module with the aim of representing the full suite of Turnitin's features within the standard Moodle workflow. The module was developed by nLearning Ltd with the full support and backing of iParadigms, the developers of Turnitin.
==Key Features==
*'''Multi Part Assignments'''
:Each Turnitin Assignment may consist of up to 5 parts, parts can be configured to have start dates, due dates and post dates independent of one another.
*'''Real Turnitin Users'''
:The integration maps Moodle users to real Turnitin user accounts for both Instructors and Students, there is the option to disable student emails should an institution not wish to have students log in to Turnitin rather than Moodle.
*'''GradeMark / Moodle Grade Book integration'''
:Grades are synchronised between Turnitin's GradeMark and the Moodle grade book
*'''Anonymous Marking (UK Only)'''
:Anonymous marking allows student names to be masked from instructors up until the post date
*'''Troubleshooting / Diagnostics'''
:Diagnostic mode allows administrators to identify bugs and communication issues by enabling API call logs and displaying line numbers within error messages
==Integration Video Walkthroughs==
*[http://www.youtube.com/watch?v=0GLaq9TflyA Turnitin Moodle Direct - Configure the Activity Module]
*[http://www.youtube.com/watch?v=ICYf9lC1f_I Turnitin Moodle Direct - Creating an Assignment]
*[http://www.youtube.com/watch?v=7j2RS4AOXz8 Turnitin Moodle Direct - Submitting Work as a Student]
*[http://www.youtube.com/watch?v=U8b0evdNnTc Turnitin Moodle Direct - Submission on behalf of a Student]

Turnitin's Moodle Direct Integration (Student Guide)

2010-09-13T17:00:20Z

Paul.dawson:

{{Turnitin Moodle Direct}}
== Assignment Summary ==

To access a Turnitin assignment click its title in the course home page. The first page you see is the assignment summary which shows the start date, due date and post date for an assignment. The '''start date''' is the date from which you may submit work, the '''due date''' is the date by which the submission must be made and the '''post date''' is the date at which time the Grades will be published to students.

== Submitting a Paper ==

To submit to an assignment access the student submission inbox by clicking 'My Submissions', then follow these steps:

# If given the choice of submission type select the type of work you are submitting from the drop down list, the option are 'File Upload' or 'Text Submission'
# Enter a title for your submission
# If there is more than one part to the assignment select the part to which you are submitting
# Submit your work:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file.

== My Submissions ==

* '''''Submission''''' contains the title of the paper and status of the submission.
* '''''Submitted''''' contains the date abd time the submission was made.
* '''''Similarity''''' contains the 'Originality Report' icon for the submission which display the percentage of text within the paper that matches content in the Turnitin database.
* '''''Grade''''' contains the grade received for the submission and the GradeMark icon if GradeMark is enabled. The grade and GradeMark icon will not be displayed until after the post date.
* '''''Feedback''''' allows students to leave feedback or comments ralating to their submission and answer comments or questions posted by their tutors.

Turnitin's Moodle Direct Integration (Instructor Guide)

2010-09-13T16:59:45Z

Paul.dawson:

{{Turnitin Moodle Direct}}
== Creating a Turnitin Assignment ==

To create a Turnitin Assignment open the course home page, after logging in as a tutor click the 'Turn editing on' button. Select 'Turnitin Assignment' from the 'Add an activity...' drop down menu.

General Turnitin Assignment settings:

# Enter a title for the Turnitin Assignment
# Enter a description for the assignment
# Select the 'Submission Type' for this assignment, the first option is 'File Upload' (default) which will take doc, docx, pdf, rtf, txt and html. The second option is 'Text Submission' and the third is 'Any Submission Type' allowing submissions to be uploaded in either format.
# Select the number of parts to be created as part of this assignment, the start date, due date and post date are given arbitary dates of one week from the time of creation. These dates should be altered as desired on the summary screen after creation.
# Select the 'Maximum File Size' for submissions. Turnitin will allow up to 2MB for text only submissions and for text and graphic files 20MB is allowed.
# Select 'Overall Grade' from the drop down menu. This is the final grade for the overall assignment. E.g. The assignment is to be graded as a maximum of 16 marks in total, each part can be marked out of 100 but the overall grade will be represented out of 16.
# (Optional) Select whether or not to use Anonymous marking for this assignment (UK Only)
# Select whether students can view Originality Reports

Advanced Turnitin Assignment settings:

# '''''Allow Late Submissions''''' allows students to submit work after the due date is passed. Submissions made after the due date will be shown in the tutor in-box with the date submission in red to indicate a late submission.
# '''''Report Generation Speed''''' determines how and when originaliy reports are generated. The options are:
## ''Generate reports immediately, first report is final'' - Originality reports are created immediately and students may not resubmit papers. Submissions must be deleted by the instructor to enable resubmission.
## ''Generate reports immediately, reports can be written until due date'' - The orgininality report is generated immediately. Students may resubmit as often as the student wishes up until the due date. Originality reports form the second and subsequent resubmissions will require a 24 hour delay before originality report is regenerated. Only the latest submission is available to the student and instructor. When the due date passes the originality report is regenerated and student submissions within the same assignment are included in the comparison which may result in a change to the originality report similarity index. Resubmissions are not allowed after the due date.
## ''Generate reports on due date'' - Originality reports for submissions are generated on the due date. Resubmissions are allowed up until the due date.
# '''''Store Student Papers''''' determines where the submission will be stored. Options are No Repository, Standard Repository and Institutional Repository.
# '''''Check against stored student papers''''' determines whether submissions are checked against other student papers.
# '''''Check against internet''''' determines whether submissions are checked against internet sources.
# '''''Check against journals, periodicals and publications''''' determines whether submissions are checked against journal, periodical and publication sources.
# '''''Moodle Groups''''' are not currently supported in the integration but are noted for inclusion in the development roadmap.

Once you have selected all of the required options click 'Save and Display' to be directed to the Summary screen where you will see options to configure each assignment part in more detail.

== Assignment Submission Dates ==

After completion of the assignment settings the 'Summary' page gives you the opportunity update the assignment parts and balance the grades awarded for each part as a proportion of the overall grade. The edit the dates and grades awarded for each part click the pencil icon. The default dates for each assignment part are initially set to be one week from the date the assignment was created.

* The '''Start Date''' determines the earliest time a student can make a submission to that assignment part.
* The '''Due Date''' determines the date by which time the student must submit their work. If allowing late submissions submissions made after this date will be marked in red to show a late submission.
* The '''Post Date''' determines when marks/grades will be released to students. If anonymous marking is switched on (UK only) this also represents the date when student names are revealed to the instructor.

== Turnitin Class Owner ==

Currently within Turnitin each class is managed by a single instructor. Moodle maps all enrolled Tutors to this one Turnitin Owner in order to facilitate multiple instructor access. An instructor on the Moodle course may change this 'owner' by clicking the pencil and changing the owner. This does not effect Moodle in any way but it does allow the Owner to log in to Turnitin and see the class natively within the Turnitin web site. Multiple instructors will be supported in Turnitin in a future release at that point this feature will be removed from the integration.

== Submit Paper on behalf of a Student ==

To submit a paper as a tutor on behalf of a student first click on the tab 'Submit Paper' then follow these steps:

# Select the student's name from the drop down list
# Enter a submission title
# Select the submission part from the drop down list, if only one part is available then this defaults to the single part.
# Enter the submission source:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file

== Viewing the Turnitin Submission Inbox ==

When you are logged in as a Tutor you can access the student submission inbox by clicking the 'Submission Inbox' tab.

* The submission inbox operates in two modes depending on the number of submissions and a third mode if anonymous marking is enabled (UK only)
* For a multi part assignment each student is listed with a summary of the submissions they have made. More information and full details of their submissions can be viewed by clicking the [+] icon to the left of their name.
* By clicking the headings of the Student Submission, Submitted, Similarity or Grade columns you can change the submission order. By default submissions are listed in the order of Similarity Index from high to low.
* Refresh Submissions is used to check Turnitin for any changes and updates Moodle with the latest Turnitin submission data for that assignment.
* Enrol All Student is used to enroll all students currently enrolled on the Moodle course onto the Turnin class associated with that course. As a part of this process students will have a Turnitin account created if they do not already have one associated with their Moodle email address. If you do not want students to receive emails with log in details you must disable the 'Send Student Emails' option in the main configuration for the integration.
* Clicking the students name in the list will open that student's Moodle profile
* By clicking the submission title you will see the submission. If the submission has not yet been submitted to Turnitin then it will reference the uplaoded file on the Moodle server, if the file has been submitted to Turnitin it will be referenced from the Turnitin server.
* When the submission has been uploaded to Turnitin an originality report will be generated. The Similarity Index percentage will be displayed in the 'Similarity' column when it becomes available, until the Report is available the Similarity column will display 'Pending'.
* The '''''Grade''''' column will display the grade in one of two ways:
** If '''''Use GradeMark''''' is enabled and set to 'Yes, use GradeMark to grade submissions' then the grade for the paper will be displayed with a GradeMark apple beside it. Clicking this apple will open GradeMark for this submission.
** If '''''Use GradeMark''''' is not enabled or set to 'No, use Moodle to grade submissions' then the grade for the paper will be displayed with a pencil icon beside it. Clicking this icon will allow you to enter a numeric grade for this submission.
* The '''''Feedback''''' column allows the tutor to give feedback to the student in relation to the submission. The student's inbox also provides the opportunity for the student to reply to feedback or leave their own comments.
* The '''''Download''''' icon allows you to download a copy of the submission.
* The '''''Delete''''' icon allows you to delete this submission.

== Options Tab ==

# '''''Auto Submit''''' can be set to 'Submit to Turnitin immediately on Upload' to upload the submission to Turnitin immediately or can be set to 'Review Upload before Submitting to Turnitin' which requires the student to click the 'Submit to Turnitin' to finalise the submission.
# '''''Use GradeMark''''' can set to 'Yes, use GradeMark to grade submissions' or 'No, use Moodle to grade submissions'
# '''''Grade Display''''' allows you to set whether the Grade will be displayed in the inbox as a percentage (default) or as a fraction of maximum marks e.g. 76/100.
# '''''Auto Refresh Grade / Scores''''' determines whether the Grades / Originality Scores are generated automatically when you enter / re-enter the inbox or if you want to disable the auto refresh function and manually refresh submissions by clicking the 'Refresh Submissions' link.
# '''''Submission List''''' lets you determine if the inbox displays only students that have made submissions or all students regardless.
# '''''Comments Remain Editable''''' lets you set the window of time within which a student may edit the comments left in the feedback screen.
# '''''Maximum Comment Length''''' allows you to limit the number of characters allowed in a feedback comment.

Template:Turnitin Moodle Direct

2010-09-13T16:59:08Z

Paul.dawson:

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-09-13T16:58:00Z

Paul.dawson:

{{Turnitin Moodle Direct}}
== Enabling the Moodle Direct Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Direct Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Template:Turnitin Moodle Direct

2010-09-13T16:57:08Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Intructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
* [[Turnitin's Moodle Direct Integration - Frequently Asked Questions|Frequently Asked Questions]]
</div>
</div>

<includeonly>[[Category:Turnitin's Moodle Direct Integration]][[Category:Turnitin]]</includeonly>

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T16:56:23Z

Paul.dawson:

{{Turnitin Moodle Direct}}
===How do I configure the Moodle Direct integration?===
Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in:

# Configure the Moodle Direct area in the administrator account via www.submit.ac.uk or www.turnitin.com entering a shared secret key (that you make up), your institutions IP range of 255.255.255.255 and the error call back URL of https://submit.ac.uk/api_error.asp if you are on the submit.ac.uk service or https://turnitin.com/api_error.asp if you are on the turnitin.com service.
# Navigate to the 'Download' link next to step 2 at the top of the page and download the latest version of the plug-in for Moodle Direct
# On the server, place the 'turnitintool' folder in the 'mod/' folder
# Ensure that you have cURL installed – you can check if you have via 'Site Administration >> Server >> Environment'
# Log-in as the Moodle administrator and navigate to notifications
# Navigate to 'Module >> Activities >> Turnitin Assignment' to complete the configuration of the plugin. [http://www.youtube.com/watch?v=0GLaq9TflyA A video guide on how to do this can be found here]
# If you are connecting through a proxy please complete the appropriate fields at the bottom of the configuration page. Including the correct URL, Port and Username and Password if applicable. Please note: that if the credentials entered here are incorrect the calls out to Turnitin will not succeed.
# Click 'Run Connectivity Test' to test connection to Turnitin. If this is successful then you will be able to proceed and create Turnitin assignments.

===What are the main differences between Moodle Basic and Moodle Direct?===
The Moodle Basic plug-in supports the full Turnitin WriteCycle: Originality Checking, GradeMark, and PeerMark. When this plug-in has been installed users can access Turnitin from within Moodle via a framed in window. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Moodle. With this plug-in, papers submitted to the Turnitin assignment are only stored in Turnitin. The following languages are supported with this plug-in: English, Spanish, French, German, Chinese (Traditional), Chinese (Simplified), Japanese, Korean, Thai and Malay.

The Moodle Basic plugin is recommended for customers who would like to use the full WriteCycle or for international customers who would like to use the integration in one of the supported languages other than English. Moodle Direct will have languages other than English implemented before the end of the 2010.
Although the Moodle Basic integration incorporates all of the Turnitin WriteCycle functionality, some users may prefer to only work from within the Moodle interface. Customers with such a desire can use the Moodle Direct integration.

The Moodle Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Moodle Direct plugin, all Turnitin actions have been incorporated seamlessly into the Moodle workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Moodle and Turnitin. This plugin also allows instructor and student users to access submissions in Turnitin via the website.

The Moodle Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Moodle workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Moodle Direct plugin, there are plans to include PeerMark in the future.

===Can users migrate their data from the Moodle Basic integration?===
Migrating data from the Moodle Basic integration to the Moodle Direct integration is not possible. However, users will still have access to their old data as long as they do not uninstall the Moodle Basic plug-in.

===Can both Moodle Direct and Moodle Basic integrations exist in the same account?===
Yes. Users can run a single Moodle instance with both the Moodle Basic and the Moodle Direct integrations installed.

===Do users have to install anything new to use Moodle Direct?===
Yes, you will need to install Moodle Direct plug-in. The plug-in can be downloaded from the administrator account via www.submit.ac.uk or www.turnitin.com

===Can both plug-ins be installed and be used simultaneously?===
Yes, both plug-ins can be run in parallel, although this could be very confusing for both instructors and students, since these are two completely different ways to create assignments and submit papers. In other words there would be two Turnitin Assignment links in the 'Add an activity' list.

===Does Moodle Direct handle due dates correctly?===
Yes, the plug-in fully supports due dates and post-dates, incorporating the Moodle GradeBook. Therefore any grades entered in Turnitin's GradeMark feature will be passed into the Moodle GradeBook on the post date specified in the assignment settings.

===Does Moodle Direct work with Moodle Groups?===
Not currently, but this is planned for a later date.

===I am a student, how do I submit my paper?===
Please see [http://www.youtube.com/watch?v=7j2RS4AOXz8 the instructional video here] for a walkthrough on how to make your submission.

There is also a [[Turnitin's Moodle Direct Integration (Student Guide) | Student User Guide here]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Student_Manual.pdf PDF available to download here].

===I am an instructor, how can I make a submission on behalf of a student?===
Please see [http://www.youtube.com/watch?v=U8b0evdNnTc the instructional video here] for a walkthrough on how to make a submission as an instructor on behalf of a student.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is also available here].

===How can I create a Turnitin Assignment via Moodle Direct?===
Please see [http://www.youtube.com/watch?v=ICYf9lC1f_I the instructional video here] for a walkthrough on how to make a Turnitin Assignment using Moodle Direct.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is available here].

===The error "Base API URL is incorrect or unavailable" is occurring when attempting to connect to TII===
Check that that API URL entered in the plug-in configuration via "Modules" >> "Activities" >> "Turnitin Assignment" is correct. For UK users on the 'submit.ac.uk' service the API URL needs to be https://submit.ac.uk/api.asp however the rest of the world users (non-UK) on the turnitin.com service will need to enter https://www.turnitin.com/api.asp

===An error occurs (No HTTPS - the URL was not transmitted via HTTPS)===
This error occurs when you configure the API Url with the http instead of https for example:
* http://api.turnitin.com/api.asp << INCORRECT
* https://api.turnitin.com/api.asp << CORRECT

===An error occurs (Could not write data to file) every time the button 'add submission' is clicked===
The error 'Could not write data to file' only occurs when you try to do a copy and paste submission, it occurs because PHP could not create a text file for the submission; this is usually due to directory permissions on the server in the 'moodledata' directory. For a file upload you will likely receive a 'File Upload Error' this will occur for the same reason. To resolve this you will need to add the necessary permissions to allow the web server to create files in the 'moodledata' directory.

Instructions for setting the correct permissions depends on your environment and server set up:

*[[Creating Moodle site data directory]]
*[[Windows_installation_using_XAMPP#Moodledata_folder]]

The above links explain how to set up the 'moodledata' directory permissions for a couple of example systems. If you are still unsure about how to do this please check with either your hosting provider / server administrator for more detailed information on how to set the correct permissions on your particular server set up.

===Do we need a new plug in for Turnitin2?===
You will not need to upgrade your plug-in for your VLE once Turnitin 2.0 is launched. The changes are being made to the features such as the Originality Report and GradeMark. The integration connects TO these features from Moodle.

Users will be defaulted into the new 'Unified Interface' that Turnitin 2.0 will bring once launch, however each user will have the ability to revert back to the previous version of the Originality Report and GradeMark up to 12 months after launch.

===Further logs to diagnose issue/error===
In order to diagnose issues in more detail, turn diagnostic mode 'ON' from the plug-in configuration screen in Moodle (Logs are kept/produced when diagnostic mode is activated). To create logs for diagnostic purposes, reproduce the error then navigate to the logs on the server. The location should be '/moodledata/temp/turnitintool/logs/....' the comms and activity logs produced should be tagged with the date so you can identify which file the error would be shown in.

Template:Turnitin Moodle Direct

2010-09-13T16:55:00Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Intructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
* [[Turnitin's Moodle Direct Integration - Frequently Asked Questions|Frequently Asked Questions]]
</div>
</div>

<includeonly>[[Category:Turnitin Moodle Direct]]</includeonly>

Template:Turnitin Moodle Direct

2010-09-13T16:53:59Z

Paul.dawson:

<div class="sideblock right" style="width: 15em;">
<div class="header">[[Turnitin's Moodle Direct Integration|Turnitin Moodle Direct]]</div>
<div class="content">
* [[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator Guide]]
* [[Turnitin's Moodle Direct Integration (Intructor Guide)|Instructor Guide]]
* [[Turnitin's Moodle Direct Integration (Student Guide)|Student Guide]]
</div>
</div>

<includeonly>[[Category:Turnitin Moodle Direct]]</includeonly>

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T16:49:59Z

Paul.dawson:

{{Turnitin Moodle Direct}}
[[Category:Turnitin's Moodle Direct Integration]]
[[Category:Turnitin]]
===How do I configure the Moodle Direct integration?===
Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in:

# Configure the Moodle Direct area in the administrator account via www.submit.ac.uk or www.turnitin.com entering a shared secret key (that you make up), your institutions IP range of 255.255.255.255 and the error call back URL of https://submit.ac.uk/api_error.asp if you are on the submit.ac.uk service or https://turnitin.com/api_error.asp if you are on the turnitin.com service.
# Navigate to the 'Download' link next to step 2 at the top of the page and download the latest version of the plug-in for Moodle Direct
# On the server, place the 'turnitintool' folder in the 'mod/' folder
# Ensure that you have cURL installed – you can check if you have via 'Site Administration >> Server >> Environment'
# Log-in as the Moodle administrator and navigate to notifications
# Navigate to 'Module >> Activities >> Turnitin Assignment' to complete the configuration of the plugin. [http://www.youtube.com/watch?v=0GLaq9TflyA A video guide on how to do this can be found here]
# If you are connecting through a proxy please complete the appropriate fields at the bottom of the configuration page. Including the correct URL, Port and Username and Password if applicable. Please note: that if the credentials entered here are incorrect the calls out to Turnitin will not succeed.
# Click 'Run Connectivity Test' to test connection to Turnitin. If this is successful then you will be able to proceed and create Turnitin assignments.

===What are the main differences between Moodle Basic and Moodle Direct?===
The Moodle Basic plug-in supports the full Turnitin WriteCycle: Originality Checking, GradeMark, and PeerMark. When this plug-in has been installed users can access Turnitin from within Moodle via a framed in window. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Moodle. With this plug-in, papers submitted to the Turnitin assignment are only stored in Turnitin. The following languages are supported with this plug-in: English, Spanish, French, German, Chinese (Traditional), Chinese (Simplified), Japanese, Korean, Thai and Malay.

The Moodle Basic plugin is recommended for customers who would like to use the full WriteCycle or for international customers who would like to use the integration in one of the supported languages other than English. Moodle Direct will have languages other than English implemented before the end of the 2010.
Although the Moodle Basic integration incorporates all of the Turnitin WriteCycle functionality, some users may prefer to only work from within the Moodle interface. Customers with such a desire can use the Moodle Direct integration.

The Moodle Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Moodle Direct plugin, all Turnitin actions have been incorporated seamlessly into the Moodle workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Moodle and Turnitin. This plugin also allows instructor and student users to access submissions in Turnitin via the website.

The Moodle Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Moodle workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Moodle Direct plugin, there are plans to include PeerMark in the future.

===Can users migrate their data from the Moodle Basic integration?===
Migrating data from the Moodle Basic integration to the Moodle Direct integration is not possible. However, users will still have access to their old data as long as they do not uninstall the Moodle Basic plug-in.

===Can both Moodle Direct and Moodle Basic integrations exist in the same account?===
Yes. Users can run a single Moodle instance with both the Moodle Basic and the Moodle Direct integrations installed.

===Do users have to install anything new to use Moodle Direct?===
Yes, you will need to install Moodle Direct plug-in. The plug-in can be downloaded from the administrator account via www.submit.ac.uk or www.turnitin.com

===Can both plug-ins be installed and be used simultaneously?===
Yes, both plug-ins can be run in parallel, although this could be very confusing for both instructors and students, since these are two completely different ways to create assignments and submit papers. In other words there would be two Turnitin Assignment links in the 'Add an activity' list.

===Does Moodle Direct handle due dates correctly?===
Yes, the plug-in fully supports due dates and post-dates, incorporating the Moodle GradeBook. Therefore any grades entered in Turnitin's GradeMark feature will be passed into the Moodle GradeBook on the post date specified in the assignment settings.

===Does Moodle Direct work with Moodle Groups?===
Not currently, but this is planned for a later date.

===I am a student, how do I submit my paper?===
Please see [http://www.youtube.com/watch?v=7j2RS4AOXz8 the instructional video here] for a walkthrough on how to make your submission.

There is also a [[Turnitin's Moodle Direct Integration (Student Guide) | Student User Guide here]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Student_Manual.pdf PDF available to download here].

===I am an instructor, how can I make a submission on behalf of a student?===
Please see [http://www.youtube.com/watch?v=U8b0evdNnTc the instructional video here] for a walkthrough on how to make a submission as an instructor on behalf of a student.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is also available here].

===How can I create a Turnitin Assignment via Moodle Direct?===
Please see [http://www.youtube.com/watch?v=ICYf9lC1f_I the instructional video here] for a walkthrough on how to make a Turnitin Assignment using Moodle Direct.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is available here].

===The error "Base API URL is incorrect or unavailable" is occurring when attempting to connect to TII===
Check that that API URL entered in the plug-in configuration via "Modules" >> "Activities" >> "Turnitin Assignment" is correct. For UK users on the 'submit.ac.uk' service the API URL needs to be https://submit.ac.uk/api.asp however the rest of the world users (non-UK) on the turnitin.com service will need to enter https://www.turnitin.com/api.asp

===An error occurs (No HTTPS - the URL was not transmitted via HTTPS)===
This error occurs when you configure the API Url with the http instead of https for example:
* http://api.turnitin.com/api.asp << INCORRECT
* https://api.turnitin.com/api.asp << CORRECT

===An error occurs (Could not write data to file) every time the button 'add submission' is clicked===
The error 'Could not write data to file' only occurs when you try to do a copy and paste submission, it occurs because PHP could not create a text file for the submission; this is usually due to directory permissions on the server in the 'moodledata' directory. For a file upload you will likely receive a 'File Upload Error' this will occur for the same reason. To resolve this you will need to add the necessary permissions to allow the web server to create files in the 'moodledata' directory.

Instructions for setting the correct permissions depends on your environment and server set up:

*[[Creating Moodle site data directory]]
*[[Windows_installation_using_XAMPP#Moodledata_folder]]

The above links explain how to set up the 'moodledata' directory permissions for a couple of example systems. If you are still unsure about how to do this please check with either your hosting provider / server administrator for more detailed information on how to set the correct permissions on your particular server set up.

===Do we need a new plug in for Turnitin2?===
You will not need to upgrade your plug-in for your VLE once Turnitin 2.0 is launched. The changes are being made to the features such as the Originality Report and GradeMark. The integration connects TO these features from Moodle.

Users will be defaulted into the new 'Unified Interface' that Turnitin 2.0 will bring once launch, however each user will have the ability to revert back to the previous version of the Originality Report and GradeMark up to 12 months after launch.

===Further logs to diagnose issue/error===
In order to diagnose issues in more detail, turn diagnostic mode 'ON' from the plug-in configuration screen in Moodle (Logs are kept/produced when diagnostic mode is activated). To create logs for diagnostic purposes, reproduce the error then navigate to the logs on the server. The location should be '/moodledata/temp/turnitintool/logs/....' the comms and activity logs produced should be tagged with the date so you can identify which file the error would be shown in.

Turnitin Moodle Direct

2010-09-13T15:57:31Z

Paul.dawson: Redirecting to Turnitin's Moodle Direct Integration

#REDIRECT[[Turnitin's Moodle Direct Integration]]

Turnitin Moodle Direct

2010-09-13T15:39:30Z

Paul.dawson: /* Turnitin's Moodle Direct */

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T15:38:35Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
[[Category:Turnitin]]
===How do I configure the Moodle Direct integration?===
Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in:

# Configure the Moodle Direct area in the administrator account via www.submit.ac.uk or www.turnitin.com entering a shared secret key (that you make up), your institutions IP range of 255.255.255.255 and the error call back URL of https://submit.ac.uk/api_error.asp if you are on the submit.ac.uk service or https://turnitin.com/api_error.asp if you are on the turnitin.com service.
# Navigate to the 'Download' link next to step 2 at the top of the page and download the latest version of the plug-in for Moodle Direct
# On the server, place the 'turnitintool' folder in the 'mod/' folder
# Ensure that you have cURL installed – you can check if you have via 'Site Administration >> Server >> Environment'
# Log-in as the Moodle administrator and navigate to notifications
# Navigate to 'Module >> Activities >> Turnitin Assignment' to complete the configuration of the plugin. [http://www.youtube.com/watch?v=0GLaq9TflyA A video guide on how to do this can be found here]
# If you are connecting through a proxy please complete the appropriate fields at the bottom of the configuration page. Including the correct URL, Port and Username and Password if applicable. Please note: that if the credentials entered here are incorrect the calls out to Turnitin will not succeed.
# Click 'Run Connectivity Test' to test connection to Turnitin. If this is successful then you will be able to proceed and create Turnitin assignments.

===What are the main differences between Moodle Basic and Moodle Direct?===
The Moodle Basic plug-in supports the full Turnitin WriteCycle: Originality Checking, GradeMark, and PeerMark. When this plug-in has been installed users can access Turnitin from within Moodle via a framed in window. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Moodle. With this plug-in, papers submitted to the Turnitin assignment are only stored in Turnitin. The following languages are supported with this plug-in: English, Spanish, French, German, Chinese (Traditional), Chinese (Simplified), Japanese, Korean, Thai and Malay.

The Moodle Basic plugin is recommended for customers who would like to use the full WriteCycle or for international customers who would like to use the integration in one of the supported languages other than English. Moodle Direct will have languages other than English implemented before the end of the 2010.
Although the Moodle Basic integration incorporates all of the Turnitin WriteCycle functionality, some users may prefer to only work from within the Moodle interface. Customers with such a desire can use the Moodle Direct integration.

The Moodle Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Moodle Direct plugin, all Turnitin actions have been incorporated seamlessly into the Moodle workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Moodle and Turnitin. This plugin also allows instructor and student users to access submissions in Turnitin via the website.

The Moodle Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Moodle workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Moodle Direct plugin, there are plans to include PeerMark in the future.

===Can users migrate their data from the Moodle Basic integration?===
Migrating data from the Moodle Basic integration to the Moodle Direct integration is not possible. However, users will still have access to their old data as long as they do not uninstall the Moodle Basic plug-in.

===Can both Moodle Direct and Moodle Basic integrations exist in the same account?===
Yes. Users can run a single Moodle instance with both the Moodle Basic and the Moodle Direct integrations installed.

===Do users have to install anything new to use Moodle Direct?===
Yes, you will need to install Moodle Direct plug-in. The plug-in can be downloaded from the administrator account via www.submit.ac.uk or www.turnitin.com

===Can both plug-ins be installed and be used simultaneously?===
Yes, both plug-ins can be run in parallel, although this could be very confusing for both instructors and students, since these are two completely different ways to create assignments and submit papers. In other words there would be two Turnitin Assignment links in the 'Add an activity' list.

===Does Moodle Direct handle due dates correctly?===
Yes, the plug-in fully supports due dates and post-dates, incorporating the Moodle GradeBook. Therefore any grades entered in Turnitin's GradeMark feature will be passed into the Moodle GradeBook on the post date specified in the assignment settings.

===Does Moodle Direct work with Moodle Groups?===
Not currently, but this is planned for a later date.

===I am a student, how do I submit my paper?===
Please see [http://www.youtube.com/watch?v=7j2RS4AOXz8 the instructional video here] for a walkthrough on how to make your submission.

There is also a [[Turnitin's Moodle Direct Integration (Student Guide) | Student User Guide here]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Student_Manual.pdf PDF available to download here].

===I am an instructor, how can I make a submission on behalf of a student?===
Please see [http://www.youtube.com/watch?v=U8b0evdNnTc the instructional video here] for a walkthrough on how to make a submission as an instructor on behalf of a student.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is also available here].

===How can I create a Turnitin Assignment via Moodle Direct?===
Please see [http://www.youtube.com/watch?v=ICYf9lC1f_I the instructional video here] for a walkthrough on how to make a Turnitin Assignment using Moodle Direct.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is available here].

===The error "Base API URL is incorrect or unavailable" is occurring when attempting to connect to TII===
Check that that API URL entered in the plug-in configuration via "Modules" >> "Activities" >> "Turnitin Assignment" is correct. For UK users on the 'submit.ac.uk' service the API URL needs to be https://submit.ac.uk/api.asp however the rest of the world users (non-UK) on the turnitin.com service will need to enter https://www.turnitin.com/api.asp

===An error occurs (No HTTPS - the URL was not transmitted via HTTPS)===
This error occurs when you configure the API Url with the http instead of https for example:
* http://api.turnitin.com/api.asp << INCORRECT
* https://api.turnitin.com/api.asp << CORRECT

===An error occurs (Could not write data to file) every time the button 'add submission' is clicked===
The error 'Could not write data to file' only occurs when you try to do a copy and paste submission, it occurs because PHP could not create a text file for the submission; this is usually due to directory permissions on the server in the 'moodledata' directory. For a file upload you will likely receive a 'File Upload Error' this will occur for the same reason. To resolve this you will need to add the necessary permissions to allow the web server to create files in the 'moodledata' directory.

Instructions for setting the correct permissions depends on your environment and server set up:

*[[Creating Moodle site data directory]]
*[[Windows_installation_using_XAMPP#Moodledata_folder]]

The above links explain how to set up the 'moodledata' directory permissions for a couple of example systems. If you are still unsure about how to do this please check with either your hosting provider / server administrator for more detailed information on how to set the correct permissions on your particular server set up.

===Do we need a new plug in for Turnitin2?===
You will not need to upgrade your plug-in for your VLE once Turnitin 2.0 is launched. The changes are being made to the features such as the Originality Report and GradeMark. The integration connects TO these features from Moodle.

Users will be defaulted into the new 'Unified Interface' that Turnitin 2.0 will bring once launch, however each user will have the ability to revert back to the previous version of the Originality Report and GradeMark up to 12 months after launch.

===Further logs to diagnose issue/error===
In order to diagnose issues in more detail, turn diagnostic mode 'ON' from the plug-in configuration screen in Moodle (Logs are kept/produced when diagnostic mode is activated). To create logs for diagnostic purposes, reproduce the error then navigate to the logs on the server. The location should be '/moodledata/temp/turnitintool/logs/....' the comms and activity logs produced should be tagged with the date so you can identify which file the error would be shown in.

Template:Turnitin Moodle Direct

2010-09-13T15:35:16Z

Paul.dawson: New page: ==Turnitin's Moodle Direct==

==Turnitin's Moodle Direct==

Turnitin Moodle Direct

2010-09-13T15:34:00Z

Paul.dawson: New page: ==Turnitin's Moodle Direct==

==Turnitin's Moodle Direct==

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T15:32:23Z

Paul.dawson:

Turnitin

2010-09-13T15:24:07Z

Paul.dawson: /* Moodle Direct Plugin */

==Turnitin Plagiarism Prevention==
Turnitin is a commercial plagiarism detection system and there are currently 3 different options available to use within Moodle.
===Plagiarism Prevention Plugins(Moodle 2.0)===
A new [[Plagiarism Prevention]] plugin system is available in Moodle 2.0 written by [http://moodle.org/user/view.php?id=21591&course=5 Dan Marsden] from [http://www.catalyst.net.nz Catalyst IT] which allows existing Modules to "call" the plagiarism service. It has been added to the upload and uploadsingle assignment types, but eventually support will be added to other areas. This is a generic plugin system and other Plagiarism products will be added in future. An older more limited version of this plugin for Moodle 1.9 is available here: http://moodle.org/mod/data/view.php?d=13&rid=1562

===Moodle Direct Plugin===
The [[Turnitin's Moodle Direct Integration|Moodle Direct Integration]] has been developed by [[http://www.nlearning.co.uk nlearning Ltd]] (Turnitin UK and European Reseller) - This module is similar to the advanced assignment type in Moodle, however it adds a range of Turnitin specific functionality. It is packaged as a stand alone activity module and supports Moodle 1.8, 1.9 and the current Moodle 2.0 preview. The current version is available as a module from [[http://www.moodle.org/modules Modules and Plugins]]. The key aim of the development is to represent all features of Turnitin within the Moodle workflow as and when they become exposed through the Turnitin API.

The integration works on the principle of mapping a Turnitin Assignment in Moodle with an assignment in Turnitin, once mapped all submissions made on either side are synchronised reflecting any changes on both platforms. It is therefore possible to access the assignments created using the plugin by logging in to either system. There is the option to disable emails sent out to students which means login details and welcome emails are not sent which encourages students to submit only through Moodle. GradeMark grades are represented in the Moodle gradebook and originality scores are displayed in the Moodle Turnitin Assignment Inbox.

For more detail see: http://moodle.org/mod/forum/discuss.php?d=149575

===Moodle Basic Plugin===
The original Assignment type developed by Iparadigms (Turnitin Development team) which is very basic and provides SSO into Turnitin, keeping the Moodle sites header, and opening their site in a frame underneath. - this means that all assignments are stored in the Turnitin system, if you canceled your Turnitin subscription, there is no way in Moodle to retrieve the files submitted.

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T15:07:35Z

Paul.dawson:

Turnitin's Moodle Direct Integration (Instructor Guide)

2010-09-13T15:05:31Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
[[Category:Turnitin]]
== Creating a Turnitin Assignment ==

To create a Turnitin Assignment open the course home page, after logging in as a tutor click the 'Turn editing on' button. Select 'Turnitin Assignment' from the 'Add an activity...' drop down menu.

General Turnitin Assignment settings:

# Enter a title for the Turnitin Assignment
# Enter a description for the assignment
# Select the 'Submission Type' for this assignment, the first option is 'File Upload' (default) which will take doc, docx, pdf, rtf, txt and html. The second option is 'Text Submission' and the third is 'Any Submission Type' allowing submissions to be uploaded in either format.
# Select the number of parts to be created as part of this assignment, the start date, due date and post date are given arbitary dates of one week from the time of creation. These dates should be altered as desired on the summary screen after creation.
# Select the 'Maximum File Size' for submissions. Turnitin will allow up to 2MB for text only submissions and for text and graphic files 20MB is allowed.
# Select 'Overall Grade' from the drop down menu. This is the final grade for the overall assignment. E.g. The assignment is to be graded as a maximum of 16 marks in total, each part can be marked out of 100 but the overall grade will be represented out of 16.
# (Optional) Select whether or not to use Anonymous marking for this assignment (UK Only)
# Select whether students can view Originality Reports

Advanced Turnitin Assignment settings:

# '''''Allow Late Submissions''''' allows students to submit work after the due date is passed. Submissions made after the due date will be shown in the tutor in-box with the date submission in red to indicate a late submission.
# '''''Report Generation Speed''''' determines how and when originaliy reports are generated. The options are:
## ''Generate reports immediately, first report is final'' - Originality reports are created immediately and students may not resubmit papers. Submissions must be deleted by the instructor to enable resubmission.
## ''Generate reports immediately, reports can be written until due date'' - The orgininality report is generated immediately. Students may resubmit as often as the student wishes up until the due date. Originality reports form the second and subsequent resubmissions will require a 24 hour delay before originality report is regenerated. Only the latest submission is available to the student and instructor. When the due date passes the originality report is regenerated and student submissions within the same assignment are included in the comparison which may result in a change to the originality report similarity index. Resubmissions are not allowed after the due date.
## ''Generate reports on due date'' - Originality reports for submissions are generated on the due date. Resubmissions are allowed up until the due date.
# '''''Store Student Papers''''' determines where the submission will be stored. Options are No Repository, Standard Repository and Institutional Repository.
# '''''Check against stored student papers''''' determines whether submissions are checked against other student papers.
# '''''Check against internet''''' determines whether submissions are checked against internet sources.
# '''''Check against journals, periodicals and publications''''' determines whether submissions are checked against journal, periodical and publication sources.
# '''''Moodle Groups''''' are not currently supported in the integration but are noted for inclusion in the development roadmap.

Once you have selected all of the required options click 'Save and Display' to be directed to the Summary screen where you will see options to configure each assignment part in more detail.

== Assignment Submission Dates ==

After completion of the assignment settings the 'Summary' page gives you the opportunity update the assignment parts and balance the grades awarded for each part as a proportion of the overall grade. The edit the dates and grades awarded for each part click the pencil icon. The default dates for each assignment part are initially set to be one week from the date the assignment was created.

* The '''Start Date''' determines the earliest time a student can make a submission to that assignment part.
* The '''Due Date''' determines the date by which time the student must submit their work. If allowing late submissions submissions made after this date will be marked in red to show a late submission.
* The '''Post Date''' determines when marks/grades will be released to students. If anonymous marking is switched on (UK only) this also represents the date when student names are revealed to the instructor.

== Turnitin Class Owner ==

Currently within Turnitin each class is managed by a single instructor. Moodle maps all enrolled Tutors to this one Turnitin Owner in order to facilitate multiple instructor access. An instructor on the Moodle course may change this 'owner' by clicking the pencil and changing the owner. This does not effect Moodle in any way but it does allow the Owner to log in to Turnitin and see the class natively within the Turnitin web site. Multiple instructors will be supported in Turnitin in a future release at that point this feature will be removed from the integration.

== Submit Paper on behalf of a Student ==

To submit a paper as a tutor on behalf of a student first click on the tab 'Submit Paper' then follow these steps:

# Select the student's name from the drop down list
# Enter a submission title
# Select the submission part from the drop down list, if only one part is available then this defaults to the single part.
# Enter the submission source:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file

== Viewing the Turnitin Submission Inbox ==

When you are logged in as a Tutor you can access the student submission inbox by clicking the 'Submission Inbox' tab.

* The submission inbox operates in two modes depending on the number of submissions and a third mode if anonymous marking is enabled (UK only)
* For a multi part assignment each student is listed with a summary of the submissions they have made. More information and full details of their submissions can be viewed by clicking the [+] icon to the left of their name.
* By clicking the headings of the Student Submission, Submitted, Similarity or Grade columns you can change the submission order. By default submissions are listed in the order of Similarity Index from high to low.
* Refresh Submissions is used to check Turnitin for any changes and updates Moodle with the latest Turnitin submission data for that assignment.
* Enrol All Student is used to enroll all students currently enrolled on the Moodle course onto the Turnin class associated with that course. As a part of this process students will have a Turnitin account created if they do not already have one associated with their Moodle email address. If you do not want students to receive emails with log in details you must disable the 'Send Student Emails' option in the main configuration for the integration.
* Clicking the students name in the list will open that student's Moodle profile
* By clicking the submission title you will see the submission. If the submission has not yet been submitted to Turnitin then it will reference the uplaoded file on the Moodle server, if the file has been submitted to Turnitin it will be referenced from the Turnitin server.
* When the submission has been uploaded to Turnitin an originality report will be generated. The Similarity Index percentage will be displayed in the 'Similarity' column when it becomes available, until the Report is available the Similarity column will display 'Pending'.
* The '''''Grade''''' column will display the grade in one of two ways:
** If '''''Use GradeMark''''' is enabled and set to 'Yes, use GradeMark to grade submissions' then the grade for the paper will be displayed with a GradeMark apple beside it. Clicking this apple will open GradeMark for this submission.
** If '''''Use GradeMark''''' is not enabled or set to 'No, use Moodle to grade submissions' then the grade for the paper will be displayed with a pencil icon beside it. Clicking this icon will allow you to enter a numeric grade for this submission.
* The '''''Feedback''''' column allows the tutor to give feedback to the student in relation to the submission. The student's inbox also provides the opportunity for the student to reply to feedback or leave their own comments.
* The '''''Download''''' icon allows you to download a copy of the submission.
* The '''''Delete''''' icon allows you to delete this submission.

== Options Tab ==

# '''''Auto Submit''''' can be set to 'Submit to Turnitin immediately on Upload' to upload the submission to Turnitin immediately or can be set to 'Review Upload before Submitting to Turnitin' which requires the student to click the 'Submit to Turnitin' to finalise the submission.
# '''''Use GradeMark''''' can set to 'Yes, use GradeMark to grade submissions' or 'No, use Moodle to grade submissions'
# '''''Grade Display''''' allows you to set whether the Grade will be displayed in the inbox as a percentage (default) or as a fraction of maximum marks e.g. 76/100.
# '''''Auto Refresh Grade / Scores''''' determines whether the Grades / Originality Scores are generated automatically when you enter / re-enter the inbox or if you want to disable the auto refresh function and manually refresh submissions by clicking the 'Refresh Submissions' link.
# '''''Submission List''''' lets you determine if the inbox displays only students that have made submissions or all students regardless.
# '''''Comments Remain Editable''''' lets you set the window of time within which a student may edit the comments left in the feedback screen.
# '''''Maximum Comment Length''''' allows you to limit the number of characters allowed in a feedback comment.

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-09-13T15:04:33Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
[[Category:Turnitin]]
== Enabling the Moodle Direct Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Direct Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration

2010-09-13T15:03:48Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
[[Category:Turnitin]]
==Introduction==
Turnitin's Moodle Direct integration activity module is a standalone Moodle module with the aim of representing the full suite of Turnitin's features within the standard Moodle workflow. The module was developed by nLearning Ltd with the full support and backing of iParadigms, the developers of Turnitin.
==Key Features==
*'''Multi Part Assignments'''
:Each Turnitin Assignment may consist of up to 5 parts, parts can be configured to have start dates, due dates and post dates independent of one another.
*'''Real Turnitin Users'''
:The integration maps Moodle users to real Turnitin user accounts for both Instructors and Students, there is the option to disable student emails should an institution not wish to have students log in to Turnitin rather than Moodle.
*'''GradeMark / Moodle Grade Book integration'''
:Grades are synchronised between Turnitin's GradeMark and the Moodle grade book
*'''Anonymous Marking (UK Only)'''
:Anonymous marking allows student names to be masked from instructors up until the post date
*'''Troubleshooting / Diagnostics'''
:Diagnostic mode allows administrators to identify bugs and communication issues by enabling API call logs and displaying line numbers within error messages
==Integration Video Walkthroughs==
*[http://www.youtube.com/watch?v=0GLaq9TflyA Turnitin Moodle Direct - Configure the Activity Module]
*[http://www.youtube.com/watch?v=ICYf9lC1f_I Turnitin Moodle Direct - Creating an Assignment]
*[http://www.youtube.com/watch?v=7j2RS4AOXz8 Turnitin Moodle Direct - Submitting Work as a Student]
*[http://www.youtube.com/watch?v=U8b0evdNnTc Turnitin Moodle Direct - Submission on behalf of a Student]
==Integration User Guides==
*[[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator User Guide]]
*[[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor User Guide]]
*[[Turnitin's Moodle Direct Integration (Student Guide)|Student User Guide]]
==Frequently Asked Questions==
*[[Turnitin's Moodle Direct Integration - Frequently Asked Questions]]

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T14:39:28Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
===How do I configure the Moodle Direct integration?===
Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in:

# Configure the Moodle Direct area in the administrator account via www.submit.ac.uk or www.turnitin.com entering a shared secret key (that you make up), your institutions IP range of 255.255.255.255 and the error call back URL of https://submit.ac.uk/api_error.asp if you are on the submit.ac.uk service or https://turnitin.com/api_error.asp if you are on the turnitin.com service.
# Navigate to the 'Download' link next to step 2 at the top of the page and download the latest version of the plug-in for Moodle Direct
# On the server, place the 'turnitintool' folder in the 'mod/' folder
# Ensure that you have cURL installed – you can check if you have via 'Site Administration >> Server >> Environment'
# Log-in as the Moodle administrator and navigate to notifications
# Navigate to 'Module >> Activities >> Turnitin Assignment' to complete the configuration of the plugin. [http://www.youtube.com/watch?v=0GLaq9TflyA A video guide on how to do this can be found here]
# If you are connecting through a proxy please complete the appropriate fields at the bottom of the configuration page. Including the correct URL, Port and Username and Password if applicable. Please note: that if the credentials entered here are incorrect the calls out to Turnitin will not succeed.
# Click 'Run Connectivity Test' to test connection to Turnitin. If this is successful then you will be able to proceed and create Turnitin assignments.

===What are the main differences between Moodle Basic and Moodle Direct?===
The Moodle Basic plug-in supports the full Turnitin WriteCycle: Originality Checking, GradeMark, and PeerMark. When this plug-in has been installed users can access Turnitin from within Moodle via a framed in window. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Moodle. With this plug-in, papers submitted to the Turnitin assignment are only stored in Turnitin. The following languages are supported with this plug-in: English, Spanish, French, German, Chinese (Traditional), Chinese (Simplified), Japanese, Korean, Thai and Malay.

The Moodle Basic plugin is recommended for customers who would like to use the full WriteCycle or for international customers who would like to use the integration in one of the supported languages other than English. Moodle Direct will have languages other than English implemented before the end of the 2010.
Although the Moodle Basic integration incorporates all of the Turnitin WriteCycle functionality, some users may prefer to only work from within the Moodle interface. Customers with such a desire can use the Moodle Direct integration.

The Moodle Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Moodle Direct plugin, all Turnitin actions have been incorporated seamlessly into the Moodle workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Moodle and Turnitin. This plugin also allows instructor and student users to access submissions in Turnitin via the website.

The Moodle Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Moodle workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Moodle Direct plugin, there are plans to include PeerMark in the future.

===Can users migrate their data from the Moodle Basic integration?===
Migrating data from the Moodle Basic integration to the Moodle Direct integration is not possible. However, users will still have access to their old data as long as they do not uninstall the Moodle Basic plug-in.

===Can both Moodle Direct and Moodle Basic integrations exist in the same account?===
Yes. Users can run a single Moodle instance with both the Moodle Basic and the Moodle Direct integrations installed.

===Do users have to install anything new to use Moodle Direct?===
Yes, you will need to install Moodle Direct plug-in. The plug-in can be downloaded from the administrator account via www.submit.ac.uk or www.turnitin.com

===Can both plug-ins be installed and be used simultaneously?===
Yes, both plug-ins can be run in parallel, although this could be very confusing for both instructors and students, since these are two completely different ways to create assignments and submit papers. In other words there would be two Turnitin Assignment links in the 'Add an activity' list.

===Does Moodle Direct handle due dates correctly?===
Yes, the plug-in fully supports due dates and post-dates, incorporating the Moodle GradeBook. Therefore any grades entered in Turnitin's GradeMark feature will be passed into the Moodle GradeBook on the post date specified in the assignment settings.

===Does Moodle Direct work with Moodle Groups?===
Not currently, but this is planned for a later date.

===I am a student, how do I submit my paper?===
Please see [http://www.youtube.com/watch?v=7j2RS4AOXz8 the instructional video here] for a walkthrough on how to make your submission.

There is also a [[Turnitin's Moodle Direct Integration (Student Guide) | Student User Guide here]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Student_Manual.pdf PDF available to download here].

===I am an instructor, how can I make a submission on behalf of a student?===
Please see [http://www.youtube.com/watch?v=U8b0evdNnTc the instructional video here] for a walkthrough on how to make a submission as an instructor on behalf of a student.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is also available here].

===How can I create a Turnitin Assignment via Moodle Direct?===
Please see [http://www.youtube.com/watch?v=ICYf9lC1f_I the instructional video here] for a walkthrough on how to make a Turnitin Assignment using Moodle Direct.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is available here].

===The error "Base API URL is incorrect or unavailable" is occurring when attempting to connect to TII===
Check that that API URL entered in the plug-in configuration via "Modules" >> "Activities" >> "Turnitin Assignment" is correct. For UK users on the 'submit.ac.uk' service the API URL needs to be https://submit.ac.uk/api.asp however the rest of the world users (non-UK) on the turnitin.com service will need to enter https://www.turnitin.com/api.asp

===An error occurs (No HTTPS - the URL was not transmitted via HTTPS)===
This error occurs when you configure the API Url with the http instead of https for example:
* http://api.turnitin.com/api.asp << INCORRECT
* https://api.turnitin.com/api.asp << CORRECT

===An error occurs (Could not write data to file) every time the button 'add submission' is clicked===
The error 'Could not write data to file' only occurs when you try to do a copy and paste submission, it occurs because PHP could not create a text file for the submission; this is usually due to directory permissions on the server in the 'moodledata' directory. For a file upload you will likely receive a 'File Upload Error' this will occur for the same reason. To resolve this you will need to add the necessary permissions to allow the web server to create files in the 'moodledata' directory.

Instructions for setting the correct permissions depends on your environment and server set up:

*[[Creating Moodle site data directory]]
*[[Windows_installation_using_XAMPP#Moodledata_folder]]

The above links explain how to set up the 'moodledata' directory permissions for a couple of example systems. If you are still unsure about how to do this please check with either your hosting provider / server administrator for more detailed information on how to set the correct permissions on your particular server set up.

===Do we need a new plug in for Turnitin2?===
You will not need to upgrade your plug-in for your VLE once Turnitin 2.0 is launched. The changes are being made to the features such as the Originality Report and GradeMark. The integration connects TO these features from Moodle.

Users will be defaulted into the new 'Unified Interface' that Turnitin 2.0 will bring once launch, however each user will have the ability to revert back to the previous version of the Originality Report and GradeMark up to 12 months after launch.

===Further logs to diagnose issue/error===
In order to diagnose issues in more detail, turn diagnostic mode 'ON' from the plug-in configuration screen in Moodle (Logs are kept/produced when diagnostic mode is activated). To create logs for diagnostic purposes, reproduce the error then navigate to the logs on the server. The location should be '/moodledata/temp/turnitintool/logs/....' the comms and activity logs produced should be tagged with the date so you can identify which file the error would be shown in.

Turnitin's Moodle Direct Integration

2010-09-13T14:38:33Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
==Introduction==
Turnitin's Moodle Direct integration activity module is a standalone Moodle module with the aim of representing the full suite of Turnitin's features within the standard Moodle workflow. The module was developed by nLearning Ltd with the full support and backing of iParadigms, the developers of Turnitin.
==Key Features==
*'''Multi Part Assignments'''
:Each Turnitin Assignment may consist of up to 5 parts, parts can be configured to have start dates, due dates and post dates independent of one another.
*'''Real Turnitin Users'''
:The integration maps Moodle users to real Turnitin user accounts for both Instructors and Students, there is the option to disable student emails should an institution not wish to have students log in to Turnitin rather than Moodle.
*'''GradeMark / Moodle Grade Book integration'''
:Grades are synchronised between Turnitin's GradeMark and the Moodle grade book
*'''Anonymous Marking (UK Only)'''
:Anonymous marking allows student names to be masked from instructors up until the post date
*'''Troubleshooting / Diagnostics'''
:Diagnostic mode allows administrators to identify bugs and communication issues by enabling API call logs and displaying line numbers within error messages
==Integration Video Walkthroughs==
*[http://www.youtube.com/watch?v=0GLaq9TflyA Turnitin Moodle Direct - Configure the Activity Module]
*[http://www.youtube.com/watch?v=ICYf9lC1f_I Turnitin Moodle Direct - Creating an Assignment]
*[http://www.youtube.com/watch?v=7j2RS4AOXz8 Turnitin Moodle Direct - Submitting Work as a Student]
*[http://www.youtube.com/watch?v=U8b0evdNnTc Turnitin Moodle Direct - Submission on behalf of a Student]
==Integration User Guides==
*[[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator User Guide]]
*[[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor User Guide]]
*[[Turnitin's Moodle Direct Integration (Student Guide)|Student User Guide]]

Turnitin's Moodle Direct Integration (Student Guide)

2010-09-13T14:37:48Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
== Assignment Summary ==

To access a Turnitin assignment click its title in the course home page. The first page you see is the assignment summary which shows the start date, due date and post date for an assignment. The '''start date''' is the date from which you may submit work, the '''due date''' is the date by which the submission must be made and the '''post date''' is the date at which time the Grades will be published to students.

== Submitting a Paper ==

To submit to an assignment access the student submission inbox by clicking 'My Submissions', then follow these steps:

# If given the choice of submission type select the type of work you are submitting from the drop down list, the option are 'File Upload' or 'Text Submission'
# Enter a title for your submission
# If there is more than one part to the assignment select the part to which you are submitting
# Submit your work:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file.

== My Submissions ==

* '''''Submission''''' contains the title of the paper and status of the submission.
* '''''Submitted''''' contains the date abd time the submission was made.
* '''''Similarity''''' contains the 'Originality Report' icon for the submission which display the percentage of text within the paper that matches content in the Turnitin database.
* '''''Grade''''' contains the grade received for the submission and the GradeMark icon if GradeMark is enabled. The grade and GradeMark icon will not be displayed until after the post date.
* '''''Feedback''''' allows students to leave feedback or comments ralating to their submission and answer comments or questions posted by their tutors.

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-09-13T14:35:52Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
== Enabling the Moodle Direct Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Direct Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Instructor Guide)

2010-09-13T14:35:01Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct Integration]]
== Creating a Turnitin Assignment ==

To create a Turnitin Assignment open the course home page, after logging in as a tutor click the 'Turn editing on' button. Select 'Turnitin Assignment' from the 'Add an activity...' drop down menu.

General Turnitin Assignment settings:

# Enter a title for the Turnitin Assignment
# Enter a description for the assignment
# Select the 'Submission Type' for this assignment, the first option is 'File Upload' (default) which will take doc, docx, pdf, rtf, txt and html. The second option is 'Text Submission' and the third is 'Any Submission Type' allowing submissions to be uploaded in either format.
# Select the number of parts to be created as part of this assignment, the start date, due date and post date are given arbitary dates of one week from the time of creation. These dates should be altered as desired on the summary screen after creation.
# Select the 'Maximum File Size' for submissions. Turnitin will allow up to 2MB for text only submissions and for text and graphic files 20MB is allowed.
# Select 'Overall Grade' from the drop down menu. This is the final grade for the overall assignment. E.g. The assignment is to be graded as a maximum of 16 marks in total, each part can be marked out of 100 but the overall grade will be represented out of 16.
# (Optional) Select whether or not to use Anonymous marking for this assignment (UK Only)
# Select whether students can view Originality Reports

Advanced Turnitin Assignment settings:

# '''''Allow Late Submissions''''' allows students to submit work after the due date is passed. Submissions made after the due date will be shown in the tutor in-box with the date submission in red to indicate a late submission.
# '''''Report Generation Speed''''' determines how and when originaliy reports are generated. The options are:
## ''Generate reports immediately, first report is final'' - Originality reports are created immediately and students may not resubmit papers. Submissions must be deleted by the instructor to enable resubmission.
## ''Generate reports immediately, reports can be written until due date'' - The orgininality report is generated immediately. Students may resubmit as often as the student wishes up until the due date. Originality reports form the second and subsequent resubmissions will require a 24 hour delay before originality report is regenerated. Only the latest submission is available to the student and instructor. When the due date passes the originality report is regenerated and student submissions within the same assignment are included in the comparison which may result in a change to the originality report similarity index. Resubmissions are not allowed after the due date.
## ''Generate reports on due date'' - Originality reports for submissions are generated on the due date. Resubmissions are allowed up until the due date.
# '''''Store Student Papers''''' determines where the submission will be stored. Options are No Repository, Standard Repository and Institutional Repository.
# '''''Check against stored student papers''''' determines whether submissions are checked against other student papers.
# '''''Check against internet''''' determines whether submissions are checked against internet sources.
# '''''Check against journals, periodicals and publications''''' determines whether submissions are checked against journal, periodical and publication sources.
# '''''Moodle Groups''''' are not currently supported in the integration but are noted for inclusion in the development roadmap.

Once you have selected all of the required options click 'Save and Display' to be directed to the Summary screen where you will see options to configure each assignment part in more detail.

== Assignment Submission Dates ==

After completion of the assignment settings the 'Summary' page gives you the opportunity update the assignment parts and balance the grades awarded for each part as a proportion of the overall grade. The edit the dates and grades awarded for each part click the pencil icon. The default dates for each assignment part are initially set to be one week from the date the assignment was created.

* The '''Start Date''' determines the earliest time a student can make a submission to that assignment part.
* The '''Due Date''' determines the date by which time the student must submit their work. If allowing late submissions submissions made after this date will be marked in red to show a late submission.
* The '''Post Date''' determines when marks/grades will be released to students. If anonymous marking is switched on (UK only) this also represents the date when student names are revealed to the instructor.

== Turnitin Class Owner ==

Currently within Turnitin each class is managed by a single instructor. Moodle maps all enrolled Tutors to this one Turnitin Owner in order to facilitate multiple instructor access. An instructor on the Moodle course may change this 'owner' by clicking the pencil and changing the owner. This does not effect Moodle in any way but it does allow the Owner to log in to Turnitin and see the class natively within the Turnitin web site. Multiple instructors will be supported in Turnitin in a future release at that point this feature will be removed from the integration.

== Submit Paper on behalf of a Student ==

To submit a paper as a tutor on behalf of a student first click on the tab 'Submit Paper' then follow these steps:

# Select the student's name from the drop down list
# Enter a submission title
# Select the submission part from the drop down list, if only one part is available then this defaults to the single part.
# Enter the submission source:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file

== Viewing the Turnitin Submission Inbox ==

When you are logged in as a Tutor you can access the student submission inbox by clicking the 'Submission Inbox' tab.

* The submission inbox operates in two modes depending on the number of submissions and a third mode if anonymous marking is enabled (UK only)
* For a multi part assignment each student is listed with a summary of the submissions they have made. More information and full details of their submissions can be viewed by clicking the [+] icon to the left of their name.
* By clicking the headings of the Student Submission, Submitted, Similarity or Grade columns you can change the submission order. By default submissions are listed in the order of Similarity Index from high to low.
* Refresh Submissions is used to check Turnitin for any changes and updates Moodle with the latest Turnitin submission data for that assignment.
* Enrol All Student is used to enroll all students currently enrolled on the Moodle course onto the Turnin class associated with that course. As a part of this process students will have a Turnitin account created if they do not already have one associated with their Moodle email address. If you do not want students to receive emails with log in details you must disable the 'Send Student Emails' option in the main configuration for the integration.
* Clicking the students name in the list will open that student's Moodle profile
* By clicking the submission title you will see the submission. If the submission has not yet been submitted to Turnitin then it will reference the uplaoded file on the Moodle server, if the file has been submitted to Turnitin it will be referenced from the Turnitin server.
* When the submission has been uploaded to Turnitin an originality report will be generated. The Similarity Index percentage will be displayed in the 'Similarity' column when it becomes available, until the Report is available the Similarity column will display 'Pending'.
* The '''''Grade''''' column will display the grade in one of two ways:
** If '''''Use GradeMark''''' is enabled and set to 'Yes, use GradeMark to grade submissions' then the grade for the paper will be displayed with a GradeMark apple beside it. Clicking this apple will open GradeMark for this submission.
** If '''''Use GradeMark''''' is not enabled or set to 'No, use Moodle to grade submissions' then the grade for the paper will be displayed with a pencil icon beside it. Clicking this icon will allow you to enter a numeric grade for this submission.
* The '''''Feedback''''' column allows the tutor to give feedback to the student in relation to the submission. The student's inbox also provides the opportunity for the student to reply to feedback or leave their own comments.
* The '''''Download''''' icon allows you to download a copy of the submission.
* The '''''Delete''''' icon allows you to delete this submission.

== Options Tab ==

# '''''Auto Submit''''' can be set to 'Submit to Turnitin immediately on Upload' to upload the submission to Turnitin immediately or can be set to 'Review Upload before Submitting to Turnitin' which requires the student to click the 'Submit to Turnitin' to finalise the submission.
# '''''Use GradeMark''''' can set to 'Yes, use GradeMark to grade submissions' or 'No, use Moodle to grade submissions'
# '''''Grade Display''''' allows you to set whether the Grade will be displayed in the inbox as a percentage (default) or as a fraction of maximum marks e.g. 76/100.
# '''''Auto Refresh Grade / Scores''''' determines whether the Grades / Originality Scores are generated automatically when you enter / re-enter the inbox or if you want to disable the auto refresh function and manually refresh submissions by clicking the 'Refresh Submissions' link.
# '''''Submission List''''' lets you determine if the inbox displays only students that have made submissions or all students regardless.
# '''''Comments Remain Editable''''' lets you set the window of time within which a student may edit the comments left in the feedback screen.
# '''''Maximum Comment Length''''' allows you to limit the number of characters allowed in a feedback comment.

Turnitin's Moodle Direct Integration (Instructor Guide)

2010-09-13T14:33:47Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct]]
== Creating a Turnitin Assignment ==

To create a Turnitin Assignment open the course home page, after logging in as a tutor click the 'Turn editing on' button. Select 'Turnitin Assignment' from the 'Add an activity...' drop down menu.

General Turnitin Assignment settings:

# Enter a title for the Turnitin Assignment
# Enter a description for the assignment
# Select the 'Submission Type' for this assignment, the first option is 'File Upload' (default) which will take doc, docx, pdf, rtf, txt and html. The second option is 'Text Submission' and the third is 'Any Submission Type' allowing submissions to be uploaded in either format.
# Select the number of parts to be created as part of this assignment, the start date, due date and post date are given arbitary dates of one week from the time of creation. These dates should be altered as desired on the summary screen after creation.
# Select the 'Maximum File Size' for submissions. Turnitin will allow up to 2MB for text only submissions and for text and graphic files 20MB is allowed.
# Select 'Overall Grade' from the drop down menu. This is the final grade for the overall assignment. E.g. The assignment is to be graded as a maximum of 16 marks in total, each part can be marked out of 100 but the overall grade will be represented out of 16.
# (Optional) Select whether or not to use Anonymous marking for this assignment (UK Only)
# Select whether students can view Originality Reports

Advanced Turnitin Assignment settings:

# '''''Allow Late Submissions''''' allows students to submit work after the due date is passed. Submissions made after the due date will be shown in the tutor in-box with the date submission in red to indicate a late submission.
# '''''Report Generation Speed''''' determines how and when originaliy reports are generated. The options are:
## ''Generate reports immediately, first report is final'' - Originality reports are created immediately and students may not resubmit papers. Submissions must be deleted by the instructor to enable resubmission.
## ''Generate reports immediately, reports can be written until due date'' - The orgininality report is generated immediately. Students may resubmit as often as the student wishes up until the due date. Originality reports form the second and subsequent resubmissions will require a 24 hour delay before originality report is regenerated. Only the latest submission is available to the student and instructor. When the due date passes the originality report is regenerated and student submissions within the same assignment are included in the comparison which may result in a change to the originality report similarity index. Resubmissions are not allowed after the due date.
## ''Generate reports on due date'' - Originality reports for submissions are generated on the due date. Resubmissions are allowed up until the due date.
# '''''Store Student Papers''''' determines where the submission will be stored. Options are No Repository, Standard Repository and Institutional Repository.
# '''''Check against stored student papers''''' determines whether submissions are checked against other student papers.
# '''''Check against internet''''' determines whether submissions are checked against internet sources.
# '''''Check against journals, periodicals and publications''''' determines whether submissions are checked against journal, periodical and publication sources.
# '''''Moodle Groups''''' are not currently supported in the integration but are noted for inclusion in the development roadmap.

Once you have selected all of the required options click 'Save and Display' to be directed to the Summary screen where you will see options to configure each assignment part in more detail.

== Assignment Submission Dates ==

After completion of the assignment settings the 'Summary' page gives you the opportunity update the assignment parts and balance the grades awarded for each part as a proportion of the overall grade. The edit the dates and grades awarded for each part click the pencil icon. The default dates for each assignment part are initially set to be one week from the date the assignment was created.

* The '''Start Date''' determines the earliest time a student can make a submission to that assignment part.
* The '''Due Date''' determines the date by which time the student must submit their work. If allowing late submissions submissions made after this date will be marked in red to show a late submission.
* The '''Post Date''' determines when marks/grades will be released to students. If anonymous marking is switched on (UK only) this also represents the date when student names are revealed to the instructor.

== Turnitin Class Owner ==

Currently within Turnitin each class is managed by a single instructor. Moodle maps all enrolled Tutors to this one Turnitin Owner in order to facilitate multiple instructor access. An instructor on the Moodle course may change this 'owner' by clicking the pencil and changing the owner. This does not effect Moodle in any way but it does allow the Owner to log in to Turnitin and see the class natively within the Turnitin web site. Multiple instructors will be supported in Turnitin in a future release at that point this feature will be removed from the integration.

== Submit Paper on behalf of a Student ==

To submit a paper as a tutor on behalf of a student first click on the tab 'Submit Paper' then follow these steps:

# Select the student's name from the drop down list
# Enter a submission title
# Select the submission part from the drop down list, if only one part is available then this defaults to the single part.
# Enter the submission source:
## For a file upload, click on the Browse... button and select the file you wish to upload. Acceptable file types are doc, docx, pdf, rtf, txt and html.
## For a text submission, enter the text into the 'Text Submission' text area.
# Click on the 'Add Submission' button to submit the file

== Viewing the Turnitin Submission Inbox ==

When you are logged in as a Tutor you can access the student submission inbox by clicking the 'Submission Inbox' tab.

* The submission inbox operates in two modes depending on the number of submissions and a third mode if anonymous marking is enabled (UK only)
* For a multi part assignment each student is listed with a summary of the submissions they have made. More information and full details of their submissions can be viewed by clicking the [+] icon to the left of their name.
* By clicking the headings of the Student Submission, Submitted, Similarity or Grade columns you can change the submission order. By default submissions are listed in the order of Similarity Index from high to low.
* Refresh Submissions is used to check Turnitin for any changes and updates Moodle with the latest Turnitin submission data for that assignment.
* Enrol All Student is used to enroll all students currently enrolled on the Moodle course onto the Turnin class associated with that course. As a part of this process students will have a Turnitin account created if they do not already have one associated with their Moodle email address. If you do not want students to receive emails with log in details you must disable the 'Send Student Emails' option in the main configuration for the integration.
* Clicking the students name in the list will open that student's Moodle profile
* By clicking the submission title you will see the submission. If the submission has not yet been submitted to Turnitin then it will reference the uplaoded file on the Moodle server, if the file has been submitted to Turnitin it will be referenced from the Turnitin server.
* When the submission has been uploaded to Turnitin an originality report will be generated. The Similarity Index percentage will be displayed in the 'Similarity' column when it becomes available, until the Report is available the Similarity column will display 'Pending'.
* The '''''Grade''''' column will display the grade in one of two ways:
** If '''''Use GradeMark''''' is enabled and set to 'Yes, use GradeMark to grade submissions' then the grade for the paper will be displayed with a GradeMark apple beside it. Clicking this apple will open GradeMark for this submission.
** If '''''Use GradeMark''''' is not enabled or set to 'No, use Moodle to grade submissions' then the grade for the paper will be displayed with a pencil icon beside it. Clicking this icon will allow you to enter a numeric grade for this submission.
* The '''''Feedback''''' column allows the tutor to give feedback to the student in relation to the submission. The student's inbox also provides the opportunity for the student to reply to feedback or leave their own comments.
* The '''''Download''''' icon allows you to download a copy of the submission.
* The '''''Delete''''' icon allows you to delete this submission.

== Options Tab ==

# '''''Auto Submit''''' can be set to 'Submit to Turnitin immediately on Upload' to upload the submission to Turnitin immediately or can be set to 'Review Upload before Submitting to Turnitin' which requires the student to click the 'Submit to Turnitin' to finalise the submission.
# '''''Use GradeMark''''' can set to 'Yes, use GradeMark to grade submissions' or 'No, use Moodle to grade submissions'
# '''''Grade Display''''' allows you to set whether the Grade will be displayed in the inbox as a percentage (default) or as a fraction of maximum marks e.g. 76/100.
# '''''Auto Refresh Grade / Scores''''' determines whether the Grades / Originality Scores are generated automatically when you enter / re-enter the inbox or if you want to disable the auto refresh function and manually refresh submissions by clicking the 'Refresh Submissions' link.
# '''''Submission List''''' lets you determine if the inbox displays only students that have made submissions or all students regardless.
# '''''Comments Remain Editable''''' lets you set the window of time within which a student may edit the comments left in the feedback screen.
# '''''Maximum Comment Length''''' allows you to limit the number of characters allowed in a feedback comment.

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-09-13T14:32:56Z

Paul.dawson:

[[Category:Turnitin's Moodle Direct]]
== Enabling the Moodle Direct Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Direct Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

error/turnitintool/string

2010-09-13T12:59:50Z

Paul.dawson: Redirecting to Turnitin's Moodle Direct Integration - Frequently Asked Questions

#REDIRECT [[Turnitin's Moodle Direct Integration - Frequently Asked Questions]]
<nowiki>Insert non-formatted text here</nowiki>

Turnitin's Moodle Direct Integration - Frequently Asked Questions

2010-09-13T12:58:40Z

Paul.dawson: New page: ===How do I configure the Moodle Direct integration?=== Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in: # Conf...

===How do I configure the Moodle Direct integration?===
Below is an overview of the steps that need to be taken to integration Turnitin with Moodle using the Moodle Direct plug-in:

# Configure the Moodle Direct area in the administrator account via www.submit.ac.uk or www.turnitin.com entering a shared secret key (that you make up), your institutions IP range of 255.255.255.255 and the error call back URL of https://submit.ac.uk/api_error.asp if you are on the submit.ac.uk service or https://turnitin.com/api_error.asp if you are on the turnitin.com service.
# Navigate to the 'Download' link next to step 2 at the top of the page and download the latest version of the plug-in for Moodle Direct
# On the server, place the 'turnitintool' folder in the 'mod/' folder
# Ensure that you have cURL installed – you can check if you have via 'Site Administration >> Server >> Environment'
# Log-in as the Moodle administrator and navigate to notifications
# Navigate to 'Module >> Activities >> Turnitin Assignment' to complete the configuration of the plugin. [http://www.youtube.com/watch?v=0GLaq9TflyA A video guide on how to do this can be found here]
# If you are connecting through a proxy please complete the appropriate fields at the bottom of the configuration page. Including the correct URL, Port and Username and Password if applicable. Please note: that if the credentials entered here are incorrect the calls out to Turnitin will not succeed.
# Click 'Run Connectivity Test' to test connection to Turnitin. If this is successful then you will be able to proceed and create Turnitin assignments.

===What are the main differences between Moodle Basic and Moodle Direct?===
The Moodle Basic plug-in supports the full Turnitin WriteCycle: Originality Checking, GradeMark, and PeerMark. When this plug-in has been installed users can access Turnitin from within Moodle via a framed in window. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Moodle. With this plug-in, papers submitted to the Turnitin assignment are only stored in Turnitin. The following languages are supported with this plug-in: English, Spanish, French, German, Chinese (Traditional), Chinese (Simplified), Japanese, Korean, Thai and Malay.

The Moodle Basic plugin is recommended for customers who would like to use the full WriteCycle or for international customers who would like to use the integration in one of the supported languages other than English. Moodle Direct will have languages other than English implemented before the end of the 2010.
Although the Moodle Basic integration incorporates all of the Turnitin WriteCycle functionality, some users may prefer to only work from within the Moodle interface. Customers with such a desire can use the Moodle Direct integration.

The Moodle Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Moodle Direct plugin, all Turnitin actions have been incorporated seamlessly into the Moodle workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Moodle and Turnitin. This plugin also allows instructor and student users to access submissions in Turnitin via the website.

The Moodle Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Moodle workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Moodle Direct plugin, there are plans to include PeerMark in the future.

===Can users migrate their data from the Moodle Basic integration?===
Migrating data from the Moodle Basic integration to the Moodle Direct integration is not possible. However, users will still have access to their old data as long as they do not uninstall the Moodle Basic plug-in.

===Can both Moodle Direct and Moodle Basic integrations exist in the same account?===
Yes. Users can run a single Moodle instance with both the Moodle Basic and the Moodle Direct integrations installed.

===Do users have to install anything new to use Moodle Direct?===
Yes, you will need to install Moodle Direct plug-in. The plug-in can be downloaded from the administrator account via www.submit.ac.uk or www.turnitin.com

===Can both plug-ins be installed and be used simultaneously?===
Yes, both plug-ins can be run in parallel, although this could be very confusing for both instructors and students, since these are two completely different ways to create assignments and submit papers. In other words there would be two Turnitin Assignment links in the 'Add an activity' list.

===Does Moodle Direct handle due dates correctly?===
Yes, the plug-in fully supports due dates and post-dates, incorporating the Moodle GradeBook. Therefore any grades entered in Turnitin's GradeMark feature will be passed into the Moodle GradeBook on the post date specified in the assignment settings.

===Does Moodle Direct work with Moodle Groups?===
Not currently, but this is planned for a later date.

===I am a student, how do I submit my paper?===
Please see [http://www.youtube.com/watch?v=7j2RS4AOXz8 the instructional video here] for a walkthrough on how to make your submission.

There is also a [[Turnitin's Moodle Direct Integration (Student Guide) | Student User Guide here]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Student_Manual.pdf PDF available to download here].

===I am an instructor, how can I make a submission on behalf of a student?===
Please see [http://www.youtube.com/watch?v=U8b0evdNnTc the instructional video here] for a walkthrough on how to make a submission as an instructor on behalf of a student.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is also available here].

===How can I create a Turnitin Assignment via Moodle Direct?===
Please see [http://www.youtube.com/watch?v=ICYf9lC1f_I the instructional video here] for a walkthrough on how to make a Turnitin Assignment using Moodle Direct.

There is also an [[Turnitin's Moodle Direct Integration (Instructor Guide) | Instructor User Guide]] and a [http://www.turnitin.com/resources/documentation/turnitin/training/Moodle_Native_Integration_Instructor_Manual.pdf PDF is available here].

===The error "Base API URL is incorrect or unavailable" is occurring when attempting to connect to TII===
Check that that API URL entered in the plug-in configuration via "Modules" >> "Activities" >> "Turnitin Assignment" is correct. For UK users on the 'submit.ac.uk' service the API URL needs to be https://submit.ac.uk/api.asp however the rest of the world users (non-UK) on the turnitin.com service will need to enter https://www.turnitin.com/api.asp

===An error occurs (No HTTPS - the URL was not transmitted via HTTPS)===
This error occurs when you configure the API Url with the http instead of https for example:
* http://api.turnitin.com/api.asp << INCORRECT
* https://api.turnitin.com/api.asp << CORRECT

===An error occurs (Could not write data to file) every time the button 'add submission' is clicked===
The error 'Could not write data to file' only occurs when you try to do a copy and paste submission, it occurs because PHP could not create a text file for the submission; this is usually due to directory permissions on the server in the 'moodledata' directory. For a file upload you will likely receive a 'File Upload Error' this will occur for the same reason. To resolve this you will need to add the necessary permissions to allow the web server to create files in the 'moodledata' directory.

Instructions for setting the correct permissions depends on your environment and server set up:

*[[Creating Moodle site data directory]]
*[[Windows_installation_using_XAMPP#Moodledata_folder]]

The above links explain how to set up the 'moodledata' directory permissions for a couple of example systems. If you are still unsure about how to do this please check with either your hosting provider / server administrator for more detailed information on how to set the correct permissions on your particular server set up.

===Do we need a new plug in for Turnitin2?===
You will not need to upgrade your plug-in for your VLE once Turnitin 2.0 is launched. The changes are being made to the features such as the Originality Report and GradeMark. The integration connects TO these features from Moodle.

Users will be defaulted into the new 'Unified Interface' that Turnitin 2.0 will bring once launch, however each user will have the ability to revert back to the previous version of the Originality Report and GradeMark up to 12 months after launch.

===Further logs to diagnose issue/error===
In order to diagnose issues in more detail, turn diagnostic mode 'ON' from the plug-in configuration screen in Moodle (Logs are kept/produced when diagnostic mode is activated). To create logs for diagnostic purposes, reproduce the error then navigate to the logs on the server. The location should be '/moodledata/temp/turnitintool/logs/....' the comms and activity logs produced should be tagged with the date so you can identify which file the error would be shown in.

error/turnitintool/string

2010-09-13T09:49:40Z

Paul.dawson: Redirecting to Turnitin's Mooodle Direct Integration - Frequently Asked Questions

#REDIRECT [[Turnitin's Mooodle Direct Integration - Frequently Asked Questions]]

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-08-13T14:43:14Z

Paul.dawson:

== Enabling the Moodle Direct Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Direct Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T15:04:46Z

Paul.dawson: /* Configuring the Module within Moodle */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to enable GradeMark functionality by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T15:03:01Z

Paul.dawson: /* Installation and Configuration */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, you will need to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T15:01:12Z

Paul.dawson: /* Installation and Configuration */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to initiate outbound communications to the Turnitin API, to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T14:59:36Z

Paul.dawson: /* Downloading the Moodle Native Integration in Turnitin */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to do outbound communications to the Turnitin API, to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T14:59:17Z

Paul.dawson: /* Downloading the Moodle Native Integration in Turnitin */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

*Note: this integration is also available to download from [[http://www.moodle.org/modules Modules and Plugins]]

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to do outbound communications to the Turnitin API, to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T14:56:49Z

Paul.dawson: /* Downloading the Moodle Native Integration in Turnitin */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 above, then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to do outbound communications to the Turnitin API, to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration (Administrator Guide)

2010-06-20T14:55:21Z

Paul.dawson: /* Enabling the Moodle Native Integration in Turnitin */

== Enabling the Moodle Native Integration in Turnitin ==

In order to create the credentials neccessary to run the Turnitin Moodle Direct integration activity module the account administrator should log into their Turnitin account at either turnitin.com or submit.ac.uk depending on your account settings.

To configure the Moodle code package follow these steps:

# Log in as the Turnitin account administrator at the Turnitin homepage and enter your email address and password.
# Click on the integrations button for the account, if your account is authorised to use integrations their will be a link in the integration column beside your account settings that says either 'unconfigured' or 'configured'. Click this link.
# Scroll down the list of integrations available to 'Moodle Direct' and click the 'configure' link
# Fill out the required fields:
## A shared key containing 8 alphanumerical characters
## Your Moodle installation's IP address or default 255.255.255.255
## An error call back URL or the default as stated below the input field
# Click submit to finalise the configuration of Moodle

== Downloading the Moodle Native Integration in Turnitin ==

To download the latest version of the plug in from within your Turnitin account follow steps 1 and 2 then:

# Scroll to the bottom of the page and click 'Download'
# Scroll down the page to the table containing the Moodle Direct packages
# Click the 'download' link in the 'Code Package' column

== Installation and Configuration ==

The activity module follows standard Moodle installation guidlines, to install the code package unzip the code package and copy the directory 'turnitintool' to the 'mod' directory. A typical install would be in '/mod/turnitintool'.

More information on how to install an activity module can be found [[Installing contributed modules or plugins|here]].

The activity module requires cURL in order to do outbound communications to the Turnitin API, to enable cURL functionality in PHP. In most cases enabling cURL is done by uncommenting the following line in your php.ini file:

<pre>;extension=php_curl.dll</pre>

:: '''OR'''

<pre>;extension=php_curl.so</pre>

Remove the semi-colon at the start of the line to activate the library and restart your web server service to make the changes active.

More information about cURL and more detailed instructions for installing it can be found here: [http://uk3.php.net/curl http://uk3.php.net/curl]

== Recommended Moodle Settings ==

The activity module performs better when dbpersist is turned off, to do this in the config.php file for your Moodle install add the following line:

<code php>$CFG->dbpersist=false;</code>

== Configuring the Module within Moodle ==

Log in to Moodle as Administrator and navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Configure the plug in:

# Enter your Turnitin Account ID
# Enter your Turnitin Secret Key
# Enter the Turnitin API, for UK users enter https://submit.ac.uk/api.asp and for other users enter https://api.turnitin.com/api.asp
# Choose whether to use GradeMark by using the drop down menu. If your account has purchased WriteCycle or GradeMark select Yes.
# Select whether to use Anonymous Marking. Anonymous Marking is only available for TurnitinUK users.
# Enter a disclaimer/agreement in the text box. Student's will have to check a box agreeing to this statement before submitting a paper.
# To stop students being sent an email that enables them to log in to the Turnitin website select ''No''. The default is ''Yes''.
# Diagnostic mode prints extra diagnostic information in error messages and produces log files to track communication with the API. Do not select Yes for Enable Diagnostic Modle option unless asked to by Turnitin Support. The default is No.
# Click on the 'Save Changes button to save your changes.

== Testing your installation ==

To test your installation navigate to:
:: Site Administration -> Modules -> Activities -> Turnitin Assignment

Click the 'Run Connectivity Test' link, Moodle will attempt to connect to your Turnitin account based on the settings you enter in the configuration screen mentioned above. If Moodle successfully connects to Turnitin you will see a message that says, "Moodle has successfully connected to Turnitin". If the connection test fails you will receive a descriptive error message that may contain information as to the reason for the failure, in the event of connection failure check you configuration data and retry the test.

== Troubleshooting ==

The activity module has a number of mechanisms for tracking down problems:

# '''''Show Data Dump / Save Data Dump''''' is used to map out the database entries for the activity module, this information can be useful for checking Moodle to Turnitin data relationships and may be requested when reporting problems to Turnitin Support.
# '''''Unlink Users''''' is used to remove the tie between the Moodle user and the Turnitin user. The activity module maps the Moodle Internal User ID with the Turnitin User ID in rare cases it is neccessary to break that tie so the system can remake the tie on the next user communication. You should not use this feature unless specifically requested to do so by Turnitin Support.
# '''''Diagnostic Mode''''' can be enabled to help Turnitin Support to track down issues. When you enable this mode a communication log is produced in /moodledata/temp/turnitintool/logs this log may be requested by Turntin Support to help track down communication issues. Diagnostic mode also adds file and line number information to error messages to help the support team to track down scripting errors.

== Time Zones ==

The integration operates in the timezone of your Moodle server, in order for Turnitin to represent the same assignment start, due and post dates you must ensure that your Turnitin account is operating in the same time zone as your Moodle server.

== Paper Repository Options ==

The Turnitin administrator can select paper repository options to allow instructors to have access to paper repository options when setting up an assignment. To change these options:

# Log in to Turnitin as the administrator and click the edit icon to the right of the account you wish to edit.
# Select one of the three options
# Click on submit to save your changes

Turnitin's Moodle Direct Integration

2010-06-20T14:54:00Z

Paul.dawson:

==Introduction==
Turnitin's Moodle Direct integration activity module is a standalone Moodle module with the aim of representing the full suite of Turnitin's features within the standard Moodle workflow. The module was developed by nLearning Ltd with the full support and backing of iParadigms, the developers of Turnitin.
==Key Features==
*'''Multi Part Assignments'''
:Each Turnitin Assignment may consist of up to 5 parts, parts can be configured to have start dates, due dates and post dates independent of one another.
*'''Real Turnitin Users'''
:The integration maps Moodle users to real Turnitin user accounts for both Instructors and Students, there is the option to disable student emails should an institution not wish to have students log in to Turnitin rather than Moodle.
*'''GradeMark / Moodle Grade Book integration'''
:Grades are synchronised between Turnitin's GradeMark and the Moodle grade book
*'''Anonymous Marking (UK Only)'''
:Anonymous marking allows student names to be masked from instructors up until the post date
*'''Troubleshooting / Diagnostics'''
:Diagnostic mode allows administrators to identify bugs and communication issues by enabling API call logs and displaying line numbers within error messages
==Integration Video Walkthroughs==
*[http://www.youtube.com/watch?v=0GLaq9TflyA Turnitin Moodle Direct - Configure the Activity Module]
*[http://www.youtube.com/watch?v=ICYf9lC1f_I Turnitin Moodle Direct - Creating an Assignment]
*[http://www.youtube.com/watch?v=7j2RS4AOXz8 Turnitin Moodle Direct - Submitting Work as a Student]
*[http://www.youtube.com/watch?v=U8b0evdNnTc Turnitin Moodle Direct - Submission on behalf of a Student]
==Integration User Guides==
*[[Turnitin's Moodle Direct Integration (Administrator Guide)|Administrator User Guide]]
*[[Turnitin's Moodle Direct Integration (Instructor Guide)|Instructor User Guide]]
*[[Turnitin's Moodle Direct Integration (Student Guide)|Student User Guide]]

Turnitin

2010-05-19T16:26:10Z

Paul.dawson: /* Moodle Direct Plugin */

==Turnitin Plagiarism Prevention==
Turnitin is a commercial plagiarism detection system and there are currently 3 different options available to use within Moodle.
===Plagiarism Prevention Plugins(Moodle 2.0)===
A new [[Plagiarism Prevention]] plugin system is available in Moodle 2.0 written by [http://moodle.org/user/view.php?id=21591&course=5 Dan Marsden] from [http://www.catalyst.net.nz Catalyst IT] which allows existing Modules to "call" the plagiarism service. It has been added to the upload and uploadsingle assignment types, but eventually support will be added to other areas. This is a generic plugin system and other Plagiarism products will be added in future. An older more limited version of this plugin for Moodle 1.9 is available here: http://moodle.org/mod/data/view.php?d=13&rid=1562

===Moodle Direct Plugin===
The [[Turnitin's Moodle Direct Integration|Moodle Direct Integration]] has been developed by [[http://www.nlearning.co.uk nlearning Ltd]] (Turnitin UK and European Reseller) - This module is similar to the advanced assignment type in Moodle, however it adds a range of Turnitin specific functionality. It is packaged as a stand alone activity module and supports Moodle 1.8 and 1.9 currently but development is under way to make it available for Moodle 2.0. The current version is available as a module from [[http://www.moodle.org/modules Modules and Plugins]]. The key aim of the development is to represent all features of Turnitin within the Moodle workflow as and when they become exposed through the Turnitin API.

The integration works on the principle of mapping a Turnitin Assignment in Moodle with an assignment in Turnitin, once mapped all submissions made on either side are synchronised reflecting any changes on both platforms. It is therefore possible to access the assignments created using the plugin by logging in to either system. There is the option to disable emails sent out to students which means login details and welcome emails are not sent which encourages students to submit only through Moodle. GradeMark grades are represented in the Moodle gradebook and originality scores are displayed in the Moodle Turnitin Assignment Inbox.

For more detail see: http://moodle.org/mod/forum/discuss.php?d=149575

===Moodle Basic Plugin===
The original Assignment type developed by Iparadigms (Turnitin Development team) which is very basic and provides SSO into Turnitin, keeping the Moodle sites header, and opening their site in a frame underneath. - this means that all assignments are stored in the Turnitin system, if you canceled your Turnitin subscription, there is no way in Moodle to retrieve the files submitted.

mod/turnitintool/view

2010-05-19T15:18:17Z

Paul.dawson: Redirecting to Turnitin's Moodle Direct Integration

#REDIRECT [[Turnitin's Moodle Direct Integration]]