WP Manifestindependent plugin directory
manifest / ecommerce / completa-endereco-for-woocommerce

Completa Endereço

Plugin Wordpress/Woocommerce para auto completar o endereço pelo CEP

by Frederico de Castro · github.com/fredpiuma/completa-endereco-for-woocommerce

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/fredpiuma/completa-endereco-for-woocommerce/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/fredpiuma/completa-endereco-for-woocommerce ↗

⚡ Completa Endereço - WooCommerce Autocomplete Address

O Completa Endereço é um plugin leve e eficiente para WordPress/WooCommerce que preenche automaticamente os campos de endereço no checkout com base no CEP digitado pelo usuário. Ele consome a API pública do ViaCEP de forma primária e conta com um sistema inteligente de fallback automático para a API OpenCEP caso o serviço principal sofra oscilações ou fique temporariamente fora do ar.

[!NOTE] Este projeto é um fork aprimorado do plugin original AutoCEP (por Wanderson Cesar - TESW), atualizado e otimizado para utilizar o ViaCEP como fonte de dados primária e OpenCEP como contingência.

✨ Funcionalidades

  • 🚀 Preenchimento Instantâneo: Busca o endereço via requisição assíncrona assim que um CEP válido de 8 dígitos é digitado.
  • 📦 Sem Bloqueios: Executado de forma segura com validação de nonce e sanitização dos campos contra ataques.
  • 🎨 Experiência Visual Suave: Adiciona feedback de carregamento (loading overlay) integrado ao checkout do WooCommerce enquanto a busca é realizada.
  • 🔗 Ampla Compatibilidade: Funciona nativamente com checkouts de terceiros renomados.

🛠️ Compatibilidade

Testado e compatível com as principais soluções de checkout do mercado:

  • WooCommerce (Checkout Padrão)
  • Fluid Checkout
  • CartFlows

📥 Instalação

  1. Baixe o código deste repositório em formato .zip.
  2. No painel administrativo do WordPress, vá em Plugins > Adicionar Novo > Enviar Plugin.
  3. Escolha o arquivo baixado e clique em Instalar Agora.
  4. Clique em Ativar Plugin.
  5. Pronto! O recurso de autocompletar endereço já estará ativo nas telas de checkout.

📖 Como Funciona?

O plugin monitora os campos de CEP (billing_postcode e shipping_postcode). Quando o usuário insere exatamente 8 dígitos numéricos:

  1. O script local realiza o disparo AJAX para o endpoint administrativo do WordPress de forma segura.
  2. O servidor efetua uma requisição otimizada (via wp_remote_get com timeout de 20s) à API ViaCEP: https://viacep.com.br/ws/{cep}/json/
  3. Os dados de logradouro, bairro, localidade (cidade) e uf (estado) são devolvidos e os campos do checkout são preenchidos automaticamente.

⚖️ Licença

Este plugin é distribuído sob a licença GPLv2 ou posterior. Sinta-se livre para usar, estudar, modificar e compartilhar.

✉️ Contato & Suporte

Precisa de ajuda com o plugin, quer sugerir melhorias ou bater um papo sobre projetos WordPress? Entre em contato por qualquer um dos canais abaixo:

Desenvolvido e mantido com ☕ por Frederico de Castro