サードパーティ製の拡張機能を管理
Adobe Commerce ビヘイビアーを拡張またはカスタマイズするコードは、拡張機能と呼ばれます。 オプションで、Commerce Marketplaceまたはその他の拡張機能ディストリビューションシステムに拡張機能をパッケージ化して配布できます。
拡張機能には次のものが含まれます。
- モジュール(Adobe Commerceの機能を拡張)
- テーマ(ストアフロントと管理者のルック&フィールの変更)
- 言語パッケージ(ストアフロントと管理者のローカライズ)
このトピックでは、コマンドラインインターフェイスを使用して、オンプレミス プロジェクト用にCommerce Marketplaceから購入したサードパーティ製の拡張機能を管理する方法について説明します。 クラウドインフラプロジェクトについては、拡張機能の管理を参照してください。
同じ手順で any 拡張機能をインストールできます。必要なのは、拡張機能のコンポーザー名とバージョンだけです。 見つけるには、拡張機能のcomposer.json ファイルを開き、"name"と"version"の値を書き留めます。
インストール
インストールの前に、次のことをおこなう必要があります。
-
データベースをバックアップします。
-
メンテナンスモードを有効にする:
code language-shell bin/magento maintenance:enable
拡張機能をインストールするには、次の操作を行う必要があります。
-
Commerce Marketplaceまたはその他の拡張機能の開発者から拡張機能を取得します。
-
Commerce Marketplaceから拡張機能をインストールする場合は、
repo.magento.comリポジトリがcomposer.jsonファイルに存在することを確認します。code language-shell "repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ] -
拡張機能のコンポーザー名とバージョンを取得します。
-
プロジェクト内の
composer.jsonファイルを、拡張機能の名前とバージョンで更新します。 -
拡張機能が正しくインストールされていることを確認します。
-
拡張機能を有効にして設定します。
拡張機能を確認
拡張機能のコンポーザー名とバージョンを既に知っている場合は、この手順をスキップして、composer.json ファイルの更新を続行します。
Commerce Marketplaceから拡張機能のコンポーザー名とバージョンを取得するには:
-
拡張機能の購入に使用したユーザー名とパスワードでCommerce Marketplaceにログインします。
-
右上隅で、自分の名前 > 自分のプロファイルをクリックします。
-
「購入履歴」をクリックします。
-
インストールする拡張機能を見つけ、コンポーネント名とバージョンをメモします。
composer.json ファイルに、any拡張機能のコンポーザー名とバージョン (Commerce Marketplaceまたは他の場所で購入した拡張機能)を見つけることができます。コンポーザーの依存関係を更新
拡張機能の名前とバージョンをcomposer.json ファイルに追加します。
-
プロジェクト ディレクトリに移動し、
composer.jsonファイルを更新します。code language-shell composer require <component-name>:<version>以下に例を挙げます。
code language-shell composer require j2t/module-payplug:2.0.2 -
認証キーを入力します。 公開鍵はユーザー名、秘密鍵はパスワードです。
-
Composerがプロジェクトの依存関係の更新を完了するのを待ち、エラーがないことを確認します。
code language-text 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>です。これは、コンポーザー名とは異なる形式です。 この形式を使用して、拡張機能を有効にします。 拡張機能の名前がわからない場合は、次を実行します。
bin/magento module:status
「無効なモジュールのリスト」の下にある拡張機能を探します。
有効にする
最初に生成された静的ビューファイルをクリアしない限り、一部の拡張機能は正しく機能しません。 拡張機能を有効にする際に--clear-static-content オプションを使用して、静的ビューファイルをクリアします。
-
拡張機能を有効にし、静的ビューファイルをクリアします。
code language-shell bin/magento module:enable J2t_Payplug --clear-static-content次の出力が表示されます。
code language-text 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. -
拡張機能を登録:
code language-shell bin/magento setup:upgrade -
プロジェクトを再コンパイルする:実稼動モードでは、「Magento コンパイルコマンドを再実行してください」というメッセージが表示されることがあります。 アプリケーションは、開発者モードでコンパイルコマンドを実行するように求めるプロンプトを表示しません。
code language-shell bin/magento setup:di:compile -
拡張機能が有効になっていることを確認します。
code language-shell bin/magento module:status J2t_Payplug拡張機能が無効になっていないことを確認する出力が表示されます。
code language-text Module is enabled -
キャッシュをクリーニングします。
code language-shell bin/magento cache:clean -
必要に応じて、Adminで拡張機能を設定します。
bin/magento cache:flush。アップグレード
モジュールまたは拡張機能を更新またはアップグレードするには:
-
Marketplaceまたは別の拡張機能の開発者から更新されたファイルをダウンロードします。 モジュール名とバージョンをメモします。
-
コンテンツをアプリケーションルートディレクトリに書き出します。
-
モジュールにComposer パッケージが存在する場合は、次のいずれかを実行します。
モジュール名ごとに更新:
code language-shell composer update vendor/module-nameバージョンごとに更新:
code language-shell composer require vendor/module-name ^x.x.x -
次のコマンドを実行して、キャッシュをアップグレード、デプロイ、クリーニングします。
code language-shell bin/magento setup:upgrade --keep-generatedcode language-shell bin/magento setup:static-content:deploycode language-shell bin/magento cache:clean
アンインストール
サードパーティの拡張機能を削除する手順については、拡張機能ベンダーにお問い合わせください。 手順では、次の情報を提供する必要があります。
- データベーステーブルの変更を元に戻す方法
- データベースデータの変更を元に戻す方法
- 削除または元に戻すファイル
サードパーティの拡張機能のアンインストールに関する一般的な情報については、次の手順を参照してください。
-
Adobe Commerce プロジェクトリポジトリから拡張機能を削除します。
-
Composer ベースの拡張機能の場合は、Adobe Commerce
composer.jsonファイルから拡張機能を削除します。code language-shell composer remove <component-name> -
Composer ベース以外の拡張機能の場合は、Adobe Commerce プロジェクトリポジトリから物理ファイルを削除します。
code language-shell rm -rf app/code/<vendor-name>/<component-name>
-
-
config.phpファイルがAdobe Commerce プロジェクト リポジトリのソース管理下にある場合は、config.phpファイルから拡張機能を削除します。 -
ローカルデータベースをテストして、ベンダーから提供された指示が期待どおりに動作することを確認します。
-
拡張機能が適切に無効になっており、web サイトがステージング環境で期待どおりに動作することを確認します。
-
本番環境に変更をデプロイします。