Plantilla:Formulario

Documentación de la plantilla

Utiliza esta plantilla para crear formularios que agregan contenido a páginas.

Parámetros

plantilla — Requerido. Nombre de la plantilla que el formulario utilizará para procesar y dar formato a los datos. Si no quieres utilizar una plantilla (o si quieres utilizar varias plantillas), puedes crear una plantilla destinada a ser sustituida y establecer subst:Ejemplo como valor de este parámetro.
página — Nombre de la página donde el formulario publicará los datos. Si la página no existe, se creará. Si se omite, se utilizará la página actual. Se pueden utilizar palabras mágicas, como {{TALKPAGENAME}}
sección — Nombre de la sección donde el formulario publicará los datos. Si la sección no existe, se creará. Si la sección existe, se agregarán los datos al final de la sección. Si se omite, los datos se agregarán al final de la página. Se pueden utilizar palabras mágicas, como {{CURRENTYEAR}}
campoN (reemplazando N por un número del 0 al 99) — Nombre del campo. Este será el nombre del parámetro introducido en la plantilla. Si quieres utilizar parámetros anónimos, simplemente nómbrelos con números (campo1 = 1).
campoN-tipo — Tipo del campo. Los valores admitidos son:
- texto — Este es el tipo de campo predeterminado normal. Sirve para entradas de texto básicas.
- contenido — Sirve para entradas de texto de varias líneas.
- radio — Permite seleccionar una de varias opciones, definidas en campoN-opciones.
- oculto — Oculta la entrada y la etiqueta. Sirve para entradas ocultas.
- sección — Oculta la entrada pero no así la etiqueta. Sirve para crear secciones dentro del formulario.
campoN-etiqueta — Etiqueta del campo.
campoN-ejemplo — Marcador de posición del campo. Sirve para ejemplificar o dar alguna indicación del tipo de datos a completar.
campoN-obligatorio — Si el campo es obligatorio. Cualquier valor significa que sí.
campoN-valor — Valor por defecto del campo.
campoN-opciones — Opciones del campo, separadas por comas. Solo aplica al tipo de campo "radio".
campoN-estilo — CSS extra del campo.
enviando — Texto para mostrar mientras se envían los datos. El valor predeterminado es "Enviando...".
enviado — Texto para mostrar cuando se envían los datos. El valor predeterminado es "Enviado, ¡gracias!".
enviar — Texto del botón para enviar los datos. El valor predeterminado es "Enviar".
estilo — Estilo CSS adicional del formulario.
clase — Clase CSS adicional del formulario.
id — ID del formulario. Útil para enlazarlo.

Ejemplos

Simple

{{Formulario
| plantilla = Reporte
| página = Wikipedia:Reportes
| campo1 = artículo
| campo1-etiqueta = Artículo
| campo2 = comentario
| campo2-tipo = contenido
| campo2-etiqueta = Comentario
}}

Artículo

Puedes dejar un comentario libre a continuación:

Este formulario requiere JavaScript.

Enviar

Cada vez que este formulario se envíe, se agregará al final de la página Wikipedia:Reportes un nuevo llamado a la Plantilla:Reporte, conteniendo los datos ingresados al formulario. Es decir, se agregará algo como lo siguiente:

{{Reporte
| artículo = Ciencia
| comentario = Falta una sección sobre la relación entre ciencia y tecnología.
}}

En cuanto a la hipotética Plantilla:Reporte, su contenido podría ser el siguiente:

; Artículo
: [[{{{artículo}}}]]
; Comentario
: {{{comentario}}}

En cuyo caso el output visible sería:

Artículo: Ciencia
Comentario: Falta una sección sobre la relación entre ciencia y tecnología.

Intermedio

{{Formulario
| plantilla = Reporte
| página = Wikipedia:Reportes
| sección = Reportes 2022
| campo1 = artículo
| campo1-etiqueta = Artículo
| campo2 = evaluación
| campo2-tipo = estrellas
| campo2-etiqueta = ¿Qué tan bueno te parece el artículo?
| campo3 = problema
| campo3-etiqueta = ¿Cuál crees que es el principal problema?
| campo3-tipo = radio
| campo3-opciones = Faltan referencias, Falta información, Es confuso
| campo4 = comentario
| campo4-tipo = contenido
| campo4-etiqueta = Puedes dejar un comentario libre a continuación:
}}

Artículo

¿Qué tan bueno te parece el artículo?

¿Cuál crees que es el principal problema?

Faltan referencias

Falta información

Es confuso

Puedes dejar un comentario libre a continuación:

Este formulario requiere JavaScript.

Enviar

Este segundo formulario es similar al primero, pero con dos campos adicionales y con el parámetro "sección" especificando que la Plantilla:Reporte se debe agregar al final de la sección "Reportes 2022" de la página Wikipedia:Reportes (si la sección no existe, se creará).

En cuanto a la Plantilla:Reporte, su contenido podría ser:

; Artículo
: [[{{{artículo}}}]]
; Evaluación
: {{{evaluación}}} sobre 5
; Principal problema
: {{{problema}}}
; Comentario
: {{{comentario}}}

Avanzado

{{Formulario
| plantilla = subst:Reporte
| página = Wikipedia:Reportes
| campo1 = artículo
| campo1-etiqueta = Artículo
| campo2 = problema
| campo2-etiqueta = ¿Cuál crees que es el principal problema?
| campo2-tipo = radio
| campo2-opciones = Faltan referencias, Falta información, Es confuso
| campo3 = comentario
| campo3-tipo = contenido
| campo3-etiqueta = Puedes dejar un comentario libre a continuación:
}}

Este tercer ejemplo es similar a los anteriores, pero el uso del prefijo "subst:" antes del nombre de la plantilla causará que sea sustituida. Entonces, si su contenido es el siguiente:

== [[{{{artículo}}}]] ==
; Principal problema
: {{{problema}}}
; Comentario
: {{{comentario}}}

Esto tendría como resultado la creación de una nueva sección en Wikipedia:Reportes por cada vez que se envía el formulario, donde el título de la sección será el contenido del campo Artículo, y el resto de la sección estará dado por el resto de los campos.

Véase también

Plantilla:Formulario/styles.css - CSS de esta plantilla
MediaWiki:Gadget-Form.js - JavaScript de esta plantilla
Módulo:Form - Módulo Lua de esta plantilla

Esta documentación está transcluida desde Plantilla:Formulario/doc.
Los editores pueden experimentar en la zona de pruebas (editar) y en los casos de prueba (editar) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.