Saltar al contenido principal

Resumen

Un formulario es una lista de preguntas que los miembros responden desde un panel en Discord o desde su propia página en la web. Cada respuesta llega como una tarjeta a un canal de revisión, con Aceptar, Rechazar y Abrir hilo. Aceptar o rechazar puede dar y quitar roles, le envía un MD al miembro y se escribe en el registro. Úsalo para postulaciones al staff, solicitudes de partner, inscripciones a eventos, apelaciones de baneo que no están ligadas a una sanción (para esas, mira Apelaciones), o cualquier pregunta que quieras que se responda en orden.
!form es un comando de prefijo (alias !forms, !application, !applications). Crear y cambiar formularios necesita Gestionar servidor. Revisar necesita Gestionar servidor o uno de los roles revisores del formulario. El dashboard tiene lo mismo en Formularios.

Configura un formulario en cinco pasos

1

Créalo

!form create staff Postulación al staff crea un formulario llamado staff con el título que ven los miembros (45 caracteres). Un formulario nuevo está cerrado hasta que lo abras.
liam escribe !form create staff con el título y Petto responde que el formulario staff se creó, que está cerrado por ahora y qué hacer después

En Discord: un formulario creado, cerrado hasta que se abra.

2

Agrega las preguntas

!form question add staff short ¿Cuántos años tienes? agrega una pregunta al final. Mira Preguntas para los tipos y las opciones.
liam escribe !form question add staff short ¿Cuántos años tienes? y Petto responde que se agregó la pregunta 1 (texto corto)

En Discord: la primera pregunta agregada.

3

Elige el canal de revisión

!form set staff channel #postulaciones es donde llegan las tarjetas. Un formulario sin canal de revisión no se puede abrir.
liam escribe !form set staff channel #solicitudes y Petto responde que se guardó channel de staff

En Discord: el canal de revisión elegido.

4

Ábrelo

!form open staff deja que los miembros lo respondan.
liam escribe !form open staff y Petto responde que el formulario está abierto y los miembros pueden llenarlo desde su panel

En Discord: el formulario abierto.

5

Publica un panel

!form panel #postular staff publica un botón que abre el formulario. Un panel puede abrir varios formularios: !form panel #postular staff partner --style select crea un menú en vez de botones, y --web yes agrega un botón de enlace Llenar en la web.
liam escribe !form panel #postulaciones staff partner; Petto publica la tarjeta con los botones Postularme y Solicitud de alianza y responde Panel publicado con el enlace

En Discord: un panel con un botón para cada formulario.

El panel con el menú Elige un formulario para llenar abierto: Postularme y Solicitud de alianza, cada uno con su descripción

En Discord: el mismo panel con --style select.

Comandos

liam escribe !form list: staff, partner y game-night con su título, estado, preguntas y respuestas pendientes

En Discord: los formularios del servidor.

liam escribe !form close partner y Petto responde que está cerrado y que sus paneles lo dicen

En Discord: un formulario cerrado.

liam escribe !form delete game-night y Petto responde que se borró y que las respuestas se guardan

En Discord: un formulario borrado; lo que enviaron los miembros se guarda.

form es el nombre o el número de un formulario. El número es de tu servidor: el primer formulario que haces en él es el número 1, sin importar lo que tengan otros servidores. Un form que es una palabra se escribe en minúsculas, con letras, números, - y _. Los nombres cortos también funcionan: !form new, !form edit (para set), !form q add, !form subs, !form approve, !form reject, !form show y !form newlink. !formconfig muestra la tarjeta del módulo con todos los ajustes a la vez.
liam escribe !formconfig: la retención, los tres formularios con su estado y su canal de revisión, y todos los comandos de formularios

En Discord: la tarjeta del módulo de formularios.

Preguntas

Cada pregunta también puede tener:
  • required: si hace falta una respuesta (sí por defecto).
  • help: una línea debajo de la pregunta, hasta 100 caracteres. Discord la muestra debajo del campo.
  • description: un texto más largo, hasta 1,000 caracteres, con negrita, cursiva y enlaces. La página web lo muestra completo; Discord muestra su comienzo cuando no hay línea de help.
  • image: una imagen sobre la pregunta en la página web, un enlace https a un archivo .png, .jpg, .gif o .webp.
  • placeholder: el texto gris en el campo vacío.
  • min y max: el largo de un texto, o el rango de un número.
  • options: para choice y multi, separadas por |.
