ドキュメントCommerce管理システムガイド

PaaS のみ

デベロッパーツール

Last update: Thu May 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 初心者
  • 中級
  • 管理者
  • 開発者

高度な開発者ツールを使用して、フロントエンド開発時のコンパイルモードの決定、IP アドレスの許可リストの作成、テンプレートパスヒントの表示を行います。 また、ストアフロントと管理者のインターフェイスで、テキストを簡単にスポット変更するためのツールもあります。

  • アクションログ Adobe Commerce （Adobe Commerceのみ）
  • フロントエンド開発ワークフロー
  • 静的ファイル署名の使用
  • リソースファイルの最適化
  • 開発者クライアントの制限
  • テンプレートパスのヒント
  • インライン翻訳

操作モード

Adobe CommerceまたはMagento Open Source インスタンスは、実稼働モード または 開発者モード のいずれかで実行するようにデプロイできます。 開発者向けに特別に設計されたツールと設定は、ストアが 開発者モード で動作している場合にのみアクセスできます。

操作モードは、適切な権限を持つユーザーがサーバーのコマンドラインからのみ変更できます。 詳しくは、『 設定ガイド の 操作モードの設定を参照してください。

マーチャントドキュメントのほとんどのトピックは、実稼動モードで実行されているCommerce インスタンスに適用されます。 ただし、次の設定とツールは、インストールが開発者モードで実行されている場合にのみ使用できます。

フロントエンド開発ワークフロー

フロントエンド開発ワークフローのタイプは、開発中にクライアントサイドまたはサーバーサイドで少ないコンパイルが行われるかどうかを決定します。 Less は、追加の機能と規則を持ち、合理化されたコードを生成する CSS の拡張機能です。 テーマの開発には、クライアントサイドの LESS コンパイルをお勧めします。 サーバーサイドのコンパイルはデフォルトのモードです。 開発ワークフローオプションは、実稼動モードのストアでは使用できません。
Commerce開発者向けドキュメントの クライアントサイド LESS コンパイルとサーバーサイドの比較を参照してください。

NOTE
フロントエンド開発ワークフローの設定は、 開発者モードでのみ使用できます。

詳細設定 – フロントエンド開発ワークフロー

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  3. 「 展開セレクター 」を展開し、「Front-end Development Workflow」セクションを展開します。

  4. Workflow Type を次のいずれかに設定します。

    • Client side less compilation - コンパイルは、ネイティブ less.js ライブラリを使用したブラウザーで行われます。
    • Server side less compilation - Less PHP ライブラリを使用して、サーバー上でコンパイルが行われます。 これは、実稼動用のデフォルトのモードです。

  5. 完了したら、「Save Config」をクリックします。

静的ファイル署名

静的ファイルの URL にデジタル署名を追加すると、ブラウザーはファイルの新しいバージョンが使用可能かどうかを検出できます。 デジタル署名で追跡できる静的ファイルには、JavaScript、CSS、画像、フォントなどがあります。 署名は、ベース URL の直後のパスに追加されます。 ファイルの署名がブラウザーのキャッシュに格納されている署名と異なる場合は、ファイルの新しいバージョンが使用されます。

Commerce開発者向けドキュメントの 静的コンテンツ署名を参照してください。

NOTE
静的ファイル設定の設定は、 開発者モードで作業している場合にのみ使用できます。

詳細設定 – 静的ファイルの設定

構成設定の詳細なリストについては、『構成リファレンス の_ 静的ファイル設定 _を参照してください。

署名済み静的ファイルを有効にするには：

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  3. 「 展開セレクター 」を展開し、「Static Files Settings」セクションを展開します。

  4. Sign Static Files を Yes に設定します。

  5. 完了したら、「Save Config」をクリックします。

リソースファイルの最適化

リソースファイルの読み込みに要する時間は、ファイルを結合およびバンドルし、コードを最小限に抑えることで短縮できます。

  • 結合すると、同じ種類の別々のファイルが 1 つのファイルに結合されます。
  • バンドルは、ページの読み込みに必要な HTTP リクエスト数を減らすために、別々のファイルをグループ化する技術です。
  • 縮小によってスペース、改行、コメントは削除されますが、コードの機能には影響しません。 最小化されたファイルは編集できないので、プロセスは、実稼動に移行する準備が整った場合にのみ適用してください。

