README

Sylius FANCourier 插件
许可证 MIT

此插件与 selfawb.ro API 兼容，并提供了来自 FANCourier 提供商的运费估算（使用他们的 API）。

此插件基于 Bitbag Shipping Export 抽象层制作，并进行了一些修改。

FANCourier 提供的服务基于罗马尼亚，您可能会在其他地区遇到错误。

先决条件

您需要在 https://www.selfawb.ro/ 上有一个账户，并且还需要一份将在您向 sales@fancourier.ro 发出明确请求后签署的合同。有许多服务可供选择，您选择的服务也必须在定义第 4 点处的运输网关时选中。

安装

1. 安装 Bitbag Shipping Export 插件，Infifni 修改版。

   1.1. 在您的应用程序的 main application composer.json 文件中添加一个 sections repositories 部分，内容如下

   {
       "repositories": [
           {
               "type": "vcs",
               "url": "https://github.com/infifni/SyliusShippingExportPlugin"
           }
       ]
   }

   1.2. 按照从 https://github.com/infifni/SyliusShippingExportPlugin 的安装步骤操作，除了 composer require 步骤。该步骤应该是

       composer require bitbag/shipping-export-plugin:dev-master

2. 安装 Sylius FANCourier 插件。

   2.1. Composer 安装。

   composer require infifni/sylius-fan-courier-plugin

   2.2. 将插件依赖项添加到您的 config/bundles.php 文件中（这可以通过 flex 自动完成）

   // config/bundles.php
   return [
       // other lines
       Infifni\SyliusFanCourierPlugin\InfifniSyliusFanCourierPlugin::class => ['all' => true],
   ];

   2.3. 导入资源

   // config/packages/infifni_sylius_fan_courier_plugin.yaml
   imports:
      - { resource: "@InfifniSyliusFanCourierPlugin/Resources/config/resource/infifni_shipping_awb.yml" }

   2.4. 执行数据库迁移（如果数据库中已经有数据，请检查查询）

   cd /project/root
   cp vendor/infifni/sylius-fan-courier-plugin/src/Migrations/Version20200606093404.php src/Migrations
   bin/console doctrine:mig:mig

3. 在 /admin/shipping-methods/new 上定义一个新的运输方法。

   • 命名为 FANCourier 和您喜欢的名称
   • 这里唯一强制性的事情是选择计算器为 FAN 计算器，它将用于成本估算

4. 在 /admin/shipping-gateways/new/fan 上定义一个新的网关并使用在第 4 点定义的运输方法。

常见问题

怎么办？

如果您遇到了这样的问题，通常可以通过更改提供的名称来解决。如果错误仍然存在，请在 Github 上报告问题。

您还可以定期查看日志（dev.log，prod.log），并搜索包含 '运费估算失败' 的错误。如果您能解决它们，请提出拉取请求。如果您不能解决，请报告问题，尤其是如果您的问题不是上述列出的异常。