Voir le texte source

Affichages

De Quickform.
Vous n’êtes pas autorisé à modifier cette page, pour la raison suivante :
Cette page a été protégée pour empêcher sa modification.
Vous pouvez voir et copier le contenu de la page pour pouvoir travailler dessus :
<table style="width:100%; background:#CCCC00;">
<tr>
<td>[[Fonctionnement général|<< Fonctionnement général]]</td>
</tr>
</table>
== Gestion des formulaires ==
Nous allons maintenant aborder la création d'un formulaire. La démarche est relativement simple et une aide au coeur même du paramétrage vous permet de vous aider de façon rapide. Toutefois un nombre de précisions considérables sont apportées tout au long de cette notice. merci donc de concilier les deux afin de prendre en main au mieux le composant.
Un formulaire se crée en 3 étapes :
<blockquote>
* Création et paramétrage du formulaire
[[Image:Fomulaire etape.jpg|center]]
* Génération de la table
* Création des champs liés au formulaire
</blockquote>
<blockquote>
[[Image:Menu_forms.jpg‎|center]]
</blockquote>
Voici la barre de menu que vous trouvez dans la section gestion des formulaires. Cette barre est assez simple de compréhension, mais mérite toute votre attention car elle pourra vous aider avec quelques fonctionnalités que vous ne soupçonnez pas:
<blockquote>
* '''Nouveau''' vous permet de créer un nouveau formulaire
* '''Editer''' vous permet de modifier un formulaire existant
* '''Copier''' vous permet de copier un formulaire complet avec sa table et ses champs
* '''Supprimer''' supprime juste le formulaire mais conserve les champs et la table
* '''Définitif''' supprime complètement le formulaire, y compris ses champs et la table de stockage. Si vous utilisez cette option, '''attention''' d'être sûr de vous, car il n'y a aucun recours possible pour récupérer le formulaire et les données après.
* '''Reconstruire''' vous permet d'optimiser et réparer les tables au sens de MYSQL, mais également de mettre à jour tous les formulaires, et de supprimer les entrées ACL supprimées de la table ACL mais toujours existante dans votre formulaire.
* '''Publier''' vous permet de publier un ou plusieurs formulaires en même temps
* '''Dépublier''' vous permet de dépublier un ou plusieurs formulaires en même temps
* '''Paramètres''' vous permet définir les options générales e l'ensemble du composant composant
</blockquote>


=== Paramétrage d'un formulaire  ===

