管理扩展

通过从Commerce Marketplace添加扩展,您可以扩展Adobe Commerce应用程序功能。 例如,您可以添加主题以更改店面的外观,或者添加语言包以将店面和管理员本地化。

NOTE
为了避免安装问题,必须使用拥有云项目的同一帐户(MAGEID)完成所有Marketplace购买。

扩展的编辑器名称

尽管本节讨论如何从Commerce Marketplace获取扩展名的编辑器名称和版本,但您可以在模块的编辑器文件中找到​ any ​模块的名称和版本。 在文本编辑器中打开composer.json文件并记下"name""version"值。

要从Commerce Marketplace ​中获取模块的编辑器名称,请执行以下操作:

  1. 使用用于购买该组件的用户名和密码登录到Commerce Marketplace

  2. 单击右上角的用户名并选择​ 我的个人资料

    访问你的Marketplace帐户

  3. 在​ 我的帐户 ​页面上,单击​ 我的购买

    市场购买历史记录

  4. 在​ 我的购买 ​页面上,选择您购买的模块,然后单击​ 技术详细信息

  5. 单击​ 复制 ​以将Component name复制到剪贴板。

  6. 打开文本编辑器并粘贴组件名称并附加一个冒号字符(:)。

  7. 在​ 技术详细信息 ​中,单击​ 复制 ​以将Component version复制到剪贴板。

  8. 在文本编辑器中,将版本号附加到组件名称中冒号的后面。 例如:

    code language-text
    extension-name/magento2:1.0.1
    

安装扩展

在向实施中添加扩展时,Adobe建议在开发分支中工作。 安装扩展时,扩展名(<VendorName>_<ComponentName>)会自动插入到app/etc/config.php文件中。 无需直接编辑文件。

要安装扩展

  1. 在本地工作站上,转到您的项目目录。

  2. 创建或签出开发分支。 查看分支

  3. 使用编辑器名称和版本,将扩展名添加到composer.json文件的require部分。

    code language-bash
    composer require <extension-name>:<version> --no-update
    
  4. 更新项目依赖关系。

    code language-bash
    composer update
    
  5. 添加、提交和推送代码更改。

    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文件以在远程环境中启用定义的依赖项。
  6. 构建和部署完成后,使用SSH登录到远程环境并验证已安装的扩展。

    code language-bash
    bin/magento module:status <extension-name>
    

    扩展名使用格式: <VendorName>_<ComponentName>

    示例响应:

    code language-none
    Module is enabled
    

    如果遇到部署错误,请参阅扩展部署失败

管理扩展

使用编辑器添加扩展时,部署过程会自动启用该扩展。 如果已安装扩展,则可以使用CLI启用或禁用该扩展。 管理扩展时,请使用格式: <VendorName>_<ComponentName>

在登录到远程环境时,切勿启用或禁用扩展。

启用或禁用扩展

  1. 在本地工作站上,转到您的项目目录。

  2. 启用或禁用模块。 module命令使用请求的模块状态更新config.php文件。

    启用模块。

    code language-bash
    bin/magento module:enable <module-name>
    

    禁用模块。

    code language-bash
    bin/magento module:disable <module-name>
    
  3. 如果启用了模块,请使用ece-tools刷新配置。

    code language-bash
    ./vendor/bin/ece-tools module:refresh
    
  4. 验证模块的状态。

    code language-bash
    bin/magento module:status <module-name>
    
  5. 添加、提交和推送代码更改。

    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版本

要更新扩展

  1. 在本地工作站上,转到您的项目目录。

  2. 创建或签出开发分支。 查看分支

  3. 在文本编辑器中打开composer.json文件。

  4. 找到扩展并更新版本。

  5. 保存更改并退出文本编辑器。

  6. 更新项目依赖关系。

    code language-bash
    composer update
    
  7. 添加、提交和推送代码更改。

    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结合使用的更多信息,请参阅​ 管理员指南 ​中的扩展

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26