README

安装

安装模块有两种支持方式，要么通过 Composer，要么手动安装。

使用 Composer 安装

要安装 AddresssFinder 模块，请运行

composer require addressfinder/module-magento1
composer config extra.magento-root-dir "MAGENTO INSTALLATION DIRECTORY"
composer require magento-hackathon/magento-composer-installer:*
composer run-script post-install-cmd -vvv -- --redeploy

magento-hackathon/magento-composer-installer 创建由 composer 创建的供应商文件与您的 magento 安装之间的符号链接。为了使此操作正常工作，您必须告诉 composer 您已安装 Magento 的位置。

提示：别忘了在您的 Magento 安装中启用符号链接以使 Composer 安装正常工作。这并不特指 AddressFinder，但是一个常见的“陷阱”。阅读更多。

手动安装

首先，下载最新版本的 ZIP 文件，然后将以下文件/目录合并到您的现有项目中

app/code/community/AddressFinder
app/design/frontend/base/default/layout/addressfinder.xml
app/design/frontend/base/default/template/addressfinder
app/etc/modules/AddressFinder_AddressFinder.xml
js/addressfinder

清除缓存

安装后，清除任何缓存非常重要。

设置与使用

请遵循 AddressFinder 网站上的用户指南

澳大利亚网站
新西兰网站

模板与事件

以下模板已公开

app/design/frontend/base/default/template/addressfinder/checkout/onepage/billing.phtml - 在结账的账单步骤上设置 AddressFinder。
app/design/frontend/base/default/template/addressfinder/checkout/onepage/shipping.phtml - 在结账的发货步骤上设置 AddressFinder。
app/design/frontend/base/default/template/addressfinder/customer/address/form.phtml - 在客户地址管理页上设置 AddressFinder。

此外，还触发了一些 JavaScript 事件。我们已确定了重要的事件

addressfinder:magento:loaded - 当 AddressFinder 加载完成时，由前端模板用于初始化
addressfinder:magento:initialising
addressfinder:magento:initialised
addressfinder:magento:enabling - 当国家改变时 AddressFinder 正在被启用（每个国家一个小部件）
addressfinder:magento:enabled
addressfinder:magento:disabling - 当国家改变时 AddressFinder 正在被禁用（每个国家一个小部件）
addressfinder:magento:disabled
addressfinder:magento:refreshing
addressfinder:magento:refreshed
addressfinder:magento:provider:registering - 当一个提供者正在注册（AU 或 NZ）时
addressfinder:magento:widget:registering - 当为一个提供者注册小部件时（AU 或 NZ）
addressfinder:magento:result:select - 当选择结果时
addressfinder:magento:value - 当为给定元数据键设置值时，例如将 city 设置为 Sydney。
addressfinder:magento:transform

要将功能附加到这些事件，请按照 Prototype 1.7 文档添加观察者

document.observe('addressfinder:magento:result:select', function (event) {
    // The payload of the event is located in event.memo

    // console.log(event.memo.fullAddress);
    // console.log(event.memo.metaData);
});

测试

要测试此插件，请克隆 docker-magento1 仓库： https://github.com/abletech/docker-magento1。按照此项目中的步骤创建您的 Magento 店铺并测试您对 AddressFinder 插件的更改。

模块开发

安装

开始开发之前，您需要使用Composer安装的Magento副本。在工作目录中创建以下composer.json文件：

{
    "repositories": {
        "firegento": {
            "type": "composer",
            "url": "https://packages.firegento.com"
        }
    },
    "require": {
        "magento-hackathon/magento-composer-installer": "^3.1",
        "aydin-hassan/magento-core-composer-installer": "^1.5",
        "firegento/magento": "v1.9.3.10"
    },
    "minimum-stability": "dev",
    "prefer-stable": true,
    "extra": {
        "magento-root-dir": "./public"
    }
}

创建此文件后，只需运行composer install即可设置您的Magento 1.9环境。当然，您可以将任何版本的Magento替换为您创建的文件中，我们只是使用了最新版本。

从现在起，将仓库克隆到某个位置（例如，在您新建的Magento项目中）

git clone https://github.com/AbleTech/addressfinder-magento-1.git

您现在可以使用Composer的一个功能将本地克隆的仓库作为Composer依赖项拉入。只需更新您的composer.json文件

{
    "repositories": {
        "firegento": {
            "type": "composer",
            "url": "https://packages.firegento.com"
        },
        "addressfinder": {
            "type": "path",
            "url": "./module-magento1"
        }
    },
    "require": {
        "magento-hackathon/magento-composer-installer": "^3.1",
        "aydin-hassan/magento-core-composer-installer": "^1.5",
        "firegento/magento": "v1.9.3.10",
        "addressfinder/module-magento1": "*"
    },
    "minimum-stability": "dev",
    "prefer-stable": true,
    "extra": {
        "magento-root-dir": "./public"
    }
}

您现在可以在模块中进行更改，这些更改将在您的Magento商店中反映出来。

编译资源

为了编译资源，只需在仓库内部运行（

）

npm install
npm run dev

以下是一些可能有用的任务

# Minitfy assets
npm run production

# Watch and automatically recompile

addressfinder / module-magento1

维护者

详细信息