Manual:Extensions/it

Extensions:

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. Use extensions at your own risk, particularly those tagged as insecure. Se si utilizza un'estensione che richiede delle patch per il software principale, assicurarsi di eseguire il backup del database.

Selecting extensions

Bundled extensions

Several extensions are bundled with MediaWiki as standard.

These extensions should generally be of high utility, perform efficiently, be stable, be well-written, and have no known major security issues. They should also be compatible with the latest versions of MediaWiki, and with each other (i.e. one extension shouldn't block the functions of another). A bundled extension may have a dependency on one or more other extensions, as long as those are also bundled.

Site admins get these automatically when installing or upgrading MediaWiki. When upgrading MediaWiki, any extension upgrades will be automatically applied as well. Site admins may choose to uninstall any of these, if they wish.

There are open, ongoing discussions about which extensions should be part of this group. You can suggest additional extensions to be bundled. Extensions will be bundled once the developers reach a consensus to do so.

An extension may be removed from bundling if its functionality is merged into MediaWiki core, it is replaced by an alternative, or in the unlikely event of any unsolvable major security vulnerabilities being discovered.

Puoi guardare in $cat per vedere l'intera gamma di estensioni che sono già state realizzate.

Testare le estensioni installate

Which extensions are active on an instance of MediaWiki can be checked by accessing the Special:Version page, and scrolling down to the heading Installed extensions (anchor #mw-version-ext). Ad esempio, queste estensioni sono attive in Wikipedia inglese.

There are a number of ways of finding popular extensions.

Extensions that are downloaded from MediaWiki.org via the ExtensionDistributor mechanism have some statistics gathered. The top 15 most downloaded extensions are listed at Special:ExtensionDistributor, and applicable extensions have their download count shown in their infobox. Note that these numbers do not account for alternative ways of installing extensions, such as via Git or Composer.

Another option is to look at WikiApiario's counts of wikis that extensions are installed on. This has the advantage of representing actual installations and not just downloads (i.e. it queries the wiki's APIs), but it is also (as of 2023) not completely up-to-date. It also doesn't count installations on private wikis.

Installare un'estensione

For further guidance, see also Manual:Extensions/Installation and upgrade

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.
    It's recommended to read the README file before installation.It usually contains important info about configuration.
  3. Installa la tua estensione.
    Al termine del file LocalSettings.php, aggiungere:
    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:Page 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 extensions/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

Rimuovi la linea da LocalSettings.php con il nome dell'estensione per disinstallarla:

wfLoadExtension( 'ExtensionName' );

È necessario rimuovere tutte le righe relative alla configurazione dell'estensione.

Developing extensions

MediaWiki core provides several ways for extensions to change the behavior and appearance of a wiki. These extension points give extensions flexibility to add features and functionality, such as displaying a special page or defining an API module. To get started, see the guide to developing extensions. Before writing a new extension, consider contributing to an existing extension or helping with an unmaintained extension.

Users can also make a general request on Phabricator, and hope that your good idea is picked up by a developer. See https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/


Vedi anche

Category:Customization techniques/it#Extensions/it Category:Extension creation/it
Category:Customization techniques/it Category:Extension creation/it