管理擴充功能

您可以從Commerce Marketplace新增擴充功能,以擴充您的Adobe Commerce應用程式功能。 例如,您可以新增佈景主題來變更店面的外觀和風格,或新增語言套件來本地化您的店面和管理員。

NOTE
為避免安裝問題,所有Marketplace購買都必須使用擁有雲端專案的相同帳戶(MAGEID)完成。

副檔名的撰寫器名稱

雖然本節討論如何從Commerce Marketplace取得副檔名的Composer名稱和版本,但您可以在模組的Composer檔案中找到​ 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
    

    如果您遇到部署錯誤,請參閱擴充功能部署失敗

管理擴充功能

當您使用Composer新增擴充功能時,部署程式會自動啟用擴充功能。 如果您已安裝擴充功能,可以使用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