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

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Developing,Content Fragments

작성 대상:

Developer

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 는 다음에 인스턴스를 업그레이드할 때 덮어쓰기됩니다(또한 핫픽스 또는 기능 팩을 적용할 때 덮어쓰기될 수도 있음).

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

필요한 항목 다시 만들기(존재하는 그대로) /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

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

템플릿

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

콘텐츠 조각 요소의 정의가 포함된 노드입니다. 필수 항목이며,에 대해 하나 이상의 하위 노드를 포함해야 합니다. 기본 요소를 포함하지만 [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