Documentation 3DIS Multistep Addon CF7

Architecture, intégration et maintenance — 3DIS Multistep Addon CF7

Référence : 0.4.5 · documentation actualisée le 30 septembre 2026. Cette partie complète le guide d’utilisation. Les exemples doivent être adaptés puis testés sur un formulaire ou contenu de recette. Ils ne modifient pas automatiquement votre site.

Architecture et activation du rendu

La classe ThreeDIS_Multistep_CF7, dans 3dis-multistep-v030.php, enregistre les balises, panneaux CF7, réglages, ressources et route de validation. Le nom historique du fichier ne donne pas la version : son en-tête indique 0.4.5. Les prérequis déclarés sont WordPress 6.4 et PHP 7.4 ; la validation intermédiaire exige CF7 6.1.3 au minimum.

Les réglages sont enregistrés par formulaire dans _3dis_multistep_settings. Le rendu wpcf7_form_elements recherche les marqueurs .threedis-ms-marker. Si l’addon est activé pour ce formulaire, il ajoute .threedis-ms-root, sa configuration et les ressources 3dis-multistep-cf7. Le JavaScript découpe le formulaire en sections et crée la progression et les boutons Suivant/Retour.

Exemple minimal de deux étapes

Placez les marqueurs dans un seul formulaire CF7. Le titre est la première valeur entre guillemets ; le nom technique de chaque étape est distinct. L’addon génère la navigation : n’ajoutez pas un second jeu de boutons qui pilote indépendamment les mêmes sections.

<p>[threedis_step coordonnees "Coordonnées"]</p>

<label>Votre nom
    [text* votre-nom]
</label>
<label>Votre e-mail
    [email* votre-email]
</label>

<p>[threedis_step demande "Votre demande"]</p>

<label>Message
    [textarea* votre-message]
</label>
[submit "Envoyer"]

Réglages et portée

Les options comprennent activation, validation par étape, progression, orientation, forme, titres, pourcentage, étapes cliquables, transition, défilement automatique, réinitialisation après succès, conservation des erreurs, textes et couleurs des boutons. Le retour entre étapes conserve les champs dans le formulaire courant ; il ne constitue pas une sauvegarde de brouillon persistante après fermeture ou rechargement.

Contrat de validation intermédiaire

Le navigateur appelle POST /wp-json/3dis-multistep/v1/validate avec _wpcf7, les noms _3dis_step_fields et les valeurs. Le serveur limite le corps à 64 Kio et la liste à 200 champs ; il ne conserve que les noms connus du formulaire. Les formulaires privés ou brouillons exigent les droits CF7 correspondants. Une limite de 60 validations par minute et par adresse réseau peut affecter des visiteurs partageant un proxy.

CF7 valide les champs standards demandés avec son schéma. Le plugin n’exécute pas les filtres globaux de soumission pour simuler un envoi : captcha, anti-spam, paiement, PDF et effets définitifs restent réservés au vrai parcours final. Les champs de fichiers natifs sont exclus de cette validation textuelle ; les extensions de dépôt doivent s’intégrer explicitement.

Hook pour les règles métier

Le filtre 3dis_multistep_validate_step($result, $tags, $form, $params, $requested) reçoit cinq arguments : résultat WPCF7_Validation, balises, formulaire, paramètres et noms de l’étape. Enregistrez le callback avec cinq arguments acceptés. Limitez-le à l’ID du formulaire visé et aux champs présents dans $requested, puis utilisez $result->invalidate($tag, $message) et retournez le résultat.

La même règle métier doit être appelée dans la validation finale CF7 du type de champ concerné, par exemple wpcf7_validate_text*. Extraire la règle dans une fonction commune évite qu’un visiteur contournant les étapes puisse éviter le contrôle final. Un callback intermédiaire ne doit ni envoyer de mail, ni créer un PDF, ni débiter, ni enregistrer une commande définitive.

add_filter(
    '3dis_multistep_validate_step',
    static function ($result, $tags, $form, $params, $requested) {
        if ((int) $form->id() !== 123 || !in_array('reference', $requested, true)) {
            return $result;
        }
        foreach ($tags as $tag) {
            if ($tag->name === 'reference' && empty($params['reference'])) {
                $result->invalidate($tag, 'Indiquez votre référence.');
            }
        }
        return $result;
    },
    10,
    5
);

Cet exemple illustre le contrat, avec un formulaire 123 à remplacer. Pour un simple champ obligatoire, préférez la balise CF7 [text* reference], déjà vérifiée à l’étape et à l’envoi. Pour une règle métier plus complexe, implémentez sa validation finale avant de la mettre en production. Les exceptions déclenchent 3dis_multistep_validation_exception($exception, $form, $requested) et une erreur contrôlée ; un journal éventuel doit masquer les valeurs personnelles.

Interactions et recette

Multifiles raccorde son contrôle au filtre intermédiaire. PAYMENT garde ses vérifications serveur. Le parcours généré par Shop utilise ses propres classes de navigation : sa seule apparence en étapes ne prouve pas qu’il emploie cet addon. Choisissez un seul pilote pour un formulaire donné.

1. Ouvrez une page fraîche : aucune erreur ne doit apparaître spontanément.
2. Testez Suivant avec champs vides, invalides puis valides. Vérifiez une erreur réseau de validation sans envoi final.
3. Revenez en arrière, contrôlez les valeurs, le focus clavier et la progression sur mobile.
4. Testez séparément la soumission finale et les règles métier ; un passage à l’étape suivante n’est pas un envoi CF7.
5. Après minification ou différé, vérifiez initialisation, appels REST, formulaires multiples et apparition du paiement.

Mise à jour et restauration

Sauvegardez le contenu CF7, ses réglages Multistep, les modèles de courriels et les personnalisations. Installez le ZIP officiel, purgez les anciens scripts et rejouez la recette. En cas de régression, désactivez le découpage du formulaire ou restaurez une archive compatible avec sa configuration. La désactivation ne restaure pas un formulaire modifié : gardez sa copie. Ne supprimez pas les hooks de sécurité d’un autre plugin pour faire passer une étape.

Retrouver les autres documentations 3DIS · Assistance technique