Jump to content

Plantilla:ExtensionInstall

From mediawiki.org
This page is a translated version of the page Template:ExtensionInstall and the translation is 100% complete.
  • Descarga y mueve la carpeta ExtensionInstall extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
Template documentation

Uso

Installation instructions.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Extension name1

Set the extension name manually.

Default
The current page name without namespace prefix.
Auto value
{{ROOTPAGENAME}}
Stringoptional
Git submodulegit-submodule

Add --recurse-submodules to the git clone command

Booleanoptional
Vagrant role namevagrant

If given, shows how to install extension with the Vagrant's enable-role command

Stringoptional
Download linkdownload-link

Overwrite the download link.

Default
Link to Special:ExtensionDistributor with the extension name.
URLoptional
LocalSettings earlylocalsettingsearly

Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.

Example
$wgUseAjax = true; // Must be included before the extension is loaded
Unknownoptional
LocalSettingslocalsettings

Pass custom PHP code that the user should include in [[LocalSettings.php]].

Example
$wgUseAjax = true;
Unknownoptional
Database updatedb-update

If the extension requires the update script to be run, set this parameter to any value. (For example, if it has one or more database tables that need to be created.)

Example
1
Booleanoptional
Composercomposer

If the extension uses Composer to manage dependencies, set this parameter to any value. Not that this does not indicate that the extension is able to be installed with Composer.

Default
false
Booleanoptional
Custom steps 0custom-steps0

Additional steps before download, e.g. other required extensions (as an unordered "* list").

Contentoptional
Custom stepscustom-steps

Additional steps (as an unordered "* list").

Contentoptional
Supports registrationregistration

Changes the template to use <code>wfLoadExtension()</code> if it supports registration. Set to any value if the extension supports registration, or to <code>required</code> if it <em>only</em> supports registration and doesn't support the old-style of loading.

Stringoptional
No registration versionno-registration-version

The MediaWiki version for which extension registration should not be used.

Default
1.24
Unknownoptional

See also

Ejemplos

Debajo hay algunos ejemplos de cómo usar esta plantilla:

Simple

{{ExtensionInstall}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Nombre

{{ExtensionInstall|CategoryTree}}
  • Descarga y mueve la carpeta CategoryTree extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/CategoryTree/CategoryTree.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Enlace de descarga

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
  • Download y extrae los archivos en el directorio «MyExtension» dentro del directorio extensions/ existente.
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    $wgUseAjax = true;
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

LocalSettings anticipado

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // Esto debe ser incluido antes de cargar la extensión
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    $wgUseAjax = true; // Esto debe ser incluido antes de cargar la extensión
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Actualización de base de datos

{{ExtensionInstall
|db-update=Yes
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Composer

{{ExtensionInstall
|composer=Yes
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Cuando se efectúa la instalación desde Git, hay que ejecutar Composer para que se instalen las dependencias de PHP; para este efecto, ejecute composer install --no-dev en el directorio de la extensión. (ver T173141 para complicaciones potenciales)
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Pasos personalizados

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Registro para asistencia

{{ExtensionInstall
|registration=1
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'MyExtension' );
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Permitir registro con versión mínima

{{ExtensionInstall
|registration=1
|no-registration-version=1.39
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'MyExtension' );
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Para quienes usan MediaWiki 1.39 o versiones anteriores:

Estas instrucciones describen la nueva forma de instalar extensiones usando wfLoadExtension(). Si necesitas instalar esta extensión en versiones anteriores (MediaWiki 1.39 y anteriores), debes usar lo siguiente en lugar de wfLoadExtension( 'MyExtension' );:

require_once "$IP/extensions/MyExtension/MyExtension.php";

Esto solo funciona si la versión especificada es 1.39 o posterior, de lo contrario la plantilla asume que a nadie le importan las versiones antiguas y recurre a #Requiere registro

Requiere registro

{{ExtensionInstall
|registration=required
}}
  • Descarga y mueve la carpeta MyExtension extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'MyExtension' );
    
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Todo

{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}
  • Download y extrae los archivos en el directorio «Example» dentro del directorio extensions/ existente.
  • Cuando se efectúa la instalación desde Git, hay que ejecutar Composer para que se instalen las dependencias de PHP; para este efecto, ejecute composer install --no-dev en el directorio de la extensión. (ver T173141 para complicaciones potenciales)
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'Example' );
    $wgUseAjax = true;
    
  • Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Para quienes usan MediaWiki 1.39 o versiones anteriores:

Estas instrucciones describen la nueva forma de instalar extensiones usando wfLoadExtension(). Si necesitas instalar esta extensión en versiones anteriores (MediaWiki 1.39 y anteriores), debes usar lo siguiente en lugar de wfLoadExtension( 'Example' );:

require_once "$IP/extensions/Example/Example.php";


Instalación Vagrant:

  • Si se utiliza Vagrant , instala con vagrant roles enable example --provision