편집 가능한 템플릿은 다음과 같이 도입되었습니다.
전문 작성자가 템플릿을 만들고 편집할 수 있도록 허용.
template-authors
그룹의 구성원이어야 합니다.템플릿에서 만든 모든 페이지에 대한 동적 연결을 유지할 수 있는 템플릿을 제공합니다. 이렇게 하면 템플릿 변경 사항이 페이지 자체에 반영됩니다.
핵심 페이지 구성 요소를 사용자 지정 없이 사용할 수 있도록 페이지 구성 요소를 보다 일반적으로 만듭니다.
편집 가능한 템플릿을 사용하면 페이지를 만드는 부분은 구성 요소 내에서 분리됩니다. UI에 필요한 구성 요소 조합을 구성하여 각 페이지 변형에 대해 새 페이지 구성 요소를 개발할 필요가 없습니다.
정적 템플릿도 사용할 수 있습니다.
이 문서는
편집 가능한 템플릿 만들기에 대한 개요를 제공합니다.
편집 가능한 템플릿을 만드는 데 필요한 관리/개발자 작업에 대해 설명합니다.
편집 가능한 템플릿의 기술적 기본 사항을 설명합니다.
이 문서에서는 템플릿 만들기 및 편집에 이미 익숙하다고 가정합니다. 템플릿 작성자에게 노출되어 있는 편집 가능 템플릿의 기능에 대한 자세한 내용은 작성 문서 페이지 템플릿 만들기를 참조하십시오.
다음 자습서는 새 프로젝트에서 편집 가능한 페이지 템플릿을 설정하는 데에도 유용합니다.
AEM Sites 파트 2 시작하기 - 기본 페이지 및 템플릿 만들기
편집 가능한 템플릿 만들기는 템플릿 작성자가 템플릿 콘솔 및 템플릿 편집기를 사용하여 주로 수행됩니다. 이 섹션에서는 이 프로세스에 대한 개요를 제공하며 기술 수준에서 발생하는 사항에 대한 설명이 나와 있습니다.
AEM 프로젝트에서 편집 가능한 템플릿을 사용하는 방법에 대한 자세한 내용은 Lazybones를 사용하여 AEM 프로젝트 만들기를 참조하십시오.
편집 가능 템플릿을 새로 만들 때 다음을 수행합니다.
템플릿](#template-folders)에 대한 [폴더를 만듭니다. 이것은 필수는 아니지만 우수 사례가 권장됩니다.
템플릿 유형을 선택합니다. 이 항목이 복사되어 템플릿 정의를 만듭니다.
템플릿 유형을 선택할 수 있습니다. 필요한 경우 자체 사이트 특정 템플릿 유형을 만들 수도 있습니다.
새 템플릿의 구조, 컨텐츠 정책, 초기 컨텐츠 및 레이아웃을 구성합니다.
구조
구조를 사용하면 템플릿에 대한 구성 요소와 컨텐츠를 정의할 수 있습니다.
템플릿 구조에 정의된 구성 요소는 결과 페이지 안에서 이동하거나 결과 페이지에서 삭제할 수 없습니다.
페이지 작성자가 구성 요소를 추가 및 제거할 수 있도록 하려면 템플릿에 단락 시스템을 추가하십시오.
초기 컨텐츠를 정의할 수 있도록 하려면 구성 요소 잠금을 해제했다가 다시 잠글 수 있습니다.
템플릿 작성자가 구조를 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기를 참조하십시오.
구조에 대한 기술 세부 정보는 이 문서의 구조를 참조하십시오.
정책
컨텐츠 정책은 구성 요소의 디자인 속성을 정의합니다.
이러한 속성은 템플릿(및 템플릿으로 만든 페이지)에 적용될 수 있습니다.
템플릿 작성자가 정책을 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기를 참조하십시오.
정책 기술 세부 정보는 이 문서의 콘텐츠 정책을 참조하십시오.
초기 컨텐츠
템플릿 작성자가 구조를 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기를 참조하십시오.
초기 컨텐츠에 대한 기술 세부 사항은 이 문서의 초기 컨텐츠를 참조하십시오.
레이아웃
템플릿 작성자가 템플릿 레이아웃을 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기를 참조하십시오.
템플릿 레이아웃에 대한 자세한 내용은 이 문서의 레이아웃을 참조하십시오.
템플릿을 활성화한 다음 특정 컨텐츠 트리에 대해 허용합니다.
템플릿 작성자가 템플릿을 활성화하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기를 참조하십시오.
템플릿 활성화에 대한 기술적인 설명은 이 문서의 Adobee용 템플릿 활성화 및 허용을 참조하십시오.
컨텐츠 페이지를 만드는 데 사용합니다.
페이지 작성자가 템플릿을 사용하여 페이지를 만드는 방법에 대한 자세한 내용은 페이지 만들기 및 구성을 참조하십시오.
편집 가능한 템플릿으로 페이지를 만드는 방법에 대한 자세한 내용은 이 문서의 결과 컨텐트 페이지를 참조하십시오.
국제화해야 하는 정보는 템플릿에 입력하지 마십시오. 내부화를 위해 핵심 구성 요소](/docs/experience-manager-core-components/using/get-started/localization.html?lang=ko)의 [현지화 기능이 권장됩니다.
템플릿은 페이지 작성 워크플로우를 간소화하기 위한 강력한 도구입니다. 그러나 너무 많은 템플릿이 작성자를 압도하고 페이지 생성을 혼동시킬 수 있습니다. 템플릿의 수를 100개 미만으로 유지하는 것이 효과적인 경험입니다.
잠재적인 성능 영향 때문에 Adobe에서는 1,000개 이상의 템플릿을 사용하는 것이 권장되지 않습니다.
편집기 클라이언트 라이브러리는 컨텐츠 페이지에 cq.shared
네임스페이스가 있다고 가정하고, 없는 경우 JavaScript 오류 Uncaught TypeError: Cannot read property 'shared' of undefined
이(가) 발생합니다.
모든 샘플 컨텐츠 페이지에는 cq.shared
이(가) 포함되어 있으므로 이를 기반으로 하는 모든 컨텐츠에 자동으로 cq.shared
이(가) 포함됩니다. 그러나 샘플 콘텐트를 기준으로 하지 않고 직접 컨텐트 페이지를 처음부터 만드는 경우에는 cq.shared
네임스페이스를 반드시 포함해야 합니다.
자세한 내용은 클라이언트측 라이브러리 사용을 참조하십시오.
템플릿을 구성하려면 다음 폴더를 사용할 수 있습니다.
폴더를 중첩할 수는 있지만 사용자가 템플릿 콘솔에서 폴더를 보면 플랫 구조로 표시됩니다.
표준 AEM 인스턴스에서는 전역 폴더가 템플릿 콘솔에 이미 있습니다. 이 폴더는 기본 템플릿을 보유하며, 현재 폴더에 정책 및/또는 템플릿 유형을 찾을 수 없는 경우 폴백으로 작동합니다. 이 폴더에 기본 템플릿을 추가하거나 새 폴더를 만들 수 있습니다(권장).
글로벌 폴더를 사용하지 않고 사용자 지정된 템플릿을 보관하는 새 폴더를 만드는 것이 좋습니다.
폴더는 admin
권한이 있는 사용자가 만들어야 합니다.
템플릿 유형과 정책은 다음 우선 순위에 따라 모든 폴더에서 상속됩니다.
/conf/global
/apps
/libs
허용되는 모든 항목 목록이 만들어집니다. 구성이 겹치는 경우( path
/ label
) 현재 폴더에 가장 가까운 인스턴스만 사용자에게 표시됩니다.
새 폴더를 만들려면 다음 중 하나를 수행합니다.
인스턴스에 대해 프로그래밍 방식으로 또는 CRXDE Lite을 사용하여 새 폴더(/conf%20%EC%95%84%EB%9E%98?lang=ko)를 만들 수 있습니다.
다음 구조를 사용해야 합니다.
/conf
<your-folder-name> [sling:Folder]
settings [sling:Folder]
wcm [cq:Page]
templates [cq:Page]
policies [cq:Page]
그런 다음 폴더 루트 노드에서 다음 속성을 정의할 수 있습니다.
<your-folder-name> [sling:Folder]
이름: jcr:title
유형: String
값:템플릿 콘솔에 표시할 제목(폴더에 대해).
표준 작성 권한 및 권한(예:content-authors
) 이제 그룹을 할당하고 작성자가 새 폴더에 템플릿을 만들 수 있도록 필요한 액세스 권한(ACL)을 정의해야 합니다.**
template-authors
그룹은 할당해야 하는 기본 그룹입니다. 자세한 내용은 다음 섹션 ACL 및 그룹을 참조하십시오.
액세스 권한 관리 및 지정에 대한 자세한 내용은 액세스 권한 관리를 참조하십시오.
전역 탐색 -> 도구 > 구성 브라우저로 이동합니다.
기존 폴더는 global 폴더를 포함하여 왼쪽에 나열됩니다.
만들기를 클릭합니다.
구성 만들기 대화 상자에서 다음 필드를 구성해야 합니다.
만들기를 클릭합니다
이 폴더 내에 템플릿을 만들려면 구성 브라우저에서 전체 폴더를 편집하고 편집 가능한 템플릿 옵션을 활성화할 수 있지만 이 방법은 권장되지 않습니다.
자세한 내용은 구성 브라우저 설명서를 참조하십시오.
템플릿 폴더가 생성되면(CRXDE를 통해 또는 구성 브라우저를 통해) 템플릿 폴더의 적절한 그룹에 대해 ACL을 정의해야 적절한 보안을 보장합니다.
We.Retail 참조 구현에 대한 템플릿 폴더를 예로 사용할 수 있습니다.
template-authors
그룹은 템플릿에 대한 액세스를 관리하는 데 사용되는 그룹이며 AEM에서 표준으로 제공되지만 비어 있습니다. 프로젝트/사이트의 그룹에 사용자를 추가해야 합니다.
template-authors
그룹은 새 템플릿을 만들 수 있어야 하는 사용자의 경우 만입니다.
템플릿 편집은 매우 강력하며 제대로 수행하지 않으면 기존 템플릿을 중단할 수 있습니다. 따라서 이 역할은 초점이 맞춰져야 하며 자격이 있는 사용자만 포함해야 합니다.
다음 표에서는 템플릿 편집에 필요한 권한에 대해 자세히 설명합니다.
경로 | 역할/그룹 | 권한 |
설명 |
---|---|---|---|
/conf/<your-folder>/settings/wcm/templates |
템플릿 작성자 |
읽기, 쓰기, 복제 | 사이트별 /conf 공간에서 템플릿을 생성, 읽기, 업데이트, 삭제 및 복제하는 템플릿 작성자 |
익명의 웹 사용자 | read | 익명 웹 사용자는 페이지를 렌더링하는 동안 템플릿을 읽어야 합니다. | |
컨텐츠 작성자 | 복제 | 복제컨텐츠 작성자는 페이지를 활성화할 때 페이지의 템플릿을 활성화해야 합니다 | |
/conf/<your-folder>/settings/wcm/policies |
Template Author |
읽기, 쓰기, 복제 | 사이트별 /conf 공간에서 템플릿을 생성, 읽기, 업데이트, 삭제 및 복제하는 템플릿 작성자 |
익명의 웹 사용자 | read | 페이지를 렌더링하는 동안 익명 웹 사용자가 정책을 읽어야 합니다. | |
컨텐츠 작성자 | 복제 | 컨텐츠 작성자는 페이지를 활성화할 때 페이지 템플릿의 정책을 활성화해야 합니다 | |
/conf/<site>/settings/template-types |
템플릿 작성자 | read | 템플릿 작성자는 사전 정의된 템플릿 유형 중 하나를 기반으로 새 템플릿을 만듭니다. |
익명의 웹 사용자 | 없음 | 익명 웹 사용자는 템플릿 유형에 액세스할 수 없습니다. |
이 기본 template-authors
그룹은 모든 template-authors
구성원이 모든 템플릿에 액세스하여 작성할 수 있는 프로젝트 설정만 포함합니다. 템플릿에 대한 별도의 액세스를 위해 여러 템플릿 작성자 그룹이 필요한 보다 복잡한 설정을 수행하려면 사용자 정의 템플릿 작성자 그룹을 만들어야 합니다. 그러나 템플릿 작성자 그룹에 대한 권한은 여전히 동일합니다.
템플릿을 더 이상 /conf/global
에 저장하지 않아야 하지만 일부 기존 설치의 경우 이 위치에 템플릿이 여전히 있을 수 있습니다. 이러한 레거시 상황에서만 다음 /conf/global
경로를 명시적으로 구성해야 합니다.
경로 | 역할/그룹 | 권한 |
설명 |
---|---|---|---|
/conf/global/settings/wcm/templates |
템플릿 작성자 | 읽기, 쓰기, 복제 | 템플릿 작성자: /conf/global |
익명의 웹 사용자 | read | 익명 웹 사용자는 페이지를 렌더링하는 동안 템플릿을 읽어야 합니다. | |
컨텐츠 작성자 | 복제 | 컨텐츠 작성자는 페이지를 활성화할 때 페이지의 템플릿을 활성화해야 합니다 | |
/conf/global/settings/wcm/policies |
Template Author |
읽기, 쓰기, 복제 | 템플릿 작성자: /conf/global |
익명의 웹 사용자 | read | 페이지를 렌더링하는 동안 익명 웹 사용자가 정책을 읽어야 합니다. | |
컨텐츠 작성자 | 복제 | 컨텐츠 작성자는 페이지를 활성화할 때 페이지 템플릿의 정책을 활성화해야 합니다 | |
/conf/global/settings/wcm/template-types |
템플릿 작성자 | read | 템플릿 작성자는 사전 정의된 템플릿 유형 중 하나를 기반으로 새 템플릿을 만듭니다 |
익명의 웹 사용자 | 없음 | 익명 웹 사용자는 템플릿 유형에 액세스할 수 없습니다. |
새 템플릿을 만들 때 템플릿 유형을 지정해야 합니다.
템플릿 유형은 템플릿에 대한 템플릿을 효과적으로 제공합니다. 새 템플릿을 만들 때 선택한 템플릿 유형의 구조 및 초기 컨텐츠는 새 템플릿에 만드는 데 사용됩니다.
템플릿 유형을 사용하여 다음을 정의할 수 있습니다.
AEM에서는 HTML5 페이지 및 적응형 양식 페이지와 같은 간단한 템플릿 유형을 제공합니다.
템플릿 유형은 일반적으로 개발자가 정의합니다.
기본 템플릿 유형은 다음 위치에 저장됩니다.
/libs/settings/wcm/template-types
/libs
경로에서 아무 것도 변경하면 안 됩니다. 이는 다음 번에 인스턴스를 업그레이드할 때 /libs
의 콘텐트가 덮어쓰여지고 핫픽스 또는 기능 팩을 적용할 때 덮어쓰여질 수 있기 때문입니다.
사이트 특정 템플릿 유형은 다음과 유사한 위치에 저장해야 합니다.
/apps/settings/wcm/template-types
사용자 지정된 템플릿 유형에 대한 정의는 사용자 정의 폴더(권장)에 저장하거나 또는 global
에 저장해야 합니다. 예:
/conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
/conf/<my-folder>/settings/wcm/template-types
/conf/global/settings/wcm/template-types
템플릿 유형은 올바른 폴더 구조(예:/settings/wcm/...
). 그렇지 않으면 템플릿 유형을 찾을 수 없습니다.
편집 가능한 템플릿에 사용되는 장치 그룹(속성 cq:deviceGroups
의 상대 경로로 설정)은 페이지 작성의 레이아웃 모드에서 에뮬레이터로 사용할 수 있는 모바일 장치를 정의합니다. 이 값은 다음 두 위치에서 설정할 수 있습니다.
새 편집 가능 템플릿을 만들 때 해당 값이 템플릿 유형에서 개별 템플릿으로 복사됩니다. 이 값이 유형에 설정되지 않은 경우 템플릿에 설정할 수 있습니다. 템플릿이 생성되면 해당 유형에서 템플릿으로 이어지는 상속이 없습니다.
cq:deviceGroups
값은 mobile/groups/responsive
과 같은 상대 경로로 설정되어야 하며 /etc/mobile/groups/responsive
와 같은 절대 경로로 설정해야 합니다.
정적 템플릿을 사용하면 cq:deviceGroups
의 값을 사이트의 루트에서 설정할 수 있습니다.
편집 가능한 템플릿을 사용하면 이제 이 값이 템플릿 수준에서 저장되고 페이지 루트 수준에서 지원되지 않습니다.
다른 템플릿의 기초로 사용할 수 있는 템플릿을 만든 경우 이 템플릿을 템플릿 유형으로 복사할 수 있습니다.
templates
노드에서 템플릿 폴더의 template-types
노드로 복사합니다.templates
노드에서 템플릿을 삭제합니다.template-types
노드 아래에 있는 템플릿 복사본에서 모든 cq:template
및 cq:templateType
jcr:content
속성을 삭제합니다.GitHub에서 사용할 수 있는 편집 가능한 템플릿 예제를 기반으로 사용하여 고유한 템플릿 유형을 개발할 수도 있습니다.
GITHUB에 대한 코드
GitHub에서 이 페이지의 코드를 찾을 수 있습니다
편집 가능한 템플릿에 대한 정의는 사용자 정의 폴더(권장) 또는 global
에 저장됩니다. 예:
/conf/<my-folder>/settings/wcm/templates
/conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
/conf/global/settings/wcm/templates
템플릿의 루트 노드는 다음과 같은 뼈대 구조를 갖는 cq:Template
유형입니다.
<template-name>
initial
jcr:content
root
<component>
...
<component>
jcr:content
@property status
policies
jcr:content
root
@property cq:policy
<component>
@property cq:policy
...
<component>
@property cq:policy
structure
jcr:content
root
<component>
...
<component>
cq:responsive
breakpoints
thumbnail.png
주요 요소는 다음과 같습니다.
<template-name>
[initial](#initial-content)
jcr:content
[structure](#structure)
[policies](#policies)
thumbnail.png
이 노드는 템플릿에 대한 속성을 보유합니다.
이름: jcr:title
이름: status
``유형: String
값: draft
, enabled
or disabled
결과 페이지의 구조를 정의합니다.
새 페이지를 만들 때 초기 내용( /initial
)과 병합됩니다.
구조를 변경하면 템플릿으로 만든 페이지에 반영됩니다.
root
( structure/jcr:content/root
) 노드는 결과 페이지에서 사용할 수 있는 구성 요소 목록을 정의합니다.
템플릿 구조에 정의된 구성 요소는 결과 페이지에서 이동하거나 삭제할 수 없습니다.
구성 요소의 잠금이 해제되면 editable
속성이 true
로 설정됩니다.
이미 콘텐트가 들어 있는 구성 요소의 잠금이 해제되면 이 콘텐트가 initial
분기로 이동합니다.
cq:responsive
노드는 응답형 레이아웃에 대한 정의를 보관합니다.
작성 시 새 페이지가 가질 초기 컨텐츠를 정의합니다.
jcr:content
노드를 포함합니다./structure
)와 병합됩니다.root
노드에는 결과 페이지에서 사용할 수 있는 구성 요소 목록이 들어 있습니다.템플릿을 편집할 때 레이아웃을 정의할 수 있습니다. 이 경우 표준 응답형 레이아웃이 사용됩니다. 구성된이기도 합니다.
컨텐츠(또는 디자인) 정책은 구성 요소의 디자인 속성을 정의합니다. 예: 사용 가능한 구성 요소 또는 최소/최대 크기. 이러한 속성은 템플릿(및 템플릿으로 만든 페이지)에 적용될 수 있습니다. 템플릿 편집기에서 컨텐츠 정책을 만들고 선택할 수 있습니다.
root
노드의 cq:policy
속성
/conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
페이지의 단락 시스템에 대한 컨텐츠 정책에 대한 상대 참조를 제공합니다.
root
아래의 구성 요소 명시적 노드에서 cq:policy
속성은 개별 구성 요소에 대한 정책에 대한 링크를 제공합니다.
실제 정책 정의는 다음과 같이 저장됩니다.
/conf/<your-folder>/settings/wcm/policies/wcm/foundation/components
정책 정의 경로는 구성 요소의 경로에 따라 다릅니다. cq:policy
구성 자체에 대한 상대 참조를 보유합니다.
편집 가능한 템플릿으로 만든 페이지는 페이지 편집기에서 디자인 모드를 제공하지 않습니다.
편집 가능한 템플릿의 policies
트리는 다음 아래에 있는 정적 템플릿의 디자인 모드 구성과 동일한 계층 구조를 가집니다.
/etc/designs/<my-site>/jcr:content/<component-name>
정적 템플릿의 디자인 모드 구성은 페이지 구성 요소별로 정의됩니다.
페이지 정책을 사용하면 템플릿 또는 결과 페이지에서 페이지에 대한 컨텐트 정책을 정의할 수 있습니다(주 parsys).
템플릿 활성화
템플릿을 사용하려면 다음 중 하나를 사용하여 템플릿을 활성화해야 합니다.
템플릿 콘솔 에서 템플릿 활성화.
jcr:content
노드에서 상태 속성을 설정합니다.
예를 들면 다음과 같습니다.
/conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content
속성을 정의합니다.
enabled
허용된 템플릿
하위 분기의 적절한 페이지 또는 루트 페이지의 페이지 속성에서 허용된 템플릿 경로를 정의합니다.
속성을 설정합니다.
cq:allowedTemplates
On the
jcr:content
node of the required branch.
예를 들어 다음 값이 있는 경우:
/conf/<your-folder>/settings/wcm/templates/.*
편집 가능한 템플릿으로 만든 페이지:
템플릿의 structure
및 initial
에서 병합된 하위 트리를 사용하여 만듭니다.
템플릿 및 템플릿 유형에 들어 있는 정보에 대한 참조가 있습니다. 이 작업은 속성이 있는 jcr:content
노드를 사용하여 수행됩니다.
cq:template
실제 템플릿에 대한 동적 참조를 제공합니다.템플릿 변경 사항이 실제 페이지에 반영되도록 합니다.
cq:templateType
템플릿 유형에 대한 참조를 제공합니다.
위의 다이어그램은 템플릿, 컨텐트 및 구성 요소가 어떻게 상호 연관되어 있는지 보여줍니다.
컨트롤러 - /content/<my-site>/<my-page>
템플릿을 참조하는 결과 페이지입니다. 컨텐츠는 전체 프로세스를 제어합니다. 정의에 따라 해당 템플릿 및 구성 요소에 액세스합니다.
구성 - /conf/<my-folder>/settings/wcm/templates/<my-template>
템플릿 및 관련 컨텐츠 정책은 페이지 구성을 정의합니다.
모델 - OSGi 번들
OSGI 번들은 기능을 구현합니다.
보기 - /apps/<my-site>/components
작성 환경과 게시 환경 모두에서 컨텐츠는 components에 의해 렌더링됩니다.
페이지를 렌더링할 때:
템플릿:
jcr:content
노드의 cq:template
속성은 해당 페이지에 해당하는 템플릿에 액세스하기 위해 참조됩니다.구성 요소:
페이지 구성 요소는 템플릿의 structure/jcr:content
트리를 페이지의 jcr:content
트리와 병합합니다.
페이지 구성 요소는 작성자가 편집 가능한 것으로 플래그가 지정된 템플릿 구조의 노드(및 하위)만 편집할 수 있도록 허용합니다.
페이지에서 구성 요소를 렌더링할 때 해당 구성 요소의 상대 경로는 jcr:content
노드에서 가져옵니다.템플릿의 policies/jcr:content
노드 아래에 있는 동일한 경로를 검색합니다.
이 노드의 cq:policy
속성은 실제 컨텐트 정책(즉, 해당 구성 요소에 대한 디자인 구성을 보유하고 있음)을 가리킵니다.
동일한 컨텐츠 정책 구성을 다시 사용하는 여러 템플릿이 있을 수 있습니다.