Aiuto:Accessori/Discuti revisione blocco
Discuti revisione blocco è un accessorio che automatizza tutte le operazioni necessarie per avviare la discussione della richiesta di revisione di un blocco.
Utilizzo
[modifica | modifica wikitesto]![](http://upload.wikimedia.org/wikipedia/commons/thumb/1/18/Screenshot_inserimento_commento_nel_template_Revisione_blocco.png/220px-Screenshot_inserimento_commento_nel_template_Revisione_blocco.png)
![](http://upload.wikimedia.org/wikipedia/commons/thumb/1/1a/Screenshot_apertura_discussione_su_revisione_blocco.png/220px-Screenshot_apertura_discussione_su_revisione_blocco.png)
L'accessorio si carica quando si visita la pagina di discussione di un utente che ha aperto una richiesta di revisione del blocco. Una volta cliccato sul pulsante "Crea la pagina di discussione" del template:Revisione blocco che corrisponde alla richiesta aperta, l'utilizzatore visualizza un'area di testo dove può inserire un parere e confermare, dopodiché riceve riscontro delle operazioni in corso in una finestra di dialogo.
Le operazioni eseguite dall'accessorio sono le seguenti:
- crea la pagina di discussione
Wikipedia:Richieste di revisione del blocco/NOME-RICHIEDENTE/DATA
riportando sia il motivo della richiesta inserito dal richiedente sia il parere facoltativo inserito dall'utilizzatore dell'accessorio; - elenca la discussione nella pagina di riepilogo
Wikipedia:Richieste di revisione del blocco/NOME-RICHIEDENTE
(creando la pagina se non esiste già); - include la discussione nella pagina di servizio Wikipedia:Richieste di revisione del blocco;
- aggiorna il template:Revisione bozza nella pagina di discussione del richiedente compilando il parametro "link discussione".
Test
[modifica | modifica wikitesto]Gli amministratori possono testare l'accessorio seguendo le istruzioni riportate in questa sezione.
1) Copiare le seguenti righe di codice nella pagina Speciale:MiaPaginaUtente/common.js:
2) Inserire il template:Revisione blocco/Sandbox in una propria sandbox. Ad esempio, copiare le seguenti righe in Speciale:MiaPaginaUtente/Sandbox:
{{Revisione blocco/Sandbox |motivo = Test |esito = }}
3) Cliccare sul pulsante "Crea la pagina di discussione" che appare nel template:Revisione blocco/Sandbox.
Il funzionamento dell'accessorio è uguale, eccetto che le modifiche non sono salvate nelle pagine di servizio del namespace Wikipedia, bensì nelle sandbox dell'utenza con cui si fanno i test.
Documentazione tecnica
[modifica | modifica wikitesto]Componenti
[modifica | modifica wikitesto]- MediaWiki:Gadget-DiscutiRevisioneBlocco.js, il file js principale
- MediaWiki:Gadget-DiscutiRevisioneBlocco-Messages.json, il file json che contiene i messaggi di sistema
- MediaWiki:Gadget-ProgressDialog.js, la finestra di dialogo che mostra le operazioni in corso
- MediaWiki:Gadget-CommentWidget.js, il widget che ricalca il più fedelmente possibile il ReplyWidget dell'estensione DiscussionTools
- https://itwikiapi.toolforge.org/v1/revisions, il wrapper di mw:API:Revisions che elabora e restituisce anche l'elenco dettagliato dei template:Revisione blocco che sono inclusi nella talk visualizzata
- altre dipendenze elencate nei vari file js e in MediaWiki:Gadgets-definition
Configurazione
[modifica | modifica wikitesto]L'accessorio è definito in MediaWiki:Gadgets-definition (vedi impostazioni attuali). Si carica solo nelle pagine che sono incluse nella categoria:Richieste di revisione del blocco aperte. Il template:Revisione blocco inserisce automaticamente le pagine di discussione utente in questa categoria quando la richiesta di revisione del blocco deve essere ancora discussa/evasa. Una volta terminato il caricamento, l'accessorio si aggancia al pulsante "Crea la pagina di discussione" del template:Revisione blocco tramite un selettore CSS. La classe selezionata è pulsante-discuti-revisione-blocco
ed è definita nel sottotemplate Template:Revisione blocco/pulsante che genera il pulsante.
I messaggi dell'accessorio sono definiti nel file MediaWiki:Gadget-DiscutiRevisioneBlocco-Messages.json e possono essere modificati da tutti gli amministratori. Si raccomanda di lasciar modificare i nomi delle proprietà agli amministratori dell'interfaccia previa modifica anche del codice dell'accessorio. Alcuni nomi delle proprietà corrispondono ai codici degli errori di MediaWiki (es. articleexists
).
La formattazione e il contenuto delle pagine di discussione create dall'accessorio col titolo Wikipedia:Richieste di revisione del blocco/NOME-RICHIEDENTE/DATA
si possono manipolare in parte modificando Wikipedia:Richieste di revisione del blocco/ModelloDiscussione, ovvero il template che viene automaticamente compilato e substato quando l'utilizzatore conferma l'avvio delle operazioni.