ContactForm et ContactFormLight Gestionnaires de formulaire pour Prestashop Edit par ARETMIC S.A.

-1-

PREAMBULE

Les conditions gnrales dutilisation dtaillant lensemble des dispositions applicables aux Produits Virtuels proposs par la socit Aretmic S.A. sont disponibles sur le site internet www.module-prestashop.aretmic.com. Le client dclare les avoir lues et acceptes, lachat de produits et lutilisation des services proposs par la socit ARETMIC S.A. emportant lacceptation et ladhsion expresse et sans rserve du client aux prsentes CGU ainsi que, le cas chant, aux documents contractuels existants compltant ou amendant lesdites CGU. La Socit Aretmic S.A. conserve intgralement la proprit intellectuelle de ses Produits. La Socit concde chaque Client qui aura achet un Produit virtuel une licence dutilisation, et ce titre non exclusif et pour le monde entier. Cette licence n'est valable qu'une seule fois pour une seule boutique e-commerce. Aucune cession de droits nest accorde par les prsentes par la Socit au Client. Il est par ailleurs interdit au Client de revendre ou dutiliser sur dautres boutiques les Produits virtuels achets sur www.module-prestashop.aretmic.com. Cette restriction inclut toutes les ressources fournies avec le Produit virtuel.

Conditions Gnrales dUtilisation des modules de la Socit ARETMIC S.A. en date du 31 aot 2010 http://www.module-prestashop.aretmic.com/content/3-conditions-generales-de-ventes

-2-

SOMMAIRE
I. APERU GENERAL DU MODULE CONTACTFORM...4I.1. Prsentation du ContactForm .............................................................................................. - 4 I.2. Ses avantages et ses caractristiques .................................................................................... - 4 I.2.1. Avantages du ContactForm ........................................................................................... - 4 I.2.2. Caractristiques du ContacForm ................................................................................... - 4 II. INSTALLATION DU MODULE CONTACTFORM.5III. PANNEAU DE CONTROLE DU CONTACTFORM....6III.1. Menu : Activer contactform ............................................................................................... - 6 III.2. Menu : Dsactiver contactform .......................................................................................... - 7 III.3. Menu : Aide ....................................................................................................................... - 8 III.4. Menu : Grer vos formulaires ............................................................................................ - 8 III.4.1. Cration dun nouveau formulaire .............................................................................. - 8 III.4.2. Edition dun formulaire............................................................................................. - 11 a. Nouveau champ............................................................................................................. - 12 b. Aperu ........................................................................................................................... - 14 III.5. Menu : Voir les donnes .................................................................................................. - 14 III.6. Menu : Ajouter des exemples de donnes ........................................................................ - 14 III.7. Menu : Sauvegarder votre formulaire .............................................................................. - 15 III.8. Menu : Restaurer votre formulaire ................................................................................... - 16 III.9. Menu : Configuration ....................................................................................................... - 17 III.9.1. Elments de la barre doutils..................................................................................... - 17 III.9.2. Zone de configuration du ContactForm ................................................................... - 17 -

-3-

I.

APERU GENERAL DU MODULE CONTACTFORM

I.1. Prsentation du ContactForm.

ContactForm est loutil idal pour laborer facilement des formulaires pour votre site Prestashop. En effet, ContacForm est un module Prestashop gnrateur de formulaires qui vous permettra de crer et de grer aisment plusieurs formulaires grce une interface dadministration simple et intuitive. Dautant plus que la manipulation du ContactForm ne ncessite aucune connaissance en programmation. Ainsi, vous pourrez raliser, selon vos besoins, de simples formulaires ou des formulaires plus volus.

I.2. Ses avantages et ses caractristiques :

I.2.1. Avantages du ContactForm :
Utilisation facile et intuitive. Ne ncessite aucune connaissance en HTML. Gestion dun nombre illimit de formulaires. Gnration et affichage rapide de formulaires. Affichage et dition de message de remerciement personnalisable Support multilingue. Intgration dun systme de sauvegarde et de restauration de formulaires.

I.2.2. Caractristiques du ContactForm :

Captcha personnalisable. Prvisualisation du formulaire depuis ladministration. Possibilit dintgrer un champ de type date. Mise en page personnalisable des formulaires et des messages derreurs lors de la soumission. Edition du CSS du formulaire. Possibilit de modifier, de filtrer les soumissions. Envoi de mail en HTML personnalis ou au format texte. Possibilit d'envoyer deux types de messages e-mail: l'une l'expditeur et l'autre soimme ou tout autre administrateur site. Importation/Exportation de formulaires. Plusieurs exemples prdfinis disponibles. Restauration du formulaire par dfaut de Prestashop Support multilingue.

