콘텐츠 조각 템플릿 :headding-anchor:content-fragment-templates

CAUTION
콘텐츠 조각 모델은(는) 모든 새 콘텐츠 조각을 만드는 데 권장됩니다.
컨텐츠 조각 모델은 WKND의 모든 예제에 사용됩니다.
NOTE
AEM 6.3 이전에는 콘텐츠 조각이 모델이 아닌 템플릿을 기반으로 생성되었습니다.
콘텐츠 조각 템플릿은 이제 더 이상 사용되지 않습니다. 조각을 만드는 데 계속 사용할 수 있지만 대신 콘텐츠 조각 모델 을 사용하는 것이 좋습니다. 조각 템플릿에 새로운 기능이 추가되지 않으며 이후 버전에서 제거됩니다.

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

기본 템플릿은 아래에 보관됩니다.

  • /libs/settings/dam/cfm/templates

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

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

  • /conf/global/settings/dam/cfm/templates
    런타임 시 변경해야 하는 인스턴스 전체 고객별 템플릿의 위치입니다.

우선 순위 순서는 /conf, /apps, /libs입니다.

CAUTION
은(는) /libs 경로에서 아무 것도 변경하지 말아야 ​합니다.
이는 다음에 인스턴스를 업그레이드할 때 /libs의 콘텐츠가 덮어쓰기되기 때문입니다(핫픽스 또는 기능 팩을 적용할 때 덮어쓸 수도 있음).
구성 및 기타 변경에 권장되는 방법은 다음과 같습니다.
  1. /apps 아래에 필요한 항목(즉, /libs에 존재하는 항목)을 다시 만듭니다.

  2. /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

노드 및 해당 속성에 대한 자세한 내용은 다음과 같습니다.

  • 템플릿

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
    이름 유형
    <template-name> nt:unstructured 이 노드는 각 템플릿의 루트입니다. 필수 항목이며 고유한 이름이 있어야 합니다.
    jcr:title

    String

    필수

    템플릿의 제목(조각 만들기 마법사에 표시됨)입니다.
    jcr:description

    String

    선택 사항

    템플릿의 목적을 설명하는 텍스트입니다(조각 만들기 마법사에 표시됨).
    initialAssociatedContent

    String[]

    선택 사항

    기본적으로 새로 생성된 콘텐츠 조각에 연결해야 하는 컬렉션 경로가 있는 배열입니다.
    precreateElements

    Boolean

    required

    true, 콘텐츠 조각을 만들 때 콘텐츠 조각의 요소(마스터 요소 제외)를 나타내는 하위 자산을 만들어야 하는 경우, false "즉시" 만들어야 하는 경우.

    참고: 현재 이 매개 변수는 true(으)로 설정해야 합니다.

    version

    Long

    required

    콘텐츠 구조의 버전. 현재 지원됨:

    참고: 현재 이 매개 변수는 2.
    (으)로 설정해야 합니다.

  • 요소

    table 0-row-3 1-row-3 html-authored
    이름 유형
    elements

    nt:unstructured

    required

    콘텐츠 조각 요소의 정의가 포함된 노드입니다. 필수 항목이며 Main 요소에 대해 자식 노드를 하나 이상 포함해야 하지만 [1...n] 하위 노드.

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

    첫 번째 요소(CRXDE Lite에서 볼 때)는 자동으로 main 요소로 간주됩니다. 노드 이름은 관련이 없으며 노드 자체에는 특별한 의미가 없습니다. 주 자산으로 표시되지만 다른 요소는 하위 자산으로 처리됩니다.

  • 요소 이름

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
    이름 유형
    <element-name> nt:unstructured 이 노드는 요소를 정의합니다. 필수 항목이며 고유한 이름이 있어야 합니다.
    jcr:title

    String

    required

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

    String

    선택 사항

    기본값: ""

    요소의 초기 콘텐츠. precreateElements = true인 경우에만 사용됨
    initialContentType

    String

    선택 사항

    기본값: text/html

    요소의 초기 콘텐츠 형식. precreateElements = true인 경우에만 사용됨; 현재 지원됨:

    • text/html
    • text/plain
    • text/x-markdown
    name

    String

    required

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

    table 0-row-3 1-row-3 html-authored
    이름 유형
    variations

    nt:unstructured

    선택 사항

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

    table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
    이름 유형
    <variation-name>

    nt:unstructured

    변형 노드가 있는 경우 필요합니다.

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

    변형은 각 요소와 동일한 초기 콘텐츠를 갖습니다(

    defaultContent/ initialContentType

    참조).

    jcr:title

    String

    required

    변형의 제목(조각 편집기의 변형 탭(왼쪽 레일)에 표시됨)입니다.
    jcr:desciption

    String

    선택 사항

    기본값: ""

    변형 에 대한 설명을 제공하는 텍스트입니다(조각 편집기의 변형 탭(왼쪽 레일)에 표시됨).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2