文件Commerce安裝指南

管理協力廠商擴充功能

Last update: Fri Jun 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined
  • undefined

擴充或自訂Adobe Commerce行為的程式碼稱為擴充功能。 您可以選擇封裝並發佈擴充功能於 Commerce Marketplace 或其他擴充功能發佈系統。

擴充功能包括：

  • 模組(擴充Adobe Commerce功能)
  • 佈景主題（變更店面外觀和風格，以及管理員）
  • 語言套件（將店面和管理員本地化）
TIP
本主題說明如何使用命令列介面來管理您從Commerce Marketplace購買的協力廠商擴充功能。 您可以使用相同的程式進行安裝 任何 擴充功能；您只需要擴充功能的撰寫器名稱和版本。 若要尋找，請開啟擴充功能的 composer.json 檔案並記下值 "name" 和 "version".

安裝

安裝之前，您可能需要：

  1. 備份您的資料庫。

  2. 啟用維護模式：

    code language-bash 
    bin/magento maintenance:enable

若要安裝擴充功能，您必須：

  1. 從Commerce Marketplace或其他擴充功能開發人員取得擴充功能。

  2. 如果您從Commerce Marketplace安裝擴充功能，請確定 repo.magento.com 存放庫存在於您的 composer.json 檔案：

    code language-bash 
    "repositories": [
    {
        "type": "composer",
        "url": "https://repo.magento.com/"
    }
]

  3. 取得擴充功能的撰寫器名稱和版本。

  4. 更新 composer.json 檔案名稱，並搭配副檔名與版本。

  5. 確認擴充功能已正確安裝。

  6. 啟用並設定擴充功能。

取得擴充功能資訊

如果您已知道擴充功能的撰寫器名稱和版本，請略過此步驟，並繼續使用 更新您的 composer.json 檔案.

若要從Commerce Marketplace取得擴充功能的撰寫器名稱和版本：

  1. 登入 Commerce Marketplace 使用您購買擴充功能所用的使用者名稱和密碼。

  2. 在右上角，按一下 您的姓名 > 我的設定檔.

    存取您的Marketplace帳戶

  3. 按一下 我的購買.

    Marketplace購買記錄

  4. 找到您要安裝的擴充功能，然後按一下 技術細節.

    技術詳細資訊會顯示擴充功能的撰寫器名稱

TIP
或者，您可以找到「撰寫器」名稱和版本 任何 擴充功能(無論您是在Commerce Marketplace或其他地方購買)中的 composer.json 檔案。

更新撰寫器相依性

將擴充功能的名稱和版本新增至 composer.json 檔案：

  1. 導覽至您的專案目錄並更新您的 composer.json 檔案。

    code language-bash 
    composer require <component-name>:<version>

    例如，

    code language-bash 
    composer require j2t/module-payplug:2.0.2

  2. 輸入您的 驗證金鑰. 您的公開金鑰是您的使用者名稱；您的私密金鑰是您的密碼。

  3. 請等待Composer完成更新您的專案相依性，並確認沒有任何錯誤：

    code language-terminal 
    Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
  - Installing j2t/module-payplug (2.0.2): Downloading (100%)
Writing lock file
Generating autoload files

驗證安裝

若要確認擴充功能是否已正確安裝，請執行以下命令：

bin/magento module:status J2t_Payplug

依預設，擴充功能可能已停用：

Module is disabled

副檔名採用格式 <VendorName>_<ComponentName>；此格式與Composer名稱不同。 使用此格式來啟用擴充功能。 如果您不確定擴充功能名稱，請執行：

bin/magento module:status

檢視「已停用模組清單」下的擴充功能。

啟用

除非您先清除產生的靜態檢視檔案，否則有些副檔名無法正常運作。 使用 --clear-static-content 啟用副檔名時清除靜態檢視檔案的選項。

  1. 啟用擴充功能並清除靜態檢視檔案：

    code language-bash 
    bin/magento module:enable J2t_Payplug --clear-static-content

    您應該會看到下列輸出：

    code language-terminal 
    The following modules have been enabled:
- J2t_Payplug

To make sure that the enabled modules are properly registered, run 'setup:upgrade'.
Cache cleared successfully.
Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes.
Generated static view files cleared successfully.

  2. 註冊擴充功能：

    code language-bash 
    bin/magento setup:upgrade

  3. 重新編譯專案：在生產模式中，您可能會收到「請重新執行Magento編譯命令」的訊息。 應用程式不會提示您以開發人員模式執行compile指令。

    code language-bash 
    bin/magento setup:di:compile

  4. 確認擴充功能已啟用：

    code language-bash 
    bin/magento module:status J2t_Payplug

    您應該會看到驗證擴充功能是否已不再停用的輸出：

    code language-terminal 
    Module is enabled

  5. 清除快取：

    code language-bash 
    bin/magento cache:clean

  6. 視需要在Admin中設定擴充功能。

TIP
如果您在瀏覽器中載入店面時發生錯誤，請使用下列命令清除快取： bin/magento cache:flush.

升級

若要更新或升級模組或擴充功能：

  1. 從Marketplace或其他擴充功能開發人員下載更新的檔案。 記下模組名稱和版本。

  2. 將內容匯出至應用程式根目錄。

  3. 如果模組存在撰寫器套件，請執行以下其中一項作業。

    每個模組名稱更新：

    code language-bash 
    composer update vendor/module-name

    每個版本更新：

    code language-bash 
    composer require vendor/module-name ^x.x.x

  4. 執行以下命令以升級、部署和清除快取。

    code language-bash 
    bin/magento setup:upgrade --keep-generated
    code language-bash 
    bin/magento setup:static-content:deploy
    code language-bash 
    bin/magento cache:clean

解除安裝

請聯絡擴充功能供應商，取得移除協力廠商擴充功能的指示。 指示應提供下列資訊：

  • 如何還原資料庫表格變更
  • 如何還原資料庫資料變更
  • 應該移除或還原哪些檔案
CAUTION
在非生產環境中執行解除安裝步驟 第一 並在部署到生產環境之前進行徹底測試。

下列指示提供解除安裝協力廠商擴充功能的一般資訊：

  1. 從您的Adobe Commerce專案存放庫移除擴充功能。

    • 針對以Composer為基礎的擴充功能，請從您的Adobe Commerce移除擴充功能 composer.json 檔案。

      code language-bash 
      composer remove <package-name>

    • 對於非Composer型副檔名，請從您的Adobe Commerce專案存放庫中移除實體檔案。

      code language-bash 
      rm -rf app/code/<vendor-name>/<module-name>

  2. 如果 config.php 檔案是由Adobe Commerce專案存放庫中的原始檔控制管理，請從移除副檔名 config.php 檔案。

  3. 測試您的本機資料庫，確保廠商提供的指示如預期般運作。

  4. 確認擴充功能已正確停用，且您的網站在中繼環境中可如預期般運作。

  5. 將變更部署到您的生產環境。

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995