README

What3Words Magento1 集成

安装

要安装，请按照https://developer.what3words.com/tools/e-commerce/magento1上的说明进行。

可以使用Packagist安装Magento 1扩展，或者通过从GitHub下载并添加到您的服务器（通过FTP或手动扩展安装）进行手动安装。

我们建议使用Composer和Packagist来安装扩展，以确保所有依赖项都与扩展一起安装。

要将what3words Magento 1扩展添加到商店并使用Packagist，首先连接到您的服务器并启动命令行界面。

在CLI中运行命令'composer require what3words/module-what3words-magento1'以安装扩展所需的文件和依赖项。

接下来，运行'php bin/magento setup:upgrade'以编译网站，确保它包含新扩展。然后我们建议运行'php bin/magento cache:clean'和'php bin/magento cache:flush'以确保清除网站缓存。

概述

what3words Magento集成（由Gene Commerce开发http://gene.co.uk/）允许Magento商家在结账时添加一个选项，让客户可以使用what3words地址进行发货。

启用后，该模块会在结账页面的账单和收货地址表单中添加一个可配置和可定制的what3words输入字段。这使得客户可以将what3words地址保存到地址簿中，以便在未来订单中轻松重复使用。

此扩展实现了官方的what3words jQuery插件（https://github.com/what3words/jquery-plugin-w3w-autosuggest）。

配置

在系统配置的what3words部分中启用，并添加您的API密钥。

要在发货标签上显示，请更新以下配置设置

客户 -> 客户配置 -> 地址模板 -> PDF到以下

{{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend suffix}} {{var suffix}}{{/depend}}| {{depend company}}{{var company}}|{{/depend}} {{if street1}}{{var street1}} {{/if}} {{depend street2}}{{var street2}}|{{/depend}} {{depend street3}}{{var street3}}|{{/depend}} {{depend street4}}{{var street4}}|{{/depend}} {{if city}}{{var city}},|{{/if}} {{if region}}{{var region}}, {{/if}}{{if postcode}}{{var postcode}}{{/if}}| {{var country}}|{{if w3w}}{{var w3w}}, {{/if}}| {{depend telephone}}T: {{var telephone}}{{/depend}}| {{depend fax}}<br/>F: {{var fax}}{{/depend}}| {{depend vat_id}}<br/>VAT: {{var vat_id}}{{/depend}}|

数据流

系统按以下步骤处理3个单词的地址

1. 从账单/收货地址保存操作中，观察者（What3Words_What3Words_Model_Observer）将3个单词地址保存到sales_quote_w3w表。

请参阅What3Words/What3Words/etc/config.xml以获取观察的具体事件。

1. 如果客户选择“保存到地址簿”选项，3个单词的地址也将记录在customer_address_w3w表中，并保存在客户地址属性“w3w”中。

2. 相同的观察者类监视sales_order_place_after事件，并在从sales_quote_w3w表检索后，将3个单词地址保存到sales_order_w3w。

自定义结账的修改

fields.js文件在以下位置附加HTML脚本

frontend/base/default/template/what3words/checkout

到以下

initBillingField和initShippingField方法。

这些可以通过修改jQuery选择器来适应任何已更改的标记。