Extension:FlaggedRevs/it

Se cerchi un'estensione che permetta agli utenti di dare un voto alle pagine vedi Extension:Review e Extension:Rating.

         

Manuale sulle Estensioni MediaWiki
Lista delle Estensioni MediaWiki

Flagged Revisions Stato Release: stable
Implementazione	User interface, Special page, Database
Descrizione	Article validation allows for article content management by "editor" and "reviewer" classes.
Autore(i)	Aaron Schulz, Joerg Baach
Versione	1.09
MediaWiki	1.14+
Licenza	GPL
Download	Template:WikimediaDownload/it
Diritti aggiunti	review, autoreview, validate, stablesettings, patrolother, movestable

La validazione degli articoli permette agli utenti Editor (Editore) e Reviewer (Recensore) di valutare gli articoli e definire la versione che dev'essere visualizzata all'utente. Queste revisioni resteranno invariate anche se i template usati subiscono delle variazioni o le immagini vengono sovrascritte. Il testo dell'articolo, compresa ogni inclusione completamente espansa, viene memorizzato nella base dei dati. Questo permette a MediaWiki di funzionare un po' di più come un CMS (Content Management System).

Installazione

• Scarica l'immagine più recente ed estraine il contenuto nella cartella delle estensioni.
• Esegui la query FlaggedRevs.sql dopo aver sostituito la stringa /*$wgDBprefix*/ col prefisso della tua wiki. Per PostgreSQL, usa invece FlaggedRevs.pg.sql.
• Aggiorna a MediaWiki 1.13
• Esegui maintenance/update.php
• Esegui maintenance/archives/populateSha1.php.
• Esegui flaggedrevs/maintenance/updateAutoPromote.php.
• Accertati che '../extensions/FlaggedRevs' sia accessibile in lettura (da CSS/JS)

Aggiungi la riga seguente a LocalSettings.php:

include_once('extensions/FlaggedRevs/FlaggedRevs.php');

È importante che la colonna sha1 sia popolata. Questo permette l'inserimento attraverso immagine anziché attraverso la coppia chiave (name, timestamp). In futuro lo spostamento di immagini potrebbe venire supportata da MediaWiki, violando quest'ultimo metodo.

Accertati di impostare anche la variabile $wgReviewCodes. Dovrebbe essere una matrice di 2 elementi di tipo stringa. Qualunque testo va bene, ma probabilmente non dovrebbe essere molto corto (sarebbe meno sicuro) o troppo lungo (sarebbe uno spreco di risorse).

In principio nessun utente potrà vedere il simbolo del recensore. Per risolvere questa cosa, fai il login come sysop, vai a Special:Userrights, promuovi un utente a reviewer/editor, esci, e poi entra usando l'utenza così promossa. Vedrai il simbolo del recensore al fondo di una pagina editabile.

Configurazione

Innanzi tutto assicurati che esista una utenza di burocrate o steward (gli Stewards possono impostare qualunque diritto di utenza). I Burocrati, per default, possono promuovere gli utenti allo stato di Reviewer/Editor oppure rimuoverli. I Sysop possono fare lo stesso con lo status di Editor.

FlaggedRevs.php arriva con un certo numero di variabili configurabili. Per modificarle la procedura migliore è quella di copiarle in LocalSettings.php e modificarle lì:

Impostazioni di base

• $wgFlaggedRevsNamespaces - Imposta in quali namespace vuoi permettere la recensione. Questo parametro è una matrice di interi. Guarda all'inizio di includes/defines.php per vedere a quale intero è mappato il namespace di default.

• $wgFlaggedRevTags - Una matrice associative con le chiavi corrispondenti ad ogni tipo di flag ed i valori interi corrispondenti al rispettivo livello di qualità desiderato. Se ognuna di queste è soddisfatta la revisiona vale come "di qualità" ed ha la precedenza su altre versioni se pure rivedute. Per qualunque revisione ogni flag deve avere un valore almeno superiore al livello 0 ("non approvato").