<blockquote>
==== Configuration générale  ====
[[Image:Fomulaire_config.jpg|center]]
La configuration générale est la partie la plus importante du formulaire. C'est elle qui détermine l'ensemble du formulaire, son identité, son existence, sa table, sa publication. Au travers d'une mise en page simple il vous est demandé de compléter et déterminer :
<blockquote>
{{List|le nom du formulaire|}}
{{List|la description du formulaire|Celle ci est affichée dans la mise en page si vous le paramétré. Elle peut contenir du code HTML ainsi que les [[Fonctionnement_général#Les_variables|les variables QuickForm]]. }}
{{List|les accès aux formulaires|Ceux ci sont attribués en fonction d'une liste de groupes d'utilisateurs. Pour sélectionner plusieurs groupe, maintenez la touche '''ctrl''' enfoncée et cliquez sur les accès souhaités. }}
{{List|la publication du formulaire|}}
{{List|une date et horaire de début|Le formulaire ne s'affiche pas tant que la date n'est pas atteinte. Laisser vide si vous ne voulez pas donner de limite de début.}}
{{List|une date et horaire de fin|Le formulaire ne s'affiche plus une fois la date dépassée. Laisser vide si vous ne voulez pas donner de limite de fin.}}
{{List|une table mysql|Cette option n'apparait que lors de la création et vous donne le choix entre ''créer une nouvelle table'' ou ''utiliser une ancienne table non affectée''(orpheline).}}
</blockquote>

==== Redirection et message de succès après soumission  ====
[[Image:Fomulaire_remerciement.jpg|center]]
A la fin de l'enregistrement des données par un utilisateurs, vous aurez très certainement envie d'afficher un message de succès d'enregistrement des données, ou bien de rediriger automatiquement l'utilisateur vers une page de votre choix. Pour se faire, vous devez vous rendre dans '''Message de remerciement''' ou vous pourrez déterminer :
<blockquote>
* '''une redirection automatique'''
* '''un lien vers lequel sera redirigé l'utilisateur'''. Automatiquement, si vous avez mis oui précédemment, ou manuellement en cliquant sur ''Terminer'', si vous avez mis non. A noter que ce lien peut contenir [[Fonctionnement_général#Les_variables|des variables QuickForm]]. 
<blockquote>
'''Exemple'''
<pre>index.php?option=com_quickform&view=quickdetails&forms=1&tod=1&rel={id:value}</pre>
Redirige vers une page d'affichage : forms=1 détaillée : tod=1 qui contient les données soumises : rel={id:value}
</blockquote>
* '''un message de félicitations'''. Ce message peut être au format texte, HTML et contenir [[Fonctionnement_général#Les_variables|les variables QuickForm]] afin d'afficher les résultats soumis précédemment ou encore l'identité de l'utilisateur connecté ayant soumis les données.
<blockquote>
'''Exemple (Texte par défaut)'''
<pre>&lt;b&gt;Merci à vous {$my-&gt;name} {$my-&gt;username},&lt;/b&gt;

Vos données ont bien été enregistrées. Un email
de confirmation vous a également été envoyé. 
Merci de ne pas y répondre.

Pour saisir de nouvelles données, cliquez sur continuer, 
sinon sur terminer.
</pre>
</blockquote>
</blockquote>

==== Envoi de mail lors de la soumission  ====
Une fois les données enregistrées, vous avez la possibilités d'envoyer deux emails différents à une ou plusieurs adresse de votre choix. Il est important de noter que chacun des champs de paramétrage peut accueillir [[Fonctionnement_général#Les_variables|les variables QuickForm]], permettant ainsi de récupérer des données venant d'être saisie par l'utilisateur. Le paramétrage de ces deux emails est identique et définis comme suit&nbsp;: 
<blockquote>
* '''De la part de '''. Adresse de l'expéditeur.
<blockquote>'''Exemple''' (Depuis un champ votreadresse du formulaire)
<pre>{votreadresse:value}</pre>
</blockquote> 
* '''Nom'''. Nom visible de l'expéditeur, généralement le nom du site. 
* '''Envoyer à'''. Liste d'adresses séparées pat des ','. Cette liste peut contenir aussi bien une adresse pré établie, qu'une adresse déterminée depuis un champ du formulaire.
<blockquote>'''Exemple n°1''' - Adresse unique
<pre>quickform@quickform.fr</pre>
'''Exemple n°2''' - Depuis un champ votreadresse du formulaire 
<pre>{votreadresse:value}</pre> 
'''Exemple n°3''' - Liste d'adresses
<pre>quickform@quickform.fr,{votreadresse:value},noreply@quickform.fr</pre>
</blockquote> 
*'''Objet'''. Objet du message. 
*'''Type'''. Détermine si le mail est enovoyé au format HTML ou en Texte brut. 
*'''Message'''. Contenu de l'email, il peut être en code HTML ou en simple texte et peut contenir les variables QuickForm. 
*'''Joindre fichier'''. Détermine l'attachement des fichiers uploadés. 
*'''Mode d'envoi du mail'''. Vous permet de choisir le moyen technique utilisé pour envoyer le mail.
</blockquote>
==== Personnalisation du code  ====
[[Image:Fomulaire script.jpg|center]]
Normalement si vous avez consulté le wiki dans l'ordre du sommaire, vous avez déjà pris connaissance des méthodes de personnalisations du code. [[Fonctionnement général#Personnalisation_du_code|Me rafraichir la mémoire]]

==== Mise en page  ====
[[Image:Fomulaire layout.jpg|center]]
La mise en page du formulaire avec QuickForm est une chose relativement simple, quelque soit votre niveau de connaissance et d'utilisation. On pourrait classer en 3 niveaux la possibilité de faire une mise en page avec QuickForm.
<blockquote>
* '''Niveau 1''' C'est le mode ligne par ligne. Destiné aux utilisateurs débutants ou souhaitant mise en page rapide, ce niveau vous propose une mise en page par défaut 100% compatible avec toutes les options QuickForm, Vous pouvez très bien créer un article avec le wyswyg et y insérer les tag {cat}, {formtitle}, {desc} et {fields}. Les lignes, misent en page dans chaque champ, seront associées et misent en remplacement du tag {fields}.
<blockquote>
'''Dans formulaire :''' (Par défaut)
<pre><div class="componentheading">{cat}, {formtitle}</div>
<div>{desc}</div>
<div>{fields}</div></pre>
'''Pour chaque champ :''' (exemple avec le code HTML par défaut dans ''Mise en page de la ligne'')
<pre><div>
<span class="editlinktip hasTip" title="{caption}::{desc}" />
<div style="width:49%; float:left;">{caption} {req}</div>
<div style="width:50%; position:relative; float:left;">{body}</div>
<div class="clr">{error}</div>
</div></pre>
</blockquote>
* '''Niveau 2''' Le mode mise en page aidé. Vous avez la possibilité de définir l'emplacement de chaque champs en fonction de leur noms en faisant votre mise en page complète dans le wyswiwyg cette fois.
<blockquote>
'''Exemple'''
<pre>
<div class="componentheading">{cat}, {formtitle}</div>
<div>{desc}</div>
<div>
<div>
<span class="editlinktip hasTip" title="{prenom:caption}::{prenom:desc}" />
<div style="width:49%; float:left;">{prenom:caption} {prenom:req}</div>
<div style="width:50%; position:relative; float:left;">{prenom:body}</div>
<div class="clr">{prenom:error}</div>
</div>
<div>
<span class="editlinktip hasTip" title="{nom:caption}::{nom:desc}" />
<div style="width:49%; float:left;">{nom:caption} {nom:req}</div>
<div style="width:50%; position:relative; float:left;">{nom:body}</div>
<div class="clr">{nom:error}</div>
</div>
</div>
</pre>
</blockquote>
* '''Niveau 3''' Le mode je m'occupe de tout. Vous créez votre mise en page dans un éditeur HTML et vous insérez le contenu  dans le wysiyg en mettant bien les noms de champ sous la forme : QF[nomduchamp] et autre standards HTML
<blockquote>
<pre>
<input type="text" value="" size="0" name="QF[monpremierchamps]" id="monpremierchamps"  style="width:100%;" maxlength="255" />
<input type="text" value="" size="0" name="QF[adressemail]" id="adressemail"  style="width:100%;" maxlength="255" />
<input type="submit" value="Soumettre" name="QF[soumettre]" id="soumettre" style="width:100%"/>
</pre>
</blockquote>
</blockquote>
</blockquote>

=== Création de la base de données  ===
Après avoir enregistré un formulaire en utilisant la méthode ''Sauvegarder'', vous revenez automatiquement sur la page principale qui liste les formulaires et affiche leur état. A ce stade, vous devriez avoir quelque chose à l'écran qui ressemble à cela :
<blockquote>
[[Image:Fomulaire_database.jpg|center]]
</blockquote>
La croix rouge signifie, en réalité, que la table n'existe pas, de ce fait vous n'avez pas accès aux champs. Afin d'initialiser la table, il vous suffit juste de cliquer sur la croix pour mettre à jour tout les formulaires en attente de création de table. Vous obtiendrai donc normalement à la fin ceci :
<blockquote>
[[Image:Fomulaire_database_created.jpg‎|center]]
</blockquote>
<table style="width:100%; background:#CCCC00;">
<tr>
<td align="right">[[Gestion des champs|Gestion des champs >>]]</td>
</tr>
</table>
Modèles utilisés sur cette page :
Modèle:List (modifier)
Revenir à la page Gestion des formulaires.
Récupérée de « http://quickform.darkoline.com/index.php/Gestion_des_formulaires »
Voir le texte source

Affichages

Navigation

Rechercher

Boîte à outils

Outils personnels
