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.

Una extensión permiten personalizar el aspecto y el funcionamiento de MediaWiki.

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

Etiquetas del analizador

Las etiquetas de analizador amplían el marcado wiki incorporado con capacidades adicionales, ya sea un procesamiento simple de cadenas o una recuperación de información completa.

Funciones del analizador

Las funciones de analizador son una sintaxis de marcado wiki especial que puede 'interactuar' con otros elementos wiki en la página y dar un resultado específico.

Ganchos

Los ganchos permiten que se ejecute código personalizado cuando ocurre algún evento definido (como guardar una página o iniciar sesión de un usuario).

Páginas especiales

Las páginas especiales son páginas que son creadas por el software en demanda para realizar una función específica.

Apariencias

Las apariencias permiten a los usuarios personalizar cómo se ve y se siente MediaWiki.

Palabras mágicas

Las palabras mágicas son una técnica para asignar una variedad de cadenas de texto wiki a un único ID que está asociado con una función.

API

MediaWiki proporciona una API de acciones, un servicio web que permite acceder a algunas funciones wiki como la autenticación, las operaciones de página y la búsqueda.

Modelos de contenido de página

El ContentHandler introducido en MediaWiki 1.21 hace posible que las páginas wiki estén compuestas por datos distintos al wikitexto, como JSON o Markdown.

Autenticación

MediaWiki proporciona SessionManager y AuthManager, dos entornos de trabajo relacionados con la autenticación para mejorar la seguridad mediante mecanismos de autenticación personalizados.

Encontrar extensiones

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.

Comprobación de extensiones instaladas

Solo alguien con acceso a la administración del sistema de archivos (y a 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.

Extensiones populares

Hay varias maneras de encontrar extensiones populares.

El primer conjunto es el que viene integrado con MediaWiki (una lista que se revisa regularmente y a la que cualquiera puede sugerir una adición).

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:

  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 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.

Véase también