Integrazione Moodle · Guida all'installazione

Integrazione di PlagiarismSearch con Moodle: installazione e configurazione

Collega PlagiarismSearch a Moodle Assignments in modo che i file e i testi online possano essere inviati per il controllo antiplagio direttamente dal flusso di lavoro di Moodle.

Gli amministratori possono configurare il controllo automatico, le fonti di confronto Web e Storage, l'accesso ai report, le autorizzazioni degli studenti e il rilevamento IA opzionale dalle impostazioni del plugin PlagiarismSearch.

Compatibilità attuale: Moodle 2.7–5.2 · Moodle Assignment (mod_assign)

Hai bisogno di aiuto con l'implementazione istituzionale di Moodle? Contatta il nostro team.

Integrazione di Moodle in sintesi

Il plugin PlagiarismSearch funziona all'interno del flusso di lavoro di assegnazione Moodle e consente agli amministratori di controllare quando vengono verificati i lavori inviati, quali fonti di confronto vengono utilizzate, quale accesso ai report è disponibile e quali opzioni possono utilizzare gli studenti.

Versioni Moodle
2.7–5.2
Attività supportata
Moodle Assignment (mod_assign)
Tipi di invio
Invio di file e testo online
Controllo automatico
Disponibile per l'invio di file e testo online.
Controllo manuale
Disponibile per l’invio di file e testi online, in base alle autorizzazioni e alle impostazioni
Fonti di confronto
Web, Storage o Web + Storage
Rilevamento IA
Impostazione separata opzionale
Rapporti
PDF, HTML o entrambi
Credenziali API
API User + API Key dal tuo account PlagiarismSearch
In questa pagina 

Prima di installare il plugin Moodle

Prima di iniziare la configurazione, assicurati di avere accesso come amministratore al sito Moodle e di poter accedere alle credenziali API del tuo account PlagiarismSearch.

Moodle richiede inoltre che la prevenzione del plagio sia abilitata a livello di sito prima di poter utilizzare i plugin antiplagio. Nella documentazione attuale di Moodle, questa impostazione è disponibile in Site administration → Advanced features → Enable plagiarism plugins.

Accesso amministratore Moodle
È necessario abilitare la prevenzione del plagio, installare il plugin e configurare le impostazioni a livello di sito.
Versione di Moodle supportata
La tua installazione deve rientrare nell'intervallo Moodle attualmente supportato, ovvero tra la versione 2.7 e la 5.2.
Account PlagiarismSearch
Necessario per ottenere API User e API Key utilizzati dal plugin.
Flusso di lavoro dei compiti Moodle
Questa guida documenta l'attuale flusso di lavoro PlagiarismSearch per Moodle Assignment (mod_assign).

Come funziona l'integrazione di Moodle

PlagiarismSearch utilizza il flusso di lavoro del plugin antiplagio Moodle. Una volta installato e connesso il plugin, le impostazioni a livello di sito possono fornire il comportamento di controllo predefinito, mentre le impostazioni supportate possono essere configurate anche per i singoli compiti di Moodle.

  1. 1

    Attiva la prevenzione del plagio

    Attiva la funzione antiplagio del plugin Moodle a livello di sito.

  2. 2

    Installa PlagiarismSearch

    Scarica il plugin corrente e installalo tramite l’amministrazione di Moodle.

  3. 3

    Collega il tuo account

    Inserisci le credenziali API disponibili nel tuo account PlagiarismSearch.

  4. 4

    Imposta le tue impostazioni predefinite

    Scegli la modalità di verifica, le fonti di confronto, le opzioni del report, il rilevamento tramite IA e le autorizzazioni degli studenti.

  5. 5

    Abilitalo per un compito

    Configura PlagiarismSearch nel compito Moodle in cui devono essere verificate le consegne.

Quando le impostazioni a livello di compito non vengono salvate, il plugin utilizza automaticamente le impostazioni corrispondenti a livello di sito. Ciò consente agli amministratori di definire le impostazioni predefinite, pur permettendo la configurazione specifica per il compito laddove consentito.

  1. Compito Moodle
  2. Invio file / testo online
  3. Controllo PlagiarismSearch
  4. Somiglianza / risultato IA opzionale
  5. Collegamenti ai report e azioni consentite a studenti/insegnanti
Schema del flusso di lavoro, non una schermata di Moodle.

Installa il plugin PlagiarismSearch in Moodle

Utilizza il pacchetto di plugin corrente da Moodle Marketplace o dal repository ufficiale PlagiarismSearch GitHub. La dicitura del menu di Moodle può variare leggermente tra le diverse versioni, ma la procedura di installazione rimane la stessa.

  1. 1

    In Moodle, vai su Site administration → Advanced features e abilita i plugin antiplagio.

  2. 2

    Scarica il file ZIP del plugin PlagiarismSearch più recente da Moodle Marketplace o dalla pagina ufficiale delle release di GitHub.

  3. 3

    In Moodle, apri Site administration → Plugins → Install plugins.

  4. 4

    Carica il pacchetto ZIP PlagiarismSearch e segui le istruzioni di installazione di Moodle.

  5. 5

    Dopo l'installazione, apri le impostazioni del plugin PlagiarismSearch nell'amministrazione del sito Moodle.

  6. 6

    Attiva Enable PlagiarismSearch e inserisci i dettagli di connessione descritti nella sezione successiva.

  7. 7

    Salva le impostazioni e verifica che Moodle possa connettersi all'API di PlagiarismSearch.

Scarica da Moodle Marketplace Visualizza GitHub Releases

Collega Moodle al tuo account PlagiarismSearch

Accedi a PlagiarismSearch e apri la sezione API del tuo account. Lì troverai i tuoi API User e API Key.

Nelle impostazioni Moodle e PlagiarismSearch, inserire tali valori nei corrispondenti campi API user e API key. Il plugin corrente contiene anche un campo API URL per l'endpoint del servizio.

Salva le impostazioni dopo aver inserito le tue credenziali.

Apri le mie credenziali API

Moodle · impostazioni del plugin

Impostazioni PlagiarismSearch in Moodle: la casella di controllo Enable PlagiarismSearch, quindi i campi API url, API user e API key e l'opzione API debug. I valori di API user e API key sono mascherati.
Esempio di impostazioni PlagiarismSearch in Moodle: i campi di connessione. I valori delle credenziali sono mascherati.

Nota sulla sicurezza

Mantieni riservata la tua API Key. Non inserirla in screenshot, documentazione pubblica, ticket di supporto visibili a terzi o altri contenuti accessibili al pubblico.

Se PlagiarismSearch non riesce a convalidare la connessione durante l'attivazione del plugin, verificare i valori di connessione API e salvare nuovamente le impostazioni.

Configura le impostazioni di PlagiarismSearch

PlagiarismSearch separa le impostazioni di connessione dalle funzioni di verifica, confronto, reporting e controllo degli accessi degli studenti. I valori a livello di sito fungono da valori predefiniti per i compiti di Moodle, a meno che non sia stato salvato un valore specifico per il compito.

Gruppo 1 — Connessione

Enable PlagiarismSearch
Attiva il plugin PlagiarismSearch a livello di sito. L'integrazione deve essere abilitata anche per l'incarico in cui si desidera utilizzarla.
API url
Definisce l'endpoint API PlagiarismSearch utilizzato dal plugin.
API user
Il tuo valore PlagiarismSearch API user.
API key
Il tuo PlagiarismSearch API key.
API debug
Impostazioni avanzate di connessione/debug. Lasciare la configurazione predefinita a meno che il supporto di PlagiarismSearch non indichi di modificarla.

Gruppo 2 — Modalità di controllo

Auto check
Invia automaticamente i documenti di consegna degli elaborati Moodle supportati per la verifica dopo l'evento di consegna pertinente. Questo vale sia per i file di consegna degli elaborati che per i testi online.
Manual check
Consente il controllo manuale dei file di assegnazione Moodle supportati e degli invii di testo online quando l'utente dispone dell'autorizzazione necessaria. L'accesso degli studenti dipende anche dalle impostazioni dello studente riportate di seguito.

Scegli cosa confrontare e cosa conservare.

Sources e Add to Storage sono controlli separati. Uno decide dove viene confrontato un invio; l'altro decide se il nuovo invio viene aggiunto a PlagiarismSearch Storage.

