README

该仓库包含一个用于Ordergroove订阅服务的中间件样例代码扩展。

兼容性 Magento 2.4
- Adobe开源: 2.4.3-p1
- Adobe Commerce: 2.4.3-p1
- 稳定版本 -> 最新1.3.X
- 支持信用卡和PayPal支付方式的Braintree支付网关

已知问题和限制

请注意，由于Magento的灵活性质，其他覆盖可能与此样例代码冲突。在集成过程中，请与您的Ordergroove代表合作进行彻底的测试。

此样例代码是以Braintree支付网关为前提构建的。如果您使用的是其他网关，则需要对代码进行定制以存储/检索安全支付方式。
目前仅支持信用卡和PayPal支付方式。如果您想支持其他支付方式，则需要修改此代码以添加对额外支付方式的支持或隐藏选择订阅支付方式的客户的替代支付方式。
多站支持仅限于使客户能够使用订阅结账并在客户账户部分管理他们之前创建的订阅。该样例代码目前不提供对放置重复订单和导入Magento产品目录（即产品源）的全面支持。
此样例代码依赖于在Magento中设置平邮费率，以便为所有重复订单应用运费。因此，在标准结账过程中，此平邮费率选项被隐藏。如果您明确使用平邮费率并将其作为客户选项提供，则必须更改代码，以便客户可以在结账时继续选择平邮费率。
此样例代码不支持客户/支付更新。如果您的当前Magento网站提供客户更新个人详情或支付方式的方式，则可以使用我们的客户/支付更新API将这些更新发送到Ordergroove。
有时很难调试特定环境的问题，为此我们添加了一些日志记录，默认情况下，日志可以在/var/log/ordergroove目录中找到。Ordergroove没有直接访问这些日志，因此有时我们可能需要您将这些日志发送给我们。
负责向Ordergroove发送产品源的cron作业可能不会执行，产品更新可能停止进入Ordergroove。这通常与默认cron计划在cron实际上不会运行作业的时间安排执行相关。如果您遇到此问题，请联系Ordergroove或查看“ordergroove”的cron_groups设置，并根据您的需要进行调整。

如果您遇到此处未列出的问题，请不要犹豫，将其添加到github issues列表：https://github.com/ordergroove/magento-module-24/issues

安装说明

通过以下两种方法之一安装Ordergroove/Subscription。之后，按照以下说明配置模块以连接到Ordergroove。

通过Composer安装（推荐）

在您的根Magento安装目录中运行以下命令

composer require ordergroove/subscription
bin/magento module:enable Ordergroove_Subscription
bin/magento setup:upgrade
bin/magento cache:flush

通过app/code安装（不推荐）

注意：通过app/code进行安装，未来升级模块将更加困难。

创建以下目录：app/code/Ordergroove/Subscription
下载模块的最新版本（您也可以通过此链接下载以前的版本）
解压缩并将文件复制到app/code/Ordergroove/Subscription。
在您的根Magento安装目录中运行以下命令

bin/magento module:enable Ordergroove_Subscription
bin/magento setup:upgrade
bin/magento cache:flush

文档

配置

所有配置均位于商店 > 配置 > Ordergroove > 订阅下。配置适用于每个网站，在默认范围内不可见。

常规配置

模块启用 - 选择是否启用该模块
环境 - 决定是否仅使用测试环境的URL进行Ordergroove操作
公共ID - Ordergroove公共/商家ID。在设置账户时由Ordergroove提供。
- 注意：公共ID应为每个网站唯一，且不应在多个网站上重复使用。
哈希密钥 - Ordergroove哈希密钥。在设置账户时由Ordergroove提供。
- 注意：哈希密钥应属于相应的公共ID。

SFTP配置

同步计划仅在默认配置范围内可用。
- 选择每天（美国东部时间）产品同步发生的小时。
主机 - 不可编辑的主机字符串。始终指向feeds.ordergroove.com
端口 - 不可编辑的端口字符串。始终为22
用户名 - 由Ordergroove提供的SFTP用户名
密码 - 由Ordergroove提供的SFTP密码
检查连接 - 在输入用户名和密码后单击以确定凭据是否有效。

日志

Ordergroove/Subscription将各种重要信息记录到位于var/log/ordergroove的日志文件中。例如，任何与产品同步相关的错误将被记录到var/log/ordergroove/product_sync/error.log，与产品同步相关的消息将被记录到var/log/ordergroove/product_sync/info.log。

周期性订单（订单放置）

放置端点配置

Ordergroove应配置为将周期性订单发送到<website_url>/ordergroove/subscription/placeorder

启用统一运费

周期性订单放置代码假定已启用统一运费。您可以在Magento中通过“商店 > 配置 > 销售 > 配送方式”启用此功能

启用多源库存

如果您的商店使用多店铺库存，您必须在Ordergroove配置中启用此功能。您可以通过“商店 > 配置 > Ordergroove > 订阅”下的标准Ordergroove设置来完成此操作。

ordergroove / subscription

维护者

详细信息