Manuale MediaWiki/Estensioni
Da Naturpedia.
Cosa sono, come installarle
Per chi è abituato a usare il browser Mozilla Firefox, non gli è nuovo questo concetto: le estensioni, deducendolo dalla parola stessa, sono dei pezzi di codice in più che si aggiungono al software di base, per darle diverse funzionalità extra che, il pacchetto originale, non ha.
Ecco così che, possiamo in definitiva, aggiungere quasi tutto quello che vogliamo sul nostro MediaWiki.
L'installazione
L'installazione di un'estensione, di solito, consiste unicamente di due passaggi:
- Si copia via Ftp la cartella e/o il file .php dell'estensione dell'estensione stessa, nell'omonima sul vostro server,
- Si attiva poi l'Estensione sul file LocalSettings, apponendovi al fondo una stringa.
Vedi, il Local Settings: installazione delle Estensioni. |
Vedi, :mw:Manual:Extensions. |
Estensioni Mediawiki (più importanti)
Per approfondire, vedi Estensioni/Download. |
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.
Indice
|
ESSENZIALI
Per le CATEGORIE
- CategoryTree Ramifica le Categorie
- ManageCategories Visualizza un comodo menu a tendina per le Categorie (Versione migliorata e tradotta all'italiano, per Naturpedia)
- ArticleToCategory2 Questa, è incompatibile con l'altra (simile) di "articletocategory". Attivate o una, o l'altra: non tutt'e due assieme. Hanno funzione simile; entrambe permettono di creare articoli direttamente dalle pagine delle Categorie. Questa è migliore però, a nostro avviso, perché invece di un box soltanto, ne mette due; l'altro, serve per creare anche le Categorie (Versione migliorata e tradotta all'italiano, per Naturpedia)
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.
- ParserFunctions[1]
- StringFunctions
- P.S: Parser Function va settato bene perché funzioni al meglio.
- ExpandTemplates
- ConditionalTemplate
- Cite Per la formattazione delle note a pie' di pagina.
- CharInsert Serve per creare l'Edittools
- InputBox Serve per creare box di ricerca.
- CreateBox (Traduzione italiana migliorata per Naturpedia) è una Versione Migliorata di Input Box. Vi consigliamo di tenere entrambe. "CreateBox", è infatti più specifica per aiutare a 'creare' gli articoli, piuttosto che 'cercarli'.
- Mimetex alternative Questa, riesce a far visualizzare senza nessun settaggio extra non solo i simboli matematici, ma anche le immagini generate nei Pdf. Per i simboli matematici bisogna usare nelle pagine il nuovo TAG generato: 'tex', al posto di 'match', per cui si va a toccare anche il codice del file EditPage.php, nella directory
/includes/
dove avete installato il vostro wiki, per fare in modo che la bottoniera del vostro Edit venga aggiornata nelle pagine. (vedi, il Manuale della variabile per maggiori informazioni).- il pezzo di codice da sostituire è questo:
array( 'image' =>'button_math.png', 'open' => "<math>", 'close' => "</math>", 'sample'=> wfMsg('math_sample'), 'tip' => wfMsg('math_tip'), 'key' => 'C'
Con questo:
array( 'image' =>'button_math.png', 'open' => "<tex>", 'close' => "</tex>", 'sample'=> wfMsg('math_sample'), 'tip' => wfMsg('math_tip'), 'key' => 'C'
Vai a: Estensione Mimetex. |
Per visualizzare VIDEO, o altri tipi di file multimediali
- MultiUpload Permette l'Upload di più immagini o file multimediali sul wiki, contemporaneamente.
-
$wgMaxUploadFiles = 20;
//Specificare qui il numero. Di default, sono cinque.
-
- OggHandler Permette la visualizzazione con Java, dei piccoli filmati .ogg
Per PDF, PdfBook e altri tipi di documenti
- Collection Va settata bene per le immagini, altrimenti stampa solo il testo delle voci: è sufficiente e completa, sia per generare Pdf singoli (dalle pagine del vostro wiki) che per creare Libri (unendo assieme le voci, delle pagine del vostro wiki). Ma potete provare anche le altre.
Vai a: Estensione Collection. |
- GoogleDocs per visualizzare i Documenti Fogli di lavoro di google Doc, sul vostro wiki. Può essere superflua se avete già installato quella di Widget che inoltre, vi permette di visualizzare bene anche gli altri tipi di documenti presenti su Google doc.
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 per farle funzionare. Altrimenti non vanno. Le diamo disattivate, quindi nel nostro LocalSettings che vi forniamo.
- ConfirmEdit
- VisualMathCaptcha (Versione migliorata)
- Questo e' il VisualCaptcha, migliore e piu' sicuro di quello standard di Google fornito piu' in basso.
- E' completo, e quindi vi consigliamo di attivarlo; prima di farlo però, andate a modificare anche il ConfermEdit.php dell'omonima cartella (sotto "Estensions", nel vostro wiki),
- e sostituite lì il Simple Captcha di Default con il Visual Captcha.
- ( Al posto di:
$wgCaptchaClass = 'SimpleCaptcha'
mettete:$wgCaptchaClass = 'VisualMathConfirmCaptcha'
)
Cancellazioni, monitoraggio e blocchi utenti
- Renameuser Questa, è per poter rinominare gli Utenti.
-
$wgGroupPermissions['sysop']['renameuser'] = true;
//Si può qui specificare chi può avere questo privilegio.
-
- Password Reset Per poter cambiare la password degli Utenti.
-
$wgGroupPermissions['sysop']['passwordreset'] = true;
//qui si scegli chi può cambiare la password degli Utenti.
-
- Maintenance Questa, abilita certe altre funzioni extra per il mantenimento del wiki, molto utili (tra cui, la possibilità sempre di cambiare le password).
-
$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
-
- UserRightsList Permette visualizzare una comoda lista di tutti gli utenti registrati e cambiare in maniera facile i loro privilegi. (Versione migliorata)
- UserLoginLog Consente di vedere l'IP di un Utente loggato (nella pagina: "Special:Log"). (Simile a CheckUser, ma funzionante fin da subito, senza settaggi)
- UserMerge Permette di cancellare gli Usuari senza pericoli per il DATABASE, tramite l'Unione l'un con l'altro.
- EditUser Permette agli utenti con i privilegi necessari, di modificare e visualizzare le preferenze personali degli altri utenti. (Versione tradotta all'italiano per Naturpedia)
-
$wgGroupPermissions['bureaucrat']['edituser'] = true;
//User che possono 'spiare' o modificare, le 'preferenze' degli altri. -
$wgGroupPermissions['sysop']['edituser-exempt'] = true;
//User 'esenti' dall'essere modificati o 'visualizzati'. - Attenzione: Abbiamo riscontrato problemi installandola sulla versione 1.16 del software mediawiki.
-
- AbuseFilter
- ConfirmAccount
Blocchi nelle pagine, filtri di parole
- AuthorProtect Permette agli utenti registrati, di bloccare le proprie pagine create, dagli edit altrui. Solo gli amministratori, potranno infatti, editarle o cambiarle.
- Attenzione: se la installate, e dopo la disattivate, le pagine "protette" dagli Utenti non passeranno automaticamente sotto quelle "protette" dagli Amministratori (Sysop); almeno, non di default. Al riattivarla comunque, si ripristineranno i vecchi permessi (dati dagli User).
- ProtectSection Permette agli amministratori, la protezione di sezioni parziali nelle pagine.
- SpamRegex permette filtri di parole, sulla creazione dei contenuti delle pagine: per esempio, solo sul titolo, ecc.
- (va creata prima una Tabella sul Database; e, sembra difettosa con le ultime versioni -1.15 in poi-)
Cancellazione di pagine
- Nuke Consente agli amministratori la cancellazione in massa, delle pagine create da un IP o user, in blocco (verranno cioè cancellate tutte le pagine create da quell'IP o da quell'Utente).
- DeletePagePermanently Permette la cancellazione permanente di pagine: aggiunge la linguetta Delete Permanently alle voci (può essere pericolosa però, se non ci si fida al 100% dei propri collaboratori; o, semplicemente, se si e' distratti)
- il codice seguente, permette di scegliere a quali Namespaces 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
-
- il codice seguente, permette di scegliere a quali Namespaces applicare la linguetta; e, in fondo, il gruppo di utenti che potranno usarla:
- SpecialDeleteOldRevisions2 permette la cancellazione solo delle vecchie revisioni delle voci. Può essere meno pericolosa della prima, perché qui non appare la 'linguetta' e il risultato è abbastanza identico. (Versione migliorata).
-
$wgGroupPermissions['sysop']['DeleteOldRevisions'] = true;
gruppo autorizzato.
-
Per gli INTERLINK
- Interwiki Vi sevirà per le tabelle, anche se decidete di non utilizzare gl'interlink. La diamo quindi attiva, nel nostro LocalSettings.
Vedi, Barra Laterale: Come mettere i Collegamenti interlingua e ad altri wiki. |
-- -- --
OPZIONALI
CATEGORIE
- CategoryWatch Permette agli Utenti loggati di mettere sotto 'osservazione' anche le pagine delle Categorie, oltre a quelle degli articoli.
- GoToCategory Permette d'includere nel motore di ricerca anche le categorie. Si verrà così reindirizzati all'omonima categoria, quando questa è digitata; altrimenti alla voce, se esiste
- MultiCategorySearch Crea una nuova pagina speciale per la ricerca di voci in più categorie (Versione migliorata tradotta all'italiano, per Naturpedia)
- RandomInCategory Permette, tramite una pagina speciale, che sia scelta a caso una pagina, solo dentro ad una determinata Categoria
- Add Article to Category Questa, è incompatibile con l'altra (simile) di "ArticleToCategory2". Attivate o una, o l'altra: non tutt'e due assieme.
- Hanno funzione simile; entrambe permettono di creare articoli direttamente dalle pagine delle Categorie
Questa successiva, dopo che le abbiamo corretto qualche errore, visualizza un comodo messaggio ricordando a chi salva una voce, senza categoria, che deve metterla. Tuttavia, è ancora difettosa: rallenta la wiki. Al momento non usatela se avete wiki molto grandi o con pagine molto lunghe.
- WarnNoCategories (Versione migliorata)
$wgWarnNoCategoriesOnNamespace[NS_MAIN] = true;
qui, si può specificare per quali Namespaces deve funzionare
Vai a: Estensione WarnNoCategories. |
Per abilitare certi comandi utili, ma non essenziali
- Contributors Visulizza una nuova voce, sulla barra laterale sinistra, per visualizzare i contribuenti e gli autori degli articoli.
- NewestPages Crea una Pagina Speciale nuova, per poter visualizzare le pagine create recentemente: per Namespaces e per Utente.
- Poem Serve per formattare testi poetici, ma vi può servire anche per i codici.
- Social Bookmarking Per segnalare sui Social Forum gli articoli. (Versione migliorata per Naturpedia)
- SimpleCalendar Permette la visualizzazione di un piccolo calendario. Funziona tramite Tag, da apporre alle voci.
- ContactPage Crea un Modulo di Contatto, una Pagina Speciale nuova per chi vuole scrivere all'amministratore. Il vantaggio, è che non siete cosi' obbligati a mettere una mail pubblica.
$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
- SidebarDonateBox Serve per aggiungere sulla barra laterale il box Donate di Paypal.
#$egSidebarDonateBoxContent = 'code Paypal';
s'immette qui il codice-html paypal.
- CustomTitle Per la modifica dei titoli delle pagine. Può essere superflua: si può infatti creare lo stesso effetto, con un semplice Template.
- CustomUserCreateForm permetterebbe di aggiungere campi aggiuntivi a chi si registra, tipo telefono, indirizzo, ecc, ma la Guida online non spiega nulla in dettaglio; presupponendo che chiunque la installi sia un esperto di .php e sappia come modificare il codice. La diamo quindi disattivata, anche se utile.
- TransformChanges Cambia l'aspetto Grafico della pagina Speciale:UltimeModifiche; può piacere, come non piacere, per cui la diamo disattivata.
- GoogleSiteSearch Cambia il motore di ricerca interno di default, con quello di Google. Per attivarla, dovete anche sostituire in
/include/
il file SpecialSearch.php con quello che vi diamo noi, oppure cambiare il pezzo di codice specificato nella guida. - AllowAnchorTags Crea un Tag alternativo per linkare. Può essere superflua, se non usate molto i link esterni.
- SpecialCite[2] Visulizza una nuova voce sulla barra laterale sinistra, per poter "citare" più facilmente gli articoli del wiki su altri spazi web.
- Description aggiunge una descrizione meta-tag alle pagine del Namespace MediaWiki del vostro wiki (pagine di servizio)
- Extension:SyntaxHighlight GeSHi Permette di poter visulizzare il codice sorgente che si scrive sulle pagine del wiki in maniera colorata, col nuovo Tag
<source>
(simile a<poem>
e<pre>
). Versione migliorata
con Tabelle da settare sul Database
Per queste ultime, va creata prima una Tabella nel Database MySQL, 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).
- MultiLanguageManager (Versione migliorata, per Naturpedia)
- CentralNotice (va creata una Tabella sul Database) Consente di mettere un Avviso che appare in tutte le pagine, che duri un certo lapso di tempo. Siccome necessita della creazione di una Tabella sul Database per funzionare, la diamo disattivata nel LocalSettings che vi diamo.
- 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.
- AjaxShowEditors (va creata una o più Tabella sul database) permette di visualizzare i contribuenti in contemporanea su una stessa pagina.
- WhosOnline (va creata una Tabella nel database) Permette di visualizzare chi è online.
Visualizzare VIDEO e altri tipi di file multimediali
- YouTubeTag Specifica per i Video di YouTube.
- VideoFlash Specifica, per i Video-Flash.
- EmbedVideo Permette di visualizzare i Video, da quasi tutti i maggiori servizi online di Videosharing.
- 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.
-
- ImageMap Utile per chi pensa di utilizzare molto la grafica: permette di linkare, all'interno delle immagini, le voci stesse del wiki.
- ImportFreeImages Permetterebbe l'importazione automatica da Flicr delle Licenze con cui sono pubblicate le immagini, ma va settata bene ed è un po' complicato farlo, altrimenti non funziona. Per cui, la diamo disattivata nel nostro LocalSettings.
- WikiHiero Permette la scrittura di Geroglifici. La diamo disattivata nel nostro LocalSettings perché è una delle più pesanti, e non tutti la usano.
PDF, PdfBook e altri tipi di documenti
- PdfBook Consente di creare libri da tutti gli articoli di una categoria, senza dover star lì a scrivere o a aggiungere singolarmente le pagine. Funziona però solo tramite template.
- PdfExport Questa è molto buona. Rispetto a "Collection", genera Pdf più velocemente, ma leggermente più pesanti.. e inoltre, va settata bene altrimenti non funziona; stesso discorso vale per la prossima... (Versione migliorata).
- Wiki2LaTeX Questa va settata bene, altrimenti non va. Inoltre, è obsoleta per molte cose. Aggiunge una linguetta in più nelle pagine, invece che sulla Barra laterale.
-
$wgExtraNamespaces[100] = "LaTeX";
-
- PdfHandler Serve per vedere in anteprima i pdf caricati nelle pagine del vostro wiki.
Per utilizzare invece, dei servizi Pdf esterni, integrati al wiki:
Vai a: Altro servizio Pdf esterno: Joliprint. |
Per approfondire, vedi Joliprint Code e Barra Laterale: Pdfonline. |
Cancellazione e SPAM
- Filtri ANTI SPAM ( possono essere superflui se il Visual Captcha vi funziona bene )
- Difettose
- RegexBlock Permetterebbe di mettere filtri di parole a quegli IP anonimi che editano frasi ripetitive, per un periodo che potete scegliere: da qualche ora, a giorni, o mesi; ma noi, non siamo riusciti a farla funzionare.
- reCAPTCHA Questo e' invece il Captcha classico. Lo diamo disattivato nel nostro LocalSettings, perché va in conflitto. O attivate questo, oppure il VisualMathCaptcha. (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, molto migliore,
- 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
Tutte le Versioni, sono state migliorate per Naturpedia, adattandone meglio la Traduzione all'italiano.
- Freenode Chat[3][4] Questa è l'unica che funziona perfettamente, subito. E, anche meglio della prossima (che ci assomiglia), in quanto: gli anonimi non solo possono entrare, ma anche scegliersi il nickname e il Canale. (Versione migliorata per Naturpedia).
-
$wgFreenodeChatChannel = '#nomeCanaleFreenode'
; //qui, si può scegliere d'inserire un nuovo canale; infatti, di default, è impostato su#mediawiki18n
dove generalmente si parla inglese.
-
- IRC Chat Questa, è più complicata settarla per via di Java (sia per chi la installa, che per chi la usa). Ma, se ci riuscite, è carina anch'essa; per cui, 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, chi non usa Java o ha problemi a settarlo, è tagliato fuori. (E, a volte, gli IP anonimi hanno difficoltà a connettersi, anche se non sempre). Versione migliorata per questo progetto.
Difettose
- WebChat Quest'altra, crea anch'essa una nuova pagina speciale di Webchat; sembra funzionare tutto, eccetto l'entrata per gli IP anonimi. Forse, perché studiata per lavorare sull'ultimissima versione di MediaWiki: la 1.16
-
$wgWebChatServer = 'qui si può impostare un Server';
-
$wgWebChatChannel = '#freenode';
qui si può impostare un Canale privato per il proprio wiki, invece di lasciare questo generale di#freenode
(o'#mibbit';
) (si crea gratis alla pagina di freenode) -
$wgWebChatClient = 'freenodeChat';
// o, in alternativa, si può usare: 'mibbit';
-
- WikiChat Questa, invece, crea una 'linguetta' di Chat su tutti gli Articoli e le voci del vostro wiki; funziona, ma.. non riusciamo a settarla. Va solo con gli 'User Burocrati'; non riusciamo a capire come settarla per tutti gli Utenti.
- DPLforum Quest'altra, permette invece la visualizzazione delle pagine di discussioni (Talk) come Forum. Va settata bene però.
- AWC's MediaWiki Forum Altra estensione che genera un Forum: forse troppo invasivo, ma molto più completo del primo qui sopra. Inoltre, va settato bene anch'esso. (Versione migliorata)
PANORAMICA e Download
Al link qui sotto, oltre al download diretto, troverete l'intera panoramica di tutte queste estensioni che noi abbiamo trovato più utili ed interessanti, in ordine alfabetico.
Vai a: Estensioni/Download. |
"Pacchetti"
Mentre, a quest'altro, un comodo "pacchetto" da scaricare con tutte le estensioni qui viste, già suddivise fra "essenziali" e superflue, delle versioni: 1.13, 1.14, 1.15 e 1.16, del software:
- essenziali.7z - (3,94 Mb)
per chi vuole installarsi, invece, solo quelle "di base" (quindi, antispam e formattazione), ecco un "pacchetto" ancora più "concentrato":
- ext di base.7z - (3,71 Mb)
Ovviamente, per attivare questi "pacchetti", fate riferimento al file LocalSettings.php che vi abbiamo preparato appositamente per ognuno di essi:
Per approfondire, vedi il Local Settings. |
Link esterni
Al seguente link, un autore esplora come noi, le estensioni più utili per il software Mediawiki:
Vai a: estensioni più utili, rigacci.org. |
Questa voce rappresenta un Articolo di Wikilibri scritto da voi lettori, o citato; non esprime quindi per forza il punto di vista enciclopedico in stile, tipico delle voci semplici. Per collaborare alla sua stesura, segui le linee guida appropriate per questo genere di voci. |