Manuale:Estensioni

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Extensions and the translation is 88% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Mirandés • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎العربية • ‎سنڌي • ‎پښتو • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-preferences-other.svg Extensions: Development Tag extensions Parser functions Hooks Special pages Skins Manuale:Parole magiche API Content models

Le estensioni ti consentono di personalizzare l'aspetto e il funzionamento di MediaWiki.

Mentre alcune estensioni sono gestite dagli sviluppatori di MediaWiki, altre sono state scritte da sviluppatori di terze parti. Di conseguenza, molte hanno bug e non tutte sono garantite come compatibili tra loro. Alcune sono senza manutenzione; non tutte le estensioni funzionano su tutte le versioni di MediaWiki. Usare una qualsiasi estensione, in particolar modo quelle contrassegnate come non sicure, è un vostro rischio. Quando usi un'estensione che richiede patch (aggiornamenti) al codice centrale di MediaWiki od a voci del tuo database, assicurati di creare un backup (una copia) del database e/o del codice centrale di MediaWiki, per evitare il rischio di danneggiare definitivamente la tua wiki.

Types of extensions

OOjs UI icon markup.svg Parser tags

Parser tags extend the built-in wiki markup with additional capabilities, whether simple string processing, or full-blown information retrieval.


Learn more about parser tags

OOjs UI icon code.svg Parser functions

Parser functions are special wiki markup syntax that can 'interact' with other wiki elements in the page, and give a specific output.


Learn more about parser functions

Plug-in Noun project 4032.svg Hooks

Hooks allow custom code to be executed when some defined event (such as saving a page or a user logging in) occurs.


Learn more about hooks

Noun Policy 1320312 4380c9.svg Special pages

Special pages are pages that are created by the software on demand to perform a specific function.


Learn more about special pages

Paint palette icon from the Noun Project.svg Skins

Skins allow users to customize the look and feel of MediaWiki.


Learn more about skins

Font Awesome 5 solid magic.svg Magic words

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.


Learn more about magic words

API - The Noun Project.svg API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.


Learn more about the MediaWiki API

OOjs UI icon article-ltr.svg Page content models

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.


Learn more about content models

OOjs UI icon lock.svg Authentication

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.


Learn more about authentication

Navigare nelle estensioni

Puoi guardare in Categoria:Estensioni per categoria per vedere l'intera gamma di estensioni che sono già state realizzate. Per informazioni sull'installazione di queste estensioni o scrivere la tua, vedi sotto.

Testare le estensioni installate

Solo chi ha accesso amministrativo al file di sistema (e spesso anche al database) su un server può installare estensioni per MediaWiki, ma chiunque può controllare quali estensioni sono attive su un'istanza di MediaWiki accedendo alla pagina Special:Version. Ad esempio, queste estensioni sono attive in Wikipedia inglese.

Installare un'estensione

MediaWiki è pronto ad accettare estensioni solo dopo che l'installazione è terminata. Per aggiungere un'estensione attenersi alla seguente procedura:

  1. Prima di iniziare
    Molte estensioni forniscono istruzioni progettate per l'installazione usando i comandi UNIX. È necessario l'accesso al protocollo di sicurezza Secure SHell (SSH) ("conchiglia sicura") per immettere questi comandi elencati nelle pagine della guida dell'estensione.
  2. Scaricare la tua estensione.
    Il distributore di estensioni (Extension Distributor) aiuta a scegliere e scaricare le estensioni più utilizzate.
    Le estensioni normalmente vengono distribuite come pacchetti modulari. Generalmente vanno nella loro sottocartella di $IP /extensions/. Un elenco di estensioni memorizzate nell'archivio Git di Wikimedia si trova in git:mediawiki/extensions. Alcune estensioni non usano il controllo della versione e sono sconsigliate.
    Alcune estensioni sono disponibili in pacchetti, in composer od in archivî di pacchetti.
  3. Installa la tua estensione..
    Generalmente, alla fine del file LocalSettings.php (sopra il delimitatore di fine del codice PHP, "?>", se presente), deve essere aggiunta la seguente riga:
    wfLoadExtension( 'ExtensionName' );
    
    Questa linea impone all'interprete PHP di leggere il file dell'estensione ed a renderlo quindi accessibile a MediaWiki.
    Alcune estensioni possono entrare in conflitto con gli script di manutenzione, ad esempio se accedono direttamente a $_SERVER (sconsigliato).
    In questo caso possono essere inclusi nel condizionale cosicché gli script di manutenzione possano ancora essere eseguiti.
if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
Lo script di manutenzione importDump.php fallirà per qualsiasi estensione che richiede spazi dei nomi personalizzati che sia inclusa all'interno del condizionale sopra come Extension:Semantic MediaWiki , Extension:Semantic Forms .
Assicurati che le autorizzazioni richieste siano impostate per le estensioni!
Mentre questa procedura di installazione è sufficiente per la maggior parte delle estensioni, alcune richiedono una diversa procedura di installazione. Controlla la documentazione della tua estensione per i dettagli.
Se vuoi modificare le variabili di configurazione in LocalSettings.php, prima devi aver incluso l'estensione. Altrimenti le impostazioni definite nell'estensione sovrascriveranno le tue impostazioni.


Aggiornare un'estensione

Alcune estensioni richiedono di essere aggiornate ogni volta che si aggiorna MediaWiki, mentre altre funzionano con più versioni. Per aggiornare ad una nuova versione di un'estensione:

  1. Scarica la nuova versione dell'estensione
  2. Sostituisci tutti i file dell'estensione nella cartella extension/ExtensionName con i nuovi file. Non rimuovere la configurazione dell'estensione presente in LocalSettings.php
  3. A seconda dell'estensione, potrebbe essere necessario eseguire lo script di manutenzione Update.php. La maggior parte delle estensioni vi ricorderà se questo script deve essere eseguito o no. (Svolgi un backup dei tuoi dati prima di eseguire lo script). Se non si dispone dell'accesso alla riga di comando, è possibile utilizzare anche il web updater (aggiornatore di web).
Queste istruzioni coprono il 99% delle estensioni. Se l'estensione specifica che stai aggiornando ha istruzioni che differiscono da queste, probabilmente dovresti seguire le istruzioni della specifica estensione

Disinstallare un'estensione

Remove the line from LocalSettings.php with the extension name to uninstall it:

wfLoadExtension( 'ExtensionName' );
  • You must remove any lines pertaining to the configuration of the extension.
  • If the extension provides any database changes, you must run update.php to remove them.

Vedi anche

Extensions : Category All RequestsTag extensions Extensions FAQ Extension hook registryExtension default namespaces