Documentation 3DIS Multistep Addon CF7
Guide 3DIS Multistep Addon CF7
Découpez un formulaire Contact Form 7 en étapes, validez l’écran actif au bon moment et créez une progression adaptée aux ordinateurs et mobiles.
Prérequis et installation
Installez et activez Contact Form 7 avant l’addon. Téléversez ensuite le ZIP officiel de 3DIS Multistep Addon CF7, activez-le puis saisissez la licence. Vérifiez que l’onglet ou les réglages Multistep sont disponibles dans l’éditeur du formulaire. Sauvegardez le formulaire actuel avant de le transformer.
Préparer le formulaire
Listez les informations demandées et regroupez-les par sujet. Évitez de créer une étape pour un seul champ si cela allonge inutilement le parcours. Les champs obligatoires sont définis avec les balises Contact Form 7 appropriées. Donnez des noms stables et explicites aux champs utilisés par d’autres extensions.
Créer les étapes
- Placez le marqueur de début de la première étape avant ses champs.
- Regroupez les coordonnées et ajoutez un bouton Suivant.
- Ajoutez les autres étapes dans leur ordre logique.
- Placez le bouton Précédent lorsqu’un retour est autorisé.
- Conservez le bouton de soumission CF7 uniquement dans la dernière étape.
- Enregistrez puis testez le formulaire public.
Validation par étape
Le clic sur Suivant doit contrôler les champs visibles de l’étape active. Si un champ obligatoire manque, la navigation est bloquée et CF7 affiche son message. Au chargement initial, aucun message ne doit être visible. Le simple focus dans un champ ne doit pas valider toutes les étapes.
Testez avec une page fraîche, sans autofill et sans cache. Vérifiez d’abord l’absence d’erreur, puis cliquez sur Suivant avec les champs vides. Corrigez les valeurs, avancez, revenez en arrière et assurez-vous que les données restent présentes.
Barre de progression
Utilisez des libellés courts : Coordonnées, Société, Adresse, Paiement. L’étape active doit être visible, les étapes terminées distinguables et les suivantes compréhensibles. Ne reposez pas uniquement sur la couleur ; conservez un numéro ou un texte. Vérifiez le contraste et la navigation au clavier.
Responsive et accessibilité
Sur mobile, la progression peut devenir verticale ou compacte. Les boutons doivent être suffisamment grands, l’ordre de tabulation logique et le focus déplacé vers la première erreur lorsque la navigation est bloquée. Les champs, messages et boutons ne doivent pas sortir du conteneur.
Intégration avec 3DIS PAYMENT
Placez la formule, la quantité et les données de facturation avant la dernière étape. Le composant de paiement apparaît à l’étape prévue. Les classes de champs doivent correspondre au profil 3DIS PAYMENT. L’addon organise l’affichage ; le montant et la sécurité restent contrôlés côté serveur par PAYMENT.
Dans un formulaire d’achat, affichez le HT, la TVA de 20 % et le TTC avant le paiement. Testez la validation des champs, le chargement de Stripe, la transaction, le retour et le webhook. Un formulaire correctement découpé mais relié au mauvais profil ne constitue pas un parcours valide.
Personnalisation
Utilisez les réglages de l’addon ou les classes documentées pour adapter les couleurs, espacements et boutons. Évitez de cibler des sélecteurs internes susceptibles de changer. Le thème doit conserver un contraste accessible et ne pas masquer les messages CF7. Testez après toute modification CSS.
Mises à jour
Sauvegardez les formulaires et consultez les notes de version. Après mise à jour, contrôlez un formulaire simple et le parcours le plus complexe. Videz les caches frontaux et les optimisations JavaScript si l’ancien comportement persiste. Ne chargez pas simultanément deux versions de l’addon.
Dépannage
| Symptôme | Contrôle |
|---|---|
| Erreurs au chargement | Déclenchement prématuré, cache, autofill ou ancienne version |
| Suivant inactif | Marqueurs d’étape, erreur JS, champ obligatoire invisible |
| Données perdues au retour | Rechargement de page, conflit de script ou champs dupliqués |
| Progression incorrecte | Ordre et nombre de marqueurs, étape conditionnelle |
| Paiement absent | Profil PAYMENT, balise, fournisseur et environnement |
Désinstallation
Avant la suppression, sauvegardez les formulaires. Retirez ou adaptez les marqueurs spécifiques si les formulaires doivent rester utilisables sans l’addon. La désactivation ne doit pas effacer automatiquement les soumissions CF7 ou les données conservées par d’autres extensions.
FAQ
Puis-je utiliser l’addon sans PAYMENT ?
Oui. Il fonctionne avec un formulaire CF7 classique.
Pourquoi les erreurs apparaissent-elles trop tôt ?
Une validation est appelée au chargement ou un état précédent est restauré. Testez sans cache et contrôlez la version.
Les champs sont-ils envoyés à chaque étape ?
La soumission finale reste gérée par Contact Form 7 ; les étapes servent à la navigation et à la validation progressive.
Peut-on revenir en arrière ?
Oui si le bouton Précédent est configuré et qu’aucune règle métier ne l’interdit.
Un problème persiste ?
Fournissez la version, la structure des étapes et le message de console utile sans données personnelles.
Contacter le supportRéférences officielles
Consultez également les spécifications des outils sur lesquels repose le parcours multi-étapes.
- Documentation officielle Contact Form 7 — balises, événements et validation
- Guide MDN sur la validation — comportement attendu des champs de formulaire