Ejemplo
liam escribe !form question edit staff 6 description con negrita y un enlace y Petto responde que la pregunta 6 cambió

En Discord: una descripción con negrita y un enlace.

liam escribe !form question move staff 3 1 y Petto responde que la zona horaria ahora es la pregunta 1

En Discord: una pregunta movida al principio.

liam escribe !form question remove staff 4 y Petto responde que se quitó la pregunta de los días

En Discord: una pregunta quitada.

liam escribe !form questions staff: las seis preguntas con su tipo, si son obligatorias, los rangos y opciones, y que se responden en 2 páginas

En Discord: las preguntas de un formulario, en orden.

En Discord, las preguntas se muestran en páginas de cinco, con Siguiente entre ellas. Una respuesta incorrecta (un número fuera de su rango, por ejemplo) se vuelve a ofrecer con lo que escribió el miembro.
El formulario de Discord con las primeras cinco preguntas respondidas: un nombre, una edad, una zona horaria, los días y Sí

En Discord: la primera página de un formulario de seis preguntas.

Petto responde solo al miembro que se guardó la página 1 de 2, con los botones Siguiente y Parar

En Discord: la página 1 guardada, Siguiente abre la página 2.

Petto responde que algunas respuestas necesitan arreglo: la edad necesita un número de 13 a 99, con los botones Corregir mis respuestas y Parar

En Discord: una edad fuera de su rango se ofrece de nuevo.