• $wgFlaggedRevValues - Quanti livelli sono previsti per ogni flag.
  • Nota: Assicurati che questi sia maggiore dei valori in $wgFlaggedRevTags.

Per esempio, per la configurazione delle etichette, supponiamo che si vogliano avere "accuratezza", "profondità" e "tono", ognuna con tre livelli. L'amministratore vuole anche delle revisioni con almeno "accuratezza" e "profondità" di livello 2 per poter essere definite "di qualità". Le seguenti impostazioni danno il risultato voluto:

$wgFlaggedRevTags = array( 'accuratezza'=>2, 'profondità'=>2, 'tono'=>1 );
$wgFlaggedRevValues = 3;

Ogni etichetta corrisponde ad una pagina di namespace in MediaWiki. Per esempio, il primo livello dell'etichetta "accuratezza" corrisponde al testo in MediaWiki:revreview-accuracy-1. Ciò può conseguentemente essere personalizzato.

• $wgFlaggedRevsOverride - Definisce se le revisioni segnate (flaggate) vincono su quella di default o semplicemente viene segnalata l'etichetta verso la versione stabile.
  • Nota: $wgFlaggedRevsExceptions non ha effetto se questo è impostato a false.
• $wgFlaggedRevsExceptions - Fà in modo che gli utenti in questi gruppi vedano come default la revisione corrente.

• $wgFlaggedRevComments - Permette agli utenti Editor/Reviewer di aggiungere delle note al fondo della pagina.
• $wgFlagRestrictions - Una matrice di chiavi corrispondenti ad ogni flag che possiede valori per le matrici dei gruppi definendone il livello massimo di revisione.

Interfaccia utente

• $wgFlaggedRevTabs - Se usare o meno le linguette di revisione "stabile" e "corrente".
• $wgSimpleFlaggedRevsUI - Quando è abilitato viene usata un'interfaccia più semplice basata su icone. Non influenza le etichette mostrate in modalità di edizione.

Flusso del lavoro

• $wgReviewChangesAfterEdit - Se abilitato gli Editor salteranno alla pagina di differenze con l'ultima versione stabile dopo aver fatto delle modifiche, a meno che possa essere auto-rivisto oppure la pagina non abbia una revisione stabile.
• $wgFlaggedRevsAutoReview - Se abilitato ogni modifica effettuata da un utente Reviewer è automaticamente segnata come rivista al salvataggio. Non c'è necessità di premere il bottone "salva revisione". Questa caratteristica necessita che la precedente versione fosse pure già rivista, altrimenti l'auto-revisione è disabilitata.
  • L'auto revisione creerà una versione in cui accuratezza, profondità e tono sono impostati a 1. In generale dei valori così bassi guadagnano una designazione di "guardato". Rammenta che la "qualità" ha una precedenza superiore rispetto a "guardato". La presenza di una versione di "qualità" bloccherà la visualizzazione della versione "guardata". Se non vuoi venir bloccato da una versione di "qualità" puoi ridefinire il significato di "qualità". $wgFlaggedRevTags = array( 'accuratezza'=>1, 'profondità'=>1, 'stile'=>1 );
  • Nota: Le modifiche a template ed immagini sono auto-rivisti (per pagina). Questo può causare che cattive versioni siano marcate come riviste. Gli utenti dovrebbero essere incoraggiati ad usare il preview prima di salvare oppure il rivedi dopo il salvataggio. Potresti eventualmente voler impostare $wgNamespaceProtection[NS_IMAGE] e $wgNamespaceProtection[NS_TEMPLATE] come array('editor') oppure array('autoconfirmed');
• $wgFlaggedRevsAutoReviewNew - Definisce se rivedere automaticamente le nuove pagine scritte da un Editor al livello minimo di base.

Promozione automatica di un utente

