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 tendría que ser añadida a todas las páginas de extensión en este wiki (pero sólo la página principal). Agregará una ficha útil (ver a continuación) y agregará 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, ve abajo. |
|
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 liberación actual Uno de:
Si el estado es cualquier cosa otro que el encima, sea ignorado y el default valor de 'Desconocido' será mostrado en la plantilla en cambio. En casos donde el valor está omitido, sea categorized cuando desconocido. En casos donde el valor es nulo, sea colocado en un categoría especial de modo que el error puede ser cogido y fijo. |
type1 type2 type3 type4 type5 type6 | Tipo de implementación
La estrategia de implementación(s) empleó en construir esta extensión. Este parámetro suele crear categorías que programadores de ayuda encuentran ejemplos de varios MediaWiki estrategias de implementación concreta o patrones. A pesar de que los valores de este parámetro a veces coincide con el caso de uso o propósito de una extensión, aquello no es razonar para este parámetro. Si los valores has escogido para este parámetro no adecuadamente identifica el de Requisitos o posible de caso de Usos, recomendamos que añades adicional enlaces de categoría cuando necesitó. Dejó valores para el tipo1, tipo2, ... Los parámetros son:
Cualquiera otro valor para 'tipo' es nulo, y causará la extensión para ser colocada en Category:Extensions with invalid or missing type/es. Nota: Muchas extensiones tienen más de uno escribe, si esto aplica al vuestro, reemplaza $tipo con $valor. Puedes definir hasta seis tipos para una extensión. |
hook1 hook2 hook3 hook4 ... |
Nombre de cada gancho utilizado por la extensión
Introduciendo los valores en este campo es una manera buena de conseguir exposición para vuestra extensión y ayudar otros desarrolladores. Cada cual el gancho documentado automáticamente añadirá la extensión a una categoría que lista extensiones que uso que gancho. Esta categoría es autolinked a cada página de gancho de modo que los programadores fácilmente pueden encontrar ejemplos de extensiones que uso un gancho particular. Para ganchos múltiples, asignar el primer gancho a gancho1, el segundo a gancho2 y tan encima. |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
Nombre de cada gancho proporcionado por la extensión También podrías querer añadir los ganchos a Extension hook registry. |
username | El nombre del usuario de autor en Mediawiki.org (si ellos tienen un). Puede ser omitido, pero si lo presenta #soler enlace a la página & de charla_de usuario de usuario del autor. Tenga que ser proporcionado sin namespace y sin [[]]s. |
El nombre del autor de extensión, si diferente de su Mediawiki.org nombre de usuario. Texto libre Si omitido entonces el 'username' el campo será utilizado (si presente). | |
description | Descripción breve |
image | screenshot o logotipo de extensión. Tenga que ser proporcionado sin namespace y sin [[]]s. |
imagesize | Facultative, 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 preliminar |
compatibility policy | Compatibility policy (accepted values: master, main, rel, ltsrel). (backlog ) |
mediawiki | Versión requerida de MediaWiki Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version . |
php | Versión requerida de PHP |
needs-updatephp |
$Sí indica que la extensión requiere una mesa de base de datos schema cambio o una acción similar, antes del MediaWiki puede correr. Es un común pitfall: vuestro MediaWiki parará, si olvidaste para correr actualización.php - Si la extensión lo requiere. $No tendría que ser puesto como valor desde este asegura que la extensión no necesita actualización.php Para ser corrido y así evita incertidumbre
Extensiones qué conformar a MediaWiki estándares de extensión venidos con un eschema guión de cambio que te necesidad de empezar manualmente' (una vez) antes de empezar y accediendo el MediaWiki a través de vuestro navegador, y después de que copiaste todos los archivos de extensión a $objetivo e insertado $código a «LocalSettings.php», corrido de la línea de orden:
$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 | The extension's Composer package name, in the standard format. It will be automatically included if set in an extension's "composer.json" file (i.e. this parameter is not required in that case). It will be linked to the extension's page on Packagist. |
virtual domain | The virtual database domain used by the extension. |
table1 table2 table3 table4 ... table30 | Nombre de cada no-núcleo la mesa utilizada por la extensión Enlaces a un subpage de vuestra página de extensión. Para caso, "$mesa1" en Extension:CheckUser enlazará a Extension:CheckUser/cu_changes table . No lista mesas de núcleo como $página o $revisión; la lista única somete aquello está añadido por extensiones. |
license | La licencia que gobierna uso de esta extensión, cuando uno de los códigos encontrados en https://spdx.org/licenses/, p. ej. $más tarde2, $sólo2 o $más tarde3, etc. |
download | Enlace a la descarga : Git, {{WikimediaDownload/es }}. |
repo | Nombre del Gerrit repositorio el código de la extensión está almacenado en, si diferente del nombre de página. Poniendo este automáticamente pone |download= , y deja la plantilla a automáticamente dato de carga del apropiado extension.json archivo. |
readme | Enlace externo al readme archivo, p. ej. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | Enlace externo al changelog archivo, p. ej. Extension:GeoGebra/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | Ejemplo, sitio web o screenshot de extensión laborable |
namespace | namespace en qué esta extensión está utilizada |
parameters | Parámetros disponibles para LocalSettings.php |
Cualesquier etiquetas vuestros usos de extensión (p. ej. $etiquetas). | |
rights | derechos añadió por la extensión. No para ser confundido con la licencia! Los derechos son como makebot o desysop , no como GFDL o LGPL o GPL - aquellos son licencias ! |
compatibility | Información de compatibilidad adicional, para gráficos de compatibilidad del caso. Está animado para añadir cualquier cliente-información de compatibilidad del lado aquí también, especialmente cuándo divergiendo de expectativas de soporte lleno para un navegador. |
bugzilla | Bugzilla MediaWiki Nombre de componente de la extensión |
phabricator | Phabricator Nombre de proyecto |
translate |
Parámetro opcional para enlazar la página exacta dónde (grupo de mensaje id con qué) la extensión será translatable en translatewiki.net si habilitó. Si el default el enlace es incorrect, manualmente puesto lo a:
|
vagrant-role | MediaWiki-Vagrant role |
CheckUsageNameOverride | override El nombre de página utilizado para el enlace de uso del control. |
Parámetros de control
Parámetro | Descripción |
---|---|
templatemode |
Coche de controles-categorización de página anfitriona. Espacio dejado normalmente. Alterna los valores son:
|
Utilizando el infobox
Existiendo páginas de extensión
Si quieres añadir el infobox a una página de existir, copia y pasta el código en el parte superior de esta página.
Crear una página de extensión nueva
Si tu quieres crear una página de extensión nueva, introducir el nombre abajo y clic el botón. Una página nueva será creada con el infobox plantilla ya en sitio.
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.
Realzando esta plantilla
Si te gustaría mejorar en esta plantilla, gracias! Esto es una plantilla complicada tan aquí es alguna ayuda a lo largo de la manera:
El Crear botón de extensión
Para mejorar el crear comportamiento de botón de la extensión:
- Template:Extension/Sample : El boilerplate extensión que es preloaded a nuevamente-creó páginas.
- Template:Extension/CreateExtensionInputBox : Una caja de entrada que puede ser insertado wherever quieres usuarios a fácilmente crear extensiones. Para documentación en el
<inputbox>
etiqueta, complacer ver Extension:InputBox .
Infobox Parámetros
En general:
- Para hacer esta plantilla fácil de utilizar, cada etiqueta en el infobox está enlazado a documentación en el parámetro de plantilla(s) muestra. Si añades un parámetro, complacer ser seguro a también añadirlo al parámetro de contenido documentación y enlazar su etiqueta a aquella documentación.
Para cambiar/correcto/añade a los parámetros de tipo de la implementación:
- Control el página de charla - ha habido algunas discusiones extensas sobre este campo.
- Los tipos válidos y qué enlazan a está definido 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. Los ganchos múltiples en uso están implementados por llamar esta plantilla con Template:Foreach.
- Template:Extension/HookInUseNoCats: Utilizado en vez de Template:Extension/HookInUse cuándo esta plantilla está utilizada en
templatemode=nocats
. Las plantillas utilizaron con Template:Foreach sólo puede tomar un parámetro así que necesitamos envolver la llamada a Template:Extension/HookInUse con otra plantilla que conjuntos el modo.
Caso de prueba
Ver si las páginas siguientes son quietas vale, después de que editó 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