Controllo 1 · dove viene confrontato

Sources

  • Doc vs Web + Storage
  • Doc vs Web
  • Doc vs Storage

Controllo 2 · se viene mantenuto

Add to Storage

Sì / No — impostare separatamente da Sources.

Doc vs Web + Storage
Confronta il contenuto inviato sia con le fonti Web sia con PlagiarismSearch Storage in base alla sua configurazione.
Doc vs Web
Confronta il contenuto inviato con le fonti Web senza utilizzare Storage come fonte di confronto.
Doc vs Storage
Confronta il contenuto inviato con Storage senza utilizzare fonti web per tale verifica.

Add to Storage

Add to Storage controlla se il contenuto inviato viene aggiunto a Storage per confronti futuri. La ricerca in Storage non implica di per sé che l'invio corrente verrà aggiunto a Storage. Allo stesso modo, l'aggiunta di un invio a Storage è separata dalla decisione se Storage verrà cercato durante il controllo corrente.

Moodle · impostazioni del plugin

Impostazioni PlagiarismSearch in Moodle: Auto check, Manual check, Add to Storage e Sources sono mostrati come controlli separati, seguiti dai filtri Only Latin characters, Exclude references, Exclude in-text citations e Exclude self-plagiarism.
Esempio di impostazioni PlagiarismSearch in Moodle: Sources e Add to Storage sono controlli separati, seguiti dai filtri di confronto. I valori mostrati rappresentano una configurazione di esempio.

Perfeziona il confronto

Only Latin characters
Applica il filtro di sostituzione dei caratteri del plugin durante la ricerca. Ha lo scopo di aiutare a identificare le sostituzioni di caratteri che possono influire sulla corrispondenza del testo.
Exclude references
Esclude dal calcolo della similarità il contenuto rilevato nella bibliografia quando il filtro è attivo.
Exclude in-text citations
Esclude dal calcolo della similarità il contenuto delle citazioni nel testo che soddisfa i criteri previsti, quando il filtro è attivo.
Exclude self-plagiarism
Modifica il modo in cui vengono filtrati i confronti Storage che coinvolgono lo stesso utente e/o corso. Questa impostazione è rilevante quando Storage viene utilizzato come fonte di confronto.

Opzioni di autoconfronto

  • No — non applicare un'esclusione per lo stesso utente/corso.
  • Exclude user plagiarism within the same course — filtra il contenuto corrispondente in Storage associato allo stesso utente nello stesso corso.
  • Exclude user plagiarism — filtra i contenuti corrispondenti in Storage associati allo stesso utente.
  • Exclude course plagiarism — filtra i contenuti corrispondenti in Storage associati allo stesso corso.

Rilevamento IA opzionale

Detect AI è un'impostazione separata dal rilevamento del plagio. Abilitala quando desideri che anche il controllo PlagiarismSearch richieda un risultato correlato all'IA.

Quando è disponibile un risultato relativo all’IA, Moodle può visualizzarlo separatamente dal risultato di plagio o similarità.

Il testo generato dall'intelligenza artificiale non è automaticamente plagio e i due segnali vanno interpretati separatamente.

Configura l'accesso ai report

Report language
Consente di selezionare la lingua da utilizzare quando viene richiesta una lingua di report supportata.
Report file type
Consente di controllare se Moodle non fornisce alcun collegamento al report, un report in formato PDF, un report in formato HTML o entrambi.
Allow teachers review reports
Abilita il collegamento aggiuntivo al report di revisione per il docente quando l’utente dispone dell’autorizzazione necessaria.

Opzioni di lingua del report correnti: Predefinita (inglese), inglese, spagnolo, ucraino, polacco e russo.

Configura PlagiarismSearch per un compito Moodle

Attività attualmente documentata

Questa guida descrive il flusso di lavoro PlagiarismSearch attualmente in uso per Moodle Assignment (mod_assign).

Crea un nuovo compito Moodle o modificane uno esistente. Nelle impostazioni del compito, individua la sezione PlagiarismSearch e abilita l’integrazione.

Le impostazioni di verifica e di reportistica supportate possono quindi utilizzare le impostazioni predefinite a livello di sito oppure essere salvate specificamente per quel compito. Ciò consente agli amministratori di stabilire una configurazione standard, pur supportando i requisiti a livello di compito laddove sia consentita la configurazione del corso.

