Form Manager

¿Cómo incorporo Form Manager a mi web?

Form Manager puede incorporarse a cualquier formulario de la web, de forma bastante sencilla. La única limitación son los formularios generados dinámicamente (por ejemplo, por plugins de Wordpress), que pueden requerir la intervención de un programador si se quieren adaptar de manera correcta. Por lo demás, un webmaster puede montar y adaptar los formularios de la web de forma sencilla siguiendo las instrucciones que indicamos a continuación.

Para integrar Form Manager en la web, sólo hay que realizar esta llamada en las páginas que contienen los formularios

<script type="text/javascript" src=“https://minervasf.es/fm/fm.js"></script>

 

¿Cómo configuro Form Manager?

A la hora de adaptar un formulario, deberemos integrar los atributos especiales de FM para que pueda tomar el control del mismo y manejar todos los aspectos de la validación, requisitos, envío, respuesta, etc...

Para integrar FM en un formulario, deberemos modificar el formulario hasta que aparezca como en este ejemplo:

<form data-form="form1">
...
</form>

Así asignamos un nombre al formulario que luego podemos usar en la interfaz de usuario de Form Manager para distinguir entre los distintos formularios de nuestra web. Además del atributo data-form, podemos integrar cualquier elemento de estilo como "class" o "style", pero no es necesario incluir ningún atributo como "method", "enctype", "action", etc… Esos atributos serán en muchos casos gestionados por Form Manager para funcionar correctamente, con lo que no es necesario utilizarlos en un formulario integrado.

Dentro del formulario podemos añadir los campos que necesitemos para recabar la información de los usuarios. En las siguientes secciones veremos como configurar cada elemento, así como los atributos de configuración de los formularios. El único atributo obligatorio en un formulario, no obstante, es "data-form", como se ve en el ejemplo, para dar nombre al formulario integrado.

 

¿Debo incluir un botón de envío en el formulario?

Debería integrarse un botón de envío para que Form Manager sepa cuando enviar el formulario. El botón puede tener cualquiera de estas dos formas:

<button type="submit">Enviar</button>

<input type="submit" value="Enviar" />

Luego es posible dar el formato que se desee al botón (por ejemplo, con forma de enlace).

 

¿Cuáles son los parámetros de configuración de un formulario?

A continuación indicamos los parámetros de configuración de los formularios integrados:

<form data-form="[nombre del formulario]"
    data-form-email="[correo electrónico de envío de datos]"
    data-form-success-event="[evento al obtener una respuesta correcta del servidor]"
    data-form-success-msg="mensaje que aparece cuando el formulario es enviado con éxito"
    data-form-error-event="[evento que se ejecuta si el envío de datos falla]"
    data-form-error-msg="mensaje que aparece cuando falla el envío del formulario"
    data-form-msg="mensaje que se muestra preguntando al usuario si desea enviar el formulario"
    data-form-event="[evento que se ejecuta cuando haberse validado el formulario]"
    data-form-msg-error="mensaje que se muestra cuando la validación ha fallado">

Como se ha indicado, el único parámetro obligatorio es "data-form", y define qué formularios se integran además de indicar su nombre. Si un formulario no contiene este parámetro no es afectado por Form Manager. Todos los demás parámetros son opcionales. Si se desea que el formulario se envíe por correo además de almacenarse (en la capa gratuita no se almacenan los datos, con lo que deben ser enviados por correo) debe indicarse obligatoriamente "data-form-email". Los atributos de evento (terminados con "-event") permiten llamar a código Javascript propio de la web realizando una llamada directa a una función como en este ejemplo:

data-form-success-event="success()"

En el caso del evento "data-form-event", puede llamarse directamente a una función o bien controlar si debe enviarse el formulario de la siguiente manera:

data-form-event="return mustSubmit()"

Si la función devuelve "true" el formulario se enviará, y si devuelve "false" se bloqueará el envío del formulario.

Los atributos de mensaje (-msg) son mostrados en ventanas de alerta del navegador.

 

¿Qué tipos de elementos admite Form Manager?

Form Manager almacena todos los tipos de elementos de formulario estándar. Para que un elemento sea almacenado deberá contener el atributo “name” como es normal.

 

¿Qué tipos de datos valida Form Manager?

Input text, input checkbox, input file, select, datalist y textarea.

 

¿Cuáles son los parámetros de configuración de los controles de datos?

A continuación indicamos la lista completa de parámetros que podemos usar en los controles para su configuración y validación (excepto que se indique lo contrario, los parámetros tienen la misma finalidad en todos los controles de formulario):

<input|select|datalist|textarea data-form-required="true|false"
    data-form-validate="true|false"
    data-form-format="text|number|integer|natural|float|email|date"
    data-form-msg-invalid="mensaje que aparece si el campo no cumple los requisitos de validación" />

data-form-required y data-form-msg-invalid son comunes a todos los tipos de campos. data-form-validate y data-form-format sólo aplican a campos de tipo "input".

