README

Incomaker 客户

本模块将 Incomaker 的 XML 数据和跟踪 API 集成到您的电子商务网站中。

安装

转到您的 Magento 安装目录，并运行以下命令：

composer require incomaker/magento2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento cache:flush

现在打开网页浏览器，进入您的电子商务网站的管理区域，选择 商店 / 配置，将范围更改为 主网站，然后在 Incomaker 部分完成模块设置。

有关插件安装的更多信息，请参阅 安装说明

当模块成功安装和配置后，您将能够访问 XML 数据

https://<your-domain>/incomaker/data/feed?key=<your-api-key>&type=product

模块开发者

注意：以下信息仅供本 Magento 模块的开发者参考。

有关 Magento2 模块开发的在线资源

• https://developer.adobe.com/commerce/php/development/build/development-environment/
• https://www.mageplaza.com/devdocs/magento-2-module-development/
• https://meetanshi.com/blog/magento-2-module-development/

本地更新依赖项

这将创建包含所有依赖项的 vendor 目录，这对于在 IDE 内部进行代码检查很有用。

bin/composer-install

设置 MGT - 开发环境

关于 MGT-DEV 的更多信息：https://www.mgt-commerce.com/magento-2-local-development-environment

访问密钥

您需要从 Adobe 获取访问密钥：https://commercemarketplace.adobe.com/customer/accessKeys/。使用注册为 salamon@incomaker.com 的帐户。使用公钥作为用户名，私钥作为密码。

创建 auth.json 文件

cp auth.json.example auth.json

并将 Adobe 密钥粘贴到其中。

启动 MGT 环境

运行

bin/mgt-dev

然后转到 UI： https://:8443/

• 添加域名（例如 incomaker.mgt，工作目录： incomaker.mgt/pub - 必须以 pub 结尾）
• 编辑 hosts 文件并添加相同的域名
• 添加数据库（例如 incomaker，将密码设置为 dbpass 以便方便脚本工作）
• 添加定时任务（例如 cd /home/cloudpanel/htdocs/incomaker.mgt && bin/magento cron:run）

现在使用方便的脚本创建 Magento 项目

bin/mgt-install <instance_name, e.g. incomaker>

或者按困难的方式来做

通过 SSH 进入 MGT 环境

所有后续命令都必须通过 SSH 发布

ssh root@127.0.0.1

安装 Magento

创建新项目

cd /home/cloudpanel/htdocs/
rm incomaker.mgt -rf
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition incomaker.mgt

安装 Magento

cd incomaker.mgt
bin/magento setup:install \
    --backend-frontname='admin' --key='18Av6ITivOZG3gwY1DhMDWtlLfx1spLP' \
    --session-save='files' --db-host='127.0.0.1' --db-name='incomaker' \
    --db-user='incomaker' --db-password='incomaker' \
    --base-url='http://incomaker.mgt/' --base-url-secure='https://incomaker.mgt/' \
    --admin-user='admin' --admin-password='!admin123!' \
    --admin-email='john@doe.com' --admin-firstname='John' --admin-lastname='Doe'
chmod -R 777 /home/cloudpanel/htdocs/incomaker.mgt

禁用双因素认证

bin/magento module:disable Magento_AdminAdobeImsTwoFactorAuth Magento_TwoFactorAuth

安装 Incomaker 模块

composer require incomaker/magento2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento cache:flush
chmod -R 777 /home/cloudpanel/htdocs/incomaker.mgt

激活开发者模式

bin/magento deploy:mode:set developer

方便的脚本（完成以上所有操作）

bin/mgt-install <domain-name> <optional:magento-version> <optional:php-version>

示例

 bin/mgt-install test7 2.4.3-p3 7.4

同步文件

您必须在您的 IDE 中配置文件同步，在项目根目录和 root:root@127.0.0.1:/home/cloudpanel/htdocs/incomaker.mgt/vendor/incomaker/magento2 之间

文件更新后，您必须重新构建 Magento DI

bin/magento setup:di:compile
bin/magento cache:clean
bin/magento cache:flush
chmod -R 777 /home/cloudpanel/htdocs/incomaker.mgt

或者简单地从主机或容器内部运行 bin/mgt-update 或 mgt-update

查看日志

watch tail var/log/debug.log

使用不同的 PHP 和/或 Magento 版本

要使用不同的 PHP 版本

bin/mgt-ssh
alias php="/usr/bin/php7.4"

故障排除

403 禁止访问

这可能是由于网络工作目录不以 /pub 结尾造成的。

构建和部署

部署到 Packagist

• 创建并检出新分支（例如 v1.1）
• 在 composer.json 中增加版本号（例如 1.1.4）
• 提交
• 创建新版本标签（例如 1.1.4）
• 推送到 GitHub

打包为 ZIP

bin/module-package