拡張機能のインストール

Adobe Commerceの動作を拡張またはカスタマイズするコードは、拡張機能と呼ばれます。 オプションで、に拡張機能をパッケージ化して配布できます Commerce Marketplace または別の拡張機能配布システムです。

拡張機能には次のものが含まれます。

  • モジュール(Adobe Commerceの機能の拡張)
  • テーマ(ストアフロントと管理者のルックアンドフィールを変更)
  • 言語パッケージ (ストアフロントをローカライズおよび管理者)
TIP
ここでは、コマンドラインを使用して、Commerce Marketplaceから購入した拡張機能をインストールする方法について説明します。 同じ手順でインストールできます いずれか 拡張機能。必要なのは、拡張機能の Composer 名とバージョンだけです。 これを見つけるには、拡張機能のを開きます 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. 拡張機能の Composer 名とバージョンを取得します。

  4. を更新 composer.json プロジェクト内のファイルを、拡張子の名前とバージョンで指定します。

  5. 拡張機能が正しくインストールされていることを確認します。

  6. 拡張機能を有効にして設定します。

拡張機能コンポーザーの名前とバージョンの取得

拡張機能の Composer 名とバージョンが既にわかっている場合は、この手順をスキップして次に進みます。 を更新 composer.json ファイル.

Commerce Marketplaceから拡張機能の Composer 名とバージョンを取得するには:

  1. へのログイン Commerce Marketplace と、拡張機能の購入に使用したユーザー名およびパスワード。

  2. 右上隅のをクリックします。 あなたの名前 > マイプロファイル.

    Marketplace アカウントにアクセス

  3. クリック 購入状況.

    Marketplace の購入履歴

  4. インストールする拡張機能を見つけて、 技術的詳細.

    技術的な詳細は、拡張機能の Composer 名を示します

TIP
または、Composer の名前とバージョン いずれか 拡張機能の内線番号(Commerce Marketplaceで購入したか、他の場所で購入したか) composer.json ファイル。

Composer ファイルの更新

拡張機能の名前とバージョンを 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コンパイルコマンドを再実行してください」というメッセージが表示される場合があります。 コンパイル コマンドを開発者モードで実行するように求めるメッセージは表示されません。

    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. 必要に応じて、管理者で拡張機能を設定します。

TIP
ブラウザーでストアフロントを読み込む際にエラーが発生した場合は、次のコマンドを使用してキャッシュをクリアします。 bin/magento cache:flush.

拡張機能のアップグレード

モジュールまたは拡張機能を更新またはアップグレードするには:

  1. Marketplace または別の拡張機能開発者から、更新されたファイルをダウンロードします。 モジュール名とバージョンをメモします。

  2. 内容をアプリケーションのルートディレクトリに書き出します。

  3. モジュール用の Composer パッケージが存在する場合は、次のいずれかを実行します。

    モジュール名ごとのアップデート:

    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
    
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995