|
La toolbar è una barra che appare al di sopra della casella di modifica. I suoi pulsanti possono fare qualunque cosa grazie a Javascript.
== AggiungereAttivare pulsantila toolbar ==
Per attivare la toolbar è necessario aver installato l'estensione [https://www.mediawiki.org/wiki/Extension:WikiEditor/it WikiEditor] nel proprio spazio web (di default è presente nel pacchetto di installazione)
Si può utilizzare qualunque icona che sia stata caricata sul wiki. Ad esempio, si possono importare le icone [[commons:Mediawiki_edit_toolbar|presenti su Wikimedia Commons]], le quali sono distribuite con licenza libera e pertanto possono essere caricate sul proprio wiki e modificate liberamente.
Se avete attivato l'estensione nell'installazione di mediawiki dovrete solo configurarla, se invece non l'avete attivata dovrete aggiungere questa riga nel vostro LocalSettings.php <code> wfLoadExtension( 'WikiEditor' ); </code> ('''NOTA''' Azione non necessaria se avete già attivato WikiEditor nel setup di MediaWiki)
{{...}}
=== Configurazione ==
Dovrete aggiungere nel file LocalSettings.php queste righe;
<code> # Enables use of WikiEditor by default but still allows users to disable it in preferences
$wgDefaultUserOptions['usebetatoolbar'] = 1;
# Enables link and table wizards by default but still allows users to disable them in preferences
== I pulsanti dell'utente MarkS ==
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1; </code>
L'utente della Wikipedia in lingua inglese [[w:en:User:MarkS|MarkS]] ha creato alcuni pulsanti che inseriscono i tag wiki più comuni e permettono quindi di scrivere sul wiki più comodamente. Il link di riferimento è [http://en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons http://en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons], in cui sono presenti le istruzioni per l'installare e per modificare l'ordine e il numero dei pulsanti.
Una volta fatto, pulite la cache del vostro browser e controllate se il procedimento è andato a buon fine.
Per attivarli:
*abilitare gli utenti all'uso di Javascript, inserendo nel file <tt>LocalSettings.php</tt> questa stringa:
<code>$wgAllowUserJS = true;</code>
*copiare questo file nella pagina <code>MediaWiki:extraeditbuttons.js</code>:
*:http://en.wikipedia.org/wiki/User:MarkS/extraeditbuttons.js
*Aggiungere al <code>MediaWiki:Monobook.js</code> questa riga:
<source lang="Javascript">
importScript("User:MarkS/extraeditbuttons.js");
</source>
Dopo aver pulito la cache del browser, i pulsanti diventeranno visibili.
=== Modificarne la disposizione o la grafica ===
Il trucco è aggiungere queste tre righe:
<source lang=javascript>
XEBOrder='A,B,C,D,F,TS,TC,TR,TE,AI,Z,I1,I2,K,L,M,H,O,R,T,V,FS,N,R1,R2,R3,R4,GEO';
rmEditButtons=[];
myButtons=[];
</source>
all'inizio del codice di <code>MediaWiki:Monobook.js</code>. Quelle lettere nella XEBOrder, sono i corrispondenti dei pulsantini che vogliamo attivare, in base alla tabella che troviamo in questa pagina:
* http://en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons
Modificando "XEBOrder" possiamo quindi aggiungere, togliere e spostare i pulsanti, a nostro completo piacimento. La linea <code>"rmEditButtons=[]"</code> è invece l'elenco dei pulsantini standard della wikipedia, che si vogliono togliere. Dentro possiamo scriverci <code>'all'</code> (così, con gli apicetti), oppure i numeri o le lettere dei pulsanti, sempre secondo la stessa tabella di prima.
Infine, <code>"myButtons"</code> ci permette invece di definire dei nuovi pulsanti, secondo la sintassi descritta sempre in quella pagina, verso il fondo.
===Aggiunta di nuovi pulsanti===
Per creare nuovi pulsanti, va aggiunto questo codice all'extraeditbuttons.js:
<source lang="Javascript">
myButtons={
'Nome' : [ 'URL', 'Tooltip1', 'Testo incollato prima', 'Testo incollato dopo', 'Testo incollato in mezzo' ],
};
</source>
<!-- Nota: la virgola alla fine si può lasciare, è ECMAScript 5 valido (invalido in ECMAScript 3) -->
* Nome: nome del nuovo pulsante (una o due lettere in maiuscolo, che non siano già date ai pulsanti standard);
* URL: link dell'immagine del nuovo pulsante (vedi esempio);
* Tooltip: un breve messaggio che appare al passaggio del mouse sopra il pulsante;
* Testo incollato prima: al clic, il pulsante incolla questo testo subito prima del cursore nella casella di modifica;
* Testo incollato dopo: al clic, il pulsante incolla questo testo subito dopo il cursore nella casella di modifica;
* Testo incollato in mezzo: testo che vi apparirà in mezzo, una volta schiacciato il bottone.
Quindi vanno aggiunti i due nomi alla riga <code>XEBOrder=</code>
Ad esempio:
<source lang="Javascript">
myButtons={
'ZA' : [ 'http://upload.wikimedia.org/wikipedia/commons/9/99/Button_reflink_advanced_2.png', 'Nota', '<ref>', 'Testo della nota', '</ref>' ],
'R4C' : [ 'http://upload.wikimedia.org/wikipedia/commons/9/9a/Button_references.png', 'Note', '\n==Note==\n', '<references/>\n', '' ],
};
XEBOrder='A,B,C,D,F,TS,TC,TR,TE,AI,Z,I1,I2,K,L,M,H,O,R,T,V,FS,N,R1,R2,R3,R4,GEO, ZA, R4C';
</source>
Come visto nell'esempio dato sopra, il ritorno a capo si scrive con questa formattazione:
<code>\n</code>
che è ben diversa dal <code><nowiki><br /></nowiki></code> usato nelle pagine (questi, infatti, funziona solo nelle pagine, non nei tag dei pulsanti).
===Link===
Per ulteriori esempi di pulsanti extra, fare riferimento ai link:
* http://en.wikipedia.org/wiki/User:Willscrlt/Voting_buttons
* http://commons.wikimedia.org/wiki/Category:MediaWiki_edit_toolbar
=== Caricare le icone sul wiki ===
Si modifica, nel codice dell'utente MarkS, la linea: <code>var Isrc='//upload.wikimedia.org/wikipedia/commons/';</code> sostituendo il percorso interno con quello della cartella 'images' del wiki, cioè quella dove le immagini sono state caricate.
== Collegamenti esterni ==
| 