Dokumentation
Wie aktiviere ich das Plugin?
Installieren Sie die ZIP-Datei auf Ihrer WordPress-Website. Gravity Forms muss bereits aktiviert sein.
Schritt 1: Installation
Melden Sie sich bei WordPress an und gehen Sie zu Plugins → Plugin hinzufügen → Plugin hochladen. Installieren Sie die ZIP-Datei und aktivieren Sie sie.
Schritt 2: Einstellungen
Gehe zu Geofencing → Einstellungen, oder Formulare → Einstellungen → Geofencing. Derselbe Bildschirm.
Die Angabe von Schlüsseln ist optional. Überspringen Sie diesen Schritt, wenn Sie nur Postleitzahlen verwenden.
- Google API-Schlüssel – Wird benötigt, um Bereiche auf der Karte darzustellen. Aktivieren Sie die Maps JavaScript API und beschränken Sie den Schlüssel auf Ihre Website. Postleitzahlengebiete benötigen keinen Schlüssel. Wenn Sie diese API bereits verwenden, … Adressen-Autovervollständigung für Gravity Forms, Wir können diesen Schlüssel so lange verwenden, bis Sie hier einen eingeben.
- Koordinaten nachschlagen und ein Geocoding-API-Schlüssel – Nur wenn Sie möchten, dass wir einen Kartenausschnitt anhand einer eingegebenen Adresse erstellen. Hierfür muss ein anderer Schlüssel als der oben genannte verwendet werden, die Geocoding-API muss aktiviert sein und es dürfen keine HTTP-Referrer-Beschränkungen gelten. Beschränken Sie die Suche stattdessen auf die IP-Adresse. Postleitzahlengebiete werden dafür nie verwendet.
Schritt 3: Erstellen Sie Ihre Bereiche
Gehe zu Geofence → Geofences, oder Formulare → Geofences. Fügen Sie eine Karte hinzu, geben Sie ihr einen Titel, wählen Sie Postleitzahlen oder eine Kartenform aus und legen Sie fest Befehl. Platzieren Sie kleinere Bereiche über größeren.
Schritt 4: Schalten Sie es für das Formular ein.
Öffnen Sie das Formular, dann Einstellungen → Geofencing.
- Einschalten Geofencing aktivieren.
- Wählen Sie die zutreffenden Bereiche aus.
- Wähle die Adressfeld (ein Adressfeld oder ein einzeiliges Textfeld).
- Wählen Blockieren Sie die Einreichung oder Warnung aussprechen, aber die Einreichung zulassen.
- Ändern Sie die Außerhalb des Bereichs gemeldet Wenn Sie möchten. Standardmäßig lautet die Antwort: “Leider bedienen wir diese Adresse derzeit nicht.”
- Optional: Einstellung Speicherbereich anpassen in ein ausgeblendetes oder einzeiliges Textfeld. Aus diesem Feld werden Benachrichtigungen und bedingte Logik ausgelesen.
Änderungen speichern.
Schritt 5: Preise (nur wenn Sie Produkte über das Formular verkaufen)
Im selben Formular öffnen Einstellungen → Geofencing-Preisgestaltung. Speichern Sie zuerst den Geofence-Tab, damit Ihre Bereiche hier angezeigt werden. Wählen Sie für jedes Produkt mit einem Festpreis aus, ob es in allen Bereichen des Formulars oder nur in einigen verkauft wird, und geben Sie einen anderen Preis ein, wenn es nicht der Basispreis ist. Unter Wenn die Adresse keinem Geofence entspricht, wählen Bestellung blockieren (Standardeinstellung) oder Grundpreise.
Schritt 6: Benachrichtigungen
Öffnen Einstellungen → Benachrichtigungen. Füge pro Gebiet eine Benachrichtigung hinzu und lege eine bedingte Logik für das Zonenfeld fest. Wenn dieses Feld „Little Rock“ lautet, sende die Benachrichtigung an littlerock@…
Das war's. Wiederholen Sie Schritt 4 für jedes weitere Formular, das dies erfordert.
Funktionsdetails
Postleitzahlengebiete
Fügen Sie Postleitzahlen ein, entweder eine pro Zeile oder durch Kommas getrennt. Leere Zeilen werden ignoriert. Eine Zeile, die mit einem Komma beginnt, wird nicht berücksichtigt. # ist eine Notiz an dich selbst.
- Genau –
90210entspricht diesem Code. - Beginnt mit –
606*entspricht jedem Code, der mit606. - Reichweite –
10001-10005Die Zahl passt zu jeder Zahl in diesem Bereich, einschließlich der Enden. Beide Enden benötigen die gleiche Anzahl an Ziffern.
Großbuchstaben spielen keine Rolle. Leerzeichen und Bindestriche werden bei exakten und “beginnt mit”-Mustern ignoriert, also 90210-1234 Spiele 90210, und SW1A 1AA Spiele SW1A1AA. Bereiche werden vor dieser Bereinigung gelesen, daher wird ein Bereich mit Bindestrichen niemals als Postleitzahl mit Bindestrichen behandelt.
Die Postleitzahlengebiete werden mit der angegebenen Adresse abgeglichen. Es wird niemals eine Karten-API aufgerufen.
auf einer Karte eingezeichnete Bereiche
Zeichnen Sie den Bereich auf einer Google-Karte ein, wenn Sie den Geofence bearbeiten. Diese Bereiche entsprechen einem Punkt auf der Karte, nicht nur der Postleitzahl.
Dieser Punkt ergibt sich aus Adressen-Autovervollständigung für Gravity Forms wenn es sich um dasselbe Adressfeld handelt, oder aus einer Nachschlagetabelle, wenn Sie die Option aktiviert haben Koordinaten nachschlagen und einen Geocoding-API-Schlüssel hinzugefügt. Die Adress-Autovervollständigung muss nicht verwendet werden.
Reihenfolge: Wer zuerst kommt, mahlt zuerst.
Wenn ein Formular mehrere Bereiche enthält, werden diese in der Reihenfolge unter Formulareinstellungen → Geofence geprüft. Der erste übereinstimmende Bereich wird als Zone festgelegt. Der kleinere Bereich sollte zuerst ausgewählt werden, damit er nicht von einem größeren Bereich überlagert wird. Die Preise werden in derselben Reihenfolge ermittelt, wenn sich zwei Bereiche überlappen.
Einstellungen für jedes Formular
Jedes Formular hat einen eigenen Geofence-Reiter. Nichts funktioniert, bis Sie ihn aktivieren. Geofencing aktivieren für dieses Formular.
Sie wählen die Bereiche, das Adressfeld, ob blockiert oder gewarnt werden soll, die Meldung für Personen außerhalb des Bereichs (Klartext, der neben der Adresse angezeigt wird) und ein optionales Feld zum Speichern des Bereichsnamens.
Speichern Sie den Bereichsnamen und leiten Sie dann die E-Mail weiter.
Speicherbereich anpassen Schreibt den Bereichstitel in ein ausgeblendetes oder einzeiliges Textfeld. Ausgeblendet ist die übliche Auswahl. Zahlenfelder werden nicht angeboten, da der Wert ein Name und keine Zahl ist.
Befinden sie sich in einem Bereich, trägt das Feld diesen Titel (zum Beispiel Little RockBefinden sich die Benutzer außerhalb aller ausgewählten Bereiche, bleibt das Feld leer. Verwenden Sie bedingte Logik, um Teile des Formulars ein- oder auszublenden und erstellen Sie für jeden Bereich eine separate Benachrichtigung.
Gravity Forms liest dieses Feld wie jedes andere, daher funktioniert sein eigenes Merge-Tag auch in einer Benachrichtigung, zusammen mit dem {pb_geo:*} Tags unten.
Der Live-Check und der Submit-Check
Die Überprüfung während der Eingabe dient dazu, das Gebietsfeld, die Warnung und die Preise zu aktualisieren.
Nach dem Absenden überprüfen wir die Adresse erneut anhand der im Formular gespeicherten Felder. Wir vertrauen nicht den Angaben des Browsers. Im Anschluss an diese zweite Überprüfung werden die Anfragen blockiert und eine Warnung ausgegeben.
Postleitzahlengebiete werden immer anhand der angegebenen Adresse überprüft. Kartengebiete werden auf die gleiche Weise überprüft, wenn Koordinaten nachschlagen Wenn der Kartenpunkt nur vom Browser stammt (Adressvervollständigung, Adresssuche deaktiviert), könnte ihn jemand ändern. Fügen Sie zusätzlich ein Postleitzahlgebiet hinzu oder aktivieren Sie die Adresssuche, falls ein eindeutiger Endpunkt erforderlich ist.
Wenn wir die Adresse nicht angeben können
Wenn die benötigten Informationen zur Adresse fehlen (z. B. nur eingezeichnete Bereiche ohne Ortsangabe auf der Karte) oder eine Suche fehlschlägt, lassen wir die Eingabe zu. Dieser Eintrag wird als ungeprüft, nicht als außerhalb liegend, vermerkt.
Formulare, die Produkte verkaufen, bilden die Ausnahme. Dort, Wenn die Adresse keinem Geofence entspricht entscheidet, und ist standardmäßig auf Blockierung eingestellt, sodass eine Adresse, an die wir keine Bestellung aufgeben konnten, erst dann eine Bestellung aufgeben kann, wenn Sie diese Einstellung ändern.
Der Wert “innen” ist “Nein”, sowohl wenn die Einträge außerhalb aller Bereiche liegen als auch wenn wir sie nicht überprüfen konnten. Der Grund dafür ist das Unterscheidungsmerkmal. Wenn wir den Eintrag überhaupt nicht überprüft haben, bleibt „innen“ leer, sodass es nicht wie ein eindeutiges „Nein“ aussieht.
Unterschiedliche Preise je nach Gebiet
Formulareinstellungen → Geofencing-Preisgestaltung funktioniert für Produktfelder in Gravity Forms mit einem festgelegten Preis (Einzelprodukte und versteckte Produkte). Dropdown-Produkte, berechnete Preise oder Felder, in denen der Kunde den Preis eingibt, werden nicht geändert.
Der im Produktfeld angegebene Preis ist der Basispreis. Für jedes der von Ihnen ausgewählten Produkte gilt Folgendes:
- Verkauft in jedem Geofence auf diesem Formular, oder
- Verkauf nur in ausgewählten Geofences
Füge dann ein Preisüberschreibung In Gebieten mit abweichenden Gebühren gilt Folgendes: Gebiete ohne Preisanpassung behalten den Basispreis. Produkte, die in einem solchen Gebiet nicht angeboten werden, werden nicht in die Gesamtsumme einbezogen und bei der Eingabe abgelehnt. Um diese Produkte auch im Formular auszublenden, kann eine bedingte Logik auf das Feld für das gespeicherte Gebiet angewendet werden.
Wenn die Adresse keinem Geofence entspricht (außerhalb jedes Bereichs, sonst könnten wir es nicht platzieren) Sie können Bestellung blockieren oder Grundpreise. Blockieren ist die Standardeinstellung und gilt unabhängig davon, ob Sie auf der Registerkarte Geofence die Option Blockieren oder Warnen ausgewählt haben.
Preise und Gesamtbetrag werden bei Adressänderungen aktualisiert. Der tatsächlich berechnete Preis wird im Eintrag gespeichert, sodass eine ältere Bestellung auch nach einer Preisänderung weiterhin den bezahlten Preis anzeigt. Adresse testen Auf demselben Bildschirm wird eine eingegebene Adresse mit den zuletzt gespeicherten Einstellungen abgeglichen.
Einträge, Schlagwörter und wer was sehen kann
Geofence → Einträge Die Liste zeigt alle Eingaben aus den dem jeweiligen Nutzer zugewiesenen Bereichen in allen Formularen mit Geofence-Funktion an. Sie können nach Bereich und Schlagwort filtern. Beim Öffnen eines Eintrags wird angezeigt, wo die Eingabe erfolgte, was zu den berechneten Preisen bestellt wurde und was der Nutzer eingegeben hat.
Legen Sie die Tag-Liste einmalig unter Geofence → Einstellungen → fest. Eintrags-Tags (Eins pro Zeile). Die Nutzer wenden diese Tags auf dem Eingabebildschirm an, sodass dieselben Wörter in allen Bereichen funktionieren.
Auf dem Benutzerbildschirm werden zwei Rollen angezeigt:
- Geofencing-Manager – legt die ihnen zugewiesenen Bereiche und die Preise fest (einschließlich Geofencing → Preisgestaltung, (was keinen Zugriff auf Gravity Forms erfordert).
- Geofence-Eintrittsanzeige – liest, kennzeichnet und vermerkt Einträge aus den ihnen zugewiesenen Bereichen.
Weisen Sie den folgenden Personen die Aufgaben zu: Zugewiesene Benutzer Beim Bearbeiten eines Bereichs erscheint ein Eingabefeld. Die Google-Schlüssel verbleiben beim Website-Administrator.
Ein ausgearbeitetes Beispiel
Fünf Postleitzahlgebiete. Zwei Dienstleistungen werden in allen fünf Gebieten angeboten, jede zu einem eigenen Preis. Eine dritte Dienstleistung wird nur in drei Gebieten angeboten, ebenfalls zu einem eigenen Preis. Der Kunde wählt eine beliebige Kombination aus den Angeboten des jeweiligen Gebiets. Bestellungen von Adressen, die nicht in Ihrem Zuständigkeitsbereich liegen, sind nicht möglich.
Der Gebietsname ist im Formular gespeichert. Eine Benachrichtigung wird ausgelöst, wenn das Feld „North Little Rock“ lautet. Eine weitere Benachrichtigung wird ausgelöst, wenn es „Lake County“ lautet.
Serienbrieffelder
Diese rufen die im Eintrag gespeicherten Werte ab. Verwenden Sie sie in Benachrichtigungen, Bestätigungen und allen anderen Gravity Forms-Merge-Tag-Feldern.
{pb_geo:fence_title} – der Bereichsname (derselbe Text wie bei „Übereinstimmende Zone speichern“). Leer, wenn kein Bereich übereinstimmt.
{pb_geo:fence_id} – die Bereichs-ID. Leer, wenn kein Bereich übereinstimmt.
{pb_geo:inside} – Ja oder Nein. Leer, wenn wir den Eintrag nie überprüft haben, damit er nicht als eindeutiges “draußen” interpretiert wird.”
{pb_geo:reason} – warum wir uns dafür entschieden haben:
- Innerhalb eines Geofence
- Außerhalb jedes Geofence
- Konnte nicht überprüft werden – die Adresse hatte keine Postleitzahl oder Koordinaten zum Abgleich.
- Konnte nicht überprüft werden – für dieses Formular wurden keine nutzbaren Geofences ausgewählt.
- Abgelehnt – die übermittelte Adresse lag in einem für dieses Plugin unlesbaren Format vor.
FAQs
Benötige ich einen Google API-Schlüssel?
Nur zum Zeichnen von Bereichen auf der Karte oder zum Nachschlagen einer eingegebenen Adresse. Postleitzahlengebiete benötigen keine Taste und rufen Google nicht auf. Die Kartentaste ist für den Editor. Die Geocodierungstaste wird nur verwendet, wenn die Koordinatensuche aktiviert ist.
Welche Postleitzahlenformate funktionieren?
Genaue Codes, Präfixe wie 606*, und Zahlenbereiche wie 10001-10005. Ein Muster pro Zeile oder Kommas. Siehe Postleitzahlengebiete unter „Feature-Details“.
Was passiert, wenn mehrere Bereiche übereinstimmen?
Wir verwenden den ersten Eintrag in der Reihenfolge. Es gelten die Preise dieses Bereichs.
Kann ich Leute warnen, ohne sie zu blockieren?
Ja. Auswählen Warnung aussprechen, aber die Einreichung zulassen. Ihre Nachricht wird weiterhin neben der Adresse angezeigt, und der Bereichsname wird weiterhin automatisch eingefügt, wenn sie übereinstimmen. E-Mails und ausgeblendete Felder funktionieren also weiterhin. Eine Ausnahme: Bei einem Formular, das Produkte verkauft, Wenn die Adresse keinem Geofence entspricht ist standardmäßig auf Blockierung eingestellt, und diese Einstellung entscheidet darüber, ob eine nicht übereinstimmende Adresse eine Bestellung aufgeben kann.
Wie kann ich für jede Region unterschiedliche E-Mails versenden?
Speichern Sie den Bereichsnamen in einem versteckten Feld oder einem Textfeld und fügen Sie dann für jeden Bereich eine Benachrichtigung mit bedingter Logik für dieses Feld hinzu.
Reicht die Überprüfung während der Eingabe aus, um jemanden zu blockieren?
Nein. Diese Prüfung gilt für die Person, die das Formular ausfüllt. Wir entscheiden erst nach dem Absenden, ob wir die Sperre aktivieren.
Was, wenn Sie nicht wissen, wo sich die Adresse befindet?
Bei einem Formular ohne Produkte lassen wir es durch und kennzeichnen den Eintrag als nicht geprüft, anstatt als außerhalb. Bei einem Formular, das Produkte verkauft, Wenn die Adresse keinem Geofence entspricht Die Einstellungen entscheiden darüber, und standardmäßig wird blockiert. In jedem Fall gibt der Grund im Eintrag an, was passiert ist.
Funktioniert es auch bei mehrseitigen Formularen?
Ja. Wir prüfen nur die Seite, die sie einreichen. Daher schlägt die Weiter-Funktion auf Seite eins nicht fehl, weil sich auf einer späteren Seite eine Adresse oder ein Produkt befindet.
Welche Produkte können je nach Region unterschiedliche Preise haben?
Produktfelder mit einem Festpreis (Einzelprodukte und versteckte Produkte). Ausgenommen sind Dropdown-Produkte, berechnete Preise und Felder mit der Option “Preis selbst bestimmen”.
Benötige ich die Adress-Autovervollständigung für Gravity Forms?
Nein. Wenn beide Plugins dasselbe Adressfeld verwenden, wird der bereits ausgewählte Standort wiederverwendet. Daher ist für kartografisch dargestellte Bereiche keine zweite Suche erforderlich. Postleitzahlengebiete benötigen dies grundsätzlich nicht. Für kartografisch dargestellte Bereiche können stattdessen Koordinaten gesucht werden.
Kann ich es auf mehr als einem Formular verwenden?
Ja. Bereiche sind wiederverwendbar. Jedes Formular verfügt über einen eigenen Ein-/Ausschalter, eine Bereichsliste, ein Adressfeld, eine Option zum Blockieren oder Warnen, eine Nachricht, ein Feld zum Speichern von Bereichen und Preise.
Die Warnung verschwand auf der zwischengespeicherten Seite. Ist das Formular noch ausgewählt?
Ja. Die Live-Warnung kann ausfallen, wenn eine Seite länger als einen Tag im Cache verbleibt. Wir überprüfen die Adresse weiterhin beim Absenden und blockieren die Seite weiterhin, wenn Sie dies aktiviert haben. Wenn Ihr Cache Seiten länger als einen Tag speichert, sollten Sie standortbezogene Formularseiten aus dem Cache entfernen oder deren Speicherdauer verkürzen.