Documentación
¿Cómo habilito el plugin?
Instala el archivo zip en tu sitio de WordPress. Gravity Forms debe estar activado previamente.
Paso 1: Instalación
Inicia sesión en WordPress y ve a Plugins → Añadir plugin → Subir plugin. Instala el archivo zip y actívalo.
Paso 2: Ajustes
Ir a Geocerca → Configuración, o Formularios → Configuración → Geocerca. Misma pantalla.
Las claves son opcionales. Omita este paso si solo va a usar códigos postales.
- Clave API de Google – necesario para dibujar áreas en el mapa. Active la API de JavaScript de Mapas y restrinja la clave a su sitio. Las áreas de código postal no necesitan una clave. Si ya utiliza Autocompletado de direcciones para Gravity Forms, podemos usar esa clave hasta que ingreses una aquí.
- Buscar coordenadas y un Clave API de geocodificación —Solo si desea que muestremos un área en el mapa a partir de una dirección ingresada. Debe ser una clave diferente a la anterior, con la API de geocodificación activada y sin restricciones de referencia HTTP. Restrinja el acceso por IP. Las áreas de código postal nunca utilizan esta función.
Paso 3: Crea tus áreas
Ir a Geocerca → Geocercas, o Formularios → Geocercas. Añade uno, dale un título, elige códigos postales o una forma de mapa y configura Orden. Coloca las áreas más pequeñas encima de las más grandes.
Paso 4: Enciéndelo para el formulario
Abra el formulario y luego Configuración → Geocerca.
- Encender Habilitar geovallado.
- Seleccione las áreas que correspondan.
- Elige el Campo de dirección (un campo de dirección o un campo de texto de una sola línea).
- Elegir Bloquear el envío o Advertir, pero permitir el envío.
- Cambiar el Mensaje de fuera de área Si lo desea. Por defecto, aparece el mensaje: “Lo sentimos, actualmente no ofrecemos servicio en esa dirección”.”
- Opcional: establecer Zona de tiendas coincidentes en a un campo de texto oculto o de una sola línea. Ese es el campo que leerán las notificaciones y la lógica condicional.
Guardar cambios.
Paso 5: Precios (solo si vende productos en el formulario)
En el mismo formulario, abrir Configuración → Precios de geocercas. Primero, guarda la pestaña Geocerca para que tus áreas aparezcan aquí. Para cada producto con un precio fijo, elige si se vende en todas las áreas del formulario o solo en algunas, e introduce un precio diferente donde no sea el precio base. En Cuando la dirección no coincide con ninguna geocerca, elegir Bloquear el pedido (el valor predeterminado) o Cobrar precios base.
Paso 6: Notificaciones
Abrir Ajustes → Notificaciones. Agregue una notificación por área y configure la lógica condicional en el campo de zona. Si ese campo es Little Rock, envíe a littlerock@…
Eso es todo. Repita el paso 4 en cualquier otro formulario que lo requiera.
Detalles de la característica
áreas de código postal
Pegue los códigos postales o ZIP, uno por línea o separados por comas. Las líneas en blanco se ignoran. Una línea que comienza con # Es una nota para ti mismo.
- Exacto –
90210coincide con ese código. - Comienza con –
606*coincide con cualquier código que comience con606. - Rango –
10001-10005Coincide con todos los números de ese rango, incluidos los extremos. Ambos extremos necesitan la misma cantidad de dígitos.
Las mayúsculas no importan. Los espacios y guiones se ignoran en patrones exactos y de "comienza con", por lo que 90210-1234 partidos 90210, y SW1A 1AA partidos SW1A1AA. Los rangos se leen antes de esa limpieza, por lo que un rango con guion nunca se trata como un código postal con guion.
Las zonas postales se cotejan con la dirección que proporcionaron. Nunca utilizan una API de mapeo.
Áreas dibujadas en un mapa
Al editar la geocerca, dibuje el área en un mapa de Google. Estas áreas coinciden con un punto en el mapa, no solo con el código postal.
Ese punto proviene de Autocompletado de direcciones para Gravity Forms si está en el mismo campo de dirección, o de una búsqueda si lo activó Buscar coordenadas y se agregó una clave API de geocodificación. No es necesario usar la función de autocompletar direcciones.
Orden: gana el primer partido
Si un formulario tiene más de una zona, las probamos en el orden que aparece en Configuración del formulario → Geocerca. La primera que coincida será la zona. Coloque primero la zona más pequeña para que una zona general no la incluya. El mismo orden determina los precios cuando dos zonas se superponen.
Configuración en cada formulario
Cada formulario tiene su propia pestaña de Geocerca. Nada se ejecuta hasta que lo actives. Habilitar geovallado para ese formulario.
Usted elige las áreas, el campo de dirección, si se debe bloquear o advertir, el mensaje de fuera de área (texto sin formato, que se muestra junto a la dirección) y un campo opcional para almacenar el nombre del área.
Guarda el nombre del área y luego redirige el correo electrónico.
Zona de tiendas coincidentes en Escribe el título del área en un campo de texto oculto o de una sola línea. Oculto es la opción habitual. No se ofrecen campos numéricos, ya que el valor es un nombre, no un número.
Si están en un área, el campo tiene ese título (por ejemplo Little RockSi se encuentran fuera de todas las áreas seleccionadas, el campo estará vacío. Aplique lógica condicional a ese campo para mostrar u ocultar partes del formulario y cree una notificación por área.
Gravity Forms lee ese campo como cualquier otro, por lo que su propia etiqueta de combinación también funciona en una notificación, junto con la {pb_geo:*} etiquetas a continuación.
La verificación en vivo y la verificación de envío
La comprobación que se realiza mientras escriben es para ellos. Actualiza el campo de área, la advertencia y los precios.
Al enviar el formulario, volvemos a comprobar la dirección IP a partir de los datos guardados. No nos fiamos de la información enviada por el navegador. Tras esta segunda comprobación, se aplica un bloqueo y se emite una advertencia.
Las zonas postales siempre se comprueban a partir de la dirección enviada. Las zonas dibujadas en el mapa se comprueban de la misma manera cuando Buscar coordenadas Está activado. Si el punto del mapa proviene únicamente del navegador (Autocompletar dirección, con la búsqueda desactivada), alguien podría modificarlo. Añada también un código postal o active la búsqueda si necesita un límite estricto.
Cuando no podemos colocar la dirección
Si las áreas requieren información que la dirección no tiene (solo áreas dibujadas en el mapa, sin ubicación en el mismo) o si la búsqueda falla, permitimos que el envío se procese. Esa entrada se registra como no verificada, no como fuera de lugar.
Los formularios que venden productos son la excepción. Allí, Cuando la dirección no coincide con ninguna geocerca decide, y está configurado para bloquear de forma predeterminada, por lo que una dirección que no pudimos procesar no podrá realizar un pedido hasta que cambie esa configuración.
El valor "dentro" es No tanto cuando están fuera de todas las áreas como cuando no pudimos verificarlo. La razón es lo que los distingue. Si nunca verificamos la entrada, "dentro" se deja en blanco para que no parezca un No seguro.
Precios diferentes por zona
La opción Configuración del formulario → Precios por geocerca funciona en los campos de producto de Gravity Forms que tienen un precio fijo (productos individuales y ocultos). No modifica los productos desplegables, los precios calculados ni los campos donde el cliente introduce el precio manualmente.
El precio que aparece en el campo del producto es el precio base. Para cada uno de los productos que elija:
- Se vende en todas las zonas geográficas de este formulario., o
- Se vende únicamente en zonas geográficas seleccionadas.
Luego agregue un Anulación de precio En las áreas que aplican cargos adicionales, se mantiene el precio base. Si un producto no se ofrece en esa área, se excluye del total y se rechaza el pedido. Para ocultarlo también del formulario, utilice una lógica condicional en el campo de área guardada.
Cuando la dirección no coincide con ninguna geocerca (fuera de cualquier área, o no podríamos ubicarlo) puedes Bloquear el pedido o Cobrar precios base. La opción Bloquear es la predeterminada y se aplica tanto si selecciona Bloquear como Advertir en la pestaña Geocerca.
Los precios y el total del formulario se actualizan al cambiar la dirección. El precio que cobramos se guarda en la entrada, por lo que un pedido antiguo seguirá mostrando lo que pagaron incluso después de que usted cambie el precio. Prueba una dirección En la misma pantalla, comprueba la dirección introducida comparándola con la última configuración guardada.
Entradas, etiquetas y quién puede ver qué
Geocerca → Entradas Muestra las solicitudes de las áreas asignadas a esa persona, en todos los formularios que utilizan una geocerca. Puedes filtrar por área y por etiqueta. Al abrir una entrada, se muestra dónde se envió, qué se pidió a los precios cobrados y qué escribió el usuario.
Configure la lista de etiquetas una sola vez en Geocerca → Configuración → Etiquetas de entrada (una por línea). Las personas aplican esas etiquetas en la pantalla de entrada, por lo que las mismas palabras funcionan en todas las áreas.
En la pantalla de Usuarios aparecen dos roles:
- Gestor de geocercas – establece las áreas asignadas a ellos y los precios (incluidos Geocerca → Precios, que no necesita acceso a Gravity Forms).
- Visor de entradas de geocerca – Lee, etiqueta y anota las entradas de las áreas que le han sido asignadas.
Asignar personas en el Usuarios asignados Aparece un cuadro al editar un área. Las claves de Google permanecen en poder del administrador del sitio.
Un ejemplo práctico
Cinco zonas postales. Dos servicios se ofrecen en las cinco, cada uno a su propio precio. Un tercer servicio se ofrece solo en tres de ellas, también a su propio precio. El cliente elige cualquier combinación disponible en la zona correspondiente, y no se pueden realizar pedidos a direcciones que no estén cubiertas por su servicio.
El nombre de la zona se guarda en el formulario. Se activa una notificación cuando ese campo es North Little Rock. Se activa otra cuando es Lake County.
Etiquetas de combinación
Estos campos extraen los valores guardados en la entrada. Úselos en notificaciones, confirmaciones y cualquier otro campo de etiquetas de combinación de Gravity Forms.
{pb_geo:fence_title} – el nombre del área (el mismo texto escrito en Almacenar zona coincidente en). Vacío cuando no se encuentra ninguna área coincidente.
{pb_geo:fence_id} – el ID del área. Vacío cuando no se encuentra ninguna área coincidente.
{pb_geo:inside} – Sí o No. Vacío si nunca revisamos la entrada, por lo que no se lee como un “exterior” seguro.”
{pb_geo:reason} – Por qué decidimos que:
- Dentro de una geocerca
- Fuera de cada geocerca
- No se pudo verificar: la dirección no tenía código postal ni coordenadas para coincidir.
- No se pudo comprobar: no se seleccionaron geocercas utilizables para este formulario.
- Rechazado: la dirección enviada no tenía un formato que este complemento pudiera leer.
Preguntas frecuentes
¿Necesito una clave de API de Google?
Solo sirve para dibujar áreas en el mapa o para buscar una dirección escrita. Las áreas de código postal no necesitan tecla y no se conectan a Google. La tecla de Mapas es para el editor. La tecla de Geocodificación solo se usa cuando la opción Buscar coordenadas está activada.
¿Qué formatos de código postal funcionan?
Códigos exactos, prefijos como 606*, y rangos de números como 10001-10005. Un patrón por línea, o comas. Consulte las áreas de códigos postales en Detalles de la función.
¿Qué ocurre si hay coincidencia en más de una zona?
Usamos el primero en el orden. Los precios que se aplican son los de esa zona.
¿Puedo advertir a la gente sin bloquearla?
Sí. Elegir Advertir, pero permitir el envío. Tu mensaje sigue apareciendo junto a la dirección, y el nombre del área sigue apareciendo cuando coinciden, por lo que los correos electrónicos y los campos ocultos siguen funcionando. Una excepción: en un formulario que vende productos, Cuando la dirección no coincide con ninguna geocerca Está configurado para bloquear de forma predeterminada, y esa configuración es la que decide si una dirección no coincidente puede realizar un pedido.
¿Cómo puedo enviar correos electrónicos diferentes según la zona?
Guarda el nombre del área en un campo oculto o de texto y, a continuación, añade una notificación para cada área con lógica condicional basada en ese campo.
¿Es suficiente con comprobar que están escribiendo para bloquear a alguien?
No. Esa verificación es para la persona que completa el formulario. Nosotros decidimos si bloquearlo cuando lo envía.
¿Qué ocurre si no puedes decir dónde está la dirección?
En un formulario sin productos, lo dejamos pasar y marcamos la entrada como no verificada en lugar de fuera. En un formulario que vende productos, Cuando la dirección no coincide con ninguna geocerca La configuración lo decide y, por defecto, bloquea. En cualquier caso, el motivo que aparece en la entrada indica lo que sucedió.
¿Funciona en formularios de varias páginas?
Sí. Solo revisamos la página que envían, por lo que el paso a Siguiente en la primera página no fallará debido a una dirección o un producto en una página posterior.
¿Qué productos pueden tener un precio diferente según la zona?
Campos de producto con precio fijo (producto individual y producto oculto). No se incluyen productos desplegables, precios calculados ni campos de "ponga su precio".
¿Necesito la función de autocompletar direcciones para Gravity Forms?
No. Si ambos complementos están en el mismo campo de dirección, reutilizamos la ubicación que ya seleccionaron, por lo que un área dibujada en el mapa no necesita una segunda búsqueda. Las áreas postales nunca la necesitan. Las áreas dibujadas en el mapa pueden usar la función Buscar coordenadas.
¿Puedo usarlo en más de un formulario?
Sí. Las áreas son reutilizables. Cada formulario tiene su propio interruptor de encendido/apagado, lista de áreas, campo de dirección, opción de bloqueo o advertencia, mensaje, campo de área guardada y precios.
La advertencia desapareció de una página almacenada en caché. ¿Sigue marcado el formulario?
Sí. La advertencia en tiempo real puede desactivarse si una página permanece en caché durante más de un día. Seguimos comprobando la dirección cuando se envía el formulario y bloqueamos el acceso si así lo has configurado. Si tu caché conserva las páginas durante más de un día, excluye las páginas de formularios con geolocalización de esa caché o reduce el tiempo que permanecen allí.
English
العربية
বাংলা
Deutsch
Español
Español de México
Français
हिन्दी
Bahasa Indonesia
Italiano
Português
Русский
اردو
简体中文