Plantilla:Extensión
![]() | This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
![]() | Uses Lua: |
![]() | This template uses TemplateStyles: |
Esta plantilla debería añadirse a todas las páginas de extensión de este wiki (pero solo la página principal). Añadirá una ficha útil (véase a continuación) y añadirá automáticamente la extensión a Categoría:Todas las extensiones , junto con las categorías estado y tipo de implementación correspondientes. It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
Uso
Copia y pega: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |virtual domain = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}Para ayuda con valores de parámetro, consulta más adelante. |
|
Parámetros de contenido
Esta sección describe parámetros que gobiernan el contenido de la ficha. Para ayuda con templatemode y otros parámetros de control, véase Parámetros de control.
Parámetro | Descripción |
---|---|
name | nombre de la extensión |
status |
estado de la versión actual Uno de los siguientes:
Si el estado no es ninguno de los anteriores, se ignorará y en cambio se mostrará en la plantilla el valor predeterminado de 'Desconocido'. En caso de que el valor esté omitido, se categorizará como desconocido. En caso de que el valor no sea válido, se le asignará una categoría especial para que se pueda detectar y corregir el error. |
type1 type2 type3 type4 type5 type6 | tipo de implementación
La(s) estrategia(s) de implementación empleada(s) para construir esta extensión. Este parámetro se utiliza para crear categorías que ayuden a los programadores a encontrar ejemplos de diversas estrategias o patrones de implementación específicos de MediaWiki. Aunque los valores de este parámetro a veces coinciden con el caso de uso o propósito de una extensión, no es la razón para utilizar este parámetro. Si los valores que has escogido para este parámetro no identifican adecuadamente el propósito o posibles casos de uso, recomendamos que añadas los enlaces de categoría adicionales que necesites. Los valores permitidos para los parámetros type1, type2, etc. son:
Cualquier otro valor para type no será válido, y hará que la extensión se incluya en Category:Extensions with invalid or missing type/es. Nota: Muchas extensiones tienen más de un tipo; si es el caso de la tuya, reemplaza|type= por |type1=|type2=|type3=... . Puedes definir hasta seis tipos para una misma extensión. |
hook1 hook2 hook3 hook4 ... |
nombre de los ganchos utilizados por la extensión
Introducir valores en este campo es una buena forma de conseguir exposición para tu extensión y ayudar a otros desarrolladores. Cada gancho documentado añadirá automáticamente la extensión a una categoría que contenga las extensiones que utilizan ese gancho. Esta categoría autoenlaza a las distintas páginas de ganchos de modo que los programadores puedan encontrar fácilmente ejemplos de extensiones que utilicen un gancho particular. Para más de un gancho, asigna el primer gancho a hook1, el segundo a hook2, etc. |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
nombre de cada gancho proporcionado por la extensión Puede que también desees añadir los ganchos a Extension hook registry. |
username | El nombre de usuario del autor en Mediawiki.org (en caso de que tenga). Se puede omitir, pero si está presente se utilizará para enlazar a su página de usuario y a la página de discusión asociada. Se debe proporcionar sin espacio de nombres y sin [[]]. |
El nombre del autor de la extensión, si es distinto de su nombre de usuario de Mediawiki.org. Texto libre. Si se omite, se utilizará el campo 'username' (si está presente). | |
description | descripción breve |
image | Captura de pantalla o logotipo de la extensión. Se debe proporcionar sin espacio de nombres y sin [[]]. |
imagesize | Facultativo, tamaño de la imagen sin añadir px, por ejemplo, 360 (el tamaño por defecto es 300px) |
version | Última versión |
update | Fecha de la última actualización |
version preview | Versión de vista previa |
update preview | Fecha de la última actualización de la versión de vista previa |
compatibility policy | Política de compatibilidad (valores admitidos: master, main, rel, ltsrel). (tareas pendientes ) |
mediawiki | Versión requerida de MediaWiki La mayoría de las extensiones no deberían tener que utilizar esto; el valor por defecto será el valor de la propiedad 'requires' de extension.json. Véanse también Category:Extensions without MediaWiki version y Category:Extensions with manual MediaWiki version . |
php | Versión requerida de PHP |
needs-updatephp |
$no indica que la extensión no necesita que se ejecute update.php.
Para evitar ambigüedades, este parámetro debe indicarse de forma explícita para no asumir que la falta de Las extensiones que cumplan con las normas de las extensiones de MediaWiki incluyen un script de modificación de esquema que deberás ejecutar a mano (una vez) antes de arrancar y acceder a MediaWiki a través de tu navegador, y después de haber copiado todos los archivos de la extensión a
$IP son las siglas de Installation Path, es decir, la ruta o directorio donde se ha instalado MediaWiki, el mismo directorio que contiene LocalSettings.php , index.php , etc.. |
composer | El nombre del paquete de la extensión para Composer, en el formato estándar. Se incluirá automáticamente si está configurado en el archivo «composer.json» de la extensión (es decir, en ese caso, no será necesario indicar el parámetro). Enlazará a la página de la extensión en Packagist. |
virtual domain | El dominio de la base de datos virtual utilizado por la extensión. |
table1 table2 table3 table4 ... table30 | nombre de las tablas no pertenecientes al núcleo utilizadas por la extensión Enlaza a una subpágina de la página de tu extensión. Por ejemplo, «table1 = cu_changes» en Extension:CheckUser enlazará a Extension:CheckUser/cu_changes table . No incluyas tablas del núcleo tales como page o revision , sino solo las tablas añadidas por extensiones. |
license | La licencia que rige el uso de esta extensión; utilícese uno de los códigos encontrados en https://spdx.org/licenses/, p. ej. GPL-2.0-or-later , GPL-2.0-only o GPL-3.0-or-later , etc. |
download | enlace a la descarga : Git, {{WikimediaDownload/es }}. |
repo | Nombre del repositorio de Gerrit en el que está almacenado el código de la extensión, si es diferente del nombre de la página. Al definirlo, se establece automáticamente |download= , y se permite que la plantilla cargue datos automáticamente del archivo extension.json correspondiente. |
readme | enlace externo al archivo readme, p. ej. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | enlace externo al registro de cambios, p. ej. Extension:GeoGebra/Changelog |
help | Enlace a la ayuda de usuario para la extensión. If not provided, will look for Help:Extension:ExtensionName . Si se proporciona, se deberá incluir el enlace completo en wikitexto (dado que puede que desees enlazar, por ejemplo, a una página externa). |
example | Ejemplo, sitio web o captura de pantalla de la extensión en funcionamiento |
namespace | espacio de nombres en que se utilice esta extensión |
parameters | Parámetros disponibles para LocalSettings.php |
Etiquetas utilizadas por tu extensión (p. ej. <tag1>, <tag2>). | |
rights | Derechos añadidos por la extensión. ¡No confundir con la licencia! Ejemplos de derechos son makebot o desysop , y no GFDL o LGPL o GPL - ¡estas últimas son licencias! |
compatibility | Información adicional de compatibilidad, por ejemplo, diagramas de compatibilidad. Se recomienda añadir asimismo cualquier información de compatibilidad del lado del cliente, especialmente en caso de que algún navegador no soporte determinadas funcionalidades. |
bugzilla | Nombre de componente de la extensión de MediaWiki en Bugzilla |
phabricator | Nombre de proyecto en Phabricator |
translate |
Parámetro opcional para enlazar a la página exacta donde (el identificador del grupo de mensajes con el cual) la extensión será traducible en translatewiki.net si está activado. Si el enlace predeterminado es incorrecto, establécelo a:
|
vagrant-role | rol de MediaWiki-Vagrant |
CheckUsageNameOverride | Redefine el nombre de la página utilizada para el enlace de control de uso. |
Parámetros de control
Parámetro | Descripción |
---|---|
templatemode |
Controla la autocategorización de la página anfitriona. Normalmente se deja en blanco. Los valores posibles son:
|
Utilizar la ficha
Páginas de extensión existentes
Si deseas añadir la ficha a una página existente, copia y pega el código de la parte superior de esta página.
Crear una página de extensión nueva
Si deseas crear una nueva página de extensión, introduce el nombre en la siguiente caja de texto y pulsa el botón. Se creará una página nueva con la plantilla de la ficha incorporada.
A developer sharing their code in the MediaWiki code repository should expect:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a Cuenta de desarrollador to continue maintaining it.
- Future versions by other developers
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
Extender esta plantilla
Si deseas mejorar esta plantilla, ¡gracias! Es una plantilla compleja, por lo que aquí presentamos algo de ayuda:
Botón «Crear extensión»
Para mejorar el comportamiento del botón «Crear extensión»:
- Template:Extension/Sample : El esqueleto de la extensión que se precargará en páginas recién creadas.
- Template:Extension/CreateExtensionInputBox : Una caja de texto que se puede insertar donde quieras que los usuarios puedan crear extensiones con facilidad. Para la documentación de la etiqueta
<inputbox>
, consulta Extension:InputBox .
Parámetros de la ficha
En general:
- Para hacer que esta plantilla sea fácil de utilizar, cada etiqueta de la ficha está enlazada a la documentación de los parámetros de la plantilla mostrados. Si añades un parámetro, asegúrate de añadirlo también a la documentación de parámetros de contenido y de enlazar su etiqueta a dicha documentación.
Para cambiar/corregir/añadir a los parámetros de implementación de tipos:
- Comprueba la página de discusión - ha habido largas discusiones sobre este asunto.
- Los tipos válidos y a qué enlazan se definen en Module:Extension
Para cambiar el comportamiento de los parámetros de gancho:
- Template:Extension/HookInUse: añade enlaces y categorías para un gancho en uso. Se puede implementar para varios ganchos llamando a esta plantilla con Template:Foreach.
- Template:Extension/HookInUseNoCats: utilizado en vez de Template:Extension/HookInUse cuando se utiliza esta plantilla en
templatemode=nocats
. Las plantillas utilizadas con Template:Foreach solo pueden tomar un parámetro, así que es necesario envolver la llamada a Template:Extension/HookInUse con otra plantilla que defina el modo.
Caso de prueba
Comprueba si las páginas siguientes siguen siendo válidas después de editar esta plantilla.
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Esta es la documentación de TemplateData para esta plantilla utilizada por VisualEditor y otras herramientas. Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived