Plantilla:Formulario

Documentación de la plantilla

Utiliza esta plantilla para crear formularios que pueden crear páginas o agregar contenido a páginas existentes.

Parámetros

General

Los siguientes parámetros controlan el comportamiento general del formulario:

plantilla - ¡Requerido! Nombre de la plantilla que procesará y formateará los datos enviados. Si no desea utilizar una plantilla (o si desea utilizar varias plantillas), puede crear una plantilla destinada a ser sustituida y establezca subst:Tu plantilla como el valor de este parámetro.
página — Nombre de la página donde se publicarán los datos. Si la página no existe, se creará. Si la página existe, se agregarán los datos al final. Si se omite, se utilizará la página actual. Si el valor de este parámetro contiene una cadena como "{{{x}}}", será reemplazada con el valor del campo llamado "x". Esto permite crear títulos de páginas dinámicamente, combinando texto predefinido con valores de campos.
sección — Nombre de la sección donde se publicarán los datos. Si la sección no existe, se creará. Si la sección existe, se adjuntarán los datos. Si se omite, los datos se agregarán al final de la página. Si el valor de este parámetro contiene una cadena como "{{{x}}}", será reemplazada con el valor del campo llamado "x". Esto permite crear títulos de secciones dinámicamente, combinando texto predefinido con valores de campos.
redirigir — Nombre de la página a la que se redirigirá al usuario una vez publicados los datos. Utilice el mismo valor que página para redirigir al usuario a la página donde se publicaron los datos. Agregue '#' y el valor de sección para redirigir al usuario a la sección exacta donde se publicaron los datos. Utilice el nombre de la página actual para recargar la página después de publicar los datos. También redirigir a los usuarios a una página preparada especialmente, con un mensaje de agradecimiento y más instrucciones, por ejemplo. Si el valor contiene una cadena como "{{{x}}}", se reemplazará con el valor del campo denominado "x". Si se omite, se mostrará en su lugar un simple mensaje de éxito definido por enviado (ver más abajo).
grupo — Grupo de usuarios al que se le permite completar el formulario, por ejemplo 'user' o 'sysop'. Si se omite, se permiten todos los grupos de usuarios.
ajuste-renglón=sí — Causa que la plantilla se agregue al final de la página o sección sin saltos de línea.

Campos

Los siguientes parámetros controlan los campos del formulario:

campoN (reemplazando N por un número del 0 al 99): nombre del campo. Este también será el nombre del parámetro introducido en la plantilla. Si desea utilizar parámetros anónimos, simplemente nómbrelos usando números (por ejemplo campo1 = 1 ). Si no se definen campos, la plantilla se inyectará sin parámetros.
campoN-etiqueta — Etiqueta del campo.
campoN-estilo — CSS adicional del campo (aplica solo al elemento mas exterior).
campoN-ayuda — Texto de ayuda del campo.
campoN-valor — Valor predeterminado del campo.
campoN-ejemplo — Marcador de posición del campo.
campoN-requerido — Si el campo es obligatorio. Cualquier valor significa que sí.
campoN-desactivado — Si se debe desactivar el campo. Cualquier valor significa que sí.
campoN-tipo — Tipo de campo. Los valores admitidos son:
- texto — Úselo para entradas de texto sin formato. Este es el tipo de campo predeterminado. Utilice campoN-valores , campoN-valores-desde-búsqueda para sugerir valores.
- contenido — Úselo para entradas de texto de varias líneas.
- número — Úselo para ingresar números. Utilice campoN-min y campoN-max para limitar los números permitidos.
- checkbox — Úselo para entradas de casillas de verificación múltiples. Úselo campoN-valores para configurar las casillas de verificación. Si solo necesita una casilla de verificación, considere usarla boolean en su lugar.
- dropdown - Úselo para menús desplegables. Se utiliza campoN-valores para establecer los valores permitidos. Si campoN-requerido no está configurado, se incluirá una opción vacía adicional, utilizándola campoN-ejemplo como etiqueta.
- radio — Úselo para entradas de selección de radio. Se utiliza campoN-valores para establecer los valores permitidos. Si campoN-requerido no está configurado, se incluirá una opción vacía adicional, utilizándola campoN-ejemplo como etiqueta.
- booleano - Úselo para entradas booleanas. Las entradas booleanas se representan como una única casilla de verificación. Si la casilla de verificación está marcada, campoN-valor se publicará el valor de , o "1" si no se establece ningún valor. Si la casilla de verificación no está marcada, no se publicará ningún valor. Úselo campoN-selected para controlar el estado inicial de la casilla de verificación.
- oculto — Úselo para entradas ocultas.
campoN-valores — Lista de valores separados por comas. Relevante para campos de tipo "texto", "checkbox", "dropdown" y "radio".
campoN-valores-desde-búsqueda — Búsqueda a partir de la cual sugerir valores. Utilice %s para representar el valor escrito por el usuario y consulte mw:Help:CirrusSearch para conocer otras opciones de búsqueda. Por ejemplo, "incategory:Agua" sugerirá títulos en la Categoría:Agua, mientras que "%s incategory:Agua" buscará en dicha categoría el valor escrito por el usuario.
campoN-opciones — Lista de opciones (etiquetas para los valores) separadas por comas. Relevante para campos de tipo "texto", "checkbox", "dropdown" y "radio".
campoN-min — Valor mínimo para campos del tipo "número".
campoN-max — Valor máximo para campos del tipo "número".
campoN-selected — Estado inicial de los campos del tipo "booleano".

Mensajes

Los siguientes parámetros controlan los mensajes del formulario:

enviar — Texto del botón de enviar. El valor predeterminado es "Enviar".
enviado — Texto a mostrar cuando los datos se envíen correctamente. El valor predeterminado es "El formulario fue enviado, ¡gracias!"
error — Texto a mostrar si se produce un error desconocido al enviar los datos. El valor predeterminado es "¡Algo salió mal!"

Ejemplos

Simple

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

Cargando...

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-etiqueta = ¿Qué tan bueno te parece el artículo?
| campo2-tipo = número
| campo2-min = 1
| campo2-max = 5
| campo3 = problema
| campo3-etiqueta = ¿Cuál crees que es el principal problema?
| campo3-tipo = radio
| campo3-valores = Faltan referencias, Falta información, Es confuso
| campo4 = comentario
| campo4-etiqueta = Puedes dejar un comentario libre a continuación:
| campo4-tipo = contenido
}}

Cargando...

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-etiqueta = Puedes dejar un comentario libre a continuación:
| campo3-tipo = contenido
}}

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

MediaWiki:Gadget-WikiForm.js - JavaScript de esta plantilla
Módulo:WikiForm - 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 (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.