Manual:Extensions/es
Las extensiones permiten personalizar cómo funciona y se ve MediaWiki.
- Los wikiusuarios pueden explorar las extensiones existentes.
- 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.
Aunque algunas extensiones son mantenidas por los desarrolladores de MediaWiki, otras fueron desarrolladas por terceros. Como resultado, muchas tienen errores, y no se garantiza que sean compatibles entre sí. Algunas están sin mantenimiento, y no todas las extensiones funcionan en todas las versiones de MediaWiki. Utiliza cualquier extensión, especialmente las etiquetadas como inseguras, bajo tu propio riesgo. Si estás usando una extensión que requiere parches para el software central, asegúrate que guardes una copia de tu base de datos. Esto ayuda a evitar el riesgo de que tu wiki se rompa.
Tipos de extensiones
File:OOjs UI icon markup.svg Etiquetas del analizador
File:OOjs UI icon code.svg Funciones del analizador
File:Plug-in Noun project 4032.svg Ganchos
File:OOjs UI icon pageSettings.svg Páginas especiales
File:OOjs UI icon browser-ltr.svg Apariencias
File:OOjs UI icon quotes-ltr.svg Palabras mágicas
File:API - The Noun Project.svg API
File:OOjs UI icon article-ltr.svg Modelos de contenido de página
File:OOjs UI icon lock.svg Autenticación
Finding extensions
Explorar extensiones
Puedes explorar Categoría:Extensiones por categoría para ver la gama completa de extensiones que ya se han creado. Para obtener información sobre cómo instalar estas extensiones o escribir la tuya propia, véase más adelante.
Comprobar las extensiones instaladas
Solo alguien con acceso a la administración del sistema de archivos (ya menudo también la base de datos) en un servidor puede instalar extensiones de MediaWiki, pero cualquiera puede comprobar qué extensiones están activas en una instancia de MediaWiki accediendo a la página Special:Version. Por ejemplo, estas extensiones están activas en Wikipedia en español.
Popular extensions
There are a number of ways of finding popular extensions.
The first set is those that are bundled with MediaWiki (a list that is reviewed regularly, and to which anyone can suggested an addition).
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 alternate ways of installing extensions, such as via Git or Composer.
A third option is to look at WikiApiary '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.
Instalar una extensión
- For further guidance, see also 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.
- It's recommended to read the README file before installation. It usually contains important info about configuration.
- 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 , Extension:Page Forms .
- 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
extension/NombreDeLaExtensión
por los nuevos.
No borres la configuración de la extensión presente en LocalSettings.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
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.
Véase también
- Categoría:extensiones
- Plantilla:Extensión
- Manual:Desarrollo de extensiones
- Manual:Traducir extensiones - Información para traducir extensiones.
- Special:ExtensionDistributor - Includes a list of the 15 most downloaded extensions in Wikimedia version control
- extloc - Where are MediaWiki extensions deployed in Wikimedia production?
- API:SiteInfo extension information