Plantilla:Extensión

This page is a translated version of the page Template:Extension and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎galego • ‎italiano • ‎magyar • ‎norsk bokmål • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎македонски • ‎русский • ‎українська • ‎հայերեն • ‎العربية • ‎فارسی • ‎کوردی • ‎मराठी • ‎हिन्दी • ‎বাংলা • ‎ไทย • ‎မြန်မာဘာသာ • ‎中文 • ‎日本語 • ‎粵語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎조선말 • ‎한국어
Template documentation

Esta plantilla tendría que ser añadida a todas páginas de extensión en este wiki (pero sólo la página principal). Añada un útil infobox (ve abajo) y automáticamente añadirá la extensión a $1, junto con el apropiado estado y tipo de implementación categorías.

Uso

Copia y pasta:

{{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             =
|table1               = 
|table2               = 
|license              = 
|download             = 
|readme               = 
|changelog            = 
|example              = 
|namespace            = 
|parameters           = 
|tags                 = 
|rights               = 
|compatibility        = 
|bugzilla             = 
|phabricator          =
|vagrant-role         = 
}}
Para ayuda con valores de parámetro, ve abajo.
Extensión matemática MediaWiki
OOjs UI icon advanced.svg
{{{name}}}
Estado de lanzamiento se desconoce
Placeholder.png
Implementación {{{type1}}}, {{{type2}}}
Descripción {{{description}}}
Autor(es) SomeAuthor (SomeUsertalk)
Última versión {{{version}}} ({{{update}}})
Latest preview version {{{version preview}}} ({{{update preview}}})
Política de compatibilidad Nulo
MediaWiki {{{mediawiki}}}
PHP {{{php}}}
Cambios de la base de datos {{{needs-updatephp}}}
Composer {{{composer}}}
Tablas [[Special:MyLanguage/Template:Extension/{{{table1}}} table|{{{table1}}}]][[:Template:Extension/{{{table1}}} table| ]]
[[Special:MyLanguage/Template:Extension/{{{table2}}} table|{{{table2}}}]][[:Template:Extension/{{{table2}}} table| ]]
Licencia {{{license}}}
Descarga {{{download}}}
{{{readme}}}
{{{changelog}}}
Ejemplo {{{example}}}
{{{namespace}}}
{{{parameters}}}
{{{tags}}}

{{{rights}}}

{{{compatibility}}}
Traduce el Extension extensión si es disponible en translatewiki.net
Función de vagabundo {{{vagrant-role}}}
Asuntos [[phab:tag/{{{phabricator}}}|Tareas abiertas]] · Reportar un bug

Parámetros de contenido

Esta sección describe parámetros que gobierna infobox contenido. Para ayuda con templatemode y otros parámetros de control, complacer ver parámetros de Control.

Parámetros de contenido
Parámetro Descripción
nameNombre de la extensión
statusEstado de liberación actual

Uno de:

  • unstable - Roto - no utiliza esta extensión
  • experimental - Etapas tempranas de desarrollo, puede cambiar drásticamente
  • beta - Estable pero no plenamente probó
  • stable - Versión estable
  • unmaintained - unmaintained - Anteriormente reclamado para ser estable, ahora unmaintained
  • archive - archived - deprecated O fusionado con otra extensión
  • unknown - default

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:

  • parser - catchall Para uncategorized parser extensiones. Si has escrito un parser extensión, complacer uso uno del siguiendo tipos más concretos:
  • access - catchall Para User access extensions , aquello es, extensiones que crea, autentica, permisos de subvención, revocar permisos, o controlar la actividad de usuarios. Si has escrito una extensión de acceso, complacer uso uno del siguiendo tipos más concretos:
    • user activity - Extensiones que actividad de usuario del monitor (logins, logouts, creación de usuario nuevo, etc.)
    • user identity - Extensiones que crea y eliminar usuarios, y/o verificar la identidad de un usuario
    • user rights - Extensiones al sistema de administración de los derechos, p. ej. cambia a los derechos de manera están asignados, API, herramientas de mantenimiento (no incluye extensiones que meramente nombrar los derechos necesitaron utilizar las características de aquella extensión; para este propósito utiliza el parámetro de derechos)
  • interface - catchall Para uncategorized extensiones de interfaz del usuario.
    • media - Extensiones que permiso el embedding de contenido multimedia en wiki páginas por registrar una extensión de archivo con $wgMediaHandlers .
    • mywiki - Extensiones que proporciona infraestructura de modo que los usuarios pueden personalize su MediaWiki experiencia y/o asistir en la administración de aquella infraestructura
    • notify - Extensiones que usuarios de email, mensajes de emisión y proporcionar otras formas de notificación comunitaria
    • page action - Extensiones que realza o modificar page action s. Esto incluye cualquier cosa aquello implementa una acción que lee, escribe, busca, crea, rebautiza, elimina, redirige o habla una página. No incluye derechos (uso user rights) o registros (uso user activity).
    • search - Extensiones que búsqueda a través de y seleccionar páginas para usuarios.
    • skin - Las extensiones que añaden CSS o de Javascript, o implementando funciones de gancho para cambiar la mirada y sentir de MediaWiki vía el marco de pieles.
    • ajax - Extensiones que uso Ajax programando técnicas.
    • special - Extensiones que subclase el SpecialPage clase, uso uno de sus ganchos, o remiendo un o más funciones en SpecialPage.php. Ve Special pages para más información.
  • other
    • api - Extensiones que añade un nuevo API módulo o extender un núcleo API módulo.
    • hook - Extensión de gancho - define un gancho nuevo - ver gancho1, etc. abajo si quieres definir los ganchos utilizaron por vuestra extensión
    • database - Añade mesas y/o campos a la base de datos que respalda un MediaWiki instalación
    • data extraction - Extracción de dato
    • filerepo - Extensión que añade repositorio de archivo nuevo escribe tan archivo backend
    • example - No una extensión real, pero un ejemplo de cómo para escribir uno

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 construido-en ganchos:

  • Uso el nombre de gancho sólo. Complacer ver Manual:Hooks para valores (pero omitir introductorio '/').

