CEP Autocomplete for Address
This module enhances address forms by adding CEP (Brazilian postal code) autocomplete functionality. It automatically fills in the state, city, street, and optionally the neighborhood when a user enters a valid CEP, improving the user experience on Drupal Commerce checkout and user profile forms.
CEP Autocomplete adiciona autocompletar de endereço por CEP (ViaCEP) aos formulários que usam o campo Address padrão (CommerceGuys Addressing).
Funciona nos Perfis “customer” do Drupal Commerce e em formulários de usuário — inclusive quando o bloco “Add Billing Information” é carregado via AJAX no checkout.
✅ Usa o Address nativo (sem campos alternativos)
✅ Compatível com Drupal 10/11 e Commerce 3.x
✅ Sem API key: ViaCEP público + cache server-side
Recursos
- Busca CEP (ViaCEP) + preenchimento automático:
- UF (Estado) → administrative_area
- Cidade → locality
- Logradouro → address_line1
- Bairro (se o campo existir) → dependent_locality
- Complemento: não é preenchido automaticamente; fica para o usuário.
- CEP em primeiro lugar + foco automático (melhor UX).
- Label/placeholder “Complemento” para address_line2 (em vez de “Street address line 2”).
- Pronto para AJAX (IEF/checkout): behaviors do Drupal reanexam no conteúdo injetado.
- Base path inteligente: funciona em sites em subdiretórios (ex.: /web/) e com prefixo de idioma.
Configuração recomendada
- Commerce → Store → Billing countries: marque apenas Brasil (BR) (opcional, remove o seletor de país).
- Confirme que o Profile “customer” tem o campo Address padrão (default do Commerce).
- Abra o formulário (edição do profile ou “Add Billing Information” no checkout).
- Digite um CEP de 8 dígitos (ex.: 01311000) — os campos serão preenchidos.
- Dica: no DevTools → Network, você verá a chamada ao endpoint interno do módulo com resposta 200.
Contribua!
Se você se sentir a vontade e quiser contribuir como gratidão, a chave pix é a seguinte: [email protected]