管理扩展
通过从Commerce Marketplace添加扩展,您可以扩展Adobe Commerce应用程序功能。 例如,您可以添加主题以更改店面的外观,或者添加语言包以将店面和管理员本地化。
扩展的编辑器名称
尽管本节讨论如何从Commerce Marketplace获取扩展名的编辑器名称和版本,但您可以在模块的编辑器文件中找到 any 模块的名称和版本。 在文本编辑器中打开composer.json
文件并记下"name"
和"version"
值。
要从Commerce Marketplace 中获取模块的编辑器名称,请执行以下操作:
-
使用用于购买该组件的用户名和密码登录到Commerce Marketplace。
-
单击右上角的用户名并选择 我的个人资料。
-
在 我的帐户 页面上,单击 我的购买。
-
在 我的购买 页面上,选择您购买的模块,然后单击 技术详细信息。
-
单击 复制 以将Component name复制到剪贴板。
-
打开文本编辑器并粘贴组件名称并附加一个冒号字符(
:
)。 -
在 技术详细信息 中,单击 复制 以将Component version复制到剪贴板。
-
在文本编辑器中,将版本号附加到组件名称中冒号的后面。 例如:
code language-text extension-name/magento2:1.0.1
安装扩展
在向实施中添加扩展时,Adobe建议在开发分支中工作。 安装扩展时,扩展名(<VendorName>_<ComponentName>
)会自动插入到app/etc/config.php
文件中。 无需直接编辑文件。
要安装扩展:
-
在本地工作站上,转到您的项目目录。
-
创建或签出开发分支。 查看分支。
-
使用编辑器名称和版本,将扩展名添加到
composer.json
文件的require
部分。code language-bash composer require <extension-name>:<version> --no-update
-
更新项目依赖关系。
code language-bash composer update
-
添加、提交和推送代码更改。
code language-bash git add -A
code language-bash git commit -m "Install <extension-name>"
code language-bash git push origin <branch-name>
note warning WARNING 安装扩展时,在将代码更改推送到远程环境时必须包含 composer.lock
文件。composer install
命令读取composer.lock
文件以在远程环境中启用定义的依赖项。 -
构建和部署完成后,使用SSH登录到远程环境并验证已安装的扩展。
code language-bash bin/magento module:status <extension-name>
扩展名使用格式:
<VendorName>_<ComponentName>
。示例响应:
code language-none Module is enabled
如果遇到部署错误,请参阅扩展部署失败。
管理扩展
使用编辑器添加扩展时,部署过程会自动启用该扩展。 如果已安装扩展,则可以使用CLI启用或禁用该扩展。 管理扩展时,请使用格式: <VendorName>_<ComponentName>
在登录到远程环境时,切勿启用或禁用扩展。
启用或禁用扩展:
-
在本地工作站上,转到您的项目目录。
-
启用或禁用模块。
module
命令使用请求的模块状态更新config.php
文件。启用模块。
code language-bash bin/magento module:enable <module-name>
禁用模块。
code language-bash bin/magento module:disable <module-name>
-
如果启用了模块,请使用
ece-tools
刷新配置。code language-bash ./vendor/bin/ece-tools module:refresh
-
验证模块的状态。
code language-bash bin/magento module:status <module-name>
-
添加、提交和推送代码更改。
code language-bash git add -A
code language-bash git commit -m "Disable <extension-name>"
code language-bash git push origin <branch-names>
升级扩展
在继续之前,您需要具有扩展的编辑器名称和版本。 此外,请确认该扩展与您的项目和Adobe Commerce版本兼容。 特别是,在开始之前检查所需的PHP版本。
要更新扩展:
-
在本地工作站上,转到您的项目目录。
-
创建或签出开发分支。 查看分支。
-
在文本编辑器中打开
composer.json
文件。 -
找到扩展并更新版本。
-
保存更改并退出文本编辑器。
-
更新项目依赖关系。
code language-bash composer update
-
添加、提交和推送代码更改。
code language-bash git add -A
code language-bash git commit -m "Update <extension-name>"
code language-bash git push origin <branch-names>
如果遇到错误,请参阅从组件故障中恢复。 要了解有关将扩展与Adobe Commerce结合使用的更多信息,请参阅 管理员指南 中的扩展。