Manual:Extensiones

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 56% complete.
Outdated translations are marked like this.

Las extensiones permiten personalizar cómo funciona y se ve MediaWiki.

While some extensions are maintained by MediaWiki developers, others were written by third-party developers. As a result, many have bugs, and they are not all guaranteed to be compatible with each other. Some are unmaintained; not all extensions work on all versions of MediaWiki. Utilice cualquier extensión, especialmente las etiquetadas como inseguras, bajo su propio riesgo. Si usted está usando una extensión que requiere parches al software central, asegúrese de guardar una copia de tu base de datos. Esto ayuda a evitar el riesgo de que su wiki se rompa.

Tipos de extensiones

Etiquetas del analizador

Parser tags extend the built-in wiki markup with additional capabilities, whether simple string processing, or full-blown information retrieval.

Parser functions

Parser functions are special wiki markup syntax that can 'interact' with other wiki elements in the page, and give a specific output.

Hooks

Hooks allow custom code to be executed when some defined event (such as saving a page or a user logging in) occurs.

Páginas especiales

Special pages are pages that are created by the software on demand to perform a specific function.

Skins

Skins allow users to customise the look and feel of MediaWiki.

Magic words

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.

API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.

Modelos de contenido de página

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.

Autenticación

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.

Finding extensions

Explorar extensiones

Puede explorar Category:Extensions by category 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 suya 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:

  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. Descarga 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. They generally go in their own subdirectory of $IP /extensions/. A list of extensions stored in the Wikimedia Git repository is located at git:mediawiki/extensions. Some extensions don't use version control and are not recommended.
    Some extensions are also available in bundles, composer or package repositories.
    It's recommended to read the README file before installation. It usually contains important info about configuration.
  3. Instale su extensión..
    Al final del archivo LocalSettings.php , añada:
    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).
    In this case they can be wrapped in the conditional so maintenance scripts can still run.
    if ( !$wgCommandLineMode ) {
       wfLoadExtension ( 'ExtensionName' );
    }
    
    The maintenance script importDump.php will fail for any extension which requires customised namespaces which is included inside the conditional above such as Extension:Semantic MediaWiki , Extension:Page Forms .
Ensure that required permissions are set for extensions!
While this installation procedure is sufficient for most extensions, some require a different installation procedure. Comprueba la documentación de su extensión para más información.
Si desea alterar las variables de configuración en LocalSettings.php, normalmente tiene 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. Descargue la nueva versión de la extensión
  1. Sustituya todos los archivos de la extensión en el directorio extension/NombreDeLaExtensión por los nuevos.

No borre la configuración de la extensión presente en LocalSettings.php

  1. 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. (Haga una copia de seguridad de tus datos antes de ejecutar el script). Si no dispone de acceso a la línea de comando, también puede usar el actualizador web.
Estas instrucciones cubren el 99% de las extensiones. Si la extensión concreta que está actualizando tiene instrucciones que difieran de estas, probablemente deba seguir las instrucciones de la extensión.

Desinstalar una extensión

Remueva la línea de LocalSettings.php con el nombre de la extensión para desinstalarla:

wfLoadExtension( 'ExtensionName' );
  • Debe remover cualquier línea pertinente a la configuración de la extensión.

Vea también