Para los ganchos hechos de encargo definieron por extensiones:

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.
usernameEl 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.
authorEl 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).
descriptionDescripción breve
imagescreenshot o logotipo de extensión. Tenga que ser proporcionado sin namespace y sin [[]]s.
imagesizefacultative, medida de la imagen (default la medida es 220px)
versionÚltima versión
updateFecha de la última actualización
compatibility policypolítica de compatibilidad (aceptado valora es $2, $3, y ltsrel). (backlog )
mediawikiVersión requerida de MediaWiki
phpVersió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:

cd path/to/wiki_install_directory
cd maintenance
php update.php
$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..
composerSi aplicable el nombre del "vendedor" así como el "paquete" tendría que ser introducido en el formato vendor/packageo, p. ej. mediawiki/semantic-media-wiki para señalar personas directamente a packagist.org, el cual sirve como el archivo de paquete.
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.
licenseLa 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.
downloadEnlace a la descarga : Git, {{WikimediaDownload/es}}.
repoNombre 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.
readmeEnlace externo al readme archivo, p. ej. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README
changelogEnlace externo al changelog archivo, p. ej. Extension:LDAP Authentication/Changelog
parametersParámetros disponibles para LocalSettings.php
tagsCualesquier etiquetas vuestros usos de extensión (p. ej. $etiquetas).
rightsderechos 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 !
namespacenamespace en qué esta extensión está utilizada
exampleEjemplo, sitio web o screenshot de extensión laborable
compatibilityInformación de compatibilidad adicional, para gráficos de compatibilidad del caso (anteriormente utilizando Template:Extension Testing). 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.
translatePará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:
  • ext-LOWERCASE(NOSPACES(Etiqueta cuando definido en $archivo)), aka
  • El parámetro entras el URL después de que
bugzillaBugzilla MediaWiki Nombre de componente de la extensión
phabricatorPhabricator Nombre de proyecto
CheckUsageNameOverrideoverride El nombre de página utilizado para el enlace de uso del control.

Parámetros de control

Parámetros de control
Parámetro Descripción
templatemodeCoche de controles-categorización de página anfitriona.

Espacio dejado normalmente. Alterna los valores son:

  • nocats - Suprime categorización y el 'uso de control' enlace. Uso este valor si estás añadiendo esta plantilla a subpages de una extensión o a qué-a documentación de extensiones. Por ejemplo, la imagen de uso por encima de conjuntos templatemode=nocats porque esto no es una página de extensión real y nosotros no quieren añadir esta página a cualesquier categorías en gracia a él.
  • nousage - Suprime el 'uso de control' enlace. El enlace es también suprimido si la página es un subpage; no es en la Extensión: namespace; o si suprimido por 'templatemode=nocats'
Si esto queda espacio, esta plantilla añadirá la página anfitriona a Category:All extensions/es y a un o categorías más adicionales, según los valores asignaron al Contenido de la ancla.

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:

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:

Para cambiar el comportamiento de los parámetros de gancho:

Caso de prueba

Ver si las páginas siguientes son quietas vale, después de que editó esta plantilla.

TemplateData

Maintenance: vulnerabilities, archived