Plantilla:ExtensionInstall
- Descarga y mueve la carpeta
ExtensionInstallextraída a tu directorioextensions/.
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";
Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
| Uses Lua: |
Uso
Installation instructions.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Extension name | 1 | Set the extension name manually.
| String | optional |
| Git submodule | git-submodule | Add --recurse-submodules to the git clone command | Boolean | optional |
| Vagrant role name | vagrant | If given, shows how to install extension with the Vagrant's enable-role command | String | optional |
| Download link | download-link | Overwrite the download link.
| URL | optional |
| LocalSettings early | localsettingsearly | Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.
| Unknown | optional |
| LocalSettings | localsettings | Pass custom PHP code that the user should include in [[LocalSettings.php]].
| Unknown | optional |
| Database update | db-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.)
| Boolean | optional |
| Composer | composer | 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.
| Boolean | optional |
| Custom steps 0 | custom-steps0 | Additional steps before download, e.g. other required extensions (as an unordered "* list"). | Content | optional |
| Custom steps | custom-steps | Additional steps (as an unordered "* list"). | Content | optional |
| Supports registration | registration | 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. | String | optional |
| No registration version | no-registration-version | The MediaWiki version for which extension registration should not be used.
| Unknown | optional |
See also
Ejemplos
Debajo hay algunos ejemplos de cómo usar esta plantilla:
Simple
{{ExtensionInstall}}
- Descarga y mueve la carpeta
MyExtensionextraída a tu directorioextensions/.
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";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
CategoryTreeextraída a tu directorioextensions/.
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";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 directorioextensions/existente.- Añade el siguiente código en la parte final de tu archivo LocalSettings.php:
require_once "$IP/extensions/MyExtension/MyExtension.php";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
MyExtensionextraída a tu directorioextensions/.
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;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
MyExtensionextraída a tu directorioextensions/.
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";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
MyExtensionextraída a tu directorioextensions/.
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.
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
MyExtensionextraída a tu directorioextensions/.
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-deven 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";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
MyExtensionextraída a tu directorioextensions/.
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
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
MyExtensionextraída a tu directorioextensions/.
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' );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
MyExtensionextraída a tu directorioextensions/.
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' );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 dewfLoadExtension( '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
MyExtensionextraída a tu directorioextensions/.
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' );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 directorioextensions/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-deven 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
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 dewfLoadExtension( 'Example' );:require_once "$IP/extensions/Example/Example.php";
Instalación Vagrant:
- Si se utiliza Vagrant, instala con
vagrant roles enable example --provision