Actions des formulaires

Qu'est ce qu'une action de formulaire ?

Une action d'un formulaire correspond au traitement des données saisies par l'utilisateur. Au moment ou l'utilisateur valide un formulaire, les informations saisies sont collectées et traitées selon des actions que vous pouvez définir.

Le module formulaire met à disposition des fonctions de traitement des données qui vous permette de gérer les données saisies sans aucune connaissance de développement particulière.

Modifier et ajouter des actions de formulaires

Pour modifier les actions d'un formulaire, c'est à dire la succession de traitement(s) réalisée à la soumission du formulaire, cliquez sur « Actions du formulaire », en regard du formulaire crée.

Plusieurs actions sont possibles et paramétrables.

Par défaut, plusieurs types d'actions sont présents. Libre à vous de les utiliser ou non.

Veillez à valider chaque type d'action individuellement.

Vous pouvez ajouter certaines actions et les cumuler aux existantes. L'envoi d'un email peut être répété autant de fois que nécessaire.

Dans les zones de texte, vous pouvez insérer des variables générales en respectant la syntaxe décrite dans la fenêtre d'actions.

L'une des actions permet d'authentifier l'utilisateur. Dans le cadre d'un site avec un espace à accès restreint, vous pouvez choisir de créer un formulaire qui authentifiera l'utilisateur et lui permettra d'accéder à une partie particulière du site.

Pour cela, il faut :

• activer l'option des paramètres Automne qui stipule que votre site utilise une authentification utilisateur. C'est ce qui permettra, sur l'ensemble des pages du site, de vérifier les droits de l'utilisateur courant en regard des élements qu'il tente de visualiser,
• avoir défini des utilisateurs et des droits. Il faut vérifier en particulier les droits de l'utilisateur « Public user » qui correspond à l'utilisateur non identifié. Seuls les utilisateurs possédant un compte Automne pourront s'authentifier par le biais de votre formulaire.

Enfin, votre formulaire doit contenir au minimum un champ permettant de saisir le login (champ de type Texte) et un champ permettant de saisir le mot de passe (champ de type Mot de passe). Vous pouvez également laisser à l'utilisateur le choix de se souvenir de son compte, auquel cas, il vous faudra également ajouter un champ de type booléen dans votre formulaire.

Ces champs doivent être identifiés ensuite dans les actions du formulaire. Automne liste l'ensemble des champs qui correspondent aux critères de type de champ pour chacun des champs nécessaires à l'authentification de l'utilisateur.

Mise en oeuvre dans Automne

L'ajout d'un formulaire dans une page génère l'inclusion à sa régénération du fichier /automne/templates/mod_cms_forms_header.php. Ce fichier sera traité en premier, c'est à dire avant l'affichage de la page qui inclue le formulaire.
C'est lui qui contient toutes les données de traitement souhaitées et définies dans les actions des formulaires.

Les formulaires générés par ce module utilise la méthode POST pour l'envoi des données et le fichier appelé dans la balise action est la page courante.

Exporter les données des formulaires

Dès que des formulaires auront été soumis en ligne, vous pourrez exporter le contenu de ces formulaires en .csv en cliquant sur le lien « Télécharger les données du formulaire au format CSV ».