Dokumentasi
Bagaimana cara mengaktifkan plugin ini?
Instal file zip tersebut di situs WordPress Anda. Gravity Forms harus sudah aktif.
Langkah 1: Instalasi
Masuk ke WordPress dan buka Plugin → Tambah Plugin → Unggah Plugin. Instal file zip dan aktifkan.
Langkah 2: Pengaturan
Pergi ke Geofence → Pengaturan, atau Formulir → Pengaturan → Geofence. Layar yang sama.
Kunci bersifat opsional. Lewati langkah ini jika Anda hanya menggunakan kode pos.
- Kunci API Google – diperlukan untuk menggambar area di peta. Aktifkan API JavaScript Peta, dan batasi kunci ke situs Anda. Area kode pos tidak memerlukan kunci. Jika Anda sudah menggunakan Autolengkapi Alamat untuk Gravity Forms, kita bisa menggunakan kunci itu sampai Anda memasukkan kunci di sini.
- Cari Koordinat dan sebuah Kunci API Geocoding – hanya jika Anda ingin kami menempatkan area yang digambar di peta dari alamat yang diketik. Ini harus berupa kunci yang berbeda dari yang di atas, dengan API Geocoding diaktifkan, dan tanpa batasan perujuk HTTP. Batasi berdasarkan IP sebagai gantinya. Area kode pos tidak pernah menggunakan ini.
Langkah 3: Buat area Anda
Pergi ke Geofence → Geofences, atau Formulir → Geofence. Tambahkan satu, beri judul, pilih kode pos atau bentuk peta, dan atur. Memesan. Letakkan area yang lebih kecil di atas area yang lebih besar.
Langkah 4: Aktifkan untuk formulir tersebut
Buka formulirnya, lalu Pengaturan → Geofence.
- Menyalakan Aktifkan Geofencing.
- Pilih area yang sesuai.
- Pilih Bidang Alamat (kolom Alamat atau kolom Teks Satu Baris).
- Memilih Blokir pengajuan tersebut atau Beri peringatan, tetapi izinkan pengajuan tersebut..
- Ubah Pesan di Luar Area jika Anda mau. Secara default, jawabannya adalah "Maaf, saat ini kami tidak melayani alamat tersebut."“
- Opsional: atur Zona Pencocokan Toko ke kolom Teks Tersembunyi atau Satu Baris. Itulah kolom yang akan dibaca oleh notifikasi dan logika kondisional.
Simpan Perubahan.
Langkah 5: Harga (hanya jika Anda menjual produk di formulir)
Pada formulir yang sama, buka Pengaturan → Harga Geofence. Simpan tab Geofence terlebih dahulu agar area Anda muncul di sini. Untuk setiap produk dengan harga tetap, pilih apakah produk tersebut dijual di setiap area pada formulir atau hanya di beberapa area, dan ketik harga yang berbeda jika bukan harga dasar. Di bawah Jika alamat tidak cocok dengan geofence., memilih Blokir pesanan tersebut (default) atau Harga dasar pengenaan biaya.
Langkah 6: Pemberitahuan
Membuka Pengaturan → Notifikasi. Tambahkan satu notifikasi per area, dan atur logika bersyarat pada kolom zona. Jika kolom tersebut adalah Little Rock, kirim ke littlerock@…
Selesai. Ulangi Langkah 4 pada formulir lain yang membutuhkannya.
Detail fitur
Area kode pos
Tempelkan kode pos atau ZIP, satu kode per baris atau dipisahkan dengan koma. Baris kosong diabaikan. Baris yang diawali dengan # Ini adalah catatan untuk dirimu sendiri.
- Akurat –
90210sesuai dengan kode tersebut. - Dimulai dengan –
606*cocok dengan kode apa pun yang diawali dengan606. - Jangkauan –
10001-10005Mencocokkan setiap angka dalam rentang tersebut, termasuk ujungnya. Kedua ujungnya membutuhkan jumlah digit yang sama.
Huruf kapital tidak berpengaruh. Spasi dan tanda hubung diabaikan pada pola yang tepat dan pola "dimulai dengan", jadi 90210-1234 pertandingan 90210, dan SW1A 1AA pertandingan SW1A1AA. Rentang dibaca sebelum pembersihan tersebut, sehingga rentang yang dipisahkan dengan tanda hubung tidak pernah diperlakukan sebagai kode pos yang dipisahkan dengan tanda hubung.
Kode pos diperiksa dan dicocokkan dengan alamat yang mereka kirimkan. Mereka tidak pernah menggunakan API pemetaan.
Area yang digambar pada peta
Gambarlah area tersebut di peta Google saat Anda mengedit geofence. Area-area ini sesuai dengan titik di peta, bukan hanya kode pos saja.
Poin itu berasal dari Autolengkapi Alamat untuk Gravity Forms jika berada di kolom alamat yang sama, atau dari pencarian jika Anda mengaktifkannya. Cari Koordinat dan menambahkan kunci API Geocoding. Anda tidak harus menggunakan Pelengkapan Otomatis Alamat.
Urutan: pertandingan pertama yang menang
Jika sebuah formulir memiliki lebih dari satu area, kami akan mengujinya sesuai urutan yang ditampilkan di Pengaturan Formulir → Geofence. Area pertama yang cocok akan menjadi zona. Letakkan area yang lebih kecil terlebih dahulu agar area yang luas tidak mencakup semuanya. Urutan yang sama akan memilih harga ketika dua area tumpang tindih.
Pengaturan pada setiap formulir
Setiap formulir memiliki tab Geofence-nya sendiri. Tidak ada yang berjalan sampai Anda mengaktifkannya. Aktifkan Geofencing untuk formulir itu.
Anda memilih area, kolom alamat, apakah akan memblokir atau memberi peringatan, pesan di luar area (teks biasa, ditampilkan di sebelah alamat), dan kolom opsional untuk menyimpan nama area.
Simpan nama area, lalu arahkan email tersebut.
Zona Pencocokan Toko Menulis judul area ke dalam kolom Teks Tersembunyi atau Satu Baris. Pilihan yang umum adalah Tersembunyi. Kolom angka tidak ditawarkan, karena nilainya adalah nama, bukan angka.
Jika mereka berada di suatu area, lapangan tersebut memegang gelar itu (misalnya, Little RockJika berada di luar setiap area yang Anda pilih, kolom tersebut kosong. Arahkan logika kondisional ke kolom tersebut untuk menampilkan atau menyembunyikan bagian-bagian formulir, dan buat satu notifikasi per area.
Gravity Forms membaca kolom tersebut seperti kolom lainnya, sehingga tag gabungannya sendiri juga berfungsi dalam notifikasi, bersamaan dengan {pb_geo:*} tag di bawah ini.
Pemeriksaan langsung dan pengiriman cek
Pemeriksaan saat mereka mengetik adalah untuk mereka. Ini memperbarui kolom area, peringatan, dan harga.
Saat mereka mengirimkan formulir, kami memeriksa kembali alamat dari area yang tersimpan di formulir tersebut. Kami tidak mempercayai apa yang dikirimkan oleh browser. Pemblokiran dan peringatan dilakukan setelah pemeriksaan kedua tersebut.
Wilayah pos selalu diperiksa dari alamat yang dikirimkan. Wilayah yang digambar di peta diperiksa dengan cara yang sama ketika Cari Koordinat sudah aktif. Jika titik peta hanya berasal dari browser (Pelengkapan Otomatis Alamat, dengan pencarian dimatikan), seseorang dapat mengubahnya. Tambahkan juga area pos, atau aktifkan pencarian, jika Anda memerlukan titik akhir yang pasti.
Ketika kami tidak dapat memasukkan alamat
Jika area tersebut memerlukan informasi yang tidak dimiliki alamat (hanya area yang digambar di peta, dan tidak ada lokasi di peta) atau pencarian gagal, kami akan membiarkan pengajuan tersebut lolos. Entri tersebut dicatat sebagai belum diperiksa, bukan sebagai di luar.
Formulir yang menjual produk adalah pengecualian. Di sana, Jika alamat tidak cocok dengan geofence. memutuskan, dan secara default diatur untuk diblokir, jadi alamat yang tidak dapat kami masukkan tidak dapat melakukan pemesanan sampai Anda mengubah pengaturan tersebut.
Nilai “di dalam” adalah Tidak, baik ketika berada di luar setiap area maupun ketika kita tidak dapat memeriksanya. Alasannya adalah apa yang membedakan keduanya. Jika kita tidak pernah memeriksa entri sama sekali, “di dalam” dibiarkan kosong sehingga tidak terlihat seperti jawaban Tidak yang pasti.
Harga berbeda per area
Pengaturan Formulir → Harga Geofence berfungsi pada kolom produk Gravity Forms yang memiliki harga tetap (produk tunggal dan produk tersembunyi). Fitur ini tidak mengubah produk dropdown, harga yang dihitung, atau kolom tempat pelanggan mengetikkan harga.
Harga yang tertera pada kolom produk adalah harga dasar. Untuk setiap produk yang Anda pilih:
- Dijual di setiap area geofence pada formulir ini, atau
- Hanya dijual di area geofence tertentu.
Kemudian tambahkan Penggantian harga pada area yang mengenakan biaya lain. Area tanpa penggantian tetap menggunakan harga dasar. Produk yang tidak ditawarkan oleh area tersebut akan dikeluarkan dari total dan ditolak jika mereka mencoba mengirimkannya. Untuk menyembunyikannya dari formulir juga, arahkan logika kondisional ke kolom area yang tersimpan.
Jika alamat tidak cocok dengan geofence. (di luar setiap area, atau kami tidak dapat menempatkannya) Anda dapat Blokir pesanan tersebut atau Harga dasar pengenaan biaya. Blokir adalah pengaturan default, dan berlaku terlepas dari apakah Anda memilih Blokir atau Peringatkan pada tab Geofence.
Harga dan total formulir akan diperbarui saat alamat berubah. Harga yang sebenarnya kami bebankan tersimpan pada entri, sehingga pesanan lama masih menunjukkan harga yang mereka bayarkan setelah Anda mengubah harga. Uji alamat Pada layar yang sama, aplikasi akan memeriksa alamat yang diketik dan membandingkannya dengan pengaturan yang terakhir Anda simpan.
Entri, tag, dan siapa yang dapat melihat apa
Geofence → Entri Daftar ini menampilkan semua pengajuan dari area yang ditugaskan kepada orang tersebut, di setiap formulir yang menggunakan geofence. Anda dapat memfilter berdasarkan area dan tag. Membuka sebuah entri akan menunjukkan ke mana entri tersebut dikirim, apa yang dipesan beserta harga yang dibebankan, dan apa yang mereka ketik.
Atur daftar tag sekali di bawah Geofence → Pengaturan → Tag Entri (satu per baris). Orang-orang menerapkan tag tersebut di layar entri, sehingga kata-kata yang sama berlaku di setiap area.
Dua peran muncul di layar Pengguna:
- Pengelola Geofence – menetapkan area yang ditugaskan kepada mereka, dan harga (termasuk Geofence → Harga, (yang tidak memerlukan akses Gravity Forms).
- Penampil Entri Geofence – membaca, memberi tag, dan mencatat entri dari area yang ditugaskan kepada mereka.
Menugaskan orang-orang di Pengguna yang Ditugaskan kotak saat Anda mengedit area. Kunci Google tetap berada di tangan administrator situs.
Contoh soal yang sudah dikerjakan
Lima wilayah pos. Dua layanan dijual di kelima wilayah tersebut, masing-masing dengan harga sendiri. Layanan ketiga hanya dijual di tiga wilayah, juga dengan harga sendiri. Pelanggan dapat memilih kombinasi apa pun yang ditawarkan oleh wilayah yang sesuai, dan alamat yang tidak tercakup tidak dapat melakukan pemesanan.
Nama wilayah tersimpan di formulir. Satu notifikasi akan muncul ketika kolom tersebut berisi North Little Rock. Notifikasi lain akan muncul ketika kolom tersebut berisi Lake County.
Tag gabungan
Nilai-nilai ini diambil dari nilai yang tersimpan pada entri. Gunakan nilai-nilai ini dalam notifikasi, konfirmasi, dan bidang tag gabungan Gravity Forms lainnya.
{pb_geo:fence_title} – nama area (teks yang sama seperti yang ditulis ke Simpan Zona yang Cocok). Kosong jika tidak ada area yang cocok.
{pb_geo:fence_id} – ID area. Kosong jika tidak ada area yang cocok.
{pb_geo:inside} – Ya atau Tidak. Kosong jika kami tidak pernah memeriksa entri tersebut, sehingga tidak terbaca sebagai "di luar" dengan pasti.“
{pb_geo:reason} – mengapa kami memutuskan demikian:
- Di dalam area geofence
- Di luar setiap geofence
- Tidak dapat diperiksa — alamat tersebut tidak memiliki kode pos atau koordinat yang sesuai.
- Tidak dapat diperiksa — tidak ada geofence yang dapat digunakan yang dipilih untuk formulir ini.
- Ditolak — alamat yang dikirimkan tidak dalam format yang dapat dibaca oleh plugin ini.
FAQ
Apakah saya memerlukan kunci API Google?
Hanya untuk menggambar area di peta, atau untuk mencari alamat yang diketik. Area kode pos tidak memerlukan tombol dan tidak memanggil Google. Tombol Peta digunakan untuk editor. Tombol Geocoding hanya digunakan saat Pencarian Koordinat diaktifkan.
Format kode pos apa yang berfungsi?
Kode pasti, awalan seperti 606*, dan rentang angka seperti 10001-10005. Satu pola per baris, atau koma. Lihat area kode pos di bawah Detail fitur.
Bagaimana jika lebih dari satu area cocok?
Kami menggunakan yang pertama dalam urutan. Harga di area tersebutlah yang berlaku.
Bisakah saya memberi peringatan kepada orang lain tanpa memblokir mereka?
Ya. Pilih Beri peringatan, tetapi izinkan pengajuan tersebut.. Pesan Anda tetap akan ditampilkan di sebelah alamat, dan nama area akan terisi otomatis jika cocok, sehingga email dan kolom tersembunyi tetap berfungsi. Satu pengecualian: pada formulir yang menjual produk, Jika alamat tidak cocok dengan geofence. Secara default, sistem diatur untuk memblokir, dan pengaturan itulah yang menentukan apakah alamat yang tidak cocok dapat melakukan pemesanan.
Bagaimana cara mengirim email berbeda untuk setiap wilayah?
Simpan nama area di bidang tersembunyi atau teks, lalu tambahkan notifikasi untuk setiap area dengan logika kondisional pada bidang tersebut.
Apakah pengecekan saat mereka mengetik sudah cukup untuk memblokir seseorang?
Tidak. Pemeriksaan itu untuk orang yang mengisi formulir. Kami memutuskan apakah akan memblokir atau tidak saat mereka mengirimkan formulir.
Bagaimana jika Anda tidak dapat mengetahui di mana alamat tersebut berada?
Pada formulir tanpa produk, kami membiarkannya dan menandai entri tersebut sebagai tidak dicentang, bukan di luar. Pada formulir yang menjual produk, Jika alamat tidak cocok dengan geofence. Pengaturan menentukan, dan secara default akan memblokir. Bagaimanapun, alasan pada entri tersebut akan memberi tahu Anda apa yang terjadi.
Apakah ini berfungsi pada formulir multi-halaman?
Ya. Kami hanya memeriksa halaman yang mereka kirimkan, jadi tombol "Selanjutnya" di halaman pertama tidak akan gagal karena alamat atau produk di halaman berikutnya.
Produk mana saja yang dapat memiliki harga berbeda per area?
Kolom produk yang memiliki harga tetap (produk tunggal dan produk tersembunyi). Bukan produk dropdown, harga yang dihitung, atau kolom "tentukan harga Anda sendiri".
Apakah saya memerlukan fitur Isi Otomatis Alamat untuk Gravity Forms?
Tidak. Jika kedua plugin berada pada kolom alamat yang sama, kami akan menggunakan kembali lokasi yang telah mereka pilih, sehingga area yang digambar di peta tidak memerlukan pencarian kedua. Area pos tidak pernah membutuhkannya. Area yang digambar di peta dapat menggunakan Koordinat Pencarian sebagai gantinya.
Bisakah saya menggunakannya di lebih dari satu formulir?
Ya. Area dapat digunakan kembali. Setiap formulir memiliki sakelar hidup/mati sendiri, daftar area, kolom alamat, pilihan blokir atau peringatkan, pesan, kolom area tersimpan, dan harga.
Peringatan tersebut hilang pada halaman yang tersimpan dalam cache. Apakah formulir tersebut masih dicentang?
Ya. Peringatan langsung dapat hilang jika sebuah halaman tersimpan dalam cache selama lebih dari satu hari. Kami tetap memeriksa alamat saat mereka mengirimkan formulir, dan kami tetap memblokir jika Anda mengaturnya untuk diblokir. Jika cache Anda menyimpan halaman lebih lama dari satu hari, keluarkan halaman formulir yang dibatasi secara geografis dari cache tersebut, atau perpendek durasi penyimpanannya.