Documentation
Comment puis-je activer le plugin ?
Installez le fichier zip sur votre site WordPress. Gravity Forms doit déjà être actif.
Étape 1 : Installation
Connectez-vous à WordPress et allez dans Extensions → Ajouter une extension → Téléverser une extension. Installez le fichier zip et activez-le.
Étape 2 : Paramètres
Aller à Géorepérage → Paramètres, ou Formulaires → Paramètres → Géorepérage. Même écran.
Les clés sont facultatives. Ignorez cette étape si vous utilisez uniquement des codes postaux.
- Clé API Google – nécessaire pour dessiner des zones sur la carte. Activez l'API Maps JavaScript et restreignez la clé à votre site. Les zones de codes postaux ne nécessitent pas de clé. Si vous utilisez déjà Autocomplétion d'adresses pour Gravity Forms, nous pouvons utiliser cette clé jusqu'à ce que vous en saisissiez une ici.
- Rechercher des coordonnées et un Clé d'API de géocodage – uniquement si vous souhaitez que nous insérions une zone dessinée sur une carte à partir d'une adresse saisie. Il doit s'agir d'une clé différente de la précédente, avec l'API Geocoding activée et sans restrictions de HTTP referrer. Restreignez-la plutôt par IP. Les zones de codes postaux n'utilisent jamais cela.
Étape 3 : Créez vos zones
Aller à Géofence → Géofences, ou Formulaires → Géofences. Ajoutez-y un, donnez-lui un titre, choisissez des codes postaux ou une forme de carte, et définissez Ordre. Placez les zones plus petites au-dessus des plus grandes.
Étape 4 : Activez-le pour le formulaire
Ouvrez le formulaire, puis Paramètres → Géorepérage.
- Allumer Activer le géorepérage.
- Sélectionnez les zones qui s'appliquent.
- Choisissez le Champ d'adresse (un champ « Adresse » ou un champ « Texte sur une seule ligne »).
- Choisir Bloquer l'envoi ou Avertir, mais autoriser la soumission.
- Modifier le Message hors zone Si vous le souhaitez. Par défaut, le message est : “ Désolé, nous ne desservons pas cette adresse pour le moment. ”
- Facultatif : ensemble Zone assortie du magasin dans un champ de texte caché ou sur une seule ligne. C'est ce champ que les notifications et la logique conditionnelle liront.
Enregistrer les modifications.
Étape 5 : Prix (uniquement si vous vendez des produits sur le formulaire)
Sur le même formulaire, ouvrez Paramètres → Tarification du géorepérage. Enregistrez d'abord l'onglet Géorepérage pour que vos zones apparaissent ici. Pour chaque produit à prix fixe, indiquez sur le formulaire s'il est vendu dans toutes les zones ou seulement dans certaines, et saisissez un prix différent du prix de base. Lorsque l'adresse ne correspond à aucune zone de géorepérage, choisir Bloquer la commande (par défaut) ou Prix de base des frais.
Étape 6 : Notifications
Ouvrir Paramètres → Notifications. Ajoutez une notification par zone et définissez une logique conditionnelle sur le champ « Zone ». Si ce champ contient « Little Rock », envoyez une notification à littlerock@…
Voilà. Répétez l'étape 4 sur tout autre formulaire qui le nécessite.
Détails des fonctionnalités
Zones de code postal
Saisissez les codes postaux, un par ligne ou séparés par des virgules. Les lignes vides sont ignorées. Une ligne commençant par # C'est une note à vous-même.
- Exact –
90210correspond à ce code. - Commence par –
606*correspond à tout code commençant par606. - Gamme –
10001-10005Correspond à tous les nombres de cette plage, y compris les extrémités. Les deux extrémités doivent avoir le même nombre de chiffres.
Les majuscules n'ont pas d'importance. Les espaces et les traits d'union sont ignorés dans les modèles exacts et les modèles “ commence par ”, donc 90210-1234 matchs 90210, et SW1A 1AA matchs SW1A1AA. Les plages sont lues avant ce nettoyage, donc une plage avec un trait d'union n'est jamais traitée comme un code postal avec un trait d'union.
Les zones postales sont vérifiées par rapport à l'adresse soumise. Aucune API de cartographie n'est jamais utilisée.
Zones dessinées sur une carte
Lors de la modification du périmètre géographique, dessinez la zone sur une carte Google. Ces zones correspondent à un point précis sur la carte, et non pas uniquement au code postal.
Ce point vient de Autocomplétion d'adresses pour Gravity Forms si elle se trouve dans le même champ d'adresse, ou à partir d'une recherche si vous l'avez activée Rechercher des coordonnées et ajouté une clé API de géocodage. L'utilisation de la saisie automatique des adresses n'est pas obligatoire.
Ordre : le premier match gagne
Si un formulaire comporte plusieurs zones, nous les testons dans l'ordre indiqué dans Paramètres du formulaire → Géorepérage. La première zone correspondante est définie comme la zone de test. Placez la zone la plus petite en premier afin qu'elle ne soit pas incluse par une zone plus large. Ce même ordre détermine les prix lorsque deux zones se chevauchent.
Paramètres sur chaque formulaire
Chaque formulaire possède son propre onglet Géorepérage. Rien ne s'exécute tant que vous ne l'activez pas. Activer le géorepérage pour ce formulaire.
Vous choisissez les zones, le champ d'adresse, si vous souhaitez bloquer ou avertir, le message hors zone (texte brut, affiché à côté de l'adresse) et un champ facultatif pour stocker le nom de la zone.
Enregistrez le nom de la zone, puis acheminez l'e-mail.
Zone assortie du magasin Saisit le titre de la zone dans un champ texte masqué ou sur une seule ligne. Le champ masqué est généralement privilégié. Les champs numériques ne sont pas disponibles, car la valeur est un nom et non un nombre.
S'ils se trouvent dans une zone, le champ porte ce titre (par exemple Little RockSi les champs se trouvent en dehors des zones sélectionnées, ils sont vides. Utilisez une logique conditionnelle pour afficher ou masquer des parties du formulaire et créez une notification par zone.
Gravity Forms interprète ce champ comme n'importe quel autre, donc sa propre balise de fusion fonctionne également dans une notification, en plus de celle-ci. {pb_geo:*} Étiquettes ci-dessous.
Le contrôle en direct et le contrôle de soumission
La vérification en temps réel est effectuée pour eux. Elle met à jour le champ de zone, l'avertissement et les prix.
Lors de la soumission, nous vérifions à nouveau l'adresse à partir des champs enregistrés dans le formulaire. Nous ne faisons pas confiance aux données transmises par le navigateur. Un blocage et un avertissement sont déclenchés suite à cette seconde vérification.
Les zones postales sont toujours vérifiées à partir de l'adresse saisie. Les zones délimitées sur la carte sont vérifiées de la même manière. Rechercher des coordonnées L'option est activée. Si le point sur la carte provient uniquement du navigateur (saisie semi-automatique des adresses, sans recherche), il pourrait être modifié. Ajoutez également une zone postale, ou activez la recherche, si vous avez besoin d'une limite précise.
Lorsque nous ne pouvons pas placer l'adresse
Si les zones nécessitent des informations que l'adresse ne contient pas (zones cartographiées uniquement, sans localisation précise sur la carte) ou si la recherche échoue, la soumission est autorisée. Cette entrée est enregistrée comme non vérifiée, et non comme hors-zone.
Les formulaires qui vendent des produits constituent l'exception. Dans ce cas, Lorsque l'adresse ne correspond à aucune zone de géorepérage décide, et ce paramètre est configuré pour bloquer par défaut, donc une adresse que nous n'avons pas pu placer ne peut pas passer de commande tant que vous n'aurez pas modifié ce paramètre.
La valeur “ intérieur ” est “ Non ” aussi bien lorsque l'élément se situe en dehors de toute zone que lorsque la vérification est impossible. C'est la raison qui permet de les distinguer. Si l'élément n'a jamais été vérifié, la valeur « intérieur » reste vide, ce qui ne donne pas l'impression d'une réponse « Non » catégorique.
Prix différents selon la zone
Paramètres du formulaire → La tarification par géorepérage s'applique aux champs de produit Gravity Forms dont le prix est fixe (produit unique et produit masqué). Elle ne modifie pas les produits des listes déroulantes, les prix calculés ni les champs où le client saisit le prix.
Le prix indiqué dans le champ « Produit » est le prix de base. Pour chacun des produits que vous sélectionnez :
- Vendu dans chaque zone géographique définie par ce formulaire, ou
- Vendu uniquement dans certaines zones géographiques.
Ajoutez ensuite un Remplacement du prix Dans les zones où un prix différent est appliqué, le prix de base est conservé pour les zones sans modification. Un produit non proposé par une zone donnée est exclu du total et la commande est refusée lors de sa validation. Pour masquer également ce champ dans le formulaire, appliquez une logique conditionnelle au champ de zone enregistrée.
Lorsque l'adresse ne correspond à aucune zone de géorepérage (en dehors de chaque zone, sinon nous n'aurions pas pu le placer) vous pouvez Bloquer la commande ou Prix de base des frais. L'option « Bloquer » est sélectionnée par défaut et s'applique que vous ayez choisi « Bloquer » ou « Avertir » dans l'onglet Géorepérage.
Les prix et le total du formulaire sont mis à jour automatiquement en cas de changement d'adresse. Le prix facturé est enregistré dans la fiche produit ; ainsi, même après modification du prix, une ancienne commande affichera toujours le montant payé. Tester une adresse Sur le même écran, l'adresse saisie est comparée aux paramètres que vous avez enregistrés en dernier lieu.
Articles, étiquettes et qui peut voir quoi
Géorepérage → Entrées Cette liste répertorie les soumissions provenant des zones attribuées à cette personne, pour tous les formulaires utilisant une géolocalisation. Vous pouvez filtrer par zone et par étiquette. En ouvrant une entrée, vous verrez sa provenance, les articles commandés aux prix indiqués et le texte saisi.
Configurez la liste des étiquettes une seule fois sous Géorepérage → Paramètres → Étiquettes d'entrée (Une par ligne). Ces étiquettes sont apposées sur le panneau d'entrée, de sorte que les mêmes mots sont utilisés dans toutes les zones.
Deux rôles apparaissent sur l'écran Utilisateurs :
- Gestionnaire de géorepérage – définit les zones qui leur sont attribuées, ainsi que les prix (y compris Géorepérage → Tarification, qui ne nécessite pas l'accès à Gravity Forms).
- Visualiseur d'entrées de géorepérage – lit, étiquette et prend des notes sur les entrées provenant des zones qui lui sont assignées.
Affecter des personnes dans le Utilisateurs désignés Une boîte s'affiche lorsque vous modifiez une zone. Les clés Google restent la propriété de l'administrateur du site.
Un exemple concret
Cinq zones postales. Deux services sont proposés dans les cinq zones, chacun à son propre tarif. Un troisième service est proposé dans seulement trois zones, également à son propre tarif. Le client choisit la combinaison de services disponible dans la zone sélectionnée ; une adresse non couverte par votre service ne peut pas passer commande.
Le nom de la zone est enregistré sur le formulaire. Une notification est envoyée lorsque ce champ contient « North Little Rock », et une autre lorsqu'il contient « Lake County ».
Balises de fusion
Ces champs récupèrent les valeurs enregistrées dans l'entrée. Utilisez-les dans les notifications, les confirmations et tout autre champ de fusion de Gravity Forms.
{pb_geo:fence_title} – le nom de la zone (le même texte que celui indiqué dans « Zone correspondante dans la base de données »). Vide si aucune zone ne correspond.
{pb_geo:fence_id} – l’identifiant de la zone. Vide si aucune zone ne correspond.
{pb_geo:inside} – Oui ou Non. Vide si nous n'avons jamais vérifié l'entrée, elle ne peut donc pas être interprétée comme une réponse “ extérieure ” certaine.”
{pb_geo:reason} – pourquoi nous avons pris cette décision :
- À l'intérieur d'une zone géographique délimitée
- En dehors de chaque zone géorepérée
- Impossible de vérifier : l’adresse ne comportait ni code postal ni coordonnées.
- Impossible de vérifier : aucune zone géographique utilisable n’a été sélectionnée pour ce formulaire.
- Rejeté — l'adresse soumise n'était pas dans un format lisible par ce plugin.
FAQ
Ai-je besoin d'une clé d'API Google ?
Ce champ sert uniquement à dessiner des zones sur la carte ou à rechercher une adresse saisie. Les codes postaux ne nécessitent aucun champ et n'interrogent pas Google. Le champ « Cartes » est réservé à l'éditeur. Le champ « Géocodage » est utilisé uniquement lorsque l'option « Rechercher des coordonnées » est activée.
Quels formats de code postal sont acceptés ?
Codes exacts, préfixes comme 606*, et des plages de nombres comme 10001-10005. Un motif par ligne, ou des virgules. Voir les zones de code postal dans la section « Détails de la fonctionnalité ».
Que se passe-t-il si plusieurs zones correspondent ?
Nous utilisons la première option de la commande. Ce sont les prix de cette zone qui s'appliquent.
Puis-je avertir les gens sans les bloquer ?
Oui. Choisissez Avertir, mais autoriser la soumission. Votre message s'affiche toujours à côté de l'adresse et le nom de la zone se remplit automatiquement lorsqu'ils correspondent ; les adresses e-mail et les champs cachés fonctionnent donc toujours. Une exception : sur un formulaire de vente de produits, Lorsque l'adresse ne correspond à aucune zone de géorepérage est configuré pour bloquer par défaut, et c'est ce paramètre qui détermine si une adresse non appariée peut passer une commande.
Comment envoyer des e-mails différents selon la zone géographique ?
Enregistrez le nom de la zone dans un champ caché ou un champ texte, puis ajoutez une notification pour chaque zone avec une logique conditionnelle sur ce champ.
Le fait de vérifier pendant qu'ils tapent est-il suffisant pour bloquer quelqu'un ?
Non. Ce contrôle concerne la personne qui remplit le formulaire. Nous décidons du blocage au moment de la soumission.
Que faire si vous ne pouvez pas indiquer l'adresse ?
Sur un formulaire sans produits, nous autorisons la saisie et la indiquons comme non cochée plutôt qu'excentrée. Sur un formulaire de vente de produits, Lorsque l'adresse ne correspond à aucune zone de géorepérage Le paramétrage détermine le problème et bloque l'accès par défaut. Dans tous les cas, la raison indiquée dans l'entrée vous explique ce qui s'est passé.
Est-ce que cela fonctionne avec des formulaires multipages ?
Oui. Nous vérifions uniquement la page qu'ils soumettent ; ainsi, la page suivante ne sera pas bloquée à cause d'une adresse ou d'un produit figurant sur une page ultérieure.
Quels produits peuvent avoir un prix différent selon la zone géographique ?
Champs de produit avec un prix fixe (produit unique et produit masqué). À l'exclusion des produits à liste déroulante, des prix calculés et des champs “ prix libre ”.
Ai-je besoin de la fonction de saisie automatique des adresses pour Gravity Forms ?
Non. Si les deux modules complémentaires sont associés au même champ d'adresse, nous réutilisons l'emplacement qu'ils ont déjà sélectionné. Ainsi, une zone dessinée sur la carte n'a pas besoin d'une seconde recherche. Les zones postales n'en ont jamais besoin. Les zones dessinées sur la carte peuvent utiliser la fonction « Rechercher des coordonnées ».
Puis-je l'utiliser sur plusieurs formulaires ?
Oui. Les zones sont réutilisables. Chaque formulaire possède son propre interrupteur marche/arrêt, une liste de zones, un champ d'adresse, une option de blocage ou d'avertissement, un message, un champ de zone enregistrée et des prix.
L'avertissement a disparu sur la page en cache. Le formulaire est-il toujours coché ?
Oui. L'alerte en direct peut se désactiver si une page reste en cache pendant plus d'une journée. Nous vérifions toujours l'adresse lors de la soumission et bloquons toujours les pages si vous avez configuré le blocage. Si votre cache conserve les pages plus d'une journée, excluez les formulaires géolocalisés de ce cache ou réduisez leur durée de conservation.