Aiuto:Accessori

Gli accessori di Wikipedia (gadget in inglese) sono vari strumenti di utilità che permettono di ampliare le funzionalità del software di Wikipedia, come personalizzarne l'interfaccia o agevolare la scrittura, la manutenzione e il controllo delle voci. Sono disponibili solo agli utenti registrati, che li possono abilitare selezionandoli nelle proprie preferenze/accessori. Sono scritti in JavaScript, con eventuale CSS, e la loro installazione iniziale può essere effettuata solo dagli amministratori dell'interfaccia, in quanto risiedono nel namespace MediaWiki.

La funzionalità degli accessori è fornita da una estensione di MediaWiki detta Extension:Gadgets, presente dalla versione 1.11 di Mediawiki del settembre 2007.

Il caricamento degli accessori è ottimizzato tramite il ResourceLoader e il localStorage, e la loro esecuzione limitata nel codice al namespace e alle condizioni opportune, tuttavia è consigliabile comunque abilitare solo gli accessori strettamente necessari, per non far eseguire al browser codice superfluo.

Principali accessori

Nel seguente elenco sono descritti i principali accessori disponibili sulla Wikipedia in lingua italiana, e sono presentati secondo la stessa suddivisione utilizzata in preferenze/accessori per una più facile ricerca:

• Tab superiori: per personalizzare i tab superiori (dove si trovano "Leggi", "Modifica", ...)
  • Purge: aggiunge il tab "purge" per aggiornare la cache di una pagina

• Link laterali: per aggiungere link a funzionalità di uso frequente nella barra laterale
  • Collegamenti personali: permette di creare link personalizzati
  • Requisiti di voto: per verificare i requisiti di voto di un utente
  • Edit count: per visualizzare il numero di modifiche effettuate su Wikipedia
• Patrolling: accessori utili per l'RC patrolling
  • LiveRC: controllo delle ultime modifiche in tempo reale direttamente su Wikipedia

• Aspetto e navigazione
  • HiddenCat: In presenza di categorie nascoste aggiunge un link in fondo alla pagina per controllarne la visibilità (accessorio abilitato di default).
  • Modalità scura: Abilita l'opzione di utilizzare un testo chiaro su un colore di sfondo scuro
  • Nascondi la colonna a sinistra: per nascondere la barra laterale
  • OpenStreetMap: Aggiunge il link "Mappa" a lato delle coordinate visualizzate in alto a destra nelle voci georeferenziate, per aprire la mappa di OpenStreetMap (accessorio abilitato di default).
  • ReferenceTooltips: al passaggio del mouse su una nota visualizza una finestra di popup con le informazioni sul riferimento, senza doversi spostare alla sezione "Note" (accessorio abilitato di default). (v. en:wp:Reference Tooltips)
  • WikiMiniAtlas: aggiunge un link con l'icona del mondo a sinistra di tutte le coordinate create con il template {{Coord}}, per aprire una mappa interattiva (accessorio abilitato di default). (v. meta:WikiMiniAtlas)

• Area di modifica
  • Colorazione della sintassi: Evidenzia la sintassi nell'area di modifica usando colori diversi
  • Completa template: nell'area di modifica completa la struttura di un template
  • ProveIt: facilita l'inserimento di citazioni con template.
  • Pulsanti della toolbar: aggiunge alla barra degli strumenti di modifica ulteriori pulsanti per l'inserimento di tag di formattazione e dei template più comuni.
  • Testo personale: casella combinata per l'inserimento di testo personalizzato.
  • WikEd: editor di testo che si sostituisce a quello di default

• Altro
  • CatWatch: per monitorare una lista di categorie
  • HotCat: per modificare le categorie direttamente dalla modalità di visualizzazione
  • Popup di navigazione: popup che appaiono sopra i link, fornendo un accesso facilitato a numerose funzioni
  • Rivelatore di disambigue: evidenzia i link che puntano a pagine di disambiguazione, ma non quelli che puntano ai loro redirect
  • Rivelatore di redirect: evidenzia automaticamente tutti i link che puntano a redirect

Accessori personali

È generalmente possibile, se si è utenti registrati, creare accessori di ogni genere solo per il proprio uso personale. Occorre modificare il file common.js della propria utenza (Speciale:MiaPagina/common.js) e inserirvi del codice Javascript per ciascun accessorio. In particolare si può inserire:

• Un richiamo a un accessorio già pronto, situato in una sottopagina di un altro utente di it.wiki, con il comando importScript('Nomepagina.js');
• Un richiamo a un accessorio già pronto in un'altra Wikipedia, o anche in altro sito esterno, con il comando mw.loader.load('//xxx.wikipedia.org/w/index.php?title=Nomepagina.js&action=raw&ctype=text/javascript');
• Direttamente il codice Javascript dell'accessorio, ad esempio una copia di un accessorio esistente personalizzata con delle modifiche. Di solito il codice principale va inserito dentro il comando addOnloadHook(function () { ..... }); affinché venga eseguito al caricamento di ogni pagina di Wikipedia.

Tenere presente anche l'avviso presente in cima alla pagina common.js sulla pulizia della cache.

Maggiori informazioni per ora sono disponibili in altre lingue, vedi en:Wikipedia:User scripts e altri. Puoi chiedere aiuto in Discussioni aiuto:Accessori.

L'uso di tool di editing automatico è riservato ai bot; per le regole di utilizzo si consiglia di leggere, nella pagina su AutoWikiBrowser, la sezione policy d'uso.

Risorse per gli sviluppatori

• (EN) Learning JavaScript
• (EN) Coding conventions Javascript
• (EN) Librerie Mediawiki e jQuery
• (EN) Javascript deprecations

Pagine correlate

• Aiuto:Preferenze/Accessori
• Speciale:GadgetUsage (statistiche sull'uso degli accessori)
• Speciale:Prefissi/MediaWiki:Gadget (pagine con codice sorgente e definizioni degli accessori, modificabili solo da amministratori)