MediaWiki/Estensioni: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
m ripulisco codice
Riga 1: Riga 1:
{{Manuale MediaWiki}}
{{MediaWiki}}
== Download e installazione ==
== Download e installazione ==
Le estensioni sono software che aggiungono al wiki funzionalità extra. Si scaricano ed installano separatamente.
Le estensioni sono software che aggiungono al wiki funzionalità extra. Si scaricano ed installano separatamente.
Riga 6: Riga 6:
#si scaricano i file dell'estensione;
#si scaricano i file dell'estensione;
#si incollano nella cartella di MediaWiki (se da remoto, si copia tramite FTP nell'omonima cartella sul server);
#si incollano nella cartella di MediaWiki (se da remoto, si copia tramite FTP nell'omonima cartella sul server);
#si attiva l'estensione modificando a mano il [[Manuale MediaWiki/LocalSettings.php|file LocalSettings.php]].
#si attiva l'estensione modificando a mano il [[MediaWiki/LocalSettings.php|file LocalSettings.php]].


=== Informazioni e download ===
=== Informazioni e download ===
Riga 62: Riga 62:
#[[mw:Extension:Description|Description]] aggiunge una descrizione [[:w:it:meta tag|meta-tag]] alle pagine del [[mw:Namespace|namespace]] <tt>MediaWiki</tt> (pagine contenenti messaggi di sistema usati dal software wiki)
#[[mw:Extension:Description|Description]] aggiunge una descrizione [[:w:it:meta tag|meta-tag]] alle pagine del [[mw:Namespace|namespace]] <tt>MediaWiki</tt> (pagine contenenti messaggi di sistema usati dal software wiki)
#[[mw:Extension:Cite|Cite]] Per la formattazione delle note a pie' di pagina.
#[[mw:Extension:Cite|Cite]] Per la formattazione delle note a pie' di pagina.
#[[mw:Extension:CharInsert|CharInsert]] Serve per creare l'[[Manuale MediaWiki/Edittools|Edittools]].
#[[mw:Extension:CharInsert|CharInsert]] Serve per creare l'[[MediaWiki/Edittools|Edittools]].
#[[mw:Extension:InputBox|InputBox]] Serve per creare box di ricerca.
#[[mw:Extension:InputBox|InputBox]] Serve per creare box di ricerca.
#[[mw:Extension:CreateBox|CreateBox]] Versione alternativa di ''Input Box'', specifica per aiutare a creare gli articoli, piuttosto che cercarli.
#[[mw:Extension:CreateBox|CreateBox]] Versione alternativa di ''Input Box'', specifica per aiutare a creare gli articoli, piuttosto che cercarli.
#[[mw:Extension:Mimetex alternative|Mimetex alternative]] Visualizza i simboli matematici e le immagini generate nei PDF, senza nessun settaggio extra. Per maggiori informazioni, consultare il [[Manuale MediaWiki/Estensioni/Manuali/Estensione Mimetex|manuale]] [[mw:Manual:Math|dell'estensione]].
#[[mw:Extension:Mimetex alternative|Mimetex alternative]] Visualizza i simboli matematici e le immagini generate nei PDF, senza nessun settaggio extra. Per maggiori informazioni, consultare il [[MediaWiki/Estensione Mimetex|manuale]] [[mw:Manual:Math|dell'estensione]].
{{vedi anche|Manuale MediaWiki/Estensioni/Manuali/Estensione Mimetex|etichetta1=Estensione Mimetex}}
{{vedi anche|Manuale MediaWiki/Estensioni/Manuali/Estensione Mimetex|etichetta1=Estensione Mimetex}}


Riga 227: Riga 227:
<references/>
<references/>


[[Category:Manuale_MediaWiki|Estensioni]]
[[Categoria:MediaWiki|Estensioni]]
{{Avanzamento|100%|11 agosto 2011}}
{{Avanzamento|100%|11 agosto 2011}}

Versione delle 07:14, 7 feb 2012

Indice del libro

Download e installazione

Le estensioni sono software che aggiungono al wiki funzionalità extra. Si scaricano ed installano separatamente.

Le istruzioni per aggiungere un'estensione sono sulla sua pagina di riferimento. Di solito, si seguono questi passaggi:

  1. si scaricano i file dell'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.