-4-

II.

INSTALLATION DU MODULE CONTACTFORM

1. Tout dabord, dcompressez le fichier dinstallation de ContactForm (contactform.v.1.2.zip ou contactformLight.v.1.2.zip), puis utilisez votre logiciel FTP pour copier le rpertoire contactform ainsi obtenu dans le dossier /modules de Prestashop. 2. Une fois tous les fichiers uploads, allez dans la partie administration de votre site et cliquez sur longlet modules depuis le menu du haut.

3. Reprez le nouveau module dans la liste appel Autres modules, faites dfiler vers le bas si ncessaire.

4. Cliquez sur le bouton Installer. 5. Pour finir, reprez nouveau le module dans la liste. Un lien configurer . Cliquez dessus pour accder aux panneaux de contrle du module. Remarque : Le bouton installer est devenu dsinstaller . Il est donc possible de dsinstaller le module Contactform.

-5-

III.

PANNEAU DE CONTROLE DU CONTACTFORM

Maintenant que linstallation du module ContaForm est faite, vous avez accs au panneau de contrle via le lien configurer , dont la description du module est disponible juste ct. En cliquant sur le lien, plusieurs menus apparaissent comme suite :

III.1. Menu : Activer contactform

Le menu activer ContactForm permet dactiver les formulaires ContactForm que vous avez crs dans ladministration pour tre visible depuis votre site. Ce menu peut se prsenter sous deux aspects : cliquable et non cliquable. Il est cliquable lorsque le bouton du menu a lapparence suivante . Ce qui vous permet de mettre jour le systme de formulaire existant par dfaut en systme de formulaire de ContactForm. Le bouton est cliquable lors de votre premier contact avec le module. Il est donc prfrable de cliquer directement dessus mme sil nexiste pas encore de formulaires. Cela ne vous empche pas de lactiver nouveau aprs la cration dun formulaire. Sil ny a aucun message derreur aprs le clic du menu, la page suivante apparatra :

Cette page signifie que vous avez russi avec succs la mise jour du systme de formulaires par dfaut de Prestashop par celui de ContactForm. Pour vrifier, allez dans votre site Prestashop et -6-

cliquez sur le lien contact ou tapez directement dans votre navigateur le lien http://www.votresite.com/contact-form.php. Vrifiez si vous avez bien le message suivant :

Ensuite, retournez au panneau de contrle en cliquant sur le bouton Fermer de la barre doutils en haut droite. Vous remarquerez que pour des raisons de scurit, le bouton deviendra non cliquable .

Si jamais vous souhaitez activer nouveau le bouton pour refaire le processus dactivation, allez dans le menu configuration et appuyez sur le bouton Activer le bouton d'activation de ContactForm en bas dans la zone Activation.

Lorsque vous revenez dans le panneau de contrle, vous constaterez que le menu est de nouveau cliquable. Il vous suffit alors de refaire le processus dactivation dcrit ci-dessus. Les dtails de ce processus seront dvelopps plus tard. Toutefois, des erreurs pourront survenir lors du processus dactivation du ContactForm. Les sources de ces erreurs sont diverses si lon ne cite que les diffrentes restrictions sur le serveur et les permissions sur les fichiers.

Dans ce cas, essayez de refaire le processus dactivation en ractivant le bouton comme on la dcrit prcdemment. Appuyez de nouveau sur le bouton activer ContactForm du panneau de contrle. Si le problme persiste, laide de votre logiciel FTP, copiez le fichier contact-form.php contenu dans le rpertoire modules/contactform/bkp/site/ la racine de votre site Prestashop.

III.2. Menu : Dsactiver contactform

Le menu dsactiver ContactForm permet la fois de dsactiver le systme de formulaire de ContactForm du site (Front Office) et de restaurer le formulaire par dfaut de Prestashop. Il est donc ncessaire de savoir faire la diffrence entre la dsinstallation du module ContactForm et sa dsactivation. La dsinstallation consiste effacer la base de donnes et les paramtres correspondant au module. Quant la dsactivation, seul laffichage du formulaire -7-

dans le Front Office sera remplac par laffichage du formulaire par dfaut sur Prestashop. Vos formulaires et vos paramtres seront toujours conservs. Si plus tard vous voulez afficher vos formulaires ContactForm, il suffit dactiver ContactForm depuis le menu activer ContactForm expos prcdemment. Comme pour le menu activer ContactForm, il peut prendre les aspects cliquable et non cliquable. Par dfaut, cest le dernier aspect quil adopte. Pour lactiver, il faut aller dans le menu configuration et cliquer sur le bouton Activer le bouton de dsactivation de ContactForm . A partir de ce moment et depuis le panneau de contrle, vous pouvez cliquer sur le bouton Dsactiver ContactForm pour restaurer le formulaire par dfaut de Prestashop.

