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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자

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의 콘텐츠가 덮어쓰기되기 때문입니다(핫픽스 또는 기능 팩을 적용할 때 덮어쓸 수도 있음).

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

/apps 아래에 필요한 항목(즉, /libs에 존재하는 항목)을 다시 만듭니다.
/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