Moodle · Impostazioni del compito

Il modulo delle impostazioni di un compito Moodle (Updating: Assignment), con la sezione PlagiarismSearch espansa ed Enable PlagiarismSearch impostato su Yes.
Dove cercare: la sezione PlagiarismSearch all'interno delle impostazioni del compito di Moodle. Viene mostrata solo come indicatore di posizione, non è l'elenco completo delle impostazioni correnti.

Nota sulla governance amministrativa

Se l'opzione Only administrators can configure course settings è abilitata a livello di sito, la configurazione di PlagiarismSearch a livello del compito viene limitata di conseguenza.

Modalità di controllo degli invii di file e testi online

È possibile utilizzare sia la verifica automatica che quella manuale per i file di assegnazione Moodle e per i testi inviati online. Le azioni manuali rimangono soggette alle autorizzazioni e alle impostazioni di verifica configurate.

Modalità di controlloInvio del fileTesto online
Auto checkSupportatoSupportato
Controllo manualeSupportato, in base alle autorizzazioni e alle impostazioni.Supportato, in base alle autorizzazioni e alle impostazioni.

Analisi degli URL per il testo online

Il plugin include anche un'opzione Allow URL parsing in text.

Quando l'analisi degli URL è abilitata, il plugin può utilizzare il parametro Valid URLs list for parsing configurato per definire quali URL sono consentiti per quel flusso di lavoro.

Limita l'elenco degli URL consentiti ai servizi e ai domini che la tua istituzione supporta intenzionalmente.

  • Allow URL parsing in textLivello del compito, ove disponibile
  • Valid URLs list for parsingA livello di sito, gestito dall'amministratore

Cosa succede dopo che uno studente ha consegnato un lavoro?

Se Auto check è abilitato, PlagiarismSearch si mette in ascolto degli eventi di invio dell'assegnazione Moodle supportati e invia il file o il testo online inviato per la verifica.

Quando Manual check è abilitato, i file idonei e i testi inviati online possono essere controllati anche manualmente, in base alle autorizzazioni configurate e alle impostazioni di accesso degli studenti.

Durante l'elaborazione di un report, Moodle può mostrare uno stato In progress e un collegamento Check status.

Al termine dell'elaborazione, Moodle può visualizzare la percentuale restituita e i collegamenti al report abilitati dalla configurazione. Se il rilevamento tramite IA era abilitato e ha restituito un risultato di IA, il valore dell'IA viene visualizzato separatamente.

Moodle · Valutazione dei compiti

Una riga di valutazione di un compito Moodle per l'invio di un file: il nome del file inviato, la percentuale restituita, un link Download .pdf report e un link Resubmit to PlagiarismSearch.
Esempio di visualizzazione dei risultati dell'assegnazione Moodle per l'invio di un file: il file, la percentuale restituita, il collegamento al report PDF e l’azione Resubmit. Non mostra il flusso di lavoro del testo online.

Nota interpretativa

Un risultato di similarità identifica contenuti corrispondenti che dovrebbero essere esaminati nel loro contesto. Non deve essere considerato come una determinazione automatica di plagio o di cattiva condotta accademica.

Controllare ciò che gli studenti possono vedere e fare

L'accesso degli studenti è configurabile. Gli amministratori possono stabilire se gli studenti possono visualizzare i link ai report, la percentuale di risultati, inviare manualmente le consegne dei compiti Moodle idonei o reinviarle dopo una revisione.

Allow students view reports
Selezionare se gli studenti riceveranno nessun link al report, un report in formato PDF, HTML o entrambi i formati supportati.
Allow students view plagiarism percentage
Controlla se gli studenti possono visualizzare la percentuale restituita in Moodle.
Allow students submit papers
Consente agli studenti di inviare manualmente le consegne dei compiti Moodle idonei quando Manual check è abilitato.
Allow students re-submit papers
Consente agli studenti di inviare manualmente nuovamente le consegne idonee del compito Moodle dopo un controllo precedente completato quando Manual check è abilitato.
The number of re-submits
Limita il numero di invii successivi consentiti agli studenti quando è configurato un limite.
Student disclosure
Definisce il testo informativo mostrato agli studenti quando il plugin è abilitato.

