Jump to content

Manual:Extensiones

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 100% complete.
Languages:
Extensiones:

Una extensión permite 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 escribir nuevas extensiones o contribuir a extensiones existentes.
Si bien algunas extensiones son mantenidas por los desarrolladores de MediaWiki, otras son desarrolladas por terceros y es posible que no reciban mantenimiento. Como resultado, muchas extensiones pueden contener errores, incluyendo, en algunos casos, vulnerabilidades de seguridad. No todas las extensiones son compatibles con todas las versiones de MediaWiki y es posible que no funcionen de manera confiable cuando se usan juntas. Utilice las extensiones bajo su propio riesgo, especialmente aquellas etiquetadas como inseguras. Si una extensión requiere parches en el software principal, asegúrese de hacer una copia de seguridad de su base de datos de antemano para minimizar el riesgo de dañar su wiki.

Seleccionar extensiones

Extensiones incluidas

Varias extensiones vienen incluidas con MediaWiki como estándar.

Por lo general, estas extensiones deberían ser de gran utilidad, funcionar de manera eficiente, ser estables, estar bien escritas y no tener problemas de seguridad importantes conocidos. También deberían ser compatibles con las últimas versiones de MediaWiki y entre sí (es decir, una extensión no debería bloquear las funciones de otra). Una extensión incluida puede tener dependencia de una o más extensiones adicionales, siempre que éstas también estén incluidas.

Los administradores del sitio los obtienen automáticamente al instalar o actualizar MediaWiki. Al actualizar MediaWiki, cualquier actualización de extensión también se aplicará automáticamente. Los administradores del sitio pueden optar por desinstalar cualquiera de estos, si lo desean.

Hay debates abiertos y en curso sobre qué extensiones deberían formar parte de este grupo. Puede sugerir extensiones adicionales para incluir . Las extensiones se incluirán una vez que los desarrolladores lleguen a un consenso para hacerlo.

Una extensión puede eliminarse del paquete si su funcionalidad se fusiona con el núcleo de MediaWiki , se reemplaza por una alternativa o en el improbable caso de que se descubran vulnerabilidades de seguridad importantes que no se puedan resolver.

Explorar extensiones

Explore Categoría:Todas las extensiones , o Categoría:Extensiones por categoría para ver la gama completa de extensiones disponibles.

Comprobación de extensiones instaladas

Se puede verificar qué extensiones están activas en una instancia de MediaWiki accediendo a la página Special:Version y desplazándose hacia abajo hasta el encabezado "Extensiones instaladas" (etiqueta #mw-version-ext). Por ejemplo, estas extensiones están instaladas en esta wiki y estas extensiones están activas en la Wikipedia en español.

Extensiones populares

Otra opción es consultar en WikiApiary el número de wikis en los que hay extensiones instaladas. 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: Extensiones/Instalación y actualización

MediaWiki está listo para aceptar extensiones justo después de que la instalación haya finalizado. Para agregar una extensión, sigue estos pasos:

  1. 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.
  2. 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.
  3. 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 los 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 .
¡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:

  1. Descarga la nueva versión de la extensión
  2. 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 en LocalSettings.php
  3. 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.
Estas instrucciones cubren el 99% de las extensiones. Si la extensión concreta que estás actualizando tiene instrucciones que difieran de estas, probablemente debas seguir las instrucciones de la extensión.

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.

Desarrollo de extensiones

El núcleo de MediaWiki proporciona varias formas para que las extensiones cambien el comportamiento y la apariencia de un wiki. Estos puntos de extensión brindan a las extensiones flexibilidad para agregar características y funcionalidades, como mostrar una página especial o definir un módulo API. Para comenzar, consulte la guía para desarrollar extensiones . Antes de escribir una nueva extensión, considere contribuir a una extensión existente o ayudar con una extensión sin mantenimiento .

Los usuarios también pueden realizar una solicitud general en Phabricator y esperar que un desarrollador adopte su buena idea. Véase https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/

Véase también

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Extensions/es&oldid=7886961"