• $wgFlaggedRevsAutopromote - Una matrice con chiavi per i giorni, edit, intervallo di tempo, valutazioni, email confermata, modifiche recenti di pagine, modifiche totali, pagine editate, sommari delle modifiche usati, unicità dell'indirizzo IP ed esistenza della pagina utente. I valori corrispondono alla quantità di giorni/modifiche necessari per un utente affiché sia auto-promosso allo stato di Editor e se deve avere una email confermata, se avere una pagina utente e così via. L'utente che deve avere almeno X modifiche che siano ad Y o più giorni di distanza, dove X è il numero di valutazioni (benchmark) ed Y lo spazio di tempo. Metti questa variabile completamente a false per disabilitare del tutto questa funzione.
  • Nota: Se un utente viene rimosso dallo stato di Editor non verrà poi automaticamente ripromosso (il registro delle revoche viene controllato prima di effettuare promozioni automatiche).
  • Nota: Alcuni di questi contatori non sono retroattivi quindi è possibile che ci siano ritardi nelle promozioni automatiche.

Per esempio, per $wgFlaggedRevsAutopromote possiamo avere:

$wgFlaggedRevsAutopromote['days'] = 60; # giorni dalla registrazione
$wgFlaggedRevsAutopromote['edits'] = 150; # totale delle modifiche
$wgFlaggedRevsAutopromote['excludeDeleted'] = true; # esclude le cancellazioni dalle modifiche di cui sopra?
$wgFlaggedRevsAutopromote['spacing'] = 3; # intervallo tra le modifiche
$wgFlaggedRevsAutopromote['benchmarks'] = 15; # quanti intervalli di tempo sono necessari?
$wgFlaggedRevsAutopromote['recentContentEdits'] = 10; # $wgContentNamespaces modifiche nei cambiamenti recenti
$wgFlaggedRevsAutopromote['totalContentEdits'] = 30; # modifiche $wgContentNamespaces
$wgFlaggedRevsAutopromote['uniqueContentPages'] = 10; # pagine uniche modificate in $wgContentNamespaces 
$wgFlaggedRevsAutopromote['editComments'] = 5; # quanti commenti usati?
$wgFlaggedRevsAutopromote['email'] = true; # deve avere l'email confermata?
$wgFlaggedRevsAutopromote['userpage'] = true; # deve avere la pagina utente?
$wgFlaggedRevsAutopromote['userpageBytes'] = 100; # se serve la pagina utente, di che dimensione minima?
$wgFlaggedRevsAutopromote['uniqueIPAddress'] = true; # Se $wgPutIPinRC è vero, se l'IP non è fisso non si può essere promossi
$wgFlaggedRevsAutopromote['noSorbsMatches'] = false; # se $wgSorbsUrl è impostato, non promuovere gli utenti corrospondenti

Impostazioni avanzate

• $wgFlaggedRevsWhitelist - schiera di indirizzi prefisssati che sono esenti dalla revisione (namespace e titolo, sottolineature al posto degli spazi).
• $wgUseStableTemplates - Analizzando una versione rivista, se un template ha una versione stabile, allora usa quella. In caso contrario usa quella specificata quando la versione è stata rivista.
  • Nota: Se abilitato la colonna fr_text non può più essere usata per migliorare le prestazioni, per quanto verrà egualmente popolata.
  • Nota: Possiamo avere dei template che non hanno versioni stabili. Data l'inclusione dei template basata sulla situazione temporale (come una funzione di analisi che seleziona il template X o Y) potrebbero mancare gli identificativi di versione per ogni template cui il testo puntava quando è stato rivisto. Un esempio può essere un testo che seleziona un template in base all'ora. Il template che verrà selezionato cambierà ed i matadati punteranno soltanto all'ID della versione rivista al momento dell'utilizzo del vecchio template. In tale caso possiamo selezionare la versione corrente (non rivista) se $wgUseCurrentTemplates è abilitato. Altrimenti ci sarà un collegamento blu al template.
