ショッピングカートラインレンダリングのカスタマイズ

ショッピングカートラインレンダリングには、Scribanテンプレートというレンダリングバリアントが含まれています。ショッピングカートラインレンダリングには独自のデフォルトレンダリングバリアントrootとデフォルトレンダリングバリアント(/sitecore/Content///Presentation/Rendering Variants/Shopping Cart Lines)があり、マークアップを生成するためにScribanテンプレートを使用します。Scribanテンプレートを変更することは可能ですが、ソフトウェアアップグレード時にカスタマイズが上書きされないように、新しいカスタムレンダリングバリアントを作成するのが最善です。また、関連するデータソース項目のレンダリングラベルを変更することも可能です。

!注ショッピングカートライン - 廃止されたレンダリングは既存サイトのみで利用可能で、Scribanテンプレートの代わりに標準ビューとコードバインドを使用しています。

以下のコードは、デフォルトのレンダリングバリアント内で定義されたショッピングカートラインレンダリング用のScribanテンプレートを示しています。ビューコンテンツ(ラベルテキストなど)はMVCモデルに渡され、Scribanコンテキスト内の埋め込みオブジェクトo_model(/xp/en/developers/sxa/100/sitecore-experience-accelerator/en/the-embedded-items-and-objects-in-the-scriban-context.html) として利用可能です。一方、製品情報(製品詳細、単価、在庫など)はフロントエンドのKnockoutバインディングとAJAX呼び出しを使って入力されます。

{{ # Error message area }} {{if o_model.error_message}}

{{ # Cart lines header, contains the columns titles }} {{ if o\_model.display\_table\_header }}

{{ sc\_field i\_datasource 'Product Details Label' }}

{{ if o\_model.display\_unit\_price\_column }}

{{ sc\_field i\_datasource 'Unit Price Label' }}

{{ end }} {{ if o\_model.display\_quantity\_column }}

{{ sc\_field i\_datasource 'Quantity Label' }}

{{ end }}

{{ sc\_field i\_datasource 'Total Label' }}

{{ if o\_model.display\_delete\_button\_column }}

 

{{ end }}

{{ end }} {{ # Cart lines body, the following

will render all the cart lines with respect to the configurations on the component properties }}

{{ sc\_raw i\_datasource 'Free Gift Label' }}

{{ # If the Display Shipping Information configuration on the component properties is enabled, the following section renders the cart line shipping information }} {{ if o\_model.display\_shipping\_information }}

{{ sc\_raw i\_datasource 'Delivery Label' }}

{{ sc\_raw i\_datasource 'Address Label' }}

{{ end }}

{{ # If the Display Unit Price configuration on the component properties is enabled, the following section renders the cart line unit price information }} {{ if o_model.display_unit_price_column }}

{{ sc\_raw i\_datasource 'Discount Label' }}

{{ end }}

{{ # If the Display Quantity configuration on the component properties is enabled, the following section renders the cart line quantity information }} {{ if o_model.display_quantity_column }}

{{ sc\_raw i\_datasource 'Quantity Label' }}:

{{ end }} {{ # The following section renders the line total }}

{{ sc\_raw i\_datasource 'Savings Label' }}

{{ # If the Display Delete Button configuration on the component properties is enabled, the following section renders the cart line delete button information }} {{ if o\_model.display\_delete\_button\_column }}

{{ end }}

{{ # If the Display Sublines configuration on the component properties is enabled, the following section renders the cart line sublines information }} {{ if o\_model.display\_sub\_lines }}

{{ if o\_model.display\_quantity\_column }}

{{ sc\_raw i\_datasource 'Quantity Label' }}:

{{ end }}

{{ if o\_model.display\_delete\_button\_column }}

{{ end }}

{{ end }}

{{ end }}

ショッピングカートラインレンダリングモデル

ショッピングカートラインのスクリバンテンプレートでは、埋め込まれたアイテムo_modelを通じてShoppingCartLinesRenderingModelモデルに含まれるプロパティやオブジェクトにアクセスできます。ショッピングカートラインレンダリングモデルのクラス図は以下の図に示されています。

ショッピングカートラインのコールシーケンス

以下のシーケンス図は、買い物客がショッピングカートラインと交換した際の通話の大まかなビューを示しています。

!注このシーケンス図は手動の無料ギフト選択に適用されており、無料ギフトがカートに追加された際の処理は反映していません。