III.3. Menu : Aide

Ce menu vous propose un manuel dutilisation multilingue du module ContactForm que vous pouvez tlcharger en format PDF.

III.4. Menu : Grer vos formulaires

Ce menu vous permet daccder toutes les fonctionnalits ncessaires lors de la cration de vos formulaires. En cliquant sur le menu, vous accdez directement la liste de tous les formulaires que vous avez crs dans le module ContactForm. Pour la premire utilisation du module, la liste sera vide.

III.4.1. Cration dun nouveau formulaire

Pour crer un nouveau formulaire, cliquez sur licne Nouveau gauche de la barre doutils. Vous parviendrez ainsi la page de paramtrage du nouveau formulaire.

-8-

On vous demande de remplir plusieurs champs catgoriss dans 3 onglets : Onglet 1: Paramtres du formulaire : Cet onglet renferme les paramtres gnraux du formulaire : 1. Nom du formulaire : cest dans ce champ que vous taperez le nom du formulaire. Ce champ est obligatoire. 2. Alias : Cest dans ce champ que vous insrerez lalias de votre formulaire. 3. Titre du formulaire : Cest dans ce champ que vous entrerez le titre de votre formulaire. Le titre sera utilis par le fil dAriane lorsque vous cliquerez sur le lien Contact du FrontOffice. Ce champ est galement obligatoire. 4. URL de retour : Ici se met lurl qui dirigera un visiteur de votre site lorsquil a soumis avec succs votre formulaire. Ce champ nest pas obligatoire. Si lurl de retour nest pas dfini, le lien de retour apparaissant dans le FrontOffice conduira le visiteur vers la page daccueil. Onglet 2: Messages Vous pouvez diter plusieurs types de messages pour votre formulaire. Ces messages ne sont pas obligatoires. 1. Message de remerciement : Cest le message qui saffiche lorsquun visiteur de votre site a soumis votre formulaire avec succs. 2. Message affich avant le formulaire : Ce message saffiche juste au dessus de votre formulaire. Il peut contenir par exemple une petite introduction du formulaire, article avec illustration ou des publicits. 3. Message affich aprs le formulaire : Ce message saffiche juste au dessous de votre formulaire. Onglet 3: E-mail Cet onglet vous permet de dfinir les paramtres relatifs la notification par e-mail.

-9-

1. Adresse e-mail : ici se met ladresse e-mail de celui qui va grer les informations envoyes par le formulaire depuis le site. Dans le cas o plusieurs personnes vont recevoir le mail, il faut sparer leur adresse e-mail par des points virgules ; . Exemple : admin@monshop.com ; contact@monshop.com . Ce champ est obligatoire 2. Nom de lexpditeur : Cest ce nom qui va apparatre dans le mail du client comme tant lexpditeur du mail de notification quil a reu. Ce champ est obligatoire 3. Sujet du mail : Cest le sujet du mail de notification que le client va recevoir. Ce champ est obligatoire 4. Notification Message : Cest le message de notification que le client reoit automatiquement lorsquil a soumis avec succs votre formulaire depuis le FrontOffice Une fois que tous les champs obligatoires sont bien remplis et vos adresses e-mails correctes, validez le tout en cliquant sur le bouton sauvegarder . Voil, vous venez de crer avec succs votre premier formulaire. Ce dernier peut tre aperu dans la liste des formulaires.

Dans la liste des formulaires, vous pouvez voir tout droite de chaque formulaire trois boutons. Ces boutons dfinissent les actions que vous pouvez entreprendre sur chaque formulaire. Le premier bouton vous permet de modifier la liste des champs dun formulaire. En cliquant dessus, vous accdez la fentre Liste des champs qui vous permettra dditer les diffrents lments des champs et leur ordre.

- 10 -

vous permet de modifier les informations et paramtres du Le second bouton formulaire. La mme action se produit lorsque vous cliquez sur chacun des informations correspondant au formulaire en question. Le troisime bouton permet de faire une prvisualisation du formulaire.

Le quatrime bouton permet de supprimer le formulaire. La suppression du formulaire effacera toutes les informations et les champs contenus lintrieur de ce formulaire. par lurl http://www.votresite.com/contact-

Votre formulaire est accessible form.php?fid=identifiantFormulaire .