デフォルトでは、Adobe CommerceとMagento Open Sourceはファイルの結合、バンドル、最小化を行わないので、プロジェクト開発者はどのファイル最適化方法を使用するかを決定する必要があります。

詳しくは、 パフォーマンスのベストプラクティスを参照してください。

NOTE
CSS ファイルとJavaScript ファイルは、 開発者モードでのみ最適化できます。
ファイルタイプ
サポートされる操作
CSS ファイル
MergeMinify
JavaScript ファイル
MergeBundleMinify
テンプレートファイル
Minify

リソースファイルを最適化するには：

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  3. CSS ファイルを最適化するには、「CSS Settings」セクションの 拡張セレクター を展開し、次の手順を実行します。

    • Merge CSS Files を Yes に設定します。
    • Minify CSS Files を Yes に設定します。

    詳細設定 – CSS 設定

CSS 設定

  1. JavaScript ファイルを最適化するには、「JavaScript Settings」セクションの 拡張セレクター を展開し、次の手順を実行します。

    • Merge JavaScript Files を Yes に設定します。
    • Minify JavaScript Files を Yes に設定します。

    詳細設定 – JavaScriptの設定

  2. PHTML テンプレートファイルを縮小するには、 拡張セレクター 「Template Settings」セクションを展開し、Minify Html を Yes に設定します。

    詳細設定 – テンプレート設定

  3. 完了したら、「Save Config」をクリックします。

クライアントの制限

許可リストに加える template path hints などのツールを使用する前に、IP アドレスを Developer Client Restrictions に追加して、ストア内のお客様のショッピングエクスペリエンスが中断されないようにします。 IP アドレスがわからない場合は、オンラインで検索できます。

NOTE
開発者クライアント制限は、 開発者モードでのみ設定できます。

Commerce技術情報については、Cloud Infrastructure ガイドの リクエストを許可するためのカスタム VCL を参照してください。

IP アドレスを許可リストに追加するには

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  3. 「 展開セレクター 」を展開し、「Developer Client Restrictions」セクションを展開します。

    詳細設定 – デベロッパークライアントの制限

  4. Allow IPs:IP アドレスを入力します。

    複数の IP アドレスからアクセスする必要がある場合は、各アドレスをコンマで区切ります。

  5. 完了したら、「Save Config」をクリックします。

  6. プロンプトが表示されたら、無効なキャッシュを更新します。

テンプレートパスのヒント

テンプレートパスヒントは、ページで使用される各テンプレートへのパスを含む表記を追加する診断ツールです。 テンプレートパスのヒントは、ストアフロントまたは管理者に対して有効にできます。

NOTE
テンプレートパスヒントは、 開発者モードでのみ編集できます。

Commerce開発者向けドキュメントの テンプレート、レイアウト、スタイルの検索を参照してください。

storefront の例 – テンプレートパスのヒント

許可リストに加える手順 1：に IP アドレスを追加する

許可リストに加える テンプレートパスヒントを使用する前に、IP アドレスを 🔗 に追加して、ストアで買い物をしている顧客への干渉を避けます。 完了したら、必ずCommerceのキャッシュをクリアして、ストアからすべてのヒントを削除します。

詳細設定 – デベロッパークライアントの制限

手順 2：テンプレートパスヒントを有効にする

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  3. Debug のセクションの 展開セレクター を展開し、以下を実行します。

    詳細設定 – デバッグ

    • ストアに対してテンプレートパスヒントをアクティブにするには、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 に設定します。

  4. 完了したら、「Save Config」をクリックします。

手順 3：キャッシュのクリア

  1. 管理者 サイドバーで、System/Tools/Cache Management ​に移動します。

  2. 右上隅の「Flush Magento Cache」をクリックします。

インラインで翻訳

