Manual de Uso: Módulo Autocomplete Intelipost

, _(*1)

Introdução

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., _(*2)

Com a instalação do módulo, essa funcionalidade estará disponível em 3 páginas:, _(*3)

Checkout (.../checkout/index/index),
Página de criação de cadastro de cliente (.../customer/account/create),
Página de atualização/criação de novo endereço (.../customer/address/form).

Este manual foi divido em três partes:, _(*4)

Instalação: Onde você econtrará instruções para instalar nosso módulo.
Configurações: Onde você encontrará o caminho para realizar as configurações e explicações de cada uma delas.
Uso: Onde você encontrará a maneira de utilização de cada uma das funcionalidades.

Instalação

É recomendado que você tenha um ambiente de testes para validar alterações e atualizações antes de atualizar sua loja em produção., _(*5)

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., _(*6)

Navegue até o diretório raíz da sua instalação do Magento 2 e execute os seguintes comandos:, _(*7)

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

Configurações

Para acessar o menu de configurações, basta seguir os seguintes passos:, _(*8)

No menu à esquerda, acessar Stores -> Configuration -> Intelipost -> Auto Complete:, _(*9)

ac1 , _(*10)

Configurações Básicas

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., _(*11)

Checkout - Customização por "name" dos campos

Nesta seção você deverá configurar os "names" dos campos do front-end que deverão receber cada uma das seguintes informações:, _(*12)

State: Estado
City: Cidade
Street: Rua
Quarter: Bairro
Additional Information: Informações Adicionais

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\\]., _(*13)

Editar Endereço do Consumidor - Customização por "id"

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., _(*14)

State: Estado
City: Cidade
Street: Rua
Quarter: Bairro
Additional Information: Informações Adicionais

Caso o cliente não faça uso de alguns desses campos para serem completados, basta deixá-los em branco., _(*15)

Criar Endereço do Consumidor - Customização por "id"

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., _(*16)

State: Estado
City: Cidade
Street: Rua
Quarter: Bairro
Additional Information: Informações Adicionais

Caso o cliente não faça uso de alguns desses campos para serem completados, basta deixá-los em branco., _(*17)

Uso

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)., _(*18)

ac1 , _(*19)