README

内容

• 先决条件
• 安装
• 故障排除

先决条件

在安装 Hive 模块之前，您应该确保您的 Magento2 店铺在您的环境中运行无任何问题。

Hive 模块支持从版本 2.0 开始的 Magento2 社区版和企业版。

您需要一个 Hive Merchants 账户，该账户允许您将插件包含到您的店铺中。如果您需要专业服务以帮助设置您的环境，请联系 selena@hivetogether.com。

安装

安装 Magento 模块相当简单，可以根据您的 Magento 版本选择几种方法进行安装。

• 从 Magento 市场安装（仅限 Magento 2.0.x 版本）
• 使用 Composer 安装
• 从 Zip 文件安装

使用 Web Setup Wizard 从 Magento 市场安装（仅限 Magento 2.0.x 版本）

注意

此安装方法仅适用于 2.0.x 版本的 Magento。如果您使用的是更新的 2.1.x 版本的 Magento，请使用 Composer 安装 或 从 Zip 文件安装。

这需要您拥有一个 Magento Commerce 账户以及相关的 API 密钥，这些密钥将用于与市场同步。

1. 在浏览器中打开 Magento 市场place 并将模块添加到购物车。结账并确保已将其添加到您的账户。
2. 以管理员身份登录到要安装模块的 Magento 系统的管理部分。
3. 通过导航到 '系统 > Web Setup Wizard' 来启动 Web Setup Wizard。
4. 点击 '组件管理器' 以与 Magento 市场同步。
5. 点击 '启用' HiveTogether。
6. 进入您的前端店铺，您应该会看到插件自动加载。

使用 Composer 安装

1. 以 Magento 文件系统所有者身份登录（或切换用户）。
2. 确保 Magento 根目录下 'app/etc' 中的文件对 Magento 文件系统所有者具有写入权限。
3. 确保已安装 Git 和 Composer。

4. 使用以下命令获取模块：

    composer require hive-together/hive-merchant-magento
   

5. 一旦模块获取完成，通过以下方式启用它：

    bin/magento module:enable Hive_HiveMerchant
   

6. 然后执行清理任务：

    bin/magento setup:upgrade
   

   然后：

    bin/magento cache:clean
   

从 Zip 文件安装

需要修改

1. 在浏览器中打开 Bitbucket 并注意/复制要安装的版本（最高版本）的 URL。

2. 以 Magento 文件系统所有者身份登录到 Magento 服务器并导航到 Magento 主目录。

3. 在 <magento home>/app/code/HiveTogether/HiveMerchant/ 创建一个目录，并切换到新目录。

4. 下载 zip/tarball 并解压。

5. 此时，可以使用以下任一方式安装：

   Web Setup Wizard 的组件管理器（仅限 Magento 2.0.x 版本，对于 2.1.x 使用命令行）

   1. 在 Web Setup Wizard 中安装。打开浏览器并使用管理权限登录到 Magento 管理部分。
   2. 导航到 '系统 > Web Setup Wizard'。
   3. 点击 '组件管理器'，向下滚动并定位 'HiveMerchant'。在操作中点击 '启用'。
   4. 按照屏幕上的说明操作，确保创建备份。

   命令行

   1. 要在命令行中启用模块，请切换到Magento目录：

      Home directory. Ensure you are logged in as the Magento filesystem owner.
      

   2. 验证 'HiveMerchant' 是否列出，并显示为禁用状态：`bin/magento

      module:status`.
      

   3. 使用以下命令启用模块：bin/magento module:enable Hive_HiveMerchant。
   4. 然后我们需要确保运行配置任务：`bin/magento

      setup:upgrade`.
      

   5. 最后，在命令行中清除Magento的缓存，请运行：`bin/magento

      cache:clean`.
      

故障排除

• 确保您的Magento版本与您使用的HiveTogether版本兼容并得到支持。

• 确保所有文件和文件夹都具有正确的Magento文件系统所有者和Web服务器用户的权限。

• 确保清除缓存并禁用/重新启用模块。

• 确保文本内容没有被压缩。

如果遇到任何您无法轻松解决的严重问题，您可以以Magento文件系统所有者的身份执行 bin/magento module:disable Hive_HiveMerchant 命令来禁用HiveMerchant模块。如有必要，再次清除Magento的缓存。

如果可能，收集尽可能多的数据，并在（bitbucket）上提交问题，以帮助改进模块。