컨텐츠 조각 템플릿 content-fragment-templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Developing

작성 대상:

Developer

CAUTION

AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

CAUTION

일부 컨텐츠 조각 기능을 사용하려면 AEM 6.4 서비스 팩 2(6.4.2.0).

CAUTION

컨텐츠 조각 모델 이제 모든 조각을 만드는 데 권장됩니다.

컨텐츠 조각 모델은 We.Retail의 모든 예에 사용됩니다.

템플릿은 컨텐츠 조각을 만들 때 선택합니다. 기본 구조, 요소 및 변형을 새 조각에 제공합니다. 컨텐츠 조각에 사용되는 템플릿은 Granite 구성 관리자를 따릅니다.

기본 템플릿은 다음과 같이 유지됩니다.

/libs/settings/dam/cfm/templates

다음 위치에서 컨텐츠 조각에 대한 사이트별 템플릿을 만들 수 있습니다.

/apps/settings/dam/cfm/templates

기본 제공 템플릿을 오버레이하거나 런타임 시 확장/변경되지 않도록 하기 위한 고객별 애플리케이션 전체 템플릿을 제공하는 위치입니다.
/conf/global/settings/dam/cfm/templates

런타임 시 변경해야 하는 인스턴스 전체 고객별 템플릿의 위치입니다.

우선 순위 순서는 (내림차순) /conf, /apps, /libs.

CAUTION

사용자 반드시 에서 아무것도 변경하지 않음 /libs 경로.

왜냐하면 /libs 는 다음에 인스턴스를 업그레이드할 때 덮어쓰여지며, 핫픽스 또는 기능 팩을 적용할 때 덮어쓸 수 있습니다.

구성 및 기타 변경에 대해 권장되는 방법은 다음과 같습니다.

필요한 항목(즉, 가 존재함에 따라)을 다시 만듭니다 /libs) 아래의 /apps
내에서 변경 /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

필수

컨텐츠 조각 요소의 정의를 포함하는 노드입니다. 필수 항목이며, 기본 요소를 포함하지만 [1..n] 하위 노드.

템플릿을 사용하면 요소 하위 분기가 조각의 모델 하위 분기에 복사됩니다.

첫 번째 요소(CRXDE Lite에서 표시됨)는 자동으로 main 요소; 노드 이름은 관련이 없으며 노드 자체가 주 자산으로 표시된다는 사실 이외에 특별한 의미를 갖지 않습니다. 다른 요소는 하위 자산으로 처리됩니다.

요소 이름

이름

유형

값

<element-name>

nt:unstructured

이 노드는 요소를 정의합니다. 필수 항목이며 고유한 이름을 사용해야 합니다.

jcr:title

String

필수

요소의 제목(조각 편집기의 요소 선택기에 표시됨)입니다.

defaultContent

String

옵션

기본값: ""

요소의 초기 컨텐츠; 다음 경우에만 사용됨 precreateElements = true

initialContentType

String

옵션

기본값: text/html

요소의 초기 컨텐츠 유형; 다음 경우에만 사용됨 precreateElements = true; 현재 지원됨:

text/html
text/plain
text/x-markdown

name

String

필수

요소의 내부 이름입니다. 조각 유형에 대해 고유해야 합니다.

변형

이름

유형

값

variations

nt:unstructured

옵션

이 선택적 노드에는 컨텐츠 조각의 초기 변형에 대한 정의가 포함되어 있습니다.

변형 이름

이름

유형

값

<variation-name>

nt:unstructured

변형 노드가 있으면 필요합니다.

초기 변형을 정의합니다.
변형은 기본적으로 컨텐츠 조각의 모든 요소에 추가됩니다.

변형은 각 요소와 동일한 초기 컨텐츠를 갖게 됩니다( 참조) defaultContent/ initialContentType)

jcr:title

String

필수

변형의 제목(조각 편집기의 변형 탭 (왼쪽 레일).

jcr:desciption

String

옵션

기본값: ""

변형에 대한 설명을 제공하는 텍스트입니다 (조각 편집기의 변형 탭 (왼쪽 레일).

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e