Le nombre de formulaires que vous pouvez crer est illimit si vous choisissez la version ContactForm. Pour afficher les formulaires dans le FrontOffice, il vous faut tout simplement crer pour chacun, le lien qui lui correspond.

III.4.2. Edition de formulaire

Lorsque vous cliquez sur le bouton diter , vous accdez directement aux informations relatives au formulaire comme le montre la figure suivante :

Vous pouvez modifier les informations puis les sauvegarder. Dans cette partie du module ContactForm, il est indispensable de voir un un les lments de la barre doutils.

Nouveau champ permet de crer un nouveau champ lintrieur du formulaire. - 11 -

Liste des champs permet de lister tous les champs contenus dans le formulaire. Aperu permet de faire une visualisation du formulaire depuis le Front Office. Liste des formulaires permet de retourner la liste des formulaires. Fermer permet de quitter la page ddition de formulaire.

a. Nouveau champ Pour crer un nouveau champ, cliquer sur le bouton Nouveau champ de la barre doutils. Linterface dinsertion des paramtres du nouveau champ est comme suite :

Dans la liste des paramtres dun nouveau champ, on distingue : - Id Formulaire : Ce champ se remplit automatiquement de lidentifiant du formulaire en cours et dans lequel on veut crer le champ. - Type de champ : Ce paramtre donne le modle de champ crer. Cest ici que vous dfinissez par exemple si vous voulez un champ de type texte ou bien des groupes de boutons radio. En effet, il y a plusieurs types de champ dans ContactForm : Text, Password, Email, Radio, Checkbox, Calendar, Textarea, Select, Button, Image button, Reset button, File upload, Captcha, Separator, pays. - Id champ : Vous insrez ici un quelconque identifiant de champ. Vous pouvez entrer des valeurs alphanumriques. Lidentifiant doit tre unique pour chaque champ et est obligatoire. - Nom champ : On met dans cette zone un nom pour le champ. Ce nom peut prendre des valeurs alphanumriques. Le nom du champ est obligatoire et doit tre unique pour tous les champs que vous allez crer. - Titre de champ : Cest le label utilis par le champ, cest--dire que cest un texte ou une petite indication qui informe sur la manire de remplir le champ. - 12 -

- Description : Elle permet de donner de plus amples informations sur le champ. Par dfaut, la description se place juste ct du champ dans le Front Office. Vous pouvez mettre des valeurs alphanumriques pour la description. Elle est facultative. - Obligatoire : Elle permet de dfinir si le champ est obligatoire ou non. Si vous cochez sur oui, cela veut dire que lutilisateur du formulaire dans le FrontOffice doit imprativement remplir ce champ, autrement le formulaire ne pourra pas tre soumis et un message derreur apparat dans ce sens. A linverse, si vous mettez non, lutilisateur nest pas oblig de mettre quelque chose dans le champ. - Confirmation : Elle permet de dfinir si le champ a besoin dtre confirm ou non pour que le formulaire soit soumis avec succs. En vous positionnant sur oui, vous prcisez que, dans le formulaire du Front Office, le contenu du champ ncessite dtre retap correctement pour valider le tout. Ceci implique quun champ de confirmation est cr automatiquement par le programme juste en dessous du champ concern. - Validation : Cest le critre que vous pouvez imposer la valeur saisie dans le champ. Il y a plusieurs types de validation dans ContactForm : None, E-mail, Numeric (0-9), alphanumeric, alpha (a-z, A-Z). - None donne une totale libert dans la saisie de la valeur du champ. - E-mail impose que la valeur saisie doit tre de type e-mail comme par exemple monmail@domaine.com - Numeric prescrit que la valeur saisie doit tre numrique. Ce type de validation est utilis par exemple dans la saisie de numros de tlphone, de numros de fax ou des codes postaux. - Alphanumeric indique que la valeur saisie peut contenir des chiffres et des lettres. - alpha (a-z, A-Z) impose que la valeur contienne uniquement des lettres. - Valeur par dfaut : Dans le formulaire du Front Office, la valeur par dfaut correspond linformation qui apparat par dfaut dans le champ mme si lutilisateur na encore rien insr. Il donne une prcision sur la nature ou le format de la valeur mettre dans le champ. Pour le cas des champs de type select, radio ou checkbox, la valeur par dfaut dfinit tous les lments du champ. C'est--dire que pour dfinir les lments du champ, on numre les lments en les sparant par des virgules. Par exemple, si je veux avoir le groupe checkbox sur limage ci-dessous, il me faut mettre dans la valeur par dfaut : Vlo, Splologie, Cano-kayak.

