Manual:Extensions/es
Una extensión permiten personalizar el aspecto y el funcionamiento de MediaWiki.
- Los administradores del sistema pueden instalar (o desinstalar) extensiones en las instalaciones de MediaWiki que administran.
- Los desarrolladores pueden crear nuevas extensiones o mejorar o mantener las extensiones existentes.
Encontrar extensiones
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.
Explorar extensiones
Puedes explorar $cat para ver la gama completa de extensiones que ya se han creado.
Comprobación de extensiones instaladas
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
).
Por ejemplo, estas extensiones están activas en Wikipedia en español.
Extensiones populares
Hay varias maneras de encontrar extensiones populares.
Las extensiones que son descargadas de MediaWiki.org a través del mecanismo ExtensionDistributor tienen algunas estadísticas recopiladas. Las 15 extensiones más descargadas están listadas en Special:ExtensionDistributor, y las extensiones correspondientes tienen su conteo de descargas mostrado en su casilla de información. Nótese que estas cifras no tienen en consideración otras maneras alternas de instalar extensiones, tales como a través de Git o Composer.
Una tercera opción es consultar los recuentos de WikiApiary de las wikis en las que están instaladas las extensiones. Esto tiene la ventaja de representar instalaciones reales y no sólo descargas (es decir, consulta las API de la wiki), pero también (a partir de 2023) no está completamente actualizado. Tampoco cuenta las instalaciones en wikis privadas.
Instalar una extensión
- Para más información, véase también Manual:Extensions/Installation and upgrade
MediaWiki está listo para aceptar extensiones justo después de que la instalación haya finalizado. Para agregar una extensión, sigue estos pasos:
- Antes de comenzar
- Muchas extensiones proporcionan instrucciones de instalación con comandos Unix.Es necesario tener acceso a la shell (SSH) para poder introducir estos comandos enumerados en las páginas de ayuda de la extensión.
- Descargar la extensión.
- Extension Distributor ayuda a elegir y descargar la mayoría de las extensiones más utilizadas.
- Las extensiones suelen distribuirse en forma de paquetes modulares.Por lo general, van en su propio subdirectorio de
$IP /extensions/
.En git:mediawiki/extensions se encuentra una lista de extensiones almacenadas en el repositorio Gerrit de Wikimedia.Algunas extensiones no utilizan control de versiones, y no se recomienda su instalación. - Algunas extensiones también están disponibles en forma de paquetes, en Composer o en repositorios.
- Se recomienda leer el archivo README antes de la instalación.Usualmente contiene información importante sobre la configuración.
- Instala tu extensión.
- Por lo general, al final del archivo
LocalSettings.php
(pero encima del delimitador de final de código de PHP, «?>
», si está presente), se debe añadir la siguiente línea: wfLoadExtension( 'ExtensionName' );
- Esta línea fuerza al intérprete de PHP a leer el archivo de extensión, y por tanto a hacerlo accesible para MediaWiki.
- Algunas extensiones pueden entrar en conflicto con scripts de mantenimiento, por ejemplo, si acceden directamente a $_SERVER (no recomendado). En este caso, se pueden envolver en el condicional, de forma que los scripts de mantenimiento sigan pudiéndose ejecutar.
if ( !$wgCommandLineMode ) { wfLoadExtension ( 'ExtensionName' ); }
- El script de mantenimiento importDump.php fallará para cualquier extensión que requiera el uso de espacios de nombres personalizados incluidos en el condicional anterior, como por ejemplo Extensión:SemanticMediaWiki , Extensión:Formas de página .
- Por lo general, al final del archivo
- ¡Asegúrate de que estén definidos los permisos requeridos para las extensiones!
- Aunque este procedimiento de instalación es suficiente para la mayoría de extensiones, algunas necesitan un procedimiento distinto de instalación.Comprueba la documentación de tu extensión para más información.
- Si deseas alterar las variables de configuración en
LocalSettings.php
, normalmente tienes que hacerlo después de incluir la extensión.En caso contrario, los valores predefinidos en la extensión sobreescribirán los que tengas configurados.
Actualizar una extensión
Algunas extensiones requieren ser actualizadas cada vez que actualices MediaWiki, mientras que otras son compatibles con varias versiones. Para actualizar una extensión a una nueva versión:
- Descarga la nueva versión de la extensión
- Sustituye todos los archivos de la extensión en el directorio
extensions/ExtensionName
por los nuevos.No borres la configuración de la extensión presente enLocalSettings.php
- Dependiendo de la extensión, quizá tengas que ejecutar el script de mantenimiento update.php .La mayoría de las extensiones mencionarán si se tiene que ejecutar este script o no.(Haz una copia de seguridad de tus datos antes de ejecutar el script).Si no dispones de acceso a la línea de comando, también puedes usar el actualizador web.
Desinstalar una extensión
Elimine la línea de LocalSettings.php
con el nombre de la extensión para desinstalarla:
wfLoadExtension( 'ExtensionName' );
- Debe quitar todas las líneas que pertenezcan a la configuración de la extensión.
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/
Véase también
- Categoría:Extensiones
- Plantilla:Extensión
- Manual:Desarrollo de extensiones
- Manual:Traducir extensiones - Información para traducir extensiones.
- Special:ExtensionDistributor - Incluye una lista de las 15 extensiones más descargadas en el control de versiones de Wikimedia.
- extloc - Where are MediaWiki extensions deployed in Wikimedia production?
- API:Siteinfo#Extensions