Show Menu
トピック×

コンテンツフラグメントテンプレート

すべてのフラグメントを作成する場合 、コンテンツフラグメントモデルが推奨されるようになりました。
コンテンツフラグメントモデルは、We.Retail のすべてのサンプルでも使用されています。
コンテンツフラグメントの作成時に選択されるテンプレートです。このテンプレートは、新しいフラグメントに基本構造、要素、バリエーションを提供します。コンテンツフラグメントに使用されるテンプレートは、Granite 設定マネージャーに従います。
既製のテンプレートは次の場所に保持されます。
  • /libs/settings/dam/cfm/templates
次の場所に、サイト固有のコンテンツフラグメントテンプレートを作成できます。
  • /apps/settings/dam/cfm/templates 標準搭載のテンプレートをオーバーレイしたり、実行時に拡張/変更を行うことを意図していない、顧客固有のアプリケーション全体のテンプレートを提供したりする場所です。
  • /conf/global/settings/dam/cfm/templates 実行時に変更する必要がある、インスタンス全体の顧客固有のテンプレートの場所。
The order of precedence is (in descending order) /conf , /apps , /libs .
You must not change anything in the /libs path.
This is because the content of /libs is overwritten the next time you upgrade your instance (and may well be overwritten when you apply either a hotfix or feature pack).
設定およびその他の変更に推奨される方法は次のとおりです。
  1. Recreate the required item (i.e. as it exists in /libs ) under /apps
  2. Make any changes within /apps
テンプレートの基本構造は、次の場所に保持されます。
conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

具体的な構造は次のようになります。
+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

ノードとプロパティの詳細を以下に示します。
  • テンプレート
    名前 タイプ
    < template-name > nt:unstructured このノードは各テンプレートのルートです。このノードは必須で、一意の名前が必要です。
    jcr:title
    String
    必須
    テンプレートのタイトル( フラグメントを作成 ウィザードに表示されます)。
    jcr:description
    String
    オプション
    テンプレートの目的を説明するテキスト( フラグメントを作成 ウィザードに表示されます)。
    initialAssociatedContent
    String[]
    オプション
    新規作成されたコンテンツフラグメントにデフォルトで関連付ける必要があるコレクションへのパスが格納された配列です。
    precreateElements
    Boolean
    必須
    true コンテンツフラグメントの要素(マスター要素を除く)を表すサブアセットをコンテンツフラグメントの作成時に作成する必要がある場合は 、、そのつど作成する場合は false に設定します。
    注意 :現在、このパラメーターは true に設定する必要があります。
    version
    Long
    必須
    コンテンツ構造のバージョン。現在サポートされています。
    注意 :現在、このパラメーターはに設定する必要がありま 2 す。
  • 要素
    名前 タイプ
    elements
    nt:unstructured
    必須
    コンテンツフラグメントの要素の定義を格納するノードです。It is mandatory and needs to contain at least one child node for the Main element, but can contain [1..n] 個です。
    テンプレートを使用すると、要素のサブブランチがフラグメントのモデルのサブブランチにコピーされます。
    CRXDE Lite に表示される最初の要素は、自動的にメイン要素 と見なされます。ノード名に意味はなく、メインアセットによって表されるという点を除き、ノード自体に特別な重要性はありません。その他の要素はサブアセットとして扱われます。
  • エレメント名
    名前 タイプ
    < element-name > nt:unstructured このノードは要素を定義します。このノードは必須で、一意の名前が必要です。
    jcr:title
    String
    必須
    要素のタイトルです(フラグメントエディターの要素セレクターに表示されます)。
    defaultContent
    String
    オプション
    デフォルト:""
    Initial content of the element; only used if precreateElements = true
    initialContentType
    String
    オプション
    default: text/html
    Initial content type of the element; only used if precreateElements = true ; currently supported:
    • text/html
    • text/plain
    • text/x-markdown
    name
    String
    必須
    要素の初期名で、フラグメントタイプに対して一意である必要があります。
  • バリエーション
    名前 タイプ
    variations
    nt:unstructured
    オプション
    このオプションのノードには、コンテンツフラグメントの初期バリエーションの定義が格納されます。
  • バリエーション名
    名前 タイプ
    < variation-name >
    nt:unstructured
    バリエーションノードが存在する場合は必須
    初期バリエーションを定義します。 バリエーションは、デフォルトでコンテンツフラグメントのすべての要素に追加されます。
    バリエーションは、それぞれの要素と同じ初期コンテンツを持ちます( defaultContent/ initialContentType または を参照してください)。
    jcr:title
    String
    必須
    バリエーションのタイトルです(フラグメントエディターの「 バリエーション 」タブ(左レール)に表示されます)。
    jcr:desciption
    String
    オプション
    デフォルト:""
    バリエーションを説明するテキスト (フラグメントエディターの「 バリエーション 」タブ(左レール)に表示されます)。