- Attributs supplmentaires: Cest dans cette zone que vous pouvez ajouter des caractristiques supplmentaires pour le champ. Par exemple, pour un champ de type texte, on peut dfinir ici la taille du champ en mettant size="50" ou bien mettre des styles supplmentaires en ajoutant style= "" - Message derreurs : Ce champ cautionne la mise en page de laffichage de lerreur correspondant au champ lorsque le remplissage du champ dans le formulaire du FrontOffice nest pas correct. Vous pouvez changer le code html mais il faut toujours que {error} y soit visible. - Ordre : Cest lordre dans lequel le champ est affich.

- 13 -

b. Aperu A tout moment, vous pouvez voir un aperu de vos formulaires en cliquant sur licne aperu de la barre doutils.

III.5. Menu : Voir les donnes

Lorsquun visiteur soumet un formulaire ContactForm, des mails de notifications sont envoys respectivement au gestionnaire du site et ce visiteur. Au mme moment, les informations seront enregistres dans la base de donnes de ContactForm. Pour voir ces informations, cliquez sur licne voir les donnes. Cette action est utile lorsquil y a un problme denvoi de mail, vous pouvez toujours voir les informations envoyes par les visiteurs. En cliquant sur le menu, la liste des informations envoyes par les visiteurs saffichera comme la suivante :

Vous pouvez supprimer ou voir les dtails des informations en cliquant sur licne . Quant la colonne Statut du mail, elle indique si le mail a t envoy votre bote aux lettres ou non.

III.6. Menu : Ajouter des exemples de donnes

Ce menu vous donne la possibilit dajouter automatiquement des exemples prdfinis pour votre formulaire ContactForm. Vous pouvez utiliser ces exemples comme modles de base. Il vous suffit de cliquer sur les images correspondant au modle que vous voulez et lexemple sajoute directement dans la liste de vos formulaires.

- 14 -

Lorsque lajout dexemple a t fait avec succs, une notification apparat tout en haut de la page et vous donne un lien pour laperu de votre formulaire.

III.7. Menu : Sauvegarder votre formulaire

Ce menu vous donne accs loutil de sauvegarde de votre base de donnes ContactForm. Vous pouvez directement faire un copier-coller des requtes SQL contenues dans la zone de texte (textarea) ou bien utiliser licne sauvegarde pour enregistrer une copie. En cas de problmes dans la sauvegarde de donnes, vous pouvez utiliser licne sauvegarde alternative.

- 15 -

Lorsque vous enregistrez une copie de la base de donnes de ContactForm, surtout nenlevez pas les balises -- [CF_tag] lintrieur des requtes.

III.8. Menu : Restaurer votre formulaire

Ce menu permet la restauration de la base de donnes de ContactForm avec celle des formulaires partir dune sauvegarde au format texte (.txt). Une zone de tlchargement sera mise votre disposition pour mettre jour votre base de donnes.

Il faut bien noter que les requtes SQL sauvegardes doivent contenir lintrieur, la balise propre ContactForm -- [CF_tag] sinon le programme ne pourra pas mettre jour la base de donnes.

- 16 -

III.9. Menu : Configuration

Ce menu vous permet daccder aux configurations gnrales du module ContactForm. Dans la page de configuration, on distingue 2 zones : La barre doutils. La zone de configuration.

III.9.1. Elments de la barre doutils

La barre doutils renferme les boutons spcifiques suivants : - Editer le CSS : Ce bouton vous permet de modifier le style de votre formulaire. - Fermer : Ce bouton permet de fermer la fentre Configuration

III.9.2. Zone de Configuration de ContactForm

Cette partie comporte les lments suivants : - Paramtres gnraux : Caractre affich aprs les champs obligatoires : Cest le caractre indiquant lutilisateur du formulaire quun champ est obligatoire. Par dfaut, ce caractre saffiche juste aprs le champ et est colori en rouge. Format accepte pour lupload : Une liste des formats accepts pour le tlchargement sera visible sur ce champ. Bouton dactivation : Ce bouton vous permet dactiver ou de dsactiver les boutons Activer ContactForm et Dsactiver ContactForm du panneau de contrle. - Paramtre des formulaires : Ici, on peut indiquer la mise en page souhaite pour les champs de type checkbox et de type radio. La mise en page peut tre horizontale ou vertical.

- 17 -

Pour toutes demandes de renseignement, d'aide ou de suggestion, vous pouvez les faire via le forum de ContactForm et ContactFormLight ci-dessous : http://www.aretmic.com/forum/listcat.html Nous souhaitons que les outils que nous avons dvelopps pour vous, vous apportent beaucoup de satisfactions et que votre imagination repousse nos limites...

- 18 -