Page Designer と PWA Kit の統合
Page Designer を使用すると、Progressive Web App (PWA) Kitサイト用に再利用可能なページタイプとコンポーネントタイプを作成できます。Business Manager のコード不要のビジュアルエディターを使用して、サイトの Page Designer ページをデザイン、スケジュール、公開します。PWA Kit サイトと統合すると、Page Designer は React コンポーネントを使用して動的でレスポンシブなページをレンダリングできます。
このガイドでは、サイトで Page Designer ページを表示できるように PWA Kit を構成する方法について説明します。
このチュートリアルのコマンドを実行する前に、プレースホルダーを実際の値に置き換えてください。プレースホルダーは $PLACEHOLDER
の形式になっています。
Page Designer を PWA Kit サイトと統合するには:
-
以下のいずれかの実装でサイトを構築します。
- Retail React アプリテンプレートを使用するサイト全体のコンポーザブルストアフロント (PWA Kit バージョン 2.7.0 以降)
- 段階的なヘッドレス ロールアウト ( Storefront Reference Architecture - SFRAおよび PWA Kit バージョン 2.7.0 以降、Retail React アプリ テンプレートを使用)
-
SLASパブリックまたはプライベートクライアントを作成または更新します。「SLAS クライアントの作成」の手順に従うか、registerClient API エンドポイントを使用します。
-
範囲フィールドに、範囲
sfcc.shopper-experience
を含めます。SLAS プライベート クライアントには、パブリック クライアントに比べていくつかの利点があります。SLAS プライベートクライアントの使用を参照してください。
-
-
Business Manager で Page Designer ページを作成します。Page Designer ビジュアルエディターを使用したページの作成
- PWA Kit は分離された Web アプリであるため、Page Designer Internet Store Markup Language (ISML) コンポーネントとそれに対応する PWA Kit React コンポーネントの両方を作成する必要があります。
- サイトで使用する ISML コンポーネントが Page Designer に存在しない場合は、Business Manager で作成します。「Page Designers コンポーネントの実装方法」を参照してください。
- PWA Kit React コンポーネントには、対応する ISML コンポーネントと一致するものがあります。React コンポーネントと ISML コンポーネントのマッチングを参照してください。一致する React コンポーネントがない場合は、ビルドできます。
- Business Manager のプレビュー機能では、Storefront Reference Architecture (SFRA) ISML コンポーネントが表示されます。そのため、Reactサイトの実際の外観はプレビューとは異なる場合があります。PWA Kit サイトのプレビューをより正確に取得するには、ストアフロントプレビューを使用します。
-
PWA Kit プロジェクトで、
app/pages/page-viewer/index.jsx
というファイルを作成し、次のコードを追加します。このファイルの目的は、コンポーネントを使用して Page Designer ページをレンダリングするようにページビューアを設定することです。このコードには、デモンストレーション用のサンプル コンポーネントが含まれています。コード内のコンポーネントを、サイトに適用するコンポーネントに置き換えます。このインテグレーションの例では、
@salesforce/commerce-sdk-react
を使用します。
-
PWA Kit プロジェクトで
app/routes.jsx
を開き、'' に移動するルートを追加します。 $PAGE_ID
は、Business Manager でPage Designerページに定義したページ ID に置き換えます。
-
Webサーバーをローカルで起動するには、次のコマンドを実行します。
npm start
-
React.js でレンダリングされたPage Designerページを確認するには、
`http:localhost:3000/page-viewer/$ PAGE_ID ' に移動し、手順 2 で特定したページ ID を使用します。
たとえば、ページ ID が 123 の場合は、
http://localhost:3000/page-viewer/123
に移動します。
これは、対応する ISML コンポーネントを持つ React コンポーネントのリストです。React コンポーネントは、PWA Kit の Page Designer GitHub リポジトリにあります。
React コンポーネント | ISML コンポーネント |
---|---|
カルーセル | commerce_layouts .carousel |
mobileGrid1r1c | commerce_layouts .mobileGrid1r1c |
mobileGrid2r1c | commerce_layouts .mobileGrid2r1c |
mobileGrid2r2c | commerce_layouts .mobileGrid2r2c |
mobileGrid2r3c | commerce_layouts .mobileGrid2r3c |
mobileGrid3r1c | commerce_layouts .mobileGrid3r1c |
mobileGrid3r2c | commerce_layouts .mobileGrid3r2c |
image-tile | commerce_assets .photoTile |
テキスト付き画像 | commerce_assets .imageAndText |
- GitHub:PWA Kit の Page Designer リポジトリ
- _ Salesforce ヘルプ:_ Page Designer ページ