Importante: le autorizzazioni degli studenti non sovrascrivono la modalità di verifica generale. L'abilitazione dell'invio da parte degli studenti non crea un'azione di invio manuale a meno che non sia abilitata anche Manual check.

Moodle · impostazioni del plugin

Impostazioni PlagiarismSearch in Moodle: Report language, Report file type, Allow students view reports, Allow students view plagiarism percentage, Allow students submit papers, Allow students re-submit papers e The number of re-submits.
Esempio di impostazioni PlagiarismSearch in Moodle: controlli di accesso per report e studenti. I valori mostrati rappresentano una configurazione di esempio.

Risoluzione dei problemi di integrazione di Moodle

PlagiarismSearch non compare nel compito
Verifica consigliataConferma che i plugin antiplagio Moodle siano abilitati, che il plugin PlagiarismSearch sia installato e abilitato e che tu stia configurando un compito Moodle.
Impossibile abilitare il plugin
Verifica consigliataRicontrollare API URL, API User e API Key. Il plugin convalida la connessione API quando è abilitata.
L'invio o il reinvio manuale non è disponibile
Verifica consigliataConferma che Manual check sia abilitato, verifica le autorizzazioni/capacità dell'utente e rivedi le impostazioni di invio/reinvio dello studente applicabili per il compito.
Uno studente non può vedere il risultato
Controllo consigliatoControlla Allow students view reports e Allow students view plagiarism percentage.
Il risultato è ancora in fase di elaborazione
Controllo consigliatoUtilizzare Check status finché il report rimane In progress.
Il comportamento di Storage non è quello che ti aspettavi
Controllo consigliatoControlla entrambi Sources e Add to Storage. Controllano comportamenti diversi.

Domande frequenti sull'integrazione di Moodle

Sì. PlagiarismSearch fornisce un plugin antiplagio per il flusso di lavoro di assegnazione dei compiti di Moodle. L'intervallo di compatibilità attualmente confermato è compreso tra Moodle 2.7 e 5.2.

Questa guida descrive il flusso di lavoro PlagiarismSearch attualmente in uso per Moodle Assignment (mod_assign).

Sì. In Moodle Assignments è possibile controllare sia i file che i testi inviati online. Sono supportati sia il controllo automatico che quello manuale; le azioni manuali dipendono dalle autorizzazioni configurate e dalle impostazioni del plugin.

Accedi al tuo account PlagiarismSearch e apri la sezione API. Lì trovi API User e API Key utilizzati dal plugin Moodle.

Apri le credenziali API

Sì. Abilita Auto check nelle impostazioni di PlagiarismSearch. Per gli invii di compiti Moodle supportati, il plugin può inviare automaticamente nuovi file e testi online per la verifica.

Sì. L'impostazione Sources può utilizzare Web, Storage o Web + Storage. La ricerca in Storage è separata da Add to Storage, che controlla se un nuovo invio viene aggiunto a Storage per confronti futuri.

Il plugin dispone di un'opzione separata Detect AI. Quando è abilitata, è possibile richiedere e visualizzare separatamente un risultato relativo all'IA rispetto al risultato di plagio/somiglianza. Il rilevamento tramite IA e il rilevamento del plagio non sono la stessa analisi.

Il plugin attuale può fornire report in formato PDF, report in formato HTML, entrambi i formati oppure nessun link per il report, a seconda delle impostazioni selezionate. È inoltre possibile abilitare un link separato per la revisione da parte degli insegnanti.

Sì, se l'amministratore lo consente. L'accesso ai report degli studenti e la visibilità delle percentuali sono impostazioni separate, quindi gli istituti possono controllare cosa gli studenti possono vedere.

Sì, per gli invii di compiti Moodle idonei quando sono abilitate le opzioni Manual check e la possibilità per gli studenti di inviare nuovamente i compiti. Gli amministratori possono anche configurare un limite per gli invii successivi.

No. Il comportamento di Storage è configurabile. Add to Storage controlla se un documento inviato viene aggiunto a Storage, mentre Sources controlla se Storage viene cercato durante un controllo.