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
  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

È 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

Pagine correlate

modifica