total-processing/magento-plugin

Total Processing 开源支付平台 Magento 模块

3.0.6 2024-08-30 14:27 UTC

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.x2.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 中安装扩展

  1. 打开命令行。
  2. 导航到 Magento 2 根目录。
  3. 运行 CLI 命令

composer require total-processing/magento-plugin --no-update

composer update total-processing/magento-plugin

  1. 运行 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

有关更多信息,请参阅文档

https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/tutorials/extensions.html?lang=en

Packagist 链接

https://packagist.org.cn/packages/total-processing/magento-plugin#2.0.17

手动安装

  1. 获取模块代码存档并将其解压缩到某个位置(或从远程存储库检出,如果已经可用)。
  1. 在 Magento 根目录下创建一个新的子文件夹 app/code/TotalProcessing/Opp
  1. 将解压缩的存档内容复制到新创建的文件夹中。请确保 composer.jsonregistration.php 以及如 BlockControllerModel 等文件夹位于 app/code/TotalProcessing/Opp 中,而不是子级文件夹中。
  1. 检出适合您平台版本的 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 文件包含有关配置的更多信息。

  1. 使用 Magento CLI 检查模块状态

    $ bin/magento module:status
    

    输出应类似于以下内容

    .....
    List of disabled modules:
       
    TotalProcessing_Opp
    Veriteworks_CookieFix
    
  2. 通过执行以下命令启用 TotalProcessing_OppVeriteworks_CookieFix 模块

    $ bin/magento module:enable TotalProcessing_Opp
    $ bin/magento module:enable Veriteworks_CookieFix
    
  3. 执行 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 文档门户 中找到各种测试信用卡号码。