Documentação
Como ativo o *plugin*?
Instale o ficheiro zip no seu site WordPress. O Gravity Forms já deve estar ativo.
Passo 1: Instalação
Inicie sessão no WordPress e vá a Plugins → Adicionar plugin → Enviar plugin. Instale o ficheiro zip e ative-o.
Passo 2: Definições
Ir para Geofocagem → Definições, ou Formulários → Definições → Geofitionamento. Mesmo ecrã.
As chaves são opcionais. Ignore isto se estiver apenas a utilizar códigos postais.
- Chave da API do Google – era necessário desenhar áreas no mapa. Ative a API Maps JavaScript e restrinja a chave ao seu site. As áreas de código postal não precisam de chave. Se já utiliza Preenchimento Automático de Moradas para o Gravity Forms, podemos utilizar essa chave até inserir uma aqui.
- Pesquisar Coordenadas e um Chave da API de Geocodificação – apenas se quiser que coloquemos uma área desenhada no mapa a partir de um endereço digitado. Esta deve ser uma chave diferente da anterior, com a API Geocoding ativada e sem restrições de referenciador HTTP. Em vez disso, restrinja-a por IP. As áreas de código postal nunca utilizam isto.
Passo 3: Criar as suas áreas
Ir para Geofence → Geofences, ou Formulários → Vedações geográficas. Adicione um, dê-lhe um título, escolha códigos postais ou uma forma de mapa e defina Encomenda. Coloque as áreas mais pequenas acima das maiores.
Passo 4: Ligue-o para o formulário
Abra o formulário e, em seguida, Definições → Geofence.
- Ligar Ativar geofencing.
- Selecione as áreas aplicáveis.
- Escolha Campo de morada (um campo Morada ou um campo Linha de Texto Única).
- Escolher Bloquear o envio ou Avisar, mas permitir a submissão.
- Alterar Mensagem Fora de Área se quiser. O predefinido é “Desculpe, atualmente não prestamos serviços nessa morada.”
- Opcional: definir Armazenar zona correspondente em para um campo de Texto Oculto ou de Linha Única. Esse é o campo que as notificações e a lógica condicional irão ler.
Guardar Alterações.
Passo 5: Preços (apenas se vender produtos no formulário)
No mesmo formulário, abrir Definições → Preços por geofencing. Primeiro, guarde o separador Perimetração para que as suas áreas apareçam aqui. Para cada produto com um preço definido, escolha se é vendido em todas as áreas do formulário ou apenas em algumas, e escreva um preço diferente onde não for o preço base. Em Quando a morada não corresponde a nenhuma geoferca, escolher Bloquear a encomenda (a predefinição) ou Cobrar preços base.
Passo 6: Notificações
Abrir Definições → Notificações. Adicione uma notificação por área e defina lógica condicional no campo da zona. Se esse campo for Little Rock, envie para littlerock@…
É isso. Repita o Passo 4 em qualquer outro formulário que o necessite.
Detalhes da funcionalidade
Áreas de código postal
Cole os códigos postais, um por linha ou separados por vírgulas. As linhas em branco são ignoradas. Uma linha que comece com # É uma anotação para você mesmo.
- Exato –
90210corresponde a esse código. - Começa com –
606*corresponde a qualquer código que comece com606. - Faixa –
10001-10005Corresponde a todos os números nesse intervalo, incluindo as extremidades. Ambas as extremidades precisam ter o mesmo número de dígitos.
Letras maiúsculas não importam. Espaços e hífenes são ignorados em padrões exatos e "começa com", então 90210-1234 partidas 90210, e SW1A 1AA partidas SW1A1AA. Os intervalos são lidos antes dessa limpeza, portanto, um intervalo com hífen nunca é tratado como um código postal com hífen.
As áreas postais são verificadas em relação ao endereço fornecido. Nunca se utiliza uma API de mapeamento.
Áreas desenhadas em um mapa
Ao editar a cerca geográfica, desenhe a área em um mapa do Google. Essas áreas correspondem a um ponto no mapa, e não apenas ao código postal.
Esse ponto vem de Preenchimento Automático de Moradas para o Gravity Forms se estiver no mesmo campo de endereço ou a partir de uma pesquisa, caso você tenha ativado a opção. Pesquisar Coordenadas e adicionou uma chave de API de Geocodificação. Você não precisa usar o recurso de Autocompletar Endereços.
Ordem: primeiro a vencer.
Se um formulário tiver mais de uma área, verificamos a ordem em que elas aparecem em Configurações do Formulário → Geocerca. A primeira área que corresponder será definida como a zona. A área menor é colocada primeiro para que uma zona genérica não a englobe. A mesma ordem define os preços quando duas áreas se sobrepõem.
Configurações em cada formulário
Cada formulário tem sua própria aba de Geofencing. Nada é executado até que você ative essa opção. Ativar geofencing para esse formulário.
Você escolhe as áreas, o campo de endereço, se deseja bloquear ou avisar, a mensagem de fora da área (texto simples, exibida ao lado do endereço) e um campo opcional para armazenar o nome da área.
Salve o nome da área e, em seguida, encaminhe o e-mail.
Armazenar zona correspondente em Insere o título da área em um campo de texto oculto ou de linha única. A opção oculta é a mais comum. Campos numéricos não são oferecidos, pois o valor é um nome, não um número.
Se eles estiverem em uma área, o campo terá esse título (por exemplo, Little RockSe estiverem fora de todas as áreas selecionadas, o campo estará vazio. Aplique lógica condicional a esse campo para mostrar ou ocultar partes do formulário e crie uma notificação para cada área.
O Gravity Forms lê esse campo como qualquer outro, portanto, sua própria tag de mesclagem também funciona em uma notificação, juntamente com a {pb_geo:*} Etiquetas abaixo.
O cheque em tempo real e o cheque para envio.
A verificação enquanto digitam serve para eles. Ela atualiza o campo de área, o aviso e os preços.
Quando o usuário envia o formulário, verificamos novamente o endereço nas áreas salvas. Não confiamos no que o navegador enviou. Após essa segunda verificação, bloqueamos e exibimos um aviso.
As áreas postais são sempre verificadas a partir do endereço fornecido. As áreas desenhadas no mapa são verificadas da mesma forma quando... Pesquisar Coordenadas Está ativado. Se o ponto no mapa vier apenas do navegador (Preenchimento automático de endereço, com a pesquisa desativada), alguém poderá alterá-lo. Adicione também uma área postal ou ative a pesquisa, se precisar de uma restrição definitiva.
Quando não conseguimos inserir o endereço
Se as áreas precisarem de informações que o endereço não possui (apenas áreas desenhadas no mapa, sem localização exata) ou se uma busca falhar, permitimos o envio. Essa entrada é registrada como não verificada, e não como externa.
Formulários que vendem produtos são a exceção. Nesses casos, Quando a morada não corresponde a nenhuma geoferca A configuração é definida para bloquear por padrão, portanto, um endereço para o qual não foi possível enviar o pedido não poderá fazê-lo até que você altere essa configuração.
O valor "dentro" é "Não" tanto quando estão fora de todas as áreas quanto quando não foi possível verificar. O motivo é o que diferencia esses casos. Se nunca verificamos a entrada, o campo "dentro" fica em branco, não parecendo um "Não" categórico.
Preços variam conforme a área.
A opção Configurações do Formulário → Preços por Geofencing funciona em campos de produto do Gravity Forms que possuem um preço fixo (produto individual e produto oculto). Ela não altera produtos em listas suspensas, preços calculados ou campos onde o cliente digita o preço.
O preço exibido no campo do produto é o preço base. Para cada um dos produtos que você escolher:
- Vendido em todas as cercas geográficas deste formulário., ou
- Vendido apenas em áreas geográficas selecionadas.
Em seguida, adicione um Alteração de preço Nas áreas que cobram um valor diferente, as áreas sem sobreposição mantêm o preço base. Um produto que essa área não oferece é excluído do total e rejeitado se o usuário tentar enviá-lo. Para ocultá-lo também do formulário, utilize lógica condicional no campo da área salva.
Quando a morada não corresponde a nenhuma geoferca (fora de todas as áreas, ou não poderíamos colocá-lo) você pode Bloquear a encomenda ou Cobrar preços base. A opção Bloquear é a padrão e se aplica independentemente de você ter escolhido Bloquear ou Avisar na guia Geofence.
Os preços e o total do formulário são atualizados conforme o endereço muda. O preço que efetivamente cobramos é salvo no registro, portanto, um pedido antigo ainda mostra o valor pago mesmo após a alteração do preço. Testar um endereço Na mesma tela, verifica se o endereço digitado corresponde às configurações salvas por último.
Entradas, etiquetas e quem pode ver o quê
Geocerca → Entradas A lista exibe os envios das áreas atribuídas àquela pessoa, em todos os formulários que utilizam geolocalização. Você pode filtrar por área e por etiqueta. Ao abrir um registro, você verá onde ele foi publicado, o que foi pedido, os preços cobrados e o que foi digitado.
Defina a lista de tags uma única vez em Geofence → Configurações → Etiquetas de entrada (uma por linha). As pessoas aplicam essas etiquetas na tela de entrada, portanto, as mesmas palavras funcionam em todas as áreas.
Na tela de Usuários, aparecem duas funções:
- Gerenciador de Geocercas – define as áreas atribuídas a eles e os preços (incluindo Geocerca → Preços, que não precisa de acesso ao Gravity Forms).
- Visualizador de entradas de geocerca – Lê, etiqueta e anota as entradas das áreas que lhe foram atribuídas.
Atribua tarefas às pessoas Usuários atribuídos A caixa de diálogo é exibida ao editar uma área. As chaves do Google permanecem com o administrador do site.
Um exemplo prático
Cinco áreas postais. Dois serviços são oferecidos em todas as cinco, cada um com seu próprio preço. Um terceiro serviço é oferecido em apenas três delas, também com seu próprio preço. O cliente escolhe qualquer combinação que a área correspondente ofereça, e um endereço que você não abrange não pode fazer o pedido.
O nome da área é salvo no formulário. Uma notificação é acionada quando o campo contém "North Little Rock". Outra notificação é acionada quando o campo contém "Lake County".
Campos de fusão
Esses campos extraem os valores salvos na entrada. Use-os em notificações, confirmações e em qualquer outro campo de mesclagem do Gravity Forms.
{pb_geo:fence_title} – o nome da área (o mesmo texto escrito em "Loja correspondente à zona de entrada"). Fica vazio quando nenhuma área corresponde.
{pb_geo:fence_id} – o ID da área. Deixa em branco quando nenhuma área corresponde.
{pb_geo:inside} – Sim ou Não. Deixe em branco se nunca tivermos verificado a entrada, para que não seja lida como uma afirmação categórica de “fora”.”
{pb_geo:reason} – por que decidimos isso:
- Dentro de uma cerca geográfica
- Fora de cada cerca geográfica
- Não foi possível verificar — o endereço não tinha código postal nem coordenadas correspondentes.
- Não foi possível verificar — nenhuma geocerca utilizável foi selecionada para este formulário.
- Rejeitado — o endereço enviado não estava em um formato que este plugin pudesse ler.
Perguntas Frequentes
Preciso de uma chave da API do Google?
Serve apenas para desenhar áreas no mapa ou para pesquisar um endereço digitado. Áreas com código postal não precisam de chave e não consultam o Google. A chave "Mapas" é para o editor. A chave "Geocodificação" só é usada quando a opção "Pesquisar Coordenadas" está ativada.
Quais formatos de código postal funcionam?
Códigos exatos, prefixos como 606*, e intervalos de números como 10001-10005. Um padrão por linha ou vírgulas. Consulte as áreas de código postal em Detalhes do recurso.
E se mais de uma área coincidir?
Usamos o primeiro da lista. Os preços dessa área são os que se aplicam.
Posso avisar as pessoas sem bloqueá-las?
Sim. Escolha Avisar, mas permitir a submissão. Sua mensagem ainda aparece ao lado do endereço, e o nome da área ainda é preenchido quando há correspondência, portanto, e-mails e campos ocultos ainda funcionam. Uma exceção: em um formulário que vende produtos, Quando a morada não corresponde a nenhuma geoferca Está configurado para bloquear por padrão, e essa configuração é o que decide se um endereço não correspondente pode fazer um pedido.
Como faço para enviar e-mails diferentes para cada região?
Salve o nome da área em um campo oculto ou de texto e, em seguida, adicione uma notificação para cada área com lógica condicional nesse campo.
A verificação enquanto a pessoa digita é suficiente para bloquear alguém?
Não. Essa verificação é para a pessoa que preenche o formulário. Nós decidimos se bloqueamos ou não o formulário quando ela o envia.
E se você não souber onde fica o endereço?
Em um formulário sem produtos, permitimos a entrada e marcamos o campo como desmarcado, em vez de externo. Em um formulário que vende produtos, o Quando a morada não corresponde a nenhuma geoferca A configuração decide e bloqueia por padrão. De qualquer forma, o motivo na entrada informa o que aconteceu.
Funciona em formulários com várias páginas?
Sim. Nós verificamos apenas a página que eles estão enviando, então o link "Próximo na primeira página" não falhará devido a um endereço ou produto em uma página posterior.
Quais produtos podem ter preços diferentes por região?
Campos de produto com preço fixo (produto único e produto oculto). Não se aplicam a produtos de lista suspensa, preços calculados ou campos "defina seu preço".
Preciso do recurso de preenchimento automático de endereços no Gravity Forms?
Não. Se ambos os plugins estiverem no mesmo campo de endereço, reutilizamos a localização que eles já selecionaram, portanto, uma área desenhada no mapa não precisa de uma segunda consulta. Áreas postais nunca precisam disso. Áreas desenhadas no mapa podem usar a opção "Consultar Coordenadas".
Posso usar em mais de um formulário?
Sim. As áreas são reutilizáveis. Cada formulário possui seu próprio botão liga/desliga, lista de áreas, campo de endereço, opção de bloquear ou avisar, mensagem, campo de área salva e preços.
O aviso desapareceu na página em cache. O formulário ainda está marcado?
Sim. O aviso em tempo real pode ser desativado se uma página permanecer em cache por mais de um dia. Ainda verificamos o endereço quando o formulário é enviado e continuamos bloqueando se você configurou o bloqueio. Se o seu cache mantiver páginas por mais de um dia, exclua páginas de formulários com geolocalização do cache ou reduza o tempo que elas permanecem lá.