開発者モードのインライン翻訳ツールを使用して、インターフェイスのテキストにタッチして、音声とブランドを反映させることができます。 インライン翻訳モードをアクティブにすると、ページ上の編集可能なテキストがすべて赤で描画されます。 フィールドラベル、メッセージなど、ストアフロントおよび管理者全体に表示されるテキストを簡単に編集できます。 例えば、多くのテーマでは、顧客がスムーズに作業できるように、マイアカウント、マイウィッシュリスト、マイダッシュボード などの用語を使用しています。 ただし、単に Account、Wishlist、および Dashboard という単語を使用することをお勧めします。

NOTE
インライン翻訳ツールは、 開発者モードで作業している場合にのみ使用できます。

Commerce開発者向けドキュメントの 翻訳の概要を参照してください。

ストアフロントの例 – 翻訳可能なテキスト

ストアが複数の言語で使用できる場合は、ロケールの翻訳済みテキストを微調整できます。 サーバー上では、インターフェイステキストは、出力ブロックごとに個別の CSV ファイルに保持され、ロケール別に整理されます。 別の方法として、インライン翻訳 ツールを使用する代わりに、CSV ファイルをサーバー上で直接編集することもできます。 翻訳ファイルは app/code/Magento/<module_name>/i18n/<language_locale>.csv に保存されます。

NOTE
インライン翻訳ツールを使用するには、ブラウザーでポップアップを許可する必要があります。

手順 1：出力キャッシュを無効にする

  1. 管理者 サイドバーで、System/Tools/Cache Management ​に移動します。

  2. 次のチェックボックスをオンにします。

    • Blocks HTML output
    • Page Cache
    • Translations

  3. Actions コントロールを Disable に設定し、Submit をクリックします。

手順 2：インライン翻訳ツールを有効にする

  1. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  2. 特定のストア表示を操作するには、更新する Store View を設定します。

  3. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  4. 「 展開セレクター 」を展開し、「Translate Inline」セクションを展開します。

    必要に応じて「Use Website」チェックボックスをオフにして、これらの設定を変更します。

    特定のストア表示を編集する場合、Enabled for Admin ​オプションは使用できません。

    詳細設定 – インライン翻訳

  5. Enabled for Storefront を Yes に設定します。

  6. 完了したら、「Save Config」をクリックします。

  7. プロンプトが表示されたら、無効なキャッシュを更新しますが、無効なキャッシュは今のところそのままにしておきます。

手順 3：テキストを更新

  1. ブラウザーでストアフロントを開き、編集するページに移動します。

    必要に応じて、言語選択を使用してストア表示を変更します。 翻訳可能なテキストの各文字列は、赤で囲まれます。 任意のテキストボックスにポインタを合わせると、ブックアイコン（ ブックアイコン ）が表示されます。

  2. ブックアイコンをクリックして 翻訳 ウィンドウを開き、次の操作を行います。

    • 特定のストア表示に対する変更の場合は、「Store View Specific」チェックボックスを選択します。

    • 新しい Custom テキストを入力します。

  3. 完了したら、「Submit」をクリックします。

    カスタムテキストを入力

  4. ストアで変更を確認するには、ブラウザーを更新します。

  5. ストア内の変更する要素すべてについて、この手順を繰り返します。

手順 4：元の設定を復元する

  1. ストアの管理者に戻ります。

  2. 管理者 サイドバーで、Stores/Settings/Configuration ​に移動します。

  3. 編集した特定のビューに Store View を設定します。

  4. 左側のパネルで「Advanced」を展開し、「Developer」を選択します。

  5. 「 展開セレクター 」を展開し、「Translate Inline」セクションを展開します。

  6. Enabled for Frontend を No に設定します。

  7. 完了したら、「Save Config」をクリックします。

  8. 管理者 サイドバーで、System/Tools/Cache Management ​に移動します。

  9. 以前に無効にした次の出力キャッシュのチェックボックスを選択します。

    • Blocks HTML output
    • Page Cache
    • Translations

  10. Actions コントロールを Enable に設定し、Submit をクリックします。

  11. プロンプトが表示されたら、無効なキャッシュを更新します。

手順 5：ストアでの変更の検証

ストアフロントに移動し、更新された各ページを調べて、変更が正しいことを確認します。 この例では、Customer Login が Customer Sign In に変更されました。 特定のビューを変更した場合は、言語選択を使用して正しいビューに切り替えます。

ストアフロントの例 – 翻訳済み顧客のログイン

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1