README

多管理员订单邮件接收器模块

此模块为OXID eShop添加了多个管理员订单邮件接收者的功能。

关于模块

许多客户都存在一个问题，即管理员订单邮件地址绑定到单个用户。如果用户无法联系，订单邮件也无法接收，没有人可以处理订单。因此，此模块添加了将多个管理员订单邮件接收者添加到后端的功能。额外的接收者将作为抄送条目添加到常规管理员订单邮件中。

兼容性

• 仅适用于OXID eShop 6.2及以上版本
• 该模块是在OXID eShop社区版上构建和工作的
• 该模块应在OXID eShop专业版和企业版上工作
• 该模块已在OXID eShop社区版上进行了测试
• 该模块尚未在OXID eShop专业版和企业版上测试

要求

• OXID eShop 6.2社区版（或更高版本）
• PHP 7.1（或更高版本）

通过composer安装模块

默认安装通过packagist（推荐）

• 将模块添加到您的商店composer.json文件中
  • cd <shop root>
  • composer require patrick-blom/multi-ordermail-receiver

通过GitHub的替代安装（手动）

• 在商店根目录下创建一个名为"thirdparty"的新文件夹，并在其下创建一个名为"pb"的子文件夹（与composer.json在同一级别）
  • cd <shop root>
  • mkdir -p thirdparty/pb
• 将存储库克隆到新文件夹中
  • git clone git@github.com:patrick-blom/multi-ordermail-receiver.git thirdparty/pb/MultiOrderMailReceiver
• 返回商店根目录并添加存储库到composer.json中
  • composer config repositories.patrick-blom/multi-ordermail-receiver path thirdparty/pb/MultiOrderMailReceiver
• 将模块添加到您的商店composer.json文件中
  • composer require patrick-blom/multi-ordermail-receiver

OXID eShop模块激活（默认和替代安装相同）

• 为eShop 6.2准备模块配置
  • vendor/bin/oe-console oe:module:install-configuration source/modules/pb/MultiOrderMailReceiver/
  • vendor/bin/oe-console oe:module:apply-configuration
• 激活模块
  • vendor/bin/oe-console oe:module:activate multiordermailreceiver
• 重新生成统一命名空间和视图，因为该模块添加了新的数据库字段
  • vendor/bin/oe-eshop-unified_namespace_generator
  • vendor/bin/oe-eshop-db_views_regenerate

使用

• 安装和激活后，您将在
  • 主设置 -> 核心设置 -> 主要（右侧）
• 下找到一个新的邮件地址字段，称为“订单的附加电子邮件地址”
• 附加邮件地址必须用分号（;）分隔
• 只有有效的电子邮件地址才会被添加为抄送

如果没有提供地址，则不会设置抄送条目

注意！

测试过程应在开发环境或CI管道中完成。

准备

• 按描述安装模块
• 准备OXID测试库，如其在存储库中所描述，或使用oxvm_eshop / docker-eshop-sdk
• 将pb/MultiOrderMailReceiver添加到您的test_config.yml中的部分模块路径中（例如：partial_module_paths: 'pb/MultiOrderMailReceiver'）
• 将来自供应商模块目录的config.inc.TEST.php.dist复制到您的商店根目录，并将其重命名为config.inc.TEST.php
• 根据您的需求调整config.inc.TEST.php中的设置（测试数据库名称、错误报告等）
• 修改您的config.inc.php并确保在测试期间将config.inc.TEST.php加载

    // bottom of config.inc.php
    if (defined('OXID_PHP_UNIT')) {
        include "config.inc.TEST.php";
    }

运行测试

• 导航到商店根目录
• 使用以下命令运行测试：php vendor/bin/runtests <商店根目录的绝对路径>/source/modules/pb/MultiOrderMailReceiver/Tests
• 使用以下命令运行覆盖率测试：php vendor/bin/runtests-coverage <商店根目录的绝对路径>/source/modules/pb/MultiOrderMailReceiver/Tests

许可证

本模块遵循GPL-3.0许可证发布。要查看完整概述，请查看LICENSE文件。