=== Autocomplete Address for WooCommerce ===
Contributors: amgnando
Donate link: https://rishi.com.br/?utm_source=wp_org&utm_medium=donate&utm_campaign=autocomplete-address
Tags: cep, endereço, checkout, woocommerce, correios
Requires at least: 5.0.0
Tested up to: 7.1
Stable tag: 1.5.1
Requires PHP: 7.0.0
Requires Plugins: woocommerce
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Preencha automaticamente o endereço a partir do CEP no checkout do WooCommerce.

== Description ==

Este plugin preenche automaticamente o endereço no checkout a partir do CEP informado: rua, bairro, cidade e estado.

Nenhuma configuração é necessária. Basta ativar e pronto! Funciona no checkout clássico e no novo checkout de blocos do WooCommerce.

= Quer um checkout completo, feito para o Brasil? =

O Autocomplete Address resolve o endereço. O [Checkout Rishi](https://rishi.com.br/?utm_source=wp_org&utm_medium=readme&utm_campaign=autocomplete-address) resolve o checkout inteiro. Ele substitui a finalização de compra do WooCommerce por um checkout de alta conversão, mantendo seus produtos, fretes, cupons e gateways de pagamento:

* **Checkout em etapas**: identificação, dados, entrega e pagamento, com barra de progresso.
* **CEP automático**: preenchimento do endereço pelo CEP já integrado.
* **CPF e CNPJ nativos**, com validação na hora.
* **Pix em destaque**, mostrando o desconto antes da escolha do pagamento.
* **Order bump** com um clique, antes de pagar.
* **Recuperação de carrinho abandonado**, com e-mails, cupom de uso único e webhooks (n8n, Make, Zapier, CRM).
* **Login sem senha**, por código ou link.
* **Personalização visual** de logo, cores e textos, com prévia ao vivo.
* **0% de taxa sobre as vendas.** Pagamento único, sem comissão por pedido.

[Conheça o Checkout Rishi →](https://rishi.com.br/?utm_source=wp_org&utm_medium=readme&utm_campaign=autocomplete-address)

Conheça também dezenas de outros [plugins para WooCommerce](https://fernandoacosta.net/plugins/assinatura/?utm_source=wp_org&utm_medium=readme&utm_campaign=autocomplete-address).

= Por que usar esse plugin? =

* **Zero configuração**: ative e o checkout já preenche o endereço.
* **Rápido**: consulta o ViaCEP e a BrasilAPI ao mesmo tempo e usa a resposta que chegar primeiro. As duas APIs têm cache próprio, então CEPs já consultados voltam em até 0,1 segundo.
* **Sempre no ar**: se um dos serviços cair, o outro responde.
* **Checkout clássico e de blocos**: funciona nos dois modelos de checkout do WooCommerce.
* **Leve**: a consulta é feita direto do navegador, sem sobrecarregar o seu servidor nem o banco de dados.
* **Cobrança e entrega**: funciona nos dois endereços do checkout.
* **CEP já informado**: se o cliente calculou o frete no carrinho, o endereço já chega preenchido no checkout.
* **Compatível com o campo Bairro** do plugin Brazilian Market on WooCommerce.
* **Compatível com HPOS** (armazenamento de pedidos de alto desempenho do WooCommerce).

Embora o plugin dos Correios do Claudio Sanches funcione bem (inclusive inspirou esse), ele pode ser lento por depender unicamente dos Correios. Além disso, esse plugin é útil caso você não utilize os Correios.

= O que você quer ver no plugin? =

Vamos atualizar o plugin com mais frequência e queremos ouvir você. Tem uma ideia de melhoria ou sentiu falta de algum recurso? [Mande sua sugestão no fórum de suporte](https://wordpress.org/support/plugin/autocomplete-address-for-woocommerce/). As mais pedidas entram nas próximas versões.

Gostou do plugin? [Deixe sua avaliação](https://wordpress.org/support/plugin/autocomplete-address-for-woocommerce/reviews/#new-post). Isso ajuda muito!

== Installation ==

1. Acesse Plugins > Adicionar novo e busque por "Autocomplete Address for WooCommerce".
2. Clique em Instalar agora e depois em Ativar.
3. Pronto. Abra o checkout, digite um CEP e veja o endereço ser preenchido.

== Frequently Asked Questions ==

= Qual é a licença do plugin? =

Este plugin esta licenciado como GPL.

= O que eu preciso para utilizar este plugin? =

* Somente o WooCommerce :)

= Funciona com o checkout de blocos? =

Sim. A partir da versão 1.5.0, o plugin funciona tanto no checkout de blocos quanto no checkout clássico (shortcode `[woocommerce_checkout]`).

= Quais serviços de CEP são usados? =

O [ViaCEP](https://viacep.com.br) e a [BrasilAPI](https://brasilapi.com.br). Os dois são consultados ao mesmo tempo e o plugin usa a resposta mais rápida. Se um deles estiver fora do ar, o outro responde.

= Onde envio sugestões de melhoria? =

No [fórum de suporte do plugin](https://wordpress.org/support/plugin/autocomplete-address-for-woocommerce/). Lemos todas as sugestões.

= Preciso usar este plugin junto com o Checkout Rishi? =

Não. O [Checkout Rishi](https://rishi.com.br/?utm_source=wp_org&utm_medium=readme&utm_campaign=autocomplete-address) já tem o preenchimento de endereço pelo CEP integrado.

= Posso carregar o script fora da página de checkout? =

Sim. Use o filtro `autocomplete_address_for_woocommerce_should_load`:

`add_filter( 'autocomplete_address_for_woocommerce_should_load', '__return_true' );`

== External services ==

Para preencher o endereço, este plugin consulta dois serviços públicos de CEP. As consultas são feitas pelo navegador do cliente, no checkout, e não passam pelo servidor da sua loja. O plugin não envia dados para servidores do autor e não guarda nenhum dado do CEP.

Quando acontece a consulta: no checkout (clássico ou de blocos), quando o cliente digita, cola ou o navegador preenche um CEP completo de 8 dígitos com o país Brasil, ou quando o CEP já chega preenchido e o endereço está vazio. Os dois serviços são consultados ao mesmo tempo, então cada um recebe o CEP em toda consulta. Além do CEP, como em qualquer requisição feita pelo navegador, cada serviço recebe o endereço IP do visitante e os dados técnicos habituais da requisição (como o User-Agent). Nenhum outro dado do checkout (nome, e-mail, telefone, CPF, número ou complemento) é enviado.

= ViaCEP =

O ViaCEP é um serviço gratuito de consulta de CEP. O plugin usa para obter rua, bairro, cidade e estado a partir do CEP.

* Endereço consultado: `https://viacep.com.br/ws/{CEP}/json/`
* Dados enviados: o CEP (8 dígitos) e, implicitamente, o IP do visitante. A consulta acontece no checkout, nas situações descritas acima.
* Site: https://viacep.com.br
* Termos de uso e política de privacidade: o ViaCEP não publica termos de uso nem política de privacidade no site (verificado em 26/10/2026). A página principal e o contato do serviço estão em https://viacep.com.br e https://viacep.com.br/faleconosco/

= BrasilAPI =

A BrasilAPI é um projeto aberto que reúne APIs públicas do Brasil. O plugin usa a API de CEP para obter rua, bairro, cidade e estado a partir do CEP.

* Endereço consultado: `https://brasilapi.com.br/api/cep/v1/{CEP}`
* Dados enviados: o CEP (8 dígitos) e, implicitamente, o IP do visitante. A consulta acontece no checkout, nas situações descritas acima.
* Site: https://brasilapi.com.br e repositório https://github.com/BrasilAPI/BrasilAPI
* Termos de uso: https://brasilapi.com.br/#termos-de-uso (a mesma seção "Termos de Uso" está no [README do projeto](https://github.com/BrasilAPI/BrasilAPI#termos-de-uso), onde o projeto informa que os termos completos ainda estão em elaboração)
* Política de privacidade: a BrasilAPI não publica uma política de privacidade (verificado em 26/10/2026).

== Changelog ==

= 1.5.1 - 26/10/2026 =

- Melhorias de segurança e estabilidade.
- Seção sobre os serviços externos de consulta de CEP (ViaCEP e BrasilAPI).
- Testado com o WordPress 7.1 e o WooCommerce 11.2.1.

= 1.5.0 - 18/10/2026 =

- Compatibilidade com o checkout de blocos do WooCommerce
- Consulta ViaCEP e BrasilAPI ao mesmo tempo, usando a resposta mais rápida
- Correção: o endereço agora também é preenchido quando o CEP é colado ou preenchido automaticamente pelo navegador
- Correção: declarar a dependência do jQuery BlockUI
- Compatibilidade testada com WordPress 7.1 e WooCommerce 11.2
- Declaração de dependência do WooCommerce (Requires Plugins)

= 1.4.0 - 07/06/2025 =

- Melhorias gerais
- Otimização do código

= 1.3.2 - 23/03/2024 =

- Adicionar sufixo .min ao arquivo JS, prevenindo dupla compressão em alguns plugins de cache

= 1.3.1 - 2024/03/10 =

- Declaração de compatibilidade com HPOS

= 1.3.0 - 2024/03/10 =

- Novo provedor de endereços

= 1.0.1 - 2021/03/23 =

- Permitir auto completar mesmo quando o campo país não estiver disponível

= 1.0.0 - 2020/11/17 =

- Primeira versão :)
