Scribanテンプレート用の組み込みCommerce関数
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
組み込み関数や埋め込みオブジェクト・アイテムを使ってSXA Storefront Scribanテンプレートをカスタマイズできます。
sc_imagelink
CatalogProductImageオブジェクトから画像URLを取得し、実際の画像への参照を含むパラメータとして取得します。画像自体はメディアライブラリまたはデジタル資産管理システムに保存されます。sc_imagelink関数は、Commerce Search Resultsレンダリング用のScribanテンプレートや、以下のScribanコードで示されているように、MVCCatalogProductImageオブジェクトを返すプロパティを公開するOrder LinesのScribanテンプレートで使用されます。
<img src="{{ o_model.master_product_image | sc_imagelink 220 220 }}/>
パラメータ
パラメータ
種類
オプション
例
目的
productImage
CatalogProductImage
いいえ
カタログ製品画像
実際の画像項目への参照を含みます。これはメディアライブラリ内の画像またはデジタル資産管理システム内の画像です。
width
Int
はい
700
画像のサイズ変更に使いました。
height
Int
はい
700
画像のサイズ変更に使いました。
!注画像を取得Sitecore DAM時、幅と高さの値は使用されず、将来の使用のために予約されます。
sc_xc_serialize
バックエンドのデータオブジェクトをJSONにシリアライズし、フロントエンドJavaScriptコンポーネントが簡単にデータを消費できるようにします。sc_xc_serialize関数は、以下のコードに示されているように、ScribanテンプレートのFree Gift Selectレンダリングで使用されます。
{{ # The hidden
無料ギフトオプションに関するデータは、初期のサーバーサイドレンダリングの一部としてHTMLマークアップにシリアライズされます。これはレンダリングに付属するフロントエンドのJavaScriptで利用できるようにするためで、バックエンドへの呼び出しを省き、パフォーマンスを向上させます。
sc_xc_translate
キーパラメータで指定された入力文字列に従い、コンテンツアイテムのValueフィールドに格納されたテキストを、現在の言語で表示します。各キーの翻訳は 、/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Termsにある検索テーブルに保存されます。
sc_xc_translate関数の必要な形式は以下の通りです:
sc_xc_translate ‘key’ ‘folder’
パラメータ
パラメータ
種類
オプション
例
目的
key
string
いいえ
Scriban Title
現在の言語に基づいて店舗のCommerce Termsから翻訳を取得するために使われました。
folder
string
はい
Storefront Dictionary Terms
翻訳をサブフォルダに分類し、メンテナンスや検索を容易にするために使用されます。フォルダが指定されていない場合、機能はデフォルトのフォルダ「Storefront Dictionary Terms」(/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Terms/Storefront Dictionary Terms)を参照します。
例
以下の例では、関数がCommerce Termsの中から「Storefront Dictionary Terms」というフォルダを探し、Scribanタイトルの値を抽出します。
この例では、スクリバンタイトルはEN Titleです。
ライブストアフロントでは、Scribanタイトルの価値は次のように表示されます:
以下の例では、関数はScribanタイトルのCommerce Termsを参照します。
<a class="product-link" title="{{displayName}}"href="{{i_term.url}}"> {{sc_xc_translate 'Scriban Title'}}