Creación de plantillas de formularios

[lindsey (Lindsey Fogle)]

Esta guía explica cómo usar plantillas de formulario para estructurar contenido en Discourse.

Nivel de usuario requerido: Administrador

Las plantillas de formulario te permiten crear formularios estructurados con reglas de validación que los usuarios pueden completar al crear temas para que puedas asegurar que los usuarios proporcionen toda la información que deseas o necesitas para ayudarlos, como para informes de errores, solicitudes de funciones, etc.

Nota: Para plantillas que funcionan más como pautas en lugar de un formulario estructurado, considera usar plantillas de tema.

Habilitar plantillas de formulario

Puedes activar las plantillas de formulario en Próximos cambios configurando Habilitar plantillas de formulario en “Todos”.

Creación de plantillas de formulario

Puedes crear y administrar plantillas de formulario yendo a Admin > Apariencia > Plantillas de formulario (/admin/customize/form-templates).

Para crear una plantilla de formulario:

1. Haz clic en Nueva Plantilla.

2. Actualiza el campo Nombre de la Plantilla con un nombre interno para tu plantilla.

3. Usa los botones en la parte superior de la página para los diversos campos de tu formulario y actualiza los atributos del campo (detallados a continuación). Muchas de las opciones son tipos de campo de formulario estándar (por ejemplo, casilla de verificación, respuesta corta, menú desplegable, etc.), pero hay algunos campos específicos:

   • Selector de grupo de etiquetas: Los usuarios pueden seleccionar una o más etiquetas de un grupo en particular.

   • Respuesta Markdown: Los usuarios pueden agregar contenido directamente en una versión en miniatura del compositor. Esto es ideal para cuando los miembros necesitan ingresar Markdown directamente, como código, o necesitan otro formato compatible con el editor enriquecido.

4. Agrega las validaciones deseadas a tus entradas. Haz clic en el botón Validación para una clave (también se muestra a continuación).

5. Haz clic en el botón Vista previa para asegurarte de que todo se vea bien.

6. Haz clic en Guardar.

Atributos de campo

Atributos comunes para todos los tipos de campo:

• label: El nombre visible del campo
• placeholder: Texto de ayuda que se muestra en campos vacíos (entrada, área de texto, desplegable, selección múltiple)
• description: Contexto o instrucciones adicionales que se muestran debajo del campo.

Atributos específicos de carga:

• file_types: Lista separada por comas de extensiones de archivo permitidas (ej. .jpg, .png, .pdf)
• allow_multiple: Booleano que indica si los usuarios pueden cargar varios archivos

Atributos de menú desplegable y selección múltiple:

• none_label: Texto que se muestra cuando no se selecciona ninguna opción
• choices: Arreglo de opciones disponibles

Opciones de validación

| Clave | Tipo | Descripción |
|----|----|----|
| required | booleano | Requiere que el campo se complete para enviar el formulario. |
| minimum | entero | Para campos de texto, especifica el número mínimo de caracteres permitidos. |
| maximum | entero | Para campos de texto, especifica el número máximo de caracteres permitidos. |
| pattern | regex; cadena | Para campos de texto, una expresión regular que especifica la entrada permitida. |
| type | cadena | Para campos de entrada, puedes especificar el tipo de entrada que se debe esperar (text, email, date, number, url, tel, color |

Agregar plantillas de formulario a una categoría

Después de crear una plantilla:

1. Navega a la categoría donde deseas usar la plantilla.
2. Haz clic en el botón para editar la categoría.

3. Activa el botón Configuración avanzada (si usas el nuevo diseño de categoría simplificado).
4. Ve a la pestaña Plantilla.
5. Activa el interruptor Plantilla de formulario.
6. Selecciona la plantilla de formulario en el menú desplegable.
7. Haz clic en Guardar categoría.

Cuando se asignan varias plantillas a una categoría, los usuarios verán un selector de plantillas al crear temas.

Experiencia del miembro

Creación de temas con plantillas de formulario

Cuando un miembro crea un tema en una categoría con plantillas de formulario, el formulario aparece automáticamente en el compositor. Si se aplican varias plantillas a la misma categoría, los miembros pueden elegir la plantilla correcta en un menú desplegable. Si los usuarios intentan crear un tema sin completar con precisión cada campo, verán un error de validación.

Rellenar valores de formulario previamente

Los campos del formulario se pueden rellenar previamente utilizando parámetros de URL que coinciden con los ID de campo. Por ejemplo: /new-topic?software-version=2.4.1&severity=Critical

Esto es útil para enlazar a la creación de temas con ciertos campos ya completados.