Aiuto:Accessori
Gli accessori di Wikibooks (gadget in inglese) sono vari strumenti di utilità che permettono di ampliare le funzionalità del software di Wikibooks, 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
[modifica | modifica sorgente]Per approfondire, vedi Speciale:Accessori. |
Di alcuni accessori è disponibile una scheda introduttiva (per gli altri è indicato un link alla pagina corrispondente su Wikipedia):
Accessori personali
[modifica | modifica sorgente]È 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 Wikibooks, o anche in altro sito esterno, con il comando
mw.loader.load('//xxx.wikibooks.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 Wikibooks.
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:Wikibooks: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
[modifica | modifica sorgente]- (EN) Learning JavaScript
- (EN) Coding conventions Javascript
- (EN) Librerie Mediawiki e jQuery
- (EN) Javascript deprecations
Pagine correlate
[modifica | modifica sorgente]- 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)