デベロッパーツール
高度な開発者ツールを使用して、フロントエンド開発時のコンパイルモードの決定、IP アドレスの許可リストの作成、テンプレートパスヒントの表示を行います。 また、ストアフロントと管理者のインターフェイスで、テキストを簡単にスポット変更するためのツールもあります。
- アクションログ (Adobe Commerceのみ)
- フロントエンド開発ワークフロー
- 静的ファイル署名の使用
- リソースファイルの最適化
- 開発者クライアントの制限
- テンプレートパスのヒント
- インライン翻訳
操作モード
Adobe CommerceまたはMagento Open Sourceインスタンスは、実稼働モード または 開発者モード のいずれかで実行するようにデプロイできます。 開発者向けに特別に設計されたツールと設定は、ストアが 開発者モード で動作している場合にのみアクセスできます。
操作モードは、適切な権限を持つユーザーがサーバーのコマンドラインからのみ変更できます。 詳しくは、『 設定ガイド の 操作モードの設定を参照してください。
マーチャントドキュメントのほとんどのトピックは、実稼動モードで実行されているCommerce インスタンスに適用されます。 ただし、次の設定とツールは、インストールが開発者モードで実行されている場合にのみ使用できます。
フロントエンド開発ワークフロー
フロントエンド開発ワークフローのタイプは、開発中にクライアントサイドまたはサーバーサイドで少ないコンパイルが行われるかどうかを決定します。 Less は、追加の機能と規則を持ち、合理化されたコードを生成する CSS の拡張機能です。 テーマの開発には、クライアントサイドの LESS コンパイルをお勧めします。 サーバーサイドのコンパイルはデフォルトのモードです。 開発ワークフローオプションは、実稼動モードのストアでは使用できません。
Commerce開発者ドキュメントの クライアントサイドの LESS コンパイルとサーバーサイドの LESS コンパイルの比較{:target="_blank"} を参照してください。
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
「 」を展開し、「Front-end Development Workflow」セクションを展開します。
-
Workflow Type を次のいずれかに設定します。
Client side less compilation
- コンパイルは、ネイティブless.js
ライブラリを使用したブラウザーで行われます。Server side less compilation
- Less PHP ライブラリを使用して、サーバー上でコンパイルが行われます。 これは、実稼動用のデフォルトのモードです。
-
完了したら、「Save Config」をクリックします。
静的ファイル署名
静的ファイルの URL にデジタル署名を追加すると、ブラウザーはファイルの新しいバージョンが使用可能かどうかを検出できます。 デジタル署名で追跡できる静的ファイルには、JavaScript、CSS、画像、フォントなどがあります。 署名は、ベース URL の直後のパスに追加されます。 ファイルの署名がブラウザーのキャッシュに格納されている署名と異なる場合は、ファイルの新しいバージョンが使用されます。
Commerce開発者ドキュメントの 静的コンテンツ署名{:target="_blank"} を参照してください。
構成設定の詳細なリストについては、『構成リファレンス の_ 静的ファイル設定 _を参照してください。
署名済み静的ファイルを有効にするには:
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
「 」を展開し、「Static Files Settings」セクションを展開します。
-
Sign Static Files を
Yes
に設定します。 -
完了したら、「Save Config」をクリックします。
リソースファイルの最適化
リソースファイルの読み込みに要する時間は、ファイルを結合およびバンドルし、コードを最小限に抑えることで短縮できます。
- 結合すると、同じ種類の別々のファイルが 1 つのファイルに結合されます。
- バンドルは、ページの読み込みに必要な HTTP リクエスト数を減らすために、別々のファイルをグループ化する技術です。
- 縮小によってスペース、改行、コメントは削除されますが、コードの機能には影響しません。 最小化されたファイルは編集できないので、プロセスは、実稼動に移行する準備が整った場合にのみ適用してください。
デフォルトでは、Adobe CommerceとMagento Open Sourceはファイルの結合、バンドル、最小化を行わないので、プロジェクト開発者はどのファイル最適化方法を使用するかを決定する必要があります。
詳しくは、 パフォーマンスのベストプラクティスを参照してください。
MergeMinify
MergeBundleMinify
Minify
リソースファイルを最適化するには:
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
CSS ファイルを最適化するには、「CSS Settings」セクションの を展開し、次の手順を実行します。
- Merge CSS Files を
Yes
に設定します。 - Minify CSS Files を
Yes
に設定します。
{width="600" modal="regular"}
- Merge CSS Files を
-
JavaScript ファイルを最適化するには、「JavaScript Settings」セクションの を展開し、次の手順を実行します。
- Merge JavaScript Files を
Yes
に設定します。 - Minify JavaScript Files を
Yes
に設定します。
{width="600" modal="regular"}
- Merge JavaScript Files を
-
PHTML テンプレートファイルを縮小するには、 「Template Settings」セクションを展開し、Minify Html を
Yes
に設定します。{width="600" modal="regular"}
-
完了したら、「Save Config」をクリックします。
クライアントの制限
許可リストに加える template path hints などのツールを使用する前に、IP アドレスを Developer Client Restrictions に追加して、ストア内のお客様のショッピングエクスペリエンスが中断されないようにします。 IP アドレスがわからない場合は、オンラインで検索できます。
Commerce技術情報については、Cloud Infrastructure ガイドの リクエストを許可するためのカスタム VCL を参照してください。
IP アドレスを許可リストに追加するには
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
「 」を展開し、「Developer Client Restrictions」セクションを展開します。
{width="600" modal="regular"}
-
Allow IPs:IP アドレスを入力します。
複数の IP アドレスからアクセスする必要がある場合は、各アドレスをコンマで区切ります。
-
完了したら、「Save Config」をクリックします。
-
プロンプトが表示されたら、無効なキャッシュを更新します。
テンプレートパスのヒント
テンプレートパスヒントは、ページで使用される各テンプレートへのパスを含む表記を追加する診断ツールです。 テンプレートパスのヒントは、ストアフロントまたは管理者に対して有効にできます。
Commerce開発者向けドキュメントの テンプレート、レイアウト、スタイルの検索{:target="_blank"} を参照してください。
許可リストに加える手順 1:に IP アドレスを追加する
許可リストに加える テンプレートパスヒントを使用する前に、IP アドレスを 🔗 に追加して、ストアで買い物をしている顧客への干渉を避けます。 完了したら、必ずCommerceのキャッシュをクリアして、ストアからすべてのヒントを削除します。
手順 2:テンプレートパスヒントを有効にする
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
Debug のセクションの を展開し、以下を実行します。
{width="600" modal="regular"}
-
ストアに対してテンプレートパスヒントをアクティブにするには、Enabled Template Path Hints for Storefront を
Yes
に設定します。 -
URL に
templatehints
パラメーターが含まれている場合にのみストアに対してテンプレート パス ヒントを有効にするには、URL パラメーターを含むストアフロントのヒントを有効にする をYes
に設定します。 必要に応じて、パラメーターの値を設定します。 デフォルト値はmagento
ですが、カスタム値を使用できます。 例えば、値をlorem
に変更した場合、mymagento.com?templatehints=lorem
を使用してテンプレートのヒントを表示します。 -
管理者用のテンプレートパスヒントをアクティブにするには、Enabled Template Path Hints for Admin を
Yes
に設定します。 -
ブロック名を含めるには、Add Block Class Type to Hints を
Yes
に設定します。
-
-
完了したら、「Save Config」をクリックします。
手順 3:キャッシュのクリア
-
管理者 サイドバーで、System/Tools/Cache Management に移動します。
-
右上隅の「Flush Magento Cache」をクリックします。
インラインで翻訳
開発者モードのインライン翻訳ツールを使用して、インターフェイスのテキストにタッチして、音声とブランドを反映させることができます。 インライン翻訳モードをアクティブにすると、ページ上の編集可能なテキストがすべて赤で描画されます。 フィールドラベル、メッセージなど、ストアフロントおよび管理者全体に表示されるテキストを簡単に編集できます。 例えば、多くのテーマでは、顧客がスムーズに作業できるように、マイアカウント、マイウィッシュリスト、マイダッシュボード などの用語を使用しています。 ただし、単に Account、Wishlist、および Dashboard という単語を使用することをお勧めします。
Commerce開発者向けドキュメントの 翻訳の概要を参照してください。
ストアが複数の言語で使用できる場合は、ロケールの翻訳済みテキストを微調整できます。 サーバー上では、インターフェイステキストは、出力ブロックごとに個別の CSV ファイルに保持され、ロケール別に整理されます。 別の方法として、インライン翻訳 ツールを使用する代わりに、CSV ファイルをサーバー上で直接編集することもできます。 翻訳ファイルは app/code/Magento/<module_name>/i18n/<language_locale>.csv
に保存されます。
手順 1:出力キャッシュを無効にする
-
管理者 サイドバーで、System/Tools/Cache Management に移動します。
-
次のチェックボックスをオンにします。
Blocks HTML output
Page Cache
Translations
-
Actions コントロールを
Disable
に設定し、Submit をクリックします。
手順 2:インライン翻訳ツールを有効にする
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
特定のストア表示を操作するには、更新する Store View を設定します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
「 」を展開し、「Translate Inline」セクションを展開します。
必要に応じて「Use Website」チェックボックスをオフにして、これらの設定を変更します。
特定のストア表示を編集する場合、Enabled for Admin オプションは使用できません。
{width="600" modal="regular"}
-
Enabled for Storefront を
Yes
に設定します。 -
完了したら、「Save Config」をクリックします。
-
プロンプトが表示されたら、無効なキャッシュを更新しますが、無効なキャッシュは今のところそのままにしておきます。
手順 3:テキストを更新
-
ブラウザーでストアフロントを開き、編集するページに移動します。
必要に応じて、言語選択を使用してストア表示を変更します。 翻訳可能なテキストの各文字列は、赤で囲まれます。 任意のテキストボックスにポインタを合わせると、ブックアイコン( )が表示されます。
-
ブックアイコンをクリックして 翻訳 ウィンドウを開き、次の操作を行います。
-
特定のストア表示に対する変更の場合は、「Store View Specific」チェックボックスを選択します。
-
新しい Custom テキストを入力します。
-
-
完了したら、「Submit」をクリックします。
{width="700" modal="regular"}
-
ストアで変更を確認するには、ブラウザーを更新します。
-
ストア内の変更する要素すべてについて、この手順を繰り返します。
手順 4:元の設定を復元する
-
ストアの管理者に戻ります。
-
管理者 サイドバーで、Stores/Settings/Configuration に移動します。
-
編集した特定のビューに Store View を設定します。
-
左側のパネルで「Advanced」を展開し、「Developer」を選択します。
-
「 」を展開し、「Translate Inline」セクションを展開します。
-
Enabled for Frontend を
No
に設定します。 -
完了したら、「Save Config」をクリックします。
-
管理者 サイドバーで、System/Tools/Cache Management に移動します。
-
以前に無効にした次の出力キャッシュのチェックボックスを選択します。
Blocks HTML output
Page Cache
Translations
-
Actions コントロールを
Enable
に設定し、Submit をクリックします。 -
プロンプトが表示されたら、無効なキャッシュを更新します。
手順 5:ストアでの変更の検証
ストアフロントに移動し、更新された各ページを調べて、変更が正しいことを確認します。 この例では、Customer Login
が Customer Sign In
に変更されました。 特定のビューを変更した場合は、言語選択を使用して正しいビューに切り替えます。