Type
magento2-module
Intelipost Autocomplete
magento2-module
OSL-3.0
None
None
None
None
None
O módulo Autocomplete Intelipost é responsável por completar os dados de endereço partindo do CEP fornecido pelo cliente final. A consulta do CEP é feita na API Intelipost.
Com a instalação do módulo, essa funcionalidade estará disponível em 3 páginas:
Este manual foi divido em três partes:
É recomendado que você tenha um ambiente de testes para validar alterações e atualizações antes de atualizar sua loja em produção.
A instalação do módulo é feita utilizando o Composer. Para baixar e instalar o Composer no seu ambiente acesse https://getcomposer.org/download/ e caso tenha dúvidas de como utilizá-lo consulte a documentação oficial do Composer.
Navegue até o diretório raíz da sua instalação do Magento 2 e execute os seguintes comandos:
bin/composer require intelipost/magento2-autocomplete // Faz a requisição do módulo da Intelipost
bin/magento module:enable Intelipost_Autocomplete // Ativa o módulo
bin/magento setup:upgrade // Registra a extensão
bin/magento setup:di:compile // Recompila o projeto Magento
Para acessar o menu de configurações, basta seguir os seguintes passos:
No menu à esquerda, acessar Stores -> Configuration -> Intelipost -> Auto Complete:
Nesta primeira etapa, a única configuração a ser feita é Tempo de Carregamento da Página (Load Page Time) em milisegundos. Ela indica a quantidade de tempo que deve ser esperado antes de carregar o script de autocomplete na página. O padrão é de 3000 ms.
Nesta seção você deverá configurar os "names" dos campos do front-end que deverão receber cada uma das seguintes informações:
Caso o cliente não faça uso de alguns desses campos para serem completados, basta deixá-los em branco. Caracteres especiais podem ser escapados utilizando duas barras invertidas "\\". Por exemplo: Se o campo Bairro for o quarto item do array street[], deve ser configurado da seguinte maneira: street\\[3\\].
As configurações de Criar e Editar Endereço são bem semelhantes ao Checkout. A grande diferença é o parâmetro usado para identificar o campo no front-end. Enquanto no Checkout é o "name", nas páginas de editar o endereço é o "id" do campo.
Caso o cliente não faça uso de alguns desses campos para serem completados, basta deixá-los em branco.
Assim como nas configurações para editar o endereço, as configurações de criar endereõ também são customizadas a partir do "id" do campo no front-end.
Caso o cliente não faça uso de alguns desses campos para serem completados, basta deixá-los em branco.
O uso do módulo é bem simples. Uma vez instalado e configurado, basta ir até a página de checkout (ou de criação/edição de cadastro) e preencher um CEP. Assim que o foco for tirado do campo CEP, os campos serão preenchidos automaticamente no formulário (rua, bairro, cidade, estado e informações adicionais).