README

介绍

Intelipost 自动完成模块负责根据客户最终提供的CEP完成地址数据。CEP查询是在Intelipost API上进行的。

安装此模块后，此功能将在3个页面上可用

• 结账 (.../checkout/index/index),
• 创建客户注册页面 (.../customer/account/create),
• 更新/创建新地址页面 (.../customer/address/form).

本手册分为三个部分

• 安装: 在哪里可以找到安装我们模块的说明。
• 配置: 在哪里可以找到进行配置的路径和每个配置的解释。
• 使用: 在哪里可以找到使用每个功能的方法。

安装

建议您在测试环境中验证更改和更新，然后再更新您的生产商店。

使用Composer安装模块。要下载和安装Composer到您的环境，请访问https://composer.php.ac.cn/download/，如有疑问，请参阅Composer官方文档。

导航到您的Magento 2安装根目录，并执行以下命令

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

配置

要访问配置菜单，请按照以下步骤操作

在左侧菜单中，访问 商店 -> 配置 -> Intelipost -> 自动完成

基本配置

在这个第一步中，唯一需要进行的配置是 页面加载时间（Load Page Time）以毫秒为单位。它表示在页面加载自动完成脚本之前应等待的时间量。默认值为3000毫秒。

结账 - 通过“name”字段自定义

在这个部分，您需要配置前端字段“names”，这些字段将接收以下信息中的每一个

• State: 州
• City: 城市
• Street: 街道
• Quarter: 社区
• Additional Information: 其他信息

如果客户不使用某些字段进行完成，只需将其留空即可。可以使用两个反斜杠“\\”来转义特殊字符。例如：如果社区字段是数组 street[] 的第四项，则应按以下方式配置：street\\[3\\]。

编辑消费者地址 - 通过“id”自定义

创建和编辑地址的配置与结账非常相似。最大的区别是用于在front-end中标识字段的参数。在结账中是 "name"，而在编辑地址的页面中是字段的 "id"。

• State: 州
• City: 城市
• Street: 街道
• Quarter: 社区
• Additional Information: 其他信息

如果客户不使用某些字段进行完成，只需将其留空即可。

创建消费者地址 - 通过“id”自定义

与编辑地址的配置一样，创建地址的配置也是从front-end中字段的 "id" 开始自定义的。

• State: 州
• City: 城市
• Street: 街道
• Quarter: 社区
• Additional Information: 其他信息

如果客户不使用某些字段进行完成，只需将其留空即可。

使用

使用模块非常简单。安装和配置完成后，只需前往结账页面（或创建/编辑注册信息页面）并填写一个邮政编码。一旦焦点离开邮政编码字段，表单中的相关字段（如街道、小区、城市、州以及附加信息）将自动填充。