MediaWiki/Estensioni

Cosa sono, come installarle

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.

L'installazione

L'installazione di un'estensione, di solito, consiste di due passaggi:

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

Estensioni Mediawiki (più importanti)

Template:Vedi anche2 Elenchiamo qui di seguito le Estensioni più importanti di MediaWiki, cercando di dare una panoramica d'insieme tra: quelle più importanti di tutte, le "essenziali", e quelle "superflue" al suo funzionamento basico. E, come nel capitolo successivo vedremo poi come attivarle sul LocalSettings, diamo accanto di alcune delucidazioni su stringhe specifiche che poi ritroverete lì, accanto a quella di attivazione.

Nota: non sono messe in ordine alfabetico, ma d'importanza.

Essenziali

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

1. 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.
2. 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]} Le diamo disattivate, quindi nel nostro LocalSettings che vi forniamo.

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. La diamo quindi attiva, nel nostro LocalSettings.

Opzionali

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.
10. TransformChanges Cambia l'aspetto grafico della pagina Speciale:UltimeModifiche.
11. 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.
12. AllowAnchorTags Crea un tag alternativo per linkare.
13. SpecialCite[2] Visulizza una nuova voce sulla barra laterale sinistra, per poter "citare" più facilmente gli articoli del wiki su altri spazi web.

con tabelle da settare sul database

Per usare le estensioni seguenti è necessario prima creare una tabella nel database usato da MediaWiki, per cui le diamo disattivate nel nostro LocalSettings: 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. Poiché necessita della creazione di una tabella sul Database per funzionare, la diamo disattivata nel LocalSettings che vi diamo.
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 Questa, la diamo disattivata nel LocalSettings, perché: necessita prima di aver reso "scrivibile" sul server la cartella /extensions/Widgets/compiled_templates/ per funzionare. I Widget, si comportano come dei comodi 'Template preconfezionati', specializzati sia sui video che 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. ImageMap Permette di linkare le voci del wiki su porzioni di immagini e miniature di immagini.
3. ImportFreeImages Permette l'importazione automatica da Flickr delle licenze con cui sono pubblicate le immagini, ma va settata bene ed è un po' complicato farlo, altrimenti non funziona^{[senza fonte]}. Per cui, la diamo disattivata nel nostro LocalSettings.
4. WikiHiero Permette di inserire geroglifici. La diamo disattivata nel nostro LocalSettings perché Template:Cn!.

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

Per utilizzare invece, dei servizi Pdf esterni, integrati al wiki: Template:Vai2 Template:Vedi anche2Template:Vedi anche2

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. Lo diamo disattivato nel nostro LocalSettings, perché 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 la diamo attiva nel nostro LocalSettings. Al contrario delle altre, visualizza comodamente diversi canali a cui accedere. Chi la usa, però, deve conoscere un minimo di comunicazione IRC, per digitare i comandi. Inoltre, richiede che l'utente abbia installato l'ambiente di esecuzione Java.

Difettose

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.
4. AWC's MediaWiki Forum Altra estensione che genera un Forum.