• $wgUseStableImages - (Simile al precedente)
• $wgUseCurrentImages - (Simile al precedente)

• $wgCompressRevisions - Se il supporto zlib è presente, gzip la colonna fr_text. Questa colonna conserva il testo preprocessato (con i template espansi) della revisione segnata. Questa è una pratica consigliata.
• $wgFlaggedRevsExternalStore - Analogo a $wgDefaultExternalStore. Se impostato a false, flaggedrevs userà il proprio supporto di memorizzazione esterno per fr_text. In caso contrario utilizzerà $wgDefaultExternalStore. Se anche questo è impostato a false allora per fr_text verrà usato il DB locale.

Accesso al sito

• $wgFlaggedRevsVisible - Per siti che restringono la visualizzazione della wiki, questo parametro rende le pagine stabili visibili soltanto ad un certo gruppo di utenti. Questa variabile è una matrice di gruppi di utenti. Impostandola a array('*') permette a chiunque, registrato o meno, di visualizzare in contenuto della tua wiki. Per restringere la visualizzazione della tua wiki imposta $wgGroupPermissions['*']['read'] = false; e $wgGroupPermissions['*']['edit'] = false;.
  • Attenzione: Questo non funziona bene con img_auth.php, poiché i visitatori non registrati non saranno in grado di vedere le immagini.
  • Nota: È probabilmente inutile senza avere $wgFlaggedRevsOverride=true.
  • Nota: Accertati che $wgWhitelistRead sia correttamente settato. Dovrai avere almeno qualcosa come $wgWhitelistRead = array( 'Main Page', 'Special:Search' ). Dovresti anche volere visibili delle pagine di cartelle o categorie, altrimenti la wiki sarà difficile da navigare per i visitatori.
  • Nota: Usa $wgFlaggedRevsTalkVisible per permettere la visualizzazione di tutte le pagine di discussione da parte di questi utenti.
  • Nota: Probabilmente dovrai editare MediaWiki:loginreqpagetext per renderla più dettagliata.

Utilizzo

Approvazione delle pagine

Gli utenti con qualche livello di recensore avranno un piccolo modulo di revisione sulla visualizzazione delle pagine e nelle differenze, così da permettere loro di di recensire le revisioni. Ogni etichetta deve almeno raggiungere il livello minimo di approvazione. Gli utenti dovrebbero guardare l'intera pagina, compresi template ed immagini, prima di recensire. Il link (diff a stabile) è molto utile per accellerare il processo.

Un utente non può recensire una pagina sulla quale non ha diritto di modifica; non può abbassare il livello di una revisione da un livello che non può impostare. Un utente bloccato non può far nulla.

All'indirizzo Special:Stableversions puoi elencare tutte le revisioni recensite per una certa pagina oppure visualizzare tutte le revisioni recensite.

Manutenzione

All'indirizzo Special:Unreviewedpages trovi la lista delle pagine che non sono state recensite, elenco disponibile per i soli Editor. Dev'essere selezionato un namespace ed è anche presente la possibilità di filtro per categoria.

All'indirizzo Special:OldReviewedpages si trova la lista delle pagine che sono state recensite ma che hanno modifiche in attesa di conferma. elenco disponibile per i soli Editor. È possibile filtrare per categoria.

Le pagine che non possono essere recensite possono comunque essere vigilate (patrolling) per fini anti-vandalistici dagli Editor per vedere cosa è già stato controllato.

Una lista delle pagine recensite al livello principale si trova all'indirizzo Special:Reviewedpages.

Registrazione delle attività

Tutte le azioni rilevanti sono registrate permanentemente di modo che tutto possa essere tracciato e supervisionato in maniera appropriata.

• Un log delle promozioni/degradazioni degli editori e dei motivi è all'indirizzo Special:Log/userrights.
• Un log delle approvazioni/rifiuti delle revisioni si trova all'indirizzo Special:Log/review.
• Un log delle modifiche alla gestione delle versioni stabili delle pagine si trova all'indirizzo Special:Log/stable.

