Neste rápido tutorial vamos ver como modificar a máscara de CEP no Magento 2.
O módulo final para alterar a máscara de CEP de endereços nacionais estará disponível no final do artigo.
Por padrão, ao selecionar o país Brasil em um campo de endereço no Magento 2, o usuário é obrigado a digitar o CEP no formato 12345-123
, caso contrário verá a mensagem de CEP inválido.
Esta validação de CEP é feita de forma dinâmica baseada em regras definidas em módulos internos do core do Magento.
Como alterar a máscara de CEP no Magento
Para realizar esta alteração precisaremos criar um novo módulo Magento 2 e depois adicionar um arquivo para sobrescrever a máscara existente para o país BR.
Para fins deste exemplo, o módulo criado será o Magenteiro_CepBrasil.
Onde a máscara de CEP é definida
As máscara de CEP são definidas no módulo Magento_Directory, em um arquivo XML localizado em <Magento_Directory>/etc/zip_codes.xml.
Lá podemos rapidamente encontrar o pattern que queremos modificar:
Como podemos ver, é no patern_2 que se encontra a expressão regular que valida o CEP Brasileiro obrigado que o caractere – seja adicionado.
Sobrescrevendo a máscara de CEP
Sendo assim, tudo que precisamos fazer é adicionar o arquivo app/code/Magenteiro/CepBrasil/app/etc/zip_codes.xml
com a nova expressão:
Em expressões regulares, ao adicionarmos o ? após um caractere faz com que ele seja opcional. Desta forma, nossa validação de CEP passará a aceitar o CEP com ou sem –.
Bem simples não é mesmo?
Download do Módulo pronto
Se quiser, você pode fazer download do módulo inteiro. Basta informar seu nome e e-mail. O módulo será enviado pra você num instante
Também odeio spam. Seu e-mail estará seguro só comigo. e só mando coisas relacionadas a Magento.
Fontes relacionadas:
Documentação Magento 2 (Em Inglês)
- PagSeguro (PagBank) para Magento 1 recebe a Nova Geração - 9 de abril de 2024
- Recorrência no WooCommerce Sem Plugins Pagos - 28 de janeiro de 2024
- Chargeback. O que é, e como se livrar deles. - 19 de dezembro de 2023
Deixe seu comentário
[fbcomments url="https://www.magenteiro.com/blog/magento-2/validacao-cep-brasil-magento2/"]