Documentation du module Powerful Form Generator

Transcription

1 Documentation du module Powerful Form Generator

2 Installation Configuration Usage Création, modification d'un formulaire Gestion des champs Voir la liste des enregistrements Utilisation des Hooks pour afficher le formulaire Utilisation des hooks pour affichage en page CMS Mettre en place une url dédiée pour chacun de vos formulaires Le formulaire n'est pas visible, pourquoi? Contact Merci!

3 Installation L'installation de ce module est très simple. Rendez vous simplement dans l'administration de votre site Prestashop, onglet "Module", cliquez sur "Ajouter un nouveau module", sélectionnez l'archive et voilà! :) Une fois installé, vous trouverez un nouveau menu dans la section "Modules", appelé " Powerful Form Generator ". Tout ce gère ici. Configuration Il n'y a aucune configuration requise pour ce module. Usage Une fois que vous êtes dans la page du module (via Modules > Powerful Form Generator ), vous pourrez configurer vos différents formulaires.

4 Création, modification d'un formulaire Lors de la création/modification d'un formulaire, vous pouvez préciser divers champs, dont : Le type d' à envoyer à l'émetteur : Message : Un message à envoyer à l'émetteur (que vous pouvez définir plus bas) Form : Le formulaire remplis Rien : Ne rien envoyer à l'émetteur Le type d' à envoyer aux destinataires. Les actions sont les mêmes. La possibilité de donner l'accès à ce formulaire à vos utilisateurs connectés uniquement, ou à tout le monde Le type de formulaire que vous voulez (accessible via une URL ou uniquement par Hook) Une liste d' qui corresponds aux destinataires. Pensez à bien séparer les s par des virgules si vous voulez ajouter plusieurs s. Un message à afficher avant ou après le formulaire Un message de remerciement personalisable

5

6 Gestion des champs Dans le listing, vous trouverez des icônes à droite, dont un engrenage. Cet engrenage vous permet d'ajouter, modifier et supprimer des champs. Lors de la création/modification d'un champ, vous pouvez remplir les différentes valeurs. Il faut savoir que le champs "Valeurs" n'est utilisé que si le type est défini à : Select : Le champs valeurs correspondra alors à une liste de valeurs, séparée par des virgules Radio : Le champs valeurs correspondra alors à une liste de boutons radio à afficher avec le texte à droite, séparé par des virgules Fichier : Une liste d'extensions autorisées, séparée par des virgules, sans le point. L'autre champ important est "Lier ce champ à". Vous pourrez trouver ces trois options :

7 de l'émetteur : Ce champ sera utilisé comme l' de l'émetteur. Vous devez définir un type à Sujet de l' Ce champ sera utilisé en tant que sujet de l' . Vous pouvez choisir un type Select ou texte standard Newsletter : Ce champ (de type checkbox), si coché par votre client, enregistrera ce client dans la newsletter. Enfin, vous trouverez aussi d'autres champs qui permettront d'améliorer l'affichage visuel de vos champs : Classe : Indiquez ici une ou plusieurs classe CSS. Vous pourrez reprendre le nom de cette classe dans votre feuille de style afin de personnaliser l'affichage de votre champs. Style (css) : Vous pouvez dans cette partie directement mettre vos style css, tel que "border: solid red 1px". Cela permet de personnaliser les champs un à un avec un style dédié. Extra : Cette section vous permet d'ajouter des attributs à votre champ, comme l'attribut "multiple" pour un champ de type select, une limitation sur le nombre de caractères, etc. Voir la liste des enregistrements Afin de voir la liste des enregistrements, vous pouvez cliquer sur le titre de votre formulaire, ou sur l'icône avec la loupe. Vous pourrez voir les différentes entrées, et exporter ces entrées au format CSV.

8 C'est aussi dans cette partie que vous trouverez le lien vers votre formulaire sur le front end de votre site. Normallement, vous trouverez le message "Cliquez ici pour voir le formulaire" si le formulaire est accessible depuis le site vitrine. Si ce lien n'est pas présent, c'est probablement car vous avez désactivé le formulaire. Il n'est donc pas visible depuis votre frontend, d'où le lien non affiché. Enfin, vous pourrez lire n importe quelle entrée du formulaire en détail juste en cliquant sur la ligne souhaitée :

9 Utilisation des Hooks pour afficher le formulaire Quand vous créez un formulaire, vous avez la possibilité de le rendre accessible via une URL ou uniquement par HOOK. Si vous décidez de passer uniquement par un HOOK, vous aurez la liberté de le placer ou vous voulez dans votre thème. Ajoutez simplement la ligne suivante ou vous voulez, et le formulaire s'affichera à l'endroit désiré: {hookh='displaypowerfulform'mod='powerfulformgenerator'id=$idpfg} NOTE : N'oubliez pas de remplacer la valeur ` $idpfg ` par le bon ID. (La valeur de l'id se trouve dans la première colonne du listing de vos formulaire ( Back office Prestashop > Modules > Powerful Form Generator ), just après la case à cocher.)

10 Utilisation des hooks pour affichage en page CMS L avantage des hooks est de pouvoir les placer ou vous souhaitez. Pour afficher votre formulaire dans une page CMS, il vous faudra modifier le fichier cms.tpl localisé dans le dossier /theme/{votre_theme}/cms.tpl. Trouvez la ligne : <divclass="rte{if$content_only}content_only{/if}"> Et mettez juste avant, ceci : {if$cms->id==x} {hookh='displaypowerfulform'mod='powerfulformgenerator'id=y} {/if} Il vous faudra remplacer les deux valeurs suivantes : X = L ID de votre page CMS (la première colonne dans votre back office). Y = L ID de votre formualire (la première colonne dans votre back office). Et voila, vous pouvez accéder à votre formulaire via une page CMS. Mettre en place une url dédiée pour chacun de vos formulaires Par défaut, Prestashop permet seulement de faire une url réécrite par module (url rewritting). Mais dans le cas du PowerfulFormGenerator, il se pourrait que vous aillez besoin de créer une url réécrite PAR formulaire. Dans ce cas, une solution existe. Vous devez modifier le fichier.htaccess et ajouter cette ligne à la fin du fichier, juste avant "#Dispatcher": RewriteRule^ contactez-nous-special $ %{ENV:REWRITEBASE}index.php?fc=module&module=powerfulformgenerator&co ntroller=display& id=1 [QSA,L] Remarquez que vous devez changer deux valeurs a la ligne précédente : 1. Remplacez le " contactez nous special " par la valeur que vous souhaitez mettre dans votre URL réécrite

11 2. Remplacez la valeur " id=1 " par l'id du formulaire que vous souhaitez afficher. Le formulaire sera alors accessible via l'adresse /contactez-nous-special (dans le cas de notre example). Le formulaire n'est pas visible, pourquoi? Quelques raisons peuvent expliquer cette situation : 1. Avez vous activé le formulaire (Un check vert doit être visible dans le listing des formulaires, vers le formulaire en question) 2. Avez vous créer des champs pour ce formulaire? 3. Avez vous autorisé l'accés uniquement aux personnes connectées et vous n'êtes pas un "client" connecté lorsque vous tentez d'afficher le formulaire? Contact Vous avez découvert un bug, vous avez des problèmes pour installer/configurer/utiliser ce module? N'hésitez pas à me contacter via le site de Prestashop à cette url et je ferai de mon mieux pour vous aider. Merci! Vous avez acheté un de mes modules, et pour ça je tenais à vous remercier.