Inoltre una nuova pagina, Special:QualityOversight, mostra le registrazioni relative alla registrazione della qualità delle pagine. Questo è utile se il log principale è troppo pieno di versioni "viste".

Note

• $wgUseRCPatrol è abilitato con questa estensione. Le revisioni segnate (flagged) sono marcate come controllate. Il Patrolling e l'AutoPatrolling sono disabilitati di pagine all'interno di namespace gestiti con la recensione. Gli altri namespace possono essere soggette a patrolling dagli Editor. Questo significa che il solo mezzo per controllare una revisione recensibile è quella di marcarla come approvata. Il vantaggio è che le modifiche controllate saranno sempre in relazione con una revisione recensita.

• I Sysop possono definire se è la recensione di qualità ad avere la precedenza o se piuttosto la versione stabile è visualizzata come default per pagine specifiche. Per disabilitare questa funzione aggiungi

$wgGroupPermissions['sysop']['stablesettings'] = false; a localsettings.php.

• È supportata la memorizzazione esterna dei testi. Se hai già un supporto esterno di memorizzazione lo stesso viene utilizzato per fr_text.
• I Collegamenti di pagina, le categorie, le immagini, i template, i linguaggi ed i collegamenti esterni diverranno l'UNIONE della versione corrente e di quella stabile.
• Gli utenti non possono spostare pagine che non possono recensire.
• Gli utenti Autoconfermati hanno le loro modifiche a pagine non recensibili marcate come autocontrollate per default. Per disabilitare questa funzione usa $wgGroupPermissions['autoconfirmed']['autopatrolother'] = false;

• Puoi degradare un Editor sia temporaneamente bloccandolo oppure permanentemente via Special:Userrights. Un log aggiuntivo per le degradazioni apparirà per permettere di tracciare l'evento.

Limitazioni

• Le transclusioni tra i wiki non sono stabili
• Le immagini da fonti esterne (a parte Commons) non sono stabili
• I Metatemplate che includono condizionalmente altri template possono avere una condizione valutata differentemente tra il momento in cui il recensore ha caricato la pagina e quando la recensisce. Ne consegue che non ci sarà alcun ID di revisione da caricare per quel template, rendendolo così un collegamento blu. Se ciò accadesse ne riceveresti notizia dirante le operazioni di recensione.
• Usare una funzione di analisi per definire quale template includere (per esempio un template per ogni giorno della settimana) non funzionerà per le revisioni stabili. La revisione verrà mostrata così come era al momento della recensione.
• Usare una pagina globale multi-wiki per degradare un Editor non è sufficiente se se l'auto-promozione è abilitata poiché verrebbe semplicemente promosso di nuovo!

Disinstallazione

• Rimuovi la lina di inclusione da LocalSettings.php
• Elimina le tabelle elencate in FlaggedRevs.sql.
• Elimina le colonne 'page_ext_reviewed', 'page_ext_quality', e 'page_ext_stable', e l'indice 'ext_namespace_reviewed' dalla tabella della pagina (se esistono, solo le versioni più vecchie le usano)
• Esegui maintenance/refreshLinks.php dalla linea di comando per ripulire i collegamenti della versione stabile.

Piattaforme di prova

• English
• Deutsch

Richieste di personalizzazioni a progetti Wikimedia

Le seguenti sono alcune delle prime wiki Wikimedia che hanno richiesto implementazioni personalizzate di questa funzionalità. Queste richieste contengono le risposte alle varie opzioni disponibili nell'estensione (oppure collegamenti a questi) di modo che queste richieste dettagliate possano servire da modello a future richieste:

• bugzilla:14254 (pt.wikinews)
• bugzilla:14618 (en.wikibooks)
• bugzilla:14648 (he.wikisource)

External links

• Stable Articles and Wiki Spam Blog.Wikible.org

Licenza

© GPL, Aaron Schulz, Joerg Baach, 2007