Informazioni e download

La maggior parte delle estensioni elencate di seguito ha una pagina di riferimento sul sito ufficiale di MediaWiki, nella quale (in alto a destra) appare un riquadro con 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 sorgente dell'estensione è 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 istruzioni per scaricare e configurare l'estensione sono descritte nel testo della pagina e nel box in alto a destra, il quale dà anche i link per scaricare i file (dal sito di MediaWiki e/o da siti di terze parti). Se queste informazioni mancano, si può fare riferimento alle seguenti alternative, se applicabili:

In alcuni casi, invece del link per il download, nella pagina appare direttamente il codice sorgente dell'estensione, accompagnato dalle istruzioni per salvarlo in un nuovo file php nella cartella di MediaWiki. Dove possibile, è preferibile invece affidarsi ai link per scaricare i file dell'estensione, in quanto il codice sorgente nella pagina non è soggetto al controllo degli sviluppatori di MediaWiki, e quindi potrebbe 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.[1]

Creazione di tabelle

Prima di poter usare alcune estensioni, è necessario creare delle tabelle apposta nel database, seguendo le istruzioni descritte nella pagina di riferimento dell'estensione. In gergo, le istruzioni da fornire al database manager per creare le tabelle si chiamano query SQL.

Le tabelle si creano in questo modo:

  • se si usa phpMyAdmin, dapprima si clicca sul nome del database nella colonna di sinistra, quindi si clicca sulla linguetta "Query", in alto, si incolla la query SQL nella casella che è sotto la scritta "SQL query on database test", infine si fa clic sul tasto "Submit query" in fondo;
  • ...

Estensioni ospitate sul sito ufficiale (installate sui progetti Wikimedia)

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

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

  1. ParserFunctions (per informazioni, consultare il manuale ufficiale)
  2. StringFunctions
  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 maggiori informazioni, consultare il manuale dell'estensione.
Per approfondire, vedi Estensione Mimetex.

Visualizzare video e altri 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.
Per approfondire, vedi Estensione Collection.

Cancellazione e 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[quali?] 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.[non chiaro]
  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.

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

Interlink

  1. Interwiki Serve per le tabelle, anche se si decide di non utilizzare gli interlink.
Per approfondire, vedi Barra Laterale: Come mettere i Collegamenti interlingua e ad altri wiki.

Altre estensioni ospitate sul sito ufficiale

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.
  6. WarnNoCategories Mostra un messaggio ricordando, a chi salva una voce senza categoria, che deve metterla. Va però corretta nel suo codice sorgente; altrimenti, così com'è, presenta antiestetici messaggi di errore.
Per approfondire, vedi Estensione WarnNoCategories.

Per abilitare alcuni comandi

  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. AllowAnchorTags Crea un tag alternativo per linkare.
  12. Cite Mostra 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.

Visualizzare video e altri file multimediali

  1. VideoFlash Specifica, per i video Flash.
  2. EmbedVideo Permette di visualizzare i video che caricati su quasi tutti i maggiori servizi online di videosharing.
  3. 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 server FTP.
  4. ImportFreeImages Permette l'importazione automatica da Flickr delle licenze con cui sono pubblicate le immagini.
  5. WikiHiero Permette di inserire geroglifici.
  6. 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 agli utenti 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';

Chat

  1. Freenode Chat Consente l'ingresso agli utenti anonimi. Permette agli utenti di 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.
  4. CentralNotice 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.
  5. WikiHiero Per la visualizzazione di geroglifici. Si tratta di una delle più pesanti per cui, se non la usate, non installatela.
  6. AjaxShowEditors permette di visualizzare gli utenti che hanno modificato una stessa pagina.
  7. WhosOnline Permette di visualizzare chi è online.

Estensioni non ospitate sul sito ufficiale

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

  1. AWC's MediaWiki Forum Genera un forum.
  2. GoogleDocs Visualizza i fogli di lavoro di Google Docs.
  3. SpecialDeleteOldRevisions2 Permette la cancellazione solo delle vecchie revisioni delle voci.
    • $wgGroupPermissions['sysop']['DeleteOldRevisions'] = true; gruppo autorizzato.
  4. YouTubeTag Per i video di YouTube.

Note

  1. Template:Extension code in wiki
  2. Template:Extension code in wiki