total-processing / magento-plugin
Total Processing 开源支付平台 Magento 模块
Requires
- php: ~7.2.0||~7.3.0||~7.4.0||~8.0.0||~8.1.0
- veriteworks/cookiefix: 2.4.*||3.0.*
This package is auto-updated.
Last update: 2024-09-20 09:46:31 UTC
README
目前,模块只能安装到 app/code
目录下。模块很快将支持基于 composer 的安装。
重要的模块依赖项与第三方 cookie 处理相关
2021 年 2 月,Google Chrome 和其他主流浏览器已采用新的第三方 cookie 限制策略,默认的 SameSite
值为 Lax
。这阻止了所有基于 iframe 的实现获取或管理会话 cookie,因此支付无法正确处理。此模块也依赖于它,需要安装额外的扩展,直到 Adobe 发布 v2.4.4,届时应该有控制 cookie 政策的方式。
MDN SameSite cookies 解释了 SameSite cookie 属性的工作流程,它定义了对环境的要求。TotalProcessing/Opp 使用具有属性 SameSite=none; secure=true;
的 cookie。此功能仅在安全上下文中(HTTPS)可用,并且由于设置了 SameSite 属性为 None 或无效值,而没有设置 secure 属性,cookie 将被拒绝。Secure 属性的值基于连接类型(HTTPS/HTTP,值是 true/false)。因此,根据策略,TotalProcessing/Opp 模块只能在 HTTPS 连接上工作。
Veriteworks/CookieFix 是一个实验性扩展,提供必要的默认 cookie 策略调整。在发布此文档时,有两个标签可用于不同的 Magento 版本 - 2.4.2
支持所有 Magento 2.2.x
和 2.3.x
版本,直到 2.3.6-p1
。2.3.6-p1 及以上版本的 Magento 版本,包括 2.4.x
,需要 Veriteworks_CookieFix
标签 3.0.1
,该标签在管理员中添加了指定默认 SameSite
策略的选项。您需要安装与您的 Magento 实例兼容的版本以及此扩展。
Composer 安装
通过 composer 在 Magento 2 中安装扩展
- 打开命令行。
- 导航到 Magento 2 根目录。
- 运行 CLI 命令
composer require total-processing/magento-plugin --no-update
composer update total-processing/magento-plugin
- 运行 Magento CLI 命令
php bin/magento module:enable TotalProcessing_Opp --clear-static-content
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
有关更多信息,请参阅文档
Packagist 链接
https://packagist.org.cn/packages/total-processing/magento-plugin#2.0.17
手动安装
- 获取模块代码存档并将其解压缩到某个位置(或从远程存储库检出,如果已经可用)。
- 在 Magento 根目录下创建一个新的子文件夹
app/code/TotalProcessing/Opp
- 将解压缩的存档内容复制到新创建的文件夹中。请确保
composer.json
、registration.php
以及如Block
、Controller
、Model
等文件夹位于app/code/TotalProcessing/Opp
中,而不是子级文件夹中。
检出适合您平台版本的
Veriteworks/CookieFix
适合的版本(有关如何找到适用于您的平台版本的详细信息,请参阅上文)到app/code/Veriteworks/CookieFix
对于低于 2.3.6-p1 的 Magento 版本
$ git clone --branch 2.4.2 https://github.com/Veriteworks/CookieFix.git app/code/Veriteworks/CookieFix
对于 2.3.6-p1 及以上版本的 Magento 版本
$ git clone --branch 3.0.1 https://github.com/Veriteworks/CookieFix.git app/code/Veriteworks/CookieFix
Veriteworks/CookieFix README 文件包含有关配置的更多信息。
使用 Magento CLI 检查模块状态
$ bin/magento module:status
输出应类似于以下内容
..... List of disabled modules: TotalProcessing_Opp Veriteworks_CookieFix
通过执行以下命令启用
TotalProcessing_Opp
和Veriteworks_CookieFix
模块$ bin/magento module:enable TotalProcessing_Opp $ bin/magento module:enable Veriteworks_CookieFix
执行 Magento 部署命令
$ bin/magento setup:upgrade $ bin/magento setup:di:compile $ bin/magento setup:static-content:deploy $ bin/magento cache:flush
安装后步骤
安装两个模块后,继续在管理员面板中配置支付方式。配置选项位于 商店 > 配置 > 销售与订单 > 支付方式 > Total Processing Limited。Veriteworks CookieFix 模块默认应用 SameSite
策略,版本为 2.4.2
。在标签 3.0.1
下出现了一个新的管理员选项,位于 商店 > 配置 > 通用 > 网络 > 默认 Cookie 设置。
您可以在 TotalProcessing 文档门户 中找到各种测试信用卡号码。