MediaWiki/Estensioni

Download e installazione

Le estensioni sono parti di software che si installano separatamente su MediaWiki, opzionalmente, per aggiungere al wiki funzionalità extra che MediaWiki non ha. Esistono molte estensioni diverse, ognuna delle quali assolve a un compito specifico ben preciso.

In genere, per aggiungere un'estensione al wiki si seguono questi passaggi:

1. si scaricano la cartella e/o il file .php che costituiscono l'estensione;
2. si incollano nella cartella di MediaWiki (se da remoto, si copia tramite FTP nell'omonima cartella sul server);
3. si attiva l'estensione modificando a mano il file LocalSettings.php, inserendo una riga in fondo, seguendo le istruzioni riportate alla pagina "Manuale MediaWiki/LocalSettings.php".

Tuttavia, alcune estensioni potrebbero fornire istruzioni diverse, indicate nelle rispettive pagine di riferimento.

Informazioni e download

La maggior parte delle estensioni presentate di seguito hanno una pagina di riferimento sul sito ufficiale di MediaWiki. In alto a destra, nella pagina, c'è un box che riporta le informazioni principali dell'estensione: tra queste, il release status e link per il download.

Il release status indica lo stato dello sviluppo dell'estensione, ed ha un nome ed un colore specifici:

stable	Il codice è stabile
beta	Il codice è stabile, ma non è stato completamente testato
experimental	Il codice sta attraversando ancora le prime fasi dello sviluppo, pertanto potrebbe essere soggetto a modifiche radicali
unstable	Non funzionante: l'estensione non va usata.
unknown	Non indicato (uno dei precedenti)

Le estensioni il cui stato non è stable potrebbero dare problemi durante l'utilizzo.

Le informazioni per il download e la configurazione sono presenti nel testo della pagina e/o nel box in alto a destra, dove sono riportati anche i link per scaricare i file dell'estensione (dal sito di MediaWiki e/o da siti di terze parti). Se queste informazioni mancano, si può fare riferimento alle seguenti alternative, se applicabili:

• consultare l'indirizzo http://www.mediawiki.org/wiki/Special:ExtensionDistributor
• cercare l'estensione fra quelle elencate all'indirizzo http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/

In alcuni casi, la pagina dell'estensione, invece di fornire il link del download, presenta direttamente il contenuto dei file dell'estensione (il codice PHP). Dove possibile, è preferibile invece affidarsi ai link per scaricare i file dell'estensione, in quanto il codice presente nella pagina non è soggetto al controllo degli sviluppatori di MediaWiki, e quindi potrebbe risultare risultare non aggiornato, presentare malfunzionamenti o esporre il wiki a vulnerabilità, ed è esposto ad eventuali modifiche malevole di terze parti non coinvolte nello sviluppo dell'estensione.

Estensioni ospitate sul sito ufficiale

Per le Categorie

1. CategoryTree Ramifica le categorie
2. ManageCategories Visualizza un menu a tendina per le categorie
3. ArticleToCategory2 Questa è incompatibile con l'altra (simile) di "articletocategory". Attivate o una, o l'altra: non tutt'e due assieme.^{[senza fonte]} Hanno funzioni simili: entrambe permettono di creare articoli direttamente dalle pagine delle categorie. Questa aggiunge un box in più per le categorie; l'altra non ha tale box.

Per abilitare certi comandi essenziali

Queste prime due sono simili (si può tranquillamente omettere la seconda) e servono per poter far visualizzare e formattare i Template.

1. ParserFunctions[1]
2. StringFunctions
   • P.S: Parser Function va settato bene perché funzioni al meglio.
3. ExpandTemplates
4. ConditionalTemplate
5. Description aggiunge una descrizione meta-tag alle pagine del namespace MediaWiki (pagine contenenti messaggi di sistema usati dal software wiki)
6. Cite Per la formattazione delle note a pie' di pagina.
7. CharInsert Serve per creare l'Edittools.
8. InputBox Serve per creare box di ricerca.
9. CreateBox Versione alternativa di Input Box, specifica per aiutare a creare gli articoli, piuttosto che cercarli.
10. Mimetex alternative Visualizza i simboli matematici e le immagini generate nei PDF, senza nessun settaggio extra. Per i simboli matematici bisogna usare nelle pagine il nuovo tag generato: <tex>, al posto di <match>. Per maggiori informazioni, consultare il manuale della variabile.

Per visualizzare video e altri tipi di file multimediali

1. MultiUpload Permette l'upload di più immagini o file multimediali sul wiki, contemporaneamente.
   • $wgMaxUploadFiles = 20; //Specificare qui il numero. Di default, sono cinque.
2. OggHandler Permette la visualizzazione di piccoli filmati .ogg con Java.

Per PDF, PdfBook e altri tipi di documenti

• Collection Genera PDF di pagine singole o di intere raccolte di voci. Richiede impostazioni aggiuntive per poter stampare anche le immagini che sono nelle voci.

• GoogleDocs Visualizza i fogli di lavoro di Google Docs.

Per la cancellazione e lo spam

L'estensione Confirm Edit e il Captcha, sia esso il Visual o il Classico, vanno settate assieme prima di attivarle, altrimenti non funzionano.^{[senza fonte]}

1. ConfirmEdit
2. VisualMathCaptcha
   • Prima di attivarlo, richiede che sia modificato il file ConfermEdit.php dell'omonima cartella (sotto "Extensions"), in cui il Simple Captcha di default va sostituito con il Visual Captcha. ( Al posto di: $wgCaptchaClass = 'SimpleCaptcha' mettete: $wgCaptchaClass = 'VisualMathConfirmCaptcha' )

Cancellazioni, monitoraggio e blocchi utenti

1. Renameuser Permette di rinominare gli Utenti.
   • $wgGroupPermissions['sysop']['renameuser'] = true; //Si può qui specificare chi può avere questo privilegio.
2. Password Reset per poter cambiare la password degli Utenti.
   • $wgGroupPermissions['sysop']['passwordreset'] = true; //idem come sopra, ma per poter cambiare la password degli Utenti.
3. Maintenance Abilita certe altre funzioni extra per il mantenimento del wiki.
   • $wgGroupPermissions['bureaucrat']['maintenance'] = true; //Di default, solo i burocrati possono accedere a questa prima estensione. Cambiare da 'burocrate' a un gruppo diverso per consentire ad un gruppo diverso di accedere
4. UserRightsList Permette di visualizzare la lista di tutti gli utenti registrati e di cambiare i loro privilegi.
5. UserLoginLog Consente di vedere l'IP di un utente loggato (nella pagina "Special:Log"). (Simile a CheckUser, ma funzionante fin da subito, senza settaggi)
6. UserMerge Permette di cancellare gli utenti senza pericoli per il database, tramite l'unione l'un con l'altro.
7. EditUser Permette agli utenti con i privilegi necessari di modificare e visualizzare le preferenze personali degli altri utenti.
   • $wgGroupPermissions['bureaucrat']['edituser'] = true; //Utenti che possono visualizzare le preferenze degli altri utenti.
   • $wgGroupPermissions['sysop']['edituser-exempt'] = true; //Utenti le cui preferenze non possono essere visualizzate con questa estensione.

Blocchi sulle pagine, filtri di parole

1. AuthorProtect Permette agli utenti registrati di proteggere le pagine che creano dalle modifiche degli altri utenti. Solo gli amministratori potranno modificarle.
   • Se viene disattivata, le pagine protette dagli utenti non passano automaticamente sotto quelle protette dagli amministratori. Tuttavia, al riattivarla, si ripristineranno i vecchi permessi dati dagli utenti.
2. ProtectSection Permette agli amministratori di proteggere le pagine parzialmente (solo alcune sezioni).
3. SpamRegex Permette di creare filtri di parole che sono applicati in automatico al momento della creazione di nuovi contenuti nelle voci.

Cancellazione di pagine

1. Nuke Consente agli amministratori di cancellare in massa tutte le pagine create da un utente anonimo o registrato.
2. DeletePagePermanently Permette la cancellazione permanente delle pagine, abilitata tramite una linguetta apposita.
   • il codice seguente permette di scegliere i namespace ai quali applicare la linguetta, e, in fondo, il gruppo di utenti che potranno usarla:
     • $wgDeletePagePermanentlyNamespaces = array( Mettere false su quelli che non si vuole applicare
     • NS_MAIN => true, Voci
     • NS_IMAGE => true, Immagini (File)
     • NS_IMAGE_TALK => true, Discussioni delle Immagini
     • NS_CATEGORY => true, Categorie
     • NS_CATEGORY_TALK => true, Discussioni delle Categorie
     • NS_MEDIAWIKI => false, Pagine MediaWiki (di servizio)
     • NS_MEDIAWIKI_TALK => true, Discussioni delle Pagine MediaWiki
     • NS_HELP => true, Aiuto
     • NS_HELP_TALK => true, Discussioni delle Pagine di Aiuto
     • NS_PROJECT => true, Progetti
     • NS_PROJECT_TALK => true, Discussioni delle Pagine dei Progetti
     • NS_TEMPLATE => true, Template
     • NS_TEMPLATE_TALK => true, Discussioni delle Pagine dei Template
     • NS_WIDGET => false, Wigget
     • NS_WIDGET_TALK => true, Discussioni delle Pagine dei Wigget
     • NS_USER => true, Pagine Utenti
     • NS_USER_TALK => true, Discussioni delle Pagine degli Utenti
     • NS_TALK => true, Discussioni delle Voci
     • );
     • $wgGroupPermissions['*'] ['deleteperm'] = false; Anonimi
     • $wgGroupPermissions['user'] ['deleteperm'] = false; Loggati
     • $wgGroupPermissions['bureaucrat']['deleteperm'] = true; Burocrati
     • $wgGroupPermissions['sysop'] ['deleteperm'] = false; Amministratori
3. SpecialDeleteOldRevisions2 Permette la cancellazione solo delle vecchie revisioni delle voci.
   • $wgGroupPermissions['sysop']['DeleteOldRevisions'] = true; gruppo autorizzato.

Per gli interlink

1. Interwiki Serve per le tabelle, anche se si decide di non utilizzare gli interlink.

Categorie

1. CategoryWatch Permette agli utenti loggati di mettere sotto "osservazione" anche le pagine delle categorie, oltre a quelle degli articoli.
2. GoToCategory Permette di includere nel motore di ricerca anche le categorie. Si verrà così reindirizzati all'omonima categoria, quando questa è digitata; altrimenti alla voce, se esiste.
3. MultiCategorySearch Crea una nuova pagina speciale per la ricerca di voci in più categorie.
4. RandomInCategory Crea una pagina speciale che sceglie una pagina a caso all'interno di una determinata categoria.
5. Add Article to Category Questa, è incompatibile con l'altra (simile) di "ArticleToCategory2". Attivate o una, o l'altra: non tutt'e due assieme.^{[senza fonte]} Hanno funzioni simili: entrambe permettono di creare articoli direttamente dalle pagine delle categorie.
   • $wgWarnNoCategoriesOnNamespace[NS_MAIN] = true; qui si può specificare per quali namespaces deve funzionare.

Per abilitare certi comandi utili, ma non essenziali

1. Contributors Visulizza una nuova voce, sulla barra laterale sinistra, per visualizzare gli utenti che hanno modificato un certo articolo.
2. NewestPages Crea una pagina speciale che fornisce accesso all'elenco delle pagine create recentemente, in base al namespace o all'utente.
3. Poem Serve per formattare testi poetici, ma può servire anche per i codici sorgenti.
4. Social Bookmarking Per segnalare gli articoli sui social network.
5. SimpleCalendar Permette la visualizzazione di un piccolo calendario.
6. ContactPage Crea una pagina speciale che implementa un modulo di contatto per chi vuole scrivere all'amministratore.
   • $wgContactUser = 'WikiSysop'; qui si può specificare il nome utente che riceverà la posta
   • $wgContactSenderName = 'Modulo di Contatto' qui si può cambiare il nome al modulo
7. SidebarDonateBox Aggiunge sulla barra laterale il box Donate di PayPal.
   • #$egSidebarDonateBoxContent = 'code Paypal'; Qui si immette il codice HTML da visualizzare nella barra laterale per il box "Donate" di PayPal.
8. CustomTitle Permette di visualizzare in una pagina un titolo diverso dal nome che la pagina ha nel wiki.
9. CustomUserCreateForm Permette di aggiungere campi aggiuntivi a chi si registra: telefono, indirizzo, ecc. La diamo quindi disattivata, anche se utile.
10. TransformChanges Cambia l'aspetto grafico della pagina Speciale:UltimeModifiche. la diamo disattivata.
11. AllowAnchorTags Crea un tag alternativo per linkare.
12. SpecialCite[2] Visulizza una nuova voce sulla barra laterale sinistra, per poter "citare" più facilmente gli articoli del wiki su altri spazi web.
13. GoogleSiteSearch Cambia il motore di ricerca interno di default, con quello di Google. Per attivarla, bisogna anche sostituire in /include/ il file SpecialSearch.php con quello che vi diamo noi, oppure cambiare il pezzo di codice specificato nella guida.

con tabelle da settare sul database

Per usare le estensioni seguenti è necessario prima creare una tabella nel database usato da MediaWiki: attivatele solo dopo aver fatto la o le tabella/e. (Le istruzioni per crearla le trovate nella cartella specifica di quell'estensione oppure su MediaWiki.org).

1. CentralNotice (va creata una tabella sul database) Consente di mettere un avviso che appare in tutte le pagine, per un certo lasso di tempo. Per funzionare, necessita della creazione di una tabella sul database.
2. WikiHiero (va creata una Tabella sul Database) Per la visualizzazione di geroglifici. Si tratta di una delle più pesanti per cui, se non la usate, non installatela.
3. AjaxShowEditors (va creata una o più Tabella sul database) permette di visualizzare i contribuenti in contemporanea su una stessa pagina.
4. WhosOnline (va creata una Tabella nel database) Permette di visualizzare chi è online.

Visualizzare video e altri tipi di file multimediali

1. YouTubeTag Per i video di YouTube.
2. VideoFlash Specifica, per i video Flash.
3. EmbedVideo Permette di visualizzare i video che caricati su quasi tutti i maggiori servizi online di videosharing.

1. Widgets Per funzionare, richiede che la cartella /extensions/Widgets/compiled_templates/ sia resa scrivibile. I widget si comportano come dei template "preconfezionati", specializzati sia sui video, sia sui documenti.
   • $wgGroupPermissions['sysop']['editwidgets'] = true; molte cose che fanno le estensioni, possono farlo i Widget; può essere più sicuro dare permessi qui, in questa stringa, piuttosto che dare la chiave del vostro server Ftp.
2. ImportFreeImages Permette l'importazione automatica da Flickr delle licenze con cui sono pubblicate le immagini.
3. WikiHiero Permette di inserire geroglifici.
4. ImageMap Permette di linkare le voci del wiki su porzioni di immagini e miniature di immagini.

PDF, PdfBook e altri tipi di documenti

1. PdfBook Consente di creare libri da tutti gli articoli di una categoria, in un colpo solo.
2. PdfExport Come l'estensione Collection.
3. Wiki2LaTeX è obsoleta per molte cose.^{[senza fonte]} Aggiunge una linguetta in più nelle pagine, invece che sulla barra laterale.
   • $wgExtraNamespaces[100] = "LaTeX";

Cancellazione e spam

Filtri anti spam

1. SimpleAntiSpam
2. SpamBlacklist
3. AntiBot

Difettose

1. RegexBlock Permette di mettere filtri di parole a quegli IP anonimi che editano frasi ripetitive.
2. reCAPTCHA Questo e' invece il Captcha classico. va in conflitto. O attivate questo, oppure il VisualMathCaptcha.^{[senza fonte]} (Da notare, che dovete anche per quest'ultimo cambiare alcuni valori nel file ConfirmEdit.php; a seconda di quale volete usare, cioè; come già spiegato sopra).
   • $recaptcha_public_key = 'immettere qui il codice di serie fornito da Google al momento della registrazione';
   • $recaptcha_private_key = 'immettere qui il codice di serie fornito da Google al momento della registrazione';
   • Se si decide di attivare il VisualMathCaptcha,
   • Non attivate i parametri che seguono sul LocalSettings, altrimenti entrano in conflitto
   • $wgCaptchaClass = 'SimpleCaptcha';
   • Attivate o uno, oppure l'altro.
   • require_once( "$IP/extensions/ConfirmEdit/MathCaptcha.php");
   • $wgCaptchaClass = 'MathCaptcha';

Per la chat

1. Freenode Chat[3][4] Tra le funzionalità aggiuntive: gli utenti anonimi non solo possono entrare, ma anche scegliere il nickname e il canale.
   • $wgFreenodeChatChannel = '#nomeCanaleFreenode'; //qui si inserisce il nome del canale di default.
2. IRC Chat. Visualizza diversi canali a cui accedere. Si usa inserendo comandi IRC. Inoltre, richiede che l'utente abbia installato l'ambiente di esecuzione Java.

Altre estensioni

1. WebChat Crea una nuova pagina speciale per la chat.
   • $wgWebChatServer = 'qui si può impostare un server';
   • $wgWebChatChannel = '#freenode'; qui va impostato il canale privato del wiki, che è possibile creare in anticipo alla pagina di freenode.
   • $wgWebChatClient = 'freenodeChat'; // o, in alternativa, si può usare 'mibbit';
2. WikiChat Crea una linguetta di chat su tutti gli articoli e le voci del wiki.
3. DPLforum Permette la visualizzazione delle pagine di discussioni in stile forum.

Non ufficiali

Queste estensioni non sono controllate dagli sviluppatori di MediaWiki, pertanto potrebbero non essere state testate con le ultime versioni del software, pertanto potrebbero non essere aggiornate oppure essere incompatibili con le ultime versioni del software, oppure potrebbero contenere problemi di efficienza, sicurezza o usabilità non noti agli sviluppatori.

1. AWC's MediaWiki Forum Altra estensione che genera un Forum.