Petto responde solo al miembro que las respuestas se enviaron (#13) y que un MD traerá el resultado

En Discord: la última página envía el formulario.

Ajustes

!form set <form> <setting> <value> cambia un ajuste. none (u off) lo borra.
liam escribe !form set staff color #ff91c2 y Petto responde que se guardó color de staff

En Discord: un ajuste cambiado.

liam escribe !form set staff colour y Petto responde con todos los ajustes que se pueden cambiar

En Discord: un ajuste que Petto no conoce muestra los que sí conoce.

Petto nunca intenta dar un rol por encima del suyo ni uno gestionado por una app: en cambio lo indica en la tarjeta.

Mensajes al miembro

!form message <form> <kind> <text> cambia lo que se le dice al miembro:
  • submitted: cuando se envían las respuestas.
  • accepted y denied: el MD con el resultado.
Un MD de Petto: las respuestas en Petto Land fueron aceptadas, con la razón debajo

En Discord: el MD de una respuesta aceptada, con la razón.

Como todo MD de Petto, este empieza con una línea gris De <servidor> y tiene botones de info, borrar y reportar: mira MD de Petto. El texto acepta {form} (el título), {number}, {server}, {status} y {reason}, y también las variables de siempre, así que {user} menciona al miembro. Una razón vacía simplemente desaparece. reset vuelve al predeterminado. En su lugar se puede usar un embed guardado con --template <name>, que acepta {form.name}, {form.title}, {form.number}, {form.status} y {form.reason}. Mira Embeds.
Ejemplo
liam escribe !form message staff accepted con un texto que usa {user} y Petto responde Mensaje guardado

En Discord: el MD de las respuestas aceptadas, cambiado.

liam escribe !form message staff submitted y Petto muestra el mensaje que lee el miembro al enviar

En Discord: sin texto, el mensaje que se usa.

Revisar

Cada tarjeta tiene todas las respuestas (las respuestas largas se cortan en la tarjeta y van completas en un archivo), la antigüedad de la cuenta y cuándo entró el miembro, y los botones:
  • Aceptar y Rechazar (con una razón opcional que lee el miembro). Se dan y se quitan los roles del formulario, el miembro recibe un MD y la categoría forms del registro recibe una línea.
  • Abrir hilo abre un hilo debajo de la tarjeta para hablar sobre la respuesta.
La tarjeta de la respuesta 12 del formulario Postulación al staff, enviada por la web, que menciona a Moderadores, con cada respuesta y los botones Aceptar, Rechazar, Abrir hilo y Panel web

En Discord: una postulación al staff tal como llega al canal de revisión.

El formulario Aceptar #12 con una razón opcional que el miembro lee en el MD

En Discord: Aceptar pide una razón opcional.

La tarjeta de la respuesta 12 ahora verde: aceptada por kira con la razón y +Ayudantes, los botones apagados; Petto responde solo a kira que se aceptó

En Discord: la tarjeta, aceptada, y la respuesta a quien revisó.

kira escribe !form accept 12 con una razón y Petto responde que la respuesta 12 de mia.draws se aceptó, Roles: +Ayudantes

En Discord: una respuesta aceptada con un comando.

kira escribe !form deny 10 con una razón y Petto responde que la respuesta 10 de jellybean se rechazó

En Discord: una respuesta rechazada con una razón.

Cuando una respuesta se acepta o se rechaza (desde la tarjeta, !form accept|deny o el dashboard), el hilo de la tarjeta recibe un último mensaje con el resultado, la razón y quién decidió, y se bloquea y archiva. No se menciona a nadie.
En el hilo de la respuesta 12 Petto escribe que kira la aceptó y que el hilo se cerró, con la razón

En Discord: el último mensaje del hilo de una respuesta aceptada.

!form submissions [form] [status] lista lo que llegó (pendientes por defecto; también accepted, denied, cancelled o all), y !form view <number> vuelve a mostrar una tarjeta con sus botones.
kira escribe !form submissions: 12, 11 y 10, pendientes, con quién las envió, el formulario, cuándo y un enlace a cada tarjeta

En Discord: las respuestas que esperan al staff.

kira escribe !form view 12 y Petto muestra la tarjeta de la respuesta 12 con todas las respuestas, pendiente, y los botones Aceptar, Rechazar, Hilo y Panel web

En Discord: una tarjeta mostrada de nuevo con sus botones.

La página web

Cada formulario también tiene su propia página en la web, activada por defecto. El miembro inicia sesión con Discord, ve el título, la descripción y todas las preguntas, y envía las respuestas. Pasan por las mismas revisiones que en Discord (roles, antigüedades, límites) y llegan como la misma tarjeta, que dice que se envió en la web. La página habla el idioma del servidor.
  • !form info <form> da el enlace, petto.sbs/form/<id>, donde el id son 12 letras y números al azar (/es/form/<id> y /pt-br/form/… lo abren en español o portugués). Pegado en Discord u otras apps, muestra una vista previa con el título, la descripción y el banner del formulario. Los enlaces antiguos petto.sbs/form#… y petto.sbs/f/… siguen funcionando.
  • Los enlaces son al azar, así que nadie puede adivinarlos. !form relink <form> crea uno nuevo, y el anterior deja de funcionar al instante. Los paneles publicados antes conservan el enlace anterior, así que publícalos de nuevo.
  • !form set <form> web off deja un formulario solo en Discord.
liam escribe !form info staff: el enlace en la web, el aspecto de la página, el canal y los roles de revisión, quién puede llenarlo, qué pasa después de la revisión y los números

En Discord: todo sobre un formulario, con su enlace.

La página web del formulario de postulación al staff de Petto Land, con sus primeras preguntas

La página de un formulario en petto.sbs, con el fondo animado aurora (Premium).

La página lleva el aspecto del formulario:
Ejemplo
  • Color: el acento de la página (botones, enlaces, números).
  • Banner: una imagen arriba (un enlace https a un .png, .jpg, .gif o .webp).
  • Fondo: default (el de Petto), solid (un tono del color) o gradient. Con Premium también hay dos animados, aurora y waves, hechos con el color del formulario; se mueven despacio y se quedan quietos para los visitantes cuyo dispositivo pide menos movimiento.
  • Ícono del servidor y nombre del servidor en el encabezado; cada uno se puede ocultar.
  • Marca: con Premium, !form set <form> branding off oculta la pequeña línea “Formularios por Petto” al final de la página.
Los fondos animados y branding off son las únicas partes Premium de los formularios. Cuando Premium termina, la página vuelve a mostrar el degradado normal y la línea, y nada más cambia. En el dashboard, el editor del formulario tiene una sección Página web con las mismas opciones, el enlace con Copiar y Nuevo enlace, y una vista previa en vivo de la página y de la pestaña del navegador.
La sección Página web con el enlace del formulario, el fondo animado Aurora y una vista previa de la página

La sección Página web del editor del formulario: el enlace, el banner, el fondo y lo que muestra el encabezado.

La sección Vista previa del enlace cambia cómo se ve el enlace cuando se pega: su propio título, descripción, imagen y color lateral, y una opción para mostrar la imagen en pequeño. Los campos vacíos usan el título, la descripción, el banner y el color del formulario. Discord guarda una vista previa por un tiempo, así que un enlace pegado antes de un cambio todavía puede mostrar la anterior.
La sección Vista previa del enlace con un título, una descripción, un color lateral y la vista previa en Discord

La sección Vista previa del enlace, con la tarjeta que muestra Discord cuando se pega el enlace.

Almacenamiento y límites

Todos los servidores tienen los mismos límites para los formularios, con o sin Premium: hasta 25 formularios de hasta 25 preguntas, y 2,000 respuestas guardadas. Cuando un servidor está lleno, sus respuestas revisadas más antiguas dejan espacio; las respuestas que siguen pendientes nunca se borran. !form retention <days> (de 1 a 365, 30 por defecto) dice cuánto tiempo se guardan las respuestas de los envíos revisados. Después de eso solo queda una fila pequeña: el formulario, el miembro, el estado, quién lo revisó, las fechas y el enlace a la tarjeta.
liam escribe !form retention 60 y Petto responde que las respuestas revisadas se guardan 60 días, con cuántas hay guardadas

En Discord: cuánto tiempo se guardan las respuestas revisadas.

Dashboard

El editor del formulario de postulación al staff con su vista previa

El editor del formulario: lo básico a la izquierda y una vista previa del panel y del formulario de Discord a la derecha.

Dashboard → Formularios tiene tres páginas:
  • Formularios: crea y edita formularios, sus preguntas (con la descripción y la imagen), las reglas, los roles, los mensajes y la página web.
  • Respuestas de formularios: las respuestas por formulario y estado, con un buscador, y Aceptar y Rechazar.
  • Paneles de formularios: publica un panel con botones o un menú.
La página Formularios con dos formularios abiertos y la inscripción a la noche de juegos cerrada, cada uno con sus respuestas pendientes y Editar, Cerrar o Abrir y Duplicar

Dashboard → Formularios → Formularios: los formularios del servidor.

La página Respuestas de formularios en Pendientes con las respuestas 12, 11 y 10, los filtros y la tarjeta Almacenamiento con 24 de 2000 guardadas y 30 días

Dashboard → Formularios → Respuestas de formularios: las respuestas pendientes y el almacenamiento.

La página Paneles de formularios con el formulario Publicar un panel y dos paneles publicados, en #postulaciones y #general

Dashboard → Formularios → Paneles de formularios: publicar un panel y los paneles publicados.

Los miembros con un rol al que se le dio acceso a la parte de Comunidad del dashboard también pueden usar esta página; mira Acceso a la dashboard.

Problemas comunes

El formulario no tiene canal de revisión. Pon uno con !form set <form> channel #channel.
Debajo del panel Petto responde solo al miembro que el formulario no está listo porque el staff no eligió adónde van las respuestas

En Discord: un miembro presiona el botón de un formulario sin canal de revisión.

El formulario está cerrado. Ábrelo con !form open <form>. !form panel te recuerda qué formularios del panel están cerrados.
Debajo del panel Petto responde solo al miembro que el formulario está cerrado

En Discord: un miembro presiona el botón de un formulario cerrado.

Al formulario se le cambió el enlace. Usa el enlace nuevo de !form info, y publica los paneles de nuevo.
El rol está por encima del rol más alto de Petto o lo gestiona una app. Sube el rol de Petto por encima; mira Problemas de permisos.
kira acepta la respuesta 12 y Petto responde que no pudo cambiar el rol Admin, que está por encima del suyo

En Discord: un rol por encima del de Petto no se da.