|||
-|-|-|
| Resumen | Discourse Authentication Validations permite añadir validaciones personalizadas a un Campo de Usuario para alternar la visualización de Campos de Usuario en el Modal de Registro.
| Enlace al Repositorio | https://github.com/discourse/discourse-authentication-validations
| Guía de Instalación | Cómo instalar plugins en Discourse
Acerca de
Discourse Authentication Validations añade la capacidad de añadir validaciones personalizadas a un Campo de Usuario.
Los Campos de Usuario Personalizados no tienen ningún tipo de validación proporcionada por el núcleo, aparte de detectar un valor vacío en un campo obligatorio. Este plugin añade la capacidad de definir una expresión regular (regex), por campo de usuario, que se comprobará contra el valor de entrada proporcionado.
Además, este plugin añade la capacidad de alternar la visualización de los Campos de Usuario en el Modal de Registro. Esto te permite «encadenar» Campos de Usuario, de modo que un Campo de Usuario solo se muestre si un Campo de Usuario anterior tiene un valor específico.
Configuración Básica
1. Habilitar Plugin
El plugin Discourse Authentication Validations se puede habilitar mediante el interruptor o desde sus ajustes, ambos accesibles desde tu página admin/plugins.
2. Añadir una validación personalizada a un Campo de Usuario
Después de habilitar el plugin Discourse Authentication Validations, verás una casilla de verificación Incluir validaciones personalizadas en la parte inferior de tu formulario de Campo de Usuario.
Cuando se marca, mostrará tres campos adicionales:
- Expresión regular de validación de valor
- Mostrar valores
- Campos de usuario de destino
Añadir una Validación Personalizada
Incluye una expresión regular válida en el campo Expresión regular de validación de valor:
El valor del campo de usuario en el formulario de registro se probará ahora contra la expresión regular que hayas incluido. En caso de que la entrada no cumpla los estándares de tu Regex personalizada, el formulario de registro no se enviará.
Sin valor (depende de la validación de formulario predeterminada)
Valor incorrecto
Valor correcto
Encadenamiento de Campos de Usuario
En primer lugar, incluye un valor de Mostrar valores en un Campo de Usuario.
Cuando un Campo de Usuario tiene un valor de Mostrar valores incluido, observará el valor de la entrada adjunta hasta que el valor de la entrada coincida con CUALQUIERA de los mostrar valores. Luego alternará la visibilidad de cualquier Campos de usuario de destino incluido, haciéndolos visibles.
En segundo lugar, añade un valor de Campos de usuario de destino.
En el menú desplegable Campos de usuario de destino, verás una lista de todos los Campos de usuario disponibles. Cualquier Campo de usuario que selecciones tendrá su visibilidad alternada por los valores correspondientes en Mostrar valores.
Encadenamiento Avanzado
Puedes encadenar Campos de Usuario añadiendo validaciones personalizadas a múltiples Campos de Usuario.
Por ejemplo, digamos que tenemos tres Campos de Usuario con los valores dados:
| Nombre | ¿Tiene Validación Personalizada? | Mostrar Valores | Campos de Usuario de Destino |
|---|---|---|---|
| Entrada Uno | true | mostrar-campo-dos | Entrada Dos |
| Entrada Dos | true | mostrar-campo-tres | Entrada Tres |
| Entrada Tres | false |
La Entrada Dos y Tres estarán ocultas por defecto ya que son «hijas» de la Entrada Uno. Cuando el valor a mostrar de mostrar-campo-dos se añade a la Entrada Uno, la Entrada Dos se mostrará, pero la Entrada Tres seguirá oculta. Permanecerá oculta hasta que la Entrada Dos tenga el valor de mostrar-campo-tres.
Con la combinación correcta de Mostrar Valores y Clases de Destino puedes anidar infinitamente Campos de Usuario uno debajo de otro.