Los formatos admitidos por los campos de texto son los siguientes:

- text: texto plano convencional.
- number: número de cualquier tipo (se admiten signos guión, coma y punto).
- integer: números enteros positivos y negativos.
- natural: números enteros sólo positivos.
- float: números decimales.
- email: direcciones de correo electrónico.
- date: fechas (en cualquier formato).

 

¿Puedo incluir otros parámetros en los controles de formulario?

Sí, pueden añadirse los parámetros clásicos: "name" (obligatorio para identificar el campo), "size" (tamaño del texto), "type" (tipo de control), etc...

Si se desea, puede agregarse a los campos "select" una opción vacía que sirva de control para obligar a los usuarios a seleccionar una opción:

<select name="opciones" multiple>
    <option value="" selected>Seleccione una opción</option>
    <option value"…">...</option>
</select>

 

Si no indico mensajes, ¿Form Manager visualiza mensajes en mi lugar?

Ciertos mensajes pueden ser mostrados por Form Manager si no son indicados en los parámetros. Actualmente están codificados los mensajes en inglés y español. Esta es la matriz de mensajes actual de Form Manager:

var langStrings = {

    "en": {

        "inputTextRequiredError": "Required item '{0}' hasn't value. Please review it.",

        "inputCheckboxRequiredError": "Required item '{0}' isn't checked. Please review it.",

        "inputFileRequiredError": "Required item '{0}' hasn't a file. Please review it.",

        "inputFileMaxSizeError": "Required item '{0}' is larger than the allowed size (500 KB). Please review it.",

        "inputValidationError": "Item value for '{0}' is not valid. Please review it.",

        "inputFileTotalMaxSizeError": "Total file sizes can't larger than the allowed max total size (1 MB). Please review it."

    },

    "es": {

        "inputTextRequiredError": "El elemento requirido '{0}' no tiene valor asignado. Por favor revíselo.",

        "inputCheckboxRequiredError": "El elemento requirido '{0}' no está marcado. Por favor revíselo.",

        "inputFileRequiredError": "El elemento requirido '{0}' no tiene un archivo. Por favor revíselo.",

        "inputFileMaxSizeError": "El elemento requirido '{0}' contiene un archivo más grande del tamaño permitido (500 KB). Por favor revíselo.",

        "inputValidationError": "El valor del elemento para '{0}' no es válido. Por favor revíselo.",

        "inputFileTotalMaxSizeError": "El tamaño total de los archivos no puede ser mayor que el tamaño total permitido (1 MB). Por favor revíselo."

    }

};

Si se desea, pueden incluirse más idiomas a la colección respetando los nombres de los tipos de mensajes como se indica en el código anterior:

langString["fr"]["inputTextRequiredError"] = "L'élément requis '{0}' n'a pas de valeur assignée. S'il vous plaît vérifier.";

langString["fr"]["inputCheckboxRequiredError"] = "L'élément requis '{0}' n'est pas marqué. S'il vous plaît vérifier.";

langString["fr"]["inputFileRequiredError"] = "L'élément requis '{0}' n'a pas de fichier. S'il vous plaît vérifier.";

langString["fr"]["inputFileMaxSizeError"] = "L'élément requis '{0}' contient un fichier plus grand de la taille autorisée (500 KB). S'il vous plaît vérifier.";

langString["fr"]["inputValidationError"] = "La valeur de l'élément pour '{0}' n'est pas valide. S'il vous plaît vérifier.";

langString["fr"]["inputFileTotalMaxSizeError"] = "La taille totale des fichiers ne peut pas être supérieure à la taille totale autorisée (1 Mo). S'il vous plaît vérifier.";

Es importante respetar los elementos entre llaves ({0}) ya que se vuelcan datos que deben aparecer en el mensaje.

 

Una vez enviado el formulario, ¿qué ocurre?

Antes de enviar el formulario se valida comprobando los campos obligatorios y su formato. Si todo está correcto, se procede a enviar el formulario para ser guardado.

Si se ha indicado una dirección de correo al configurar el formulario, los datos del formulario son enviados a la dirección indicada (debe ser una dirección correcta y el servidor de destino no debe encontrarse en listas negras de correo). En el caso de las capas de pago, se almacena el mensaje en nuestros servidores listo para ser utilizado por el administrador de formularios tal y como se indica en la documentación enviada al contratar Form Manager. Si el envío resultara erróneo por el motivo que sea, se indicará la razón en la consola del navegador, pudiendo el webmaster depurar los posibles problemas que puedan darse.

 

¿Cuanto tiempo se almacenan los formularios?

Los formularios almacenados en la capa de pago se guardan durante el plazo de legal de 5 años a no ser que el administrador de formularios lo elimine antes.

 

¿Qué límites tiene el envío de archivos?

La capa de pago con archivos permite enviar los archivos que se quieran, pero con la limitación de 500 KB por archivo y 1 MB de datos totales entre todos los archivos.

 

¿Qué tipo de archivos se pueden enviar?

De cualquier tipo.