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 rellenar al crear temas, de modo que puedas asegurar que los usuarios proporcionan toda la información que deseas o necesitas para ayudarlos, como para informes de errores, solicitudes de características, etc.
Nota: Para plantillas que funcionen 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 gestionar plantillas de formulario yendo a Admin > Apariencia > Plantillas de formulario (/admin/customize/form-templates).
Para crear una plantilla de formulario:
- Haz clic en Nueva Plantilla.
-
Actualiza el campo Nombre de la Plantilla con un nombre interno para tu plantilla.
-
Utiliza los botones en la parte superior de la página para los distintos campos de tu formulario y actualiza los atributos de los campos (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 introducir contenido directamente en una versión mini del compositor. Esto es ideal para cuando los miembros necesitan introducir Markdown directamente, como código, o necesitan otro formato compatible con el editor enriquecido.
-
-
Añade las validaciones deseadas a tus entradas. Haz clic en el botón Validación para una clave (también se muestra a continuación).
-
Haz clic en el botón Vista previa para asegurarte de que todo se vea bien.
-
Haz clic en Guardar.
Atributos de campo
Atributos comunes para todos los tipos de campo:
label: El nombre visible del campoplaceholder: Texto de ayuda que se muestra en los campos vacíos (entrada, área de texto, menú desplegable, selección múltiple)description: Contexto o instrucciones adicionales mostradas debajo del campo.
Atributos específicos de subida:
file_types: Lista separada por comas de extensiones de archivo permitidas (ejemplo:.jpg,.png,.pdf)allow_multiple: Booleano que indica si los usuarios pueden subir varios archivos
Atributos de menú desplegable y selección múltiple:
none_label: Texto mostrado cuando no se selecciona ninguna opciónchoices: Array de opciones disponibles
Atributos del selector de grupo de etiquetas:
tag_group: (propiedad de nivel superior del campo) El nombre del grupo de etiquetas para poblar las opcionesnone_label: Texto mostrado cuando no se selecciona ninguna opciónmultiple: Booleano que indica si los usuarios pueden seleccionar varias etiquetas (el andamiaje predeterminado lo establece entrue)
Opciones de validación
| Clave | Tipo | Descripción |
|---|---|---|
required |
booleano | Requiere que se complete el campo 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, password) |
Añadir plantillas de formulario a una categoría
Después de crear una plantilla:
- Navega a la categoría donde deseas usar la plantilla.
- Haz clic en el botón
para editar la categoría.
- Activa el botón Configuración avanzada (si usas el nuevo diseño de categoría simplificado).
- Ve a la pestaña Plantilla.
- Activa el interruptor Plantilla de formulario.
- Selecciona la plantilla de formulario en el menú desplegable.
- 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 rellenar con precisión cada campo, verán un error de validación.
Rellenar previamente los valores del formulario
Los campos del formulario se pueden rellenar previamente utilizando parámetros de URL que coincidan 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 rellenados.