설명서AEM 6.5사용 안내서

모든 기능을 갖춘 웹 사이트(JSP) 만들기 create-a-fully-featured-website-jsp

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

작성 대상:

  • 개발자
NOTE
이 문서에서는 JSP를 사용하고 클래식 UI를 기반으로 하는 웹 사이트를 만드는 방법을 설명합니다. Adobe은 문서 AEM Sites 개발 시작하기에 자세히 설명된 대로 웹 사이트에 최신 Adobe Experience Manager(AEM) 기술을 사용하는 것을 권장합니다.

이 자습서를 통해 AEM에서 모든 기능을 갖춘 웹 사이트를 만들 수 있습니다. 웹 사이트는 일반 웹 사이트를 기반으로 하며 주로 웹 개발자를 대상으로 합니다. 모든 개발은 작성자 환경 내에서 수행됩니다.

이 튜토리얼에서는 다음 방법을 설명합니다.

  1. AEM을 설치합니다.

  2. 액세스 CRXDE Lite(개발 환경).

  3. CRXDE Lite에서 프로젝트 구조를 설정합니다.

  4. 컨텐츠 페이지 작성의 기반으로 사용되는 템플릿, 구성 요소 및 스크립트를 작성합니다.

  5. 웹 사이트의 루트 페이지를 만든 다음 컨텐츠 페이지를 만듭니다.

  6. 페이지에서 사용할 다음 구성 요소를 만듭니다.

    • 위쪽 탐색
    • 하위 목록
    • 로고
    • 이미지
    • Text-Image
    • 검색

  7. 다양한 기초 구성 요소를 포함합니다.

모든 단계를 수행한 후 페이지는 다음과 같이 표시되어야 합니다.

chlimage_1-24

최종 결과 다운로드

연습을 수행하지 않고 자습서와 함께 따르려면 website-1.0.zip을 다운로드합니다. 이 파일은 이 자습서의 결과를 포함하는 AEM 콘텐츠 패키지입니다. 작성자 인스턴스에 패키지를 설치하려면 패키지 관리자를 사용하십시오.

참고: 이 패키지를 설치하면 이 자습서를 사용하여 만든 작성 인스턴스의 모든 리소스를 덮어씁니다.

웹 사이트 컨텐츠 패키지

파일 가져오기

Adobe Experience Manager 설치 installing-adobe-experience-manager

웹 사이트 개발을 위한 AEM 인스턴스를 설치하려면 작성자 및 게시 인스턴스로 배포 환경을 설정하는 지침을 따르거나 일반 설치를 수행하십시오. 일반 설치에는 AEM Quickstart JAR 파일을 다운로드하고, JAR 파일과 동일한 디렉토리에 license.properties 파일을 배치한 다음 JAR 파일을 두 번 클릭하는 작업이 포함됩니다.

AEM을 설치한 후 시작 페이지에서 CRXDE Lite 링크를 클릭하여 CRXDE Lite 개발 환경에 액세스합니다.

chlimage_1-25

NOTE
기본 포트를 사용하여 로컬에 설치된 AEM 작성 인스턴스의 CRXDE Lite URL은 https://localhost:4502/crx/de/입니다.

CRXDE Lite에서 프로젝트 구조 설정 setting-up-the-project-structure-in-crxde-lite

CRXDE Lite을 사용하여 저장소에서 mywebsite 애플리케이션 구조를 생성합니다.

  1. CRXDE Lite 왼쪽의 트리에서 /apps 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 만들기 폴더 ​를 클릭합니다. 폴더 만들기 대화 상자에서 mywebsite을(를) 폴더 이름으로 입력하고 확인 ​을 클릭합니다.

  2. /apps/mywebsite 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 폴더 만들기 ​를 클릭합니다. 폴더 만들기 대화 상자에서 components을(를) 폴더 이름으로 입력하고 확인 ​을 클릭합니다.

  3. /apps/mywebsite 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 폴더 만들기 ​를 클릭합니다. 폴더 만들기 대화 상자에서 templates을(를) 폴더 이름으로 입력하고 확인 ​을 클릭합니다.

    이제 트리의 구조는 다음과 같이 표시되어야 합니다.

    chlimage_1-26

  4. 모두 저장 ​을 클릭합니다.

디자인 설정 setting-up-the-design

이 섹션에서는 Designer 도구를 사용하여 애플리케이션에 대한 디자인을 만듭니다. 디자인은 웹 사이트에 대한 CSS 및 이미지 리소스를 제공합니다.

NOTE
mywebsite.zip을 다운로드하려면 다음 링크를 클릭하십시오. 아카이브에는 디자인에 대한 static.css 및 이미지 파일이 포함되어 있습니다.

샘플 static.css 파일 및 이미지

파일 가져오기

  1. AEM 시작 페이지에서 도구 ​를 클릭합니다. (https://localhost:4502/libs/cq/core/content/welcome.html)

    chlimage_1-27

  2. 폴더 트리에서 디자인 폴더를 선택한 다음 새로 만들기 > 새 페이지 ​를 클릭합니다. 제목으로 mywebsite을(를) 입력하고 만들기 ​를 클릭합니다.

  3. mywebsite 항목이 테이블에 표시되지 않으면 트리 또는 테이블을 새로 고칩니다.

  4. WebDAV 액세스를 사용하여 https://localhost:4502의 URL에 액세스한 후 다운로드한 mywebsite.zip 파일에서 샘플 static.css 파일과 images 폴더를 /etc/designs/mywebsite 폴더로 복사하십시오.

    chlimage_1-28

Contentpage 템플릿, 구성 요소 및 스크립트 만들기 creating-the-contentpage-template-component-and-script

이 섹션에서는 다음을 만듭니다.

  • 예제 웹 사이트에서 컨텐츠 페이지를 만드는 데 사용되는 컨텐츠 페이지 템플릿입니다.
  • 컨텐츠 페이지를 렌더링하는 데 사용되는 contentpage 구성 요소입니다.
  • contentpage 스크립트.

Contentpage 템플릿 만들기 creating-the-contentpage-template

사이트의 웹 페이지의 기반으로 사용할 템플릿을 만듭니다.

템플릿은 새 페이지의 기본 콘텐츠를 정의합니다. 복잡한 웹 사이트에서는 사이트에서 서로 다른 유형의 페이지를 만들기 위해 여러 템플릿을 사용할 수 있습니다. 이 연습에서는 모든 페이지가 하나의 간단한 템플릿을 기반으로 합니다.

  1. CRXDE Lite의 폴더 트리에서 /apps/mywebsite/templates을(를) 마우스 오른쪽 단추로 클릭하고 만들기 > 템플릿 만들기 ​를 클릭합니다.

  2. 템플릿 만들기 대화 상자에서 다음 값을 입력한 다음 다음 ​을 클릭합니다.

    • 레이블: contentpage
    • 제목: 내 웹 사이트 콘텐츠 페이지 템플릿
    • 설명: 내 웹 사이트 콘텐츠 페이지 템플릿입니다.
    • 리소스 유형: mywebsite/components/contentpage

    Ranking 속성에 기본값을 사용합니다.

    chlimage_1-29

    리소스 유형은 페이지를 렌더링하는 구성 요소를 식별합니다. 이 경우 contentpage 템플릿을 사용하여 만든 모든 페이지는 mywebsite/components/contentpage 구성 요소에 의해 렌더링됩니다.

  3. 이 템플릿을 사용할 수 있는 페이지의 경로를 지정하려면 더하기 단추를 클릭하고 표시되는 텍스트 상자에 /content(/.*)?을(를) 입력하십시오. 그런 다음 다음 ​을 클릭합니다.

    chlimage_1-30

    허용되는 경로 속성의 값은 정규 표현식입니다.식에 일치하는 경로가 있는 페이지에서 템플릿을 사용할 수 있습니다. 이 경우 정규식은 /content 폴더 및 모든 하위 페이지의 경로와 일치합니다.

    작성자가 /content 아래에 페이지를 만들면 contentpage 템플릿이 사용할 수 있는 템플릿 목록에 나타납니다.

  4. 허용된 부모 및 허용된 자식 패널에서 다음 ​을 클릭하고 확인 ​을 클릭합니다. CRXDE Lite에서 모두 저장 ​을 클릭합니다.

    chlimage_1-31

Contentpage 구성 요소 만들기 creating-the-contentpage-component

콘텐츠를 정의하고 contentpage 템플릿을 사용하는 페이지를 렌더링하는 구성 요소 ​를 만듭니다. 구성 요소의 위치는 contentpage 템플릿의 리소스 유형 속성 값과 일치해야 합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components을(를) 마우스 오른쪽 단추로 클릭하고 만들기 > 구성 요소 ​를 클릭합니다.

  2. 구성 요소 만들기 대화 상자에서 다음 속성 값을 입력합니다.

    • 레이블: contentpage
    • 제목: 내 웹 사이트 콘텐츠 페이지 구성 요소
    • 설명: 내 웹 사이트 콘텐츠 페이지 구성 요소입니다

    chlimage_1-32

    새 구성 요소의 위치는 /apps/mywebsite/components/contentpage입니다. 이 경로는 contentpage 템플릿의 리소스 유형(경로의 초기 /apps/ 부분 제외)에 해당합니다.

    이 서신은 템플릿을 구성 요소에 연결하고 웹 사이트의 올바른 기능에 중요합니다.

  3. 대화 상자의 [허용된 자식] 패널이 나타날 때까지 다음 ​을 클릭한 다음 확인 ​을 클릭합니다. CRXDE Lite에서 모두 저장 ​을 클릭합니다.

    이제 구조는 다음과 같습니다.

    chlimage_1-33

Contentpage 구성 요소 스크립트 개발 developing-the-contentpage-component-script

contentpage.jsp 스크립트에 코드를 추가하여 페이지 콘텐츠를 정의합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage의 contentpage.jsp 파일을 엽니다. 파일에는 기본적으로 다음 코드가 포함되어 있습니다.

    code language-java 
    <%--

  My Website Content Page Component component.

  This is My Website Content Page Component.

--%><%
%><%@include file="/libs/foundation/global.jsp"%><%
%><%@page session="false" %><%
%><%
    /* TODO add you code here */
%>

  2. 다음 코드를 복사하여 기본 코드 뒤에 contentpage.jsp에 붙여넣습니다.

    code language-java 
    <%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"https://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>My title</title>
</head>
<body>
<div>My body</div>
</body>
</html>

  3. 변경 내용을 저장하려면 모두 저장 ​을 클릭하세요.

웹 사이트 페이지 및 컨텐츠 페이지 만들기 creating-your-website-page-and-content-pages

이 섹션에서는 내 웹 사이트, 영어, 제품, 서비스 및 고객 페이지에서 컨텐츠 페이지 템플릿을 사용하는 페이지를 만듭니다.

  1. AEM 시작 페이지(https://localhost:4502/libs/cq/core/content/welcome.html)에서 웹 사이트를 클릭합니다.

    chlimage_1-34

  2. 폴더 트리에서 웹 사이트 폴더를 선택한 다음 새로 만들기 > 새 페이지 ​를 클릭합니다.

  3. 페이지 만들기 창에서 다음을 입력하십시오.

    • 제목: My Website
    • 이름: mywebsite
    • My Website Content Page Template 선택

    chlimage_1-35

  4. 만들기 ​를 클릭합니다. 폴더 트리에서 /Websites/My Website 페이지를 선택하고 새로 만들기 > 새 페이지 ​를 클릭합니다.

  5. [페이지 만들기] 대화 상자에서 다음 속성 값을 입력한 다음 [만들기]를 클릭합니다.

    • 제목: 영어
    • 이름: en
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  6. 폴더 트리에서 /Websites/My Website/English 페이지를 선택하고 새로 만들기> 새 페이지 ​를 클릭합니다.

  7. 페이지 만들기 대화 상자에서 다음 속성 값을 입력한 다음 만들기 ​를 클릭합니다.

    • 제목: Products
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  8. 폴더 트리에서 /Websites/My Website/English 페이지를 선택하고 새로 만들기 > 새 페이지 ​를 클릭합니다.

  9. 페이지 만들기 대화 상자에서 다음 속성 값을 입력한 다음 만들기 ​를 클릭합니다.

    • 제목: 서비스
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  10. 폴더 트리에서 /Websites/My Website/English 페이지를 선택하고 새로 만들기 > 새 페이지 ​를 클릭합니다.

  11. 페이지 만들기 대화 상자에서 다음 속성 값을 입력한 다음 만들기 ​를 클릭합니다.

    • 제목: 고객
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

    구조는 다음과 같습니다.

    chlimage_1-36

  12. 페이지를 mywebsite 디자인에 연결하려면 CRXDE Lite에서 /content/mywebsite/en/jcr:content 노드를 선택합니다. 속성 탭에서 새 속성에 대해 다음 값을 입력한 다음 추가를 클릭합니다.

    • 이름: cq:designPath
    • 유형: 문자열
    • 값: /etc/designs/mywebsite

    chlimage_1-37

  13. 새 웹 브라우저 탭 또는 창에서 https://localhost:4502/content/mywebsite/en/products.html을(를) 열어 제품 페이지를 확인합니다.

    chlimage_1-38

Contentpage 스크립트 향상 enhancing-the-contentpage-script

이 섹션에서는 AEM foundation 구성 요소 스크립트를 사용하고 고유한 스크립트를 작성하여 콘텐츠 페이지 스크립트를 향상시키는 방법에 대해 설명합니다.

완료되면 제품 페이지는 다음과 같이 표시됩니다.

chlimage_1

Foundation 페이지 스크립트 사용 using-the-foundation-page-scripts

이 연습에서는 상위 유형이 AEM Page 구성 요소가 되도록 pagecontent 구성 요소를 구성합니다. 구성 요소는 슈퍼타입의 기능을 상속받기 때문에 page 컨텐츠는 페이지 구성 요소의 스크립트와 속성을 상속받습니다.

예를 들어 구성 요소 JSP 코드에서 슈퍼타입 구성 요소가 구성 요소에 포함된 것처럼 제공하는 스크립트를 참조할 수 있습니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage 노드에 속성을 추가합니다.

    1. /apps/mywebsite/components/contentpage 노드를 선택하십시오.

    2. 속성 탭 하단에 다음 속성 값을 입력한 다음 추가를 클릭합니다.

      • 이름: sling:resourceSuperType
      • 유형: 문자열
      • 값: foundation/components/page

    3. 모두 저장을 클릭합니다.

  2. /apps/mywebsite/components/contentpage에서 contentpage.jsp 파일을 열고 기존 코드를 다음 코드로 바꿉니다.

    code language-xml 
    <%@include file="/libs/foundation/global.jsp"%><%
%><%@page session="false" contentType="text/html; charset=utf-8" %><%
%><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "https://www.w3.org/TR/html4/strict.dtd">
<html>
<cq:include script="head.jsp"/>
<cq:include script="body.jsp"/>
</html>

  3. 변경 사항을 저장합니다.

  4. 브라우저에서 제품 페이지를 다시 로드합니다. 이는 다음과 같습니다.

    chlimage_1-1

    페이지 소스를 열어 head.jsp 및 body.jsp 스크립트가 생성한 JavaScript 및 HTML 요소를 확인합니다. 페이지를 열면 다음 스크립트 코드 조각이 Sidekick에 열립니다.

    code language-java 
    CQ.WCM.launchSidekick("/content/mywebsite/en/products",
            {propsDialog: "/libs/foundation/components/page/dialog",
               locked: false locked: false
             });

자체 스크립트 사용 using-your-own-scripts

이 섹션에서는 페이지 본문의 일부를 각각 생성하는 몇 개의 스크립트를 만듭니다. 그런 다음 pageContent 구성 요소에 body.jsp 파일을 생성하여 AEM Page 구성 요소의 body.jsp를 재정의합니다. body.jsp 파일에 페이지 본문의 다른 부분을 생성하는 스크립트를 포함합니다.

팁: 구성 요소에 구성 요소의 슈퍼타입에서 파일과 이름 및 상대 위치가 같은 파일이 포함되어 있으면 오버레이 ​라고 합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래에 left.jsp 파일을 만듭니다.

    1. /apps/mywebsite/components/contentpage 노드를 마우스 오른쪽 단추로 클릭한 다음 만들기 ​다음 파일 만들기 ​를 선택합니다.

    2. 창에서 이름(으)로 left.jsp을(를) 입력하고 확인 ​을(를) 클릭합니다.

  2. left.jsp 파일을 편집하여 기존 콘텐츠를 제거하고 다음 코드로 대체합니다.

    code language-java 
    <%@include file="/libs/foundation/global.jsp"%><%
%><div class="left">
<div>logo</div>
<div>newslist</div>
<div>search</div>
</div>

  3. 변경 사항을 저장합니다.

  4. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래에 center.jsp 파일을 만듭니다.

    1. /apps/mywebsite/components/contentpage 노드를 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 파일 만들기 ​를 선택합니다.

    2. 대화 상자에서 center.jsp을(를) 이름(으)로 입력하고 확인 ​을 클릭합니다.

  5. center.jsp 파일을 편집하여 기존 콘텐츠를 제거하고 다음 코드로 바꿉니다.

    code language-java 
    <%@include file="/libs/foundation/global.jsp"%><%
%><div class="center">
<div>trail</div>
<div>title</div>
<div>parsys</div>
</div>

  6. 변경 사항을 저장합니다.

  7. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래에 right.jsp 파일을 만듭니다.

    1. /apps/mywebsite/components/contentpage 노드를 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 파일 만들기 ​를 선택합니다.

    2. 대화 상자에서 right.jsp을(를) 이름(으)로 입력하고 확인 ​을 클릭합니다.

  8. right.jsp 파일을 편집하여 기존 콘텐츠를 제거하고 다음 코드로 대체합니다.

    code language-java 
    <%@include file="/libs/foundation/global.jsp"%><%
%><div class="right">
<div>iparsys</div>
</div>

  9. 변경 사항을 저장합니다.

  10. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래에 body.jsp 파일을 만듭니다.

  11. body.jsp 파일을 편집하여 기존 콘텐츠를 제거하고 다음 코드로 대체합니다.

    code language-java 
    <%@include file="/libs/foundation/global.jsp"%><%
%><body>
<div id="CQ">
<div class="topnav">topnav</div>
<div class="content">
<cq:include script="left.jsp" />
<cq:include script="center.jsp" />
<cq:include script="right.jsp" />
</div>
<div class="footer">
<div class="toolbar">toolbar</div>
</div>
</div>
</body>

  12. 변경 사항을 저장합니다.

  13. 브라우저에서 제품 페이지를 다시 로드합니다. 이는 다음과 같습니다.

    chlimage_1-2

상단 탐색 구성 요소 만들기 creating-the-top-navigation-component

이 섹션에서는 쉽게 탐색할 수 있도록 웹 사이트의 모든 최상위 페이지에 대한 링크를 표시하는 구성 요소를 만듭니다. 이 구성 요소 콘텐츠는 콘텐츠 페이지 템플릿을 사용하여 만든 모든 페이지의 맨 위에 표시됩니다.

위쪽 탐색 구성 요소의 첫 번째 버전(topnav)에서 탐색 항목은 텍스트 링크입니다. 두 번째 버전에서는 이미지 탐색 링크와 함께 topnav를 구현합니다.

완료되면 위쪽 탐색은 다음과 같이 표시됩니다.

chlimage_1-39

상단 탐색 구성 요소 만들기 creating-the-top-navigation-component-1

  1. CRXDE Lite에서 /apps/mywebsite/components을(를) 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 구성 요소 만들기 ​를 선택합니다.

  2. 구성 요소 만들기 창에서 다음을 입력하십시오.

    • 레이블: topnav

    • 제목: My Top Navigation Component

    • 설명: This is My Top Navigation Component

  3. 확인 ​을 클릭하는 마지막 창이 나타날 때까지 다음 ​을 클릭합니다. 변경 사항을 저장합니다.

상위 탐색에 렌더링 스크립트를 추가하여 하위 페이지에 대한 텍스트 링크를 생성합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/topnav 아래의 topnav.jsp 파일을 엽니다.

  2. 다음 코드를 복사하여 붙여 넣어 있는 코드를 바꿉니다.

    code language-xml 
    <%@include file="/libs/foundation/global.jsp"%><%
%><%@ page import="java.util.Iterator,
        com.day.text.Text,
        com.day.cq.wcm.api.PageFilter, com.day.cq.wcm.api.Page" %><%
    /* get starting point of navigation */
    Page navRootPage = currentPage.getAbsoluteParent(2);
    if (navRootPage == null && currentPage != null) {
    navRootPage = currentPage;
    }
    if (navRootPage != null) {
        Iterator<Page> children = navRootPage.listChildren(new PageFilter(request));
        while (children.hasNext()) {
            Page child = children.next();
            %><a href="<%= child.getPath() %>.html"><%=child.getTitle() %></a><%
        }
    }
%>

Contentpage 구성 요소에 위쪽 탐색 포함 including-top-navigation-in-the-contentpage-component

contentpage 구성 요소에 topnav를 포함하려면 다음을 수행합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage의 body.jsp을(를) 열고 다음을 바꾸십시오.

    code language-xml 
    <div class="topnav">topnav</div>

    포함:

    code language-xml 
    <cq:include path="topnav" resourceType="mywebsite/components/topnav" />

  2. 변경 사항을 저장합니다.

  3. 브라우저에서 제품 페이지를 다시 로드합니다. 위쪽 탐색은 다음과 같이 나타납니다.

    chlimage_1-40

자막으로 페이지 향상 enhancing-pages-with-subtitles

페이지 구성 요소는 페이지에 캡션을 제공할 수 있는 속성을 정의합니다. 페이지 콘텐츠에 대한 정보를 제공하는 캡션을 추가합니다.

  1. 브라우저에서 제품 페이지를 엽니다.

  2. Sidekick 페이지 탭에서 페이지 속성 ​을 클릭합니다.

  3. 대화 상자의 기본 탭에서 제목 및 설명 추가, ​를 확장하고 하위 제목 속성에 대해 수행할 작업 ​을 입력합니다. 확인 ​을 클릭합니다.

  4. 서비스 페이지에 서비스 정보 ​라는 부제를 추가하려면 이전 단계를 반복합니다.

  5. 앞의 단계를 반복하여 고객 페이지에 트러스트 획득 ​을(를) 추가합니다.

    팁: CRXDE Lite에서 /content/mywebsite/en/products/jcr:content 노드를 선택하여 자막 속성이 추가되었는지 확인합니다.

탐색 컨트롤에 하이퍼텍스트 대신 이미지 링크를 사용하도록 topnav 구성 요소의 렌더링 스크립트를 개선합니다. 이미지에는 링크 대상의 제목과 부제가 포함되어 있습니다.

이 연습에서는 Sling 요청 처리를 보여 줍니다. 페이지 탐색 링크에 사용할 이미지를 동적으로 생성하는 스크립트를 호출하도록 topnav.jsp 스크립트가 수정되었습니다. 이 연습에서는 Sling이 이미지 소스 파일의 URL을 구문 분석하여 이미지 렌더링에 사용할 스크립트를 결정합니다.

예를 들어 제품 페이지에 대한 이미지 링크의 소스는 https://localhost:4502/content/mywebsite/en/products.navimage.png일 수 있습니다. Sling은 이 URL을 구문 분석하여 리소스 유형과 리소스 렌더링에 사용할 스크립트를 결정합니다.

  1. Sling은 리소스의 경로를 /content/mwebysite/en/products.png.로 결정합니다.

  2. Sling은 이 경로를 /content/mywebsite/en/products 노드와 일치시킵니다.

  3. Sling은 이 노드의 sling:resourceType을(를) mywebsite/components/contentpage(으)로 결정합니다.

  4. Sling은 이 구성 요소에서 URL 선택기(navimage) 및 파일 이름 확장명(png)과 가장 일치하는 스크립트를 찾습니다.

이 연습에서는 Sling이 이러한 URL을 사용자가 만드는 /apps/mywebsite/components/contentpage/navimage.png.java 스크립트와 일치시킵니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/topnav.앵커 요소의 내용 찾기(14행) 아래의 topnav.jsp을(를) 엽니다.

    code language-xml 
    <%=child.getTitle() %>

  2. 앵커 콘텐츠를 다음 코드로 바꿉니다.

    code language-xml 
    <img alt="<%= child.getTitle() %>" src="<%= child.getPath() %>.navimage.png">

  3. 변경 사항을 저장합니다.

  4. /apps/mywebsite/components/contentpage 노드를 마우스 오른쪽 단추로 클릭하고 만들기 > 파일 만들기 ​를 클릭합니다.

  5. 파일 만들기 창에서 이름(으)로 navimage.png.java을(를) 입력하십시오.

    .java 파일 이름 확장명은 Apache Sling Scripting Java™ 지원을 사용하여 스크립트를 컴파일하고 서블릿을 생성해야 함을 Sling에 나타냅니다.

  6. 다음 코드를 navimage.png.java.에 복사합니다. 이 코드는 AbstractImageServlet 클래스를 확장합니다.

    • AbstractImageServlet은(는) 현재 리소스의 속성을 저장하는 ImageContext 개체를 만듭니다.
    • 리소스의 상위 페이지는 ImageContext 개체에서 추출됩니다. 그런 다음 페이지 제목과 자막을 얻습니다.
    • ImageHelper은(는) 사이트 디자인, 페이지 제목 및 페이지 부제의 navimage_bg.jpg 파일에서 이미지를 생성하는 데 사용됩니다.
    code language-java 
    package apps.mywebsite.components.contentpage;

import java.awt.Color;
import java.awt.Paint;
import java.awt.geom.Rectangle2D;

import java.io.IOException;
import javax.jcr.RepositoryException;

import com.day.cq.wcm.api.Page;
import com.day.cq.wcm.api.PageManager;
import com.day.cq.wcm.api.components.Component;
import com.day.cq.wcm.api.designer.Designer;

import com.day.cq.commons.SlingRepositoryException;
import com.day.cq.wcm.commons.WCMUtils;
import com.day.cq.wcm.commons.AbstractImageServlet;
import com.day.cq.commons.ImageHelper;

import com.day.image.Font;
import com.day.image.Layer;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;

/**
  * Renders the navigation image
  */
public class navimage_png extends AbstractImageServlet {

      protected Layer createLayer(ImageContext ctx)
             throws RepositoryException, IOException {
         PageManager pageManager = ctx.resolver.adaptTo(PageManager.class);
         Page currentPage = pageManager.getContainingPage(ctx.resource);

         /* constants for image appearance */
         int scale = 6;
         int paddingX = 24;
         int paddingY = 24;
         Color bgColor = new Color(0x004a565c, true);

         /* obtain the page title */
         String title = currentPage.getTitle();
         if (title == null) {
             title = currentPage.getName();
         }

         /* format the title text */
         title = title.toUpperCase();
         Paint titleColor = Color.WHITE;
         Font titleFont = new Font("Myriad Pro", 10 * scale, Font.BOLD);
         int titleBase = 10 * scale;

         /* obtain and format the page subtitle */
         String subtitle = currentPage.getProperties().get("subtitle", "");
         Paint subtitleColor = new Color(0xffa9afb1, true);
         Font subTitleFont = new Font("Tahoma", 7);
         int subTitleBase = 20;

         /* create a layer that contains the background image from the mywebsite design */
         Designer dg = ctx.resolver.adaptTo(Designer.class);
         String imgPath = new String(dg.getDesignPath(currentPage)+"/images/navimage_bg.jpg");
         Layer bg = ImageHelper.createLayer(ctx.resolver.resolve(imgPath));

         /* draw the title text (4 times bigger) */
         Rectangle2D titleExtent = titleFont.getTextExtent(0, 0, 0, 0, title, Font.ALIGN_LEFT, 0, 0);
         Rectangle2D subtitleExtent = subTitleFont.getTextExtent(0, 0, 0, 0, subtitle, Font.ALIGN_LEFT, 0, 0);

         /* ensure subtitleExtent is wide enough */
         if ( subtitle.length() > 0 ) {
             int titleWidth = (int)titleExtent.getWidth() / scale;
             if ( subtitleExtent.getWidth() > titleWidth && subtitleExtent.getWidth() + 2 * paddingX >
 bg.getWidth() ) {
                 int charWidth = (int)subtitleExtent.getWidth() / subtitle.length();
                 int maxWidth = (bg.getWidth() > titleWidth + 2  * paddingX ? bg.getWidth() - 2 * paddingX : titleWidth);
                 int len = (maxWidth - ( 2 * charWidth) ) / charWidth;
                 subtitle = subtitle.substring(0, len) + "...";
                 subtitleExtent = subTitleFont.getTextExtent(0, 0, 0, 0, subtitle, Font.ALIGN_LEFT, 0, 0);
             }
         }
         int width = Math.max((int) titleExtent.getWidth(), (int) subtitleExtent.getWidth());
        /* create the text layer */
         Layer text = new Layer(width, (int) titleExtent.getHeight() + 40, new Color(0x01ffffff, true));
         text.setPaint(titleColor);
         text.drawText(0, titleBase, 0, 0, title, titleFont, Font.ALIGN_LEFT | Font.ALIGN_BASE, 0, 0);
         text.resize(text.getWidth() / scale, text.getHeight() / scale);
         text.setX(0);
         text.setY(0);

         if (subtitle.length() > 0) {
             /* draw the subtitle normal sized */
             text.setPaint(subtitleColor);
             text.drawText(0, subTitleBase, 0, 0, subtitle, subTitleFont, Font.ALIGN_LEFT | Font.ALIGN_BASE, 0, 0);
         }

         /* merge the image and text layers */
         text.setY(paddingY);
         text.setX(paddingX);
         text.setBackgroundColor(bgColor);

         int bgWidth = bg.getWidth();
         if ( text.getWidth() + 2 * paddingX > bgWidth ) {
             bgWidth = text.getWidth() + 2 * paddingX;
             bg.resize(bgWidth, bg.getHeight());
         }
         bg.merge(text);

         return bg;
     }
 }

  7. 변경 사항을 저장합니다.

  8. 브라우저에서 제품 페이지를 다시 로드합니다. 이제 위쪽 탐색이 다음과 같이 표시됩니다.

    screen_shot_2012-03-07at10047pm

하위 목록 구성 요소 만들기 creating-the-list-children-component

페이지 제목, 설명 및 날짜(예: 제품 페이지)를 포함하는 페이지 링크 목록을 생성하는 listchildren 구성 요소를 만듭니다. 이 링크는 현재 페이지의 하위 페이지 또는 구성 요소 대화 상자에 지정된 루트 페이지의 하위 페이지를 대상으로 합니다.

chlimage_1-41

제품 페이지 만들기 creating-product-pages

제품 페이지 아래에 두 페이지를 만듭니다. 두 개의 특정 제품을 설명하는 각 페이지에 대해 제목, 설명 및 날짜를 설정합니다.

  1. 웹 사이트 페이지의 폴더 트리에서 웹 사이트/내 웹 사이트/영어/제품 항목을 선택하고 새로 만들기 > 새 페이지 를 클릭합니다.

  2. 대화 상자에서 다음 속성 값을 입력한 다음 [만들기]를 클릭합니다.

    • 제목: 제품 1.
    • 이름: product1.
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  3. 다음 속성 값을 사용하여 Products 아래에 다른 페이지를 만듭니다.

    • 제목: 제품 2
    • 이름: product2
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  4. CRXDE Lite에서 제품 1 페이지에 대한 설명 및 날짜를 설정합니다.

    1. /content/mywebsite/en/products/product1/jcr:content 노드를 선택하십시오.

    2. 속성 탭에서 다음 값을 입력하십시오.

      • 이름: jcr:description
      • 유형: String
      • 값: This is a description of the Product 1!.

    3. 추가 ​를 클릭합니다.

    4. 속성 탭에서 다음 값을 사용하여 다른 속성을 만듭니다.

      • 이름: 날짜
      • 유형: 문자열
      • 값: 2008/02/14
      • 추가를 클릭합니다.

    5. 모두 저장을 클릭합니다.

  5. CRXDE Lite에서 제품 2 페이지에 대한 설명 및 날짜를 설정합니다.

    1. /content/mywebsite/en/products/product2/jcr:content 노드를 선택합니다.

    2. 속성 탭에서 다음 값을 입력하십시오.

      • 이름: jcr:description
      • 유형: 문자열
      • 값: 제품 2에 대한 설명입니다.

    3. 추가 ​를 클릭합니다.

    4. 동일한 텍스트 상자에서 이전 값을 다음 값으로 바꿉니다.

      • 이름: 날짜
      • 유형: 문자열
      • 값: 2012/05/11
      • 추가를 클릭합니다.

    5. 모두 저장을 클릭합니다.

하위 목록 구성 요소 만들기 creating-the-list-children-component-1

listchildren 구성 요소를 만들려면 다음을 수행하십시오.

  1. CRXDE Lite에서 /apps/mywebsite/components을(를) 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 구성 요소 만들기 ​를 선택합니다.

  2. 대화 상자에서 다음 속성 값을 입력한 후 다음을 클릭합니다.

    • 레이블: listchildren
    • 제목: 내 Listchildren 구성 요소
    • 설명: 내 Listchildren 구성 요소입니다.

  3. [허용된 하위] 패널이 나타날 때까지 [다음]을 계속 클릭한 다음 [확인]을 클릭합니다.

하위 목록 스크립트 만들기 creating-the-list-children-script

listchildren 구성 요소에 대한 스크립트를 개발합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/listchildren 아래의 listchildren.jsp 파일을 엽니다.

  2. 기본 코드를 다음 코드로 바꿉니다.

    code language-xml 
    <%@include file="/libs/foundation/global.jsp"%><%
%><%@ page import="java.util.Iterator,
         com.day.cq.wcm.api.PageFilter"%><%
     /* Create a Page object using the path of the current page */
      String listroot = properties.get("listroot", currentPage.getPath());
     Page rootPage = pageManager.getPage(listroot);
     /* iterate through the child pages and gather properties */
     if (rootPage != null) {
         Iterator<Page> children = rootPage.listChildren(new PageFilter(request));
         while (children.hasNext()) {
             Page child = children.next();
             String title = child.getTitle() == null ? child.getName() : child.getTitle();
             String date = child.getProperties().get("date","");
             %><div class="item">
             <a href="<%= child.getPath() %>.html"><b><%= title %></b></a>
             <span><%= date %></code><br>
             <%= child.getProperties().get("jcr:description","") %><br>
             </div><%
         }
     }
 %>

  3. 변경 사항을 저장합니다.

하위 목록 대화 상자 만들기 creating-the-list-children-dialog

listchildren 구성 요소 속성을 구성하는 데 사용되는 대화 상자를 만듭니다.

  1. listchildren 구성 요소 아래에 대화 상자 노드를 만듭니다.

    1. CRXDE Lite에서 /apps/mywebsite/components/listchildren노드를 마우스 오른쪽 단추로 클릭하고 만들기 > 대화 상자 만들기 ​를 클릭합니다.

    2. 대화 상자에서 다음 등록 정보 값을 입력하고 확인을 클릭합니다

      • 레이블: dialog

      • 제목: Edit Component을(를) 클릭하고 확인 ​을 클릭합니다.

    screen_shot_2012-03-07at45818pm

    다음 속성을 사용합니다.

    screen_shot_2012-03-07at50415pm

  2. /apps/mywebsite/components/listchildren/dialog/items/items/tab1 노드를 선택하십시오.

  3. 속성 탭에서 title 속성의 값을 List Children(으)로 변경합니다.

    chlimage_1-42

  4. tab1 노드를 선택하고 만들기 > 노드 만들기를 클릭하고 다음 속성 값을 입력한 다음 확인을 클릭합니다.

    • 이름: 항목
    • 유형: cq:WidgetCollection

    screen_shot_2012-03-07at51018pm

  5. 다음 속성 값을 사용하여 항목 노드 아래에 노드를 만듭니다.

    • 이름: listroot
    • 유형: cq:Widget

    screen_shot_2012-03-07at51031pm

  6. listroot 노드의 속성을 추가하여 텍스트 필드로 구성합니다. 다음 표의 각 행은 속성을 나타냅니다. 완료되면 모두 저장 을 클릭합니다.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    이름 유형 값
    fieldLabel 문자열 목록 루트의 경로
    이름 문자열 ./listroot
    xtype 문자열 텍스트 필드

    screen_shot_2012-03-07at51433pm

Contentpage 구성 요소에 목록 하위 포함 including-list-children-in-the-contentpage-component

listchildren 구성 요소를 contentpage 구성 요소에 포함하려면 다음과 같이 진행합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래의 left.jsp 파일을 열고 다음 코드(4행)를 찾습니다.

    code language-xml 
    <div>newslist</div>

  2. 해당 코드를 다음 코드로 바꿉니다.

    code language-xml 
    <cq:include path="newslist" resourceType="mywebsite/components/listchildren" />

  3. 변경 사항을 저장합니다.

페이지에서 목록 하위 보기 viewing-list-children-in-a-page

이 구성 요소의 전체 작업을 보려면 제품 페이지를 확인하십시오.

  • 상위 페이지("목록 루트의 경로")가 정의되지 않은 경우.
  • 상위 페이지("목록 루트의 경로")가 정의된 경우.

  1. 브라우저에서 제품 페이지를 다시 로드합니다. listchildren 구성 요소는 다음과 같이 표시됩니다.

    chlimage_1-43

  2. chlimage_1-44

  3. 목록 루트의 경로로 /content/mywebsite/en을(를) 입력하십시오. 확인을 클릭합니다. 이제 페이지의 listchildren 구성 요소는 다음과 같습니다.

    chlimage_1-45

로고 구성 요소 만들기 creating-the-logo-component

회사 로고를 표시하고 사이트의 홈 페이지에 대한 링크를 제공하는 구성 요소를 만듭니다. 구성 요소에는 사이트 디자인(https://experienceleague.adobe.com/etc/designs/mywebsite?lang=ko)에 속성 값을 저장할 수 있는 디자인 모드 대화 상자가 포함되어 있습니다.

  • 속성 값은 디자인을 사용하는 페이지에 추가되는 구성 요소의 모든 인스턴스에 적용됩니다.
  • 디자인을 사용하는 페이지에 있는 구성 요소의 인스턴스를 사용하여 속성을 구성할 수 있습니다.

디자인 모드 대화 상자에는 이미지와 링크 경로를 설정하는 속성이 포함되어 있습니다. 로고 구성 요소는 웹 사이트의 모든 페이지에서 왼쪽 상단에 배치됩니다.

작업을 마치면 다음과 같이 표시됩니다.

chlimage_1-46

NOTE
Adobe Experience Manager은 더 많은 기능을 갖춘 로고 구성 요소(/libs/foundation/components/logo)를 제공합니다.

로고 구성 요소 노드 만들기 creating-the-logo-component-node

로고 구성 요소를 만들려면 다음 단계를 수행하십시오.

  1. CRXDE Lite에서 /apps/mywebsite/components를 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 구성 요소 만들기 ​를 선택합니다.

  2. 구성 요소 만들기 대화 상자에서 다음 속성 값을 입력하고 다음을 클릭합니다.

    • 레이블: logo.
    • 제목: My Logo Component.
    • 설명: This is My Logo Component.

  3. 대화 상자의 마지막 패널에 도달할 때까지 [다음]을 클릭한 다음 확인 ​을 클릭합니다.

로고 스크립트 만들기 creating-the-logo-script

이 섹션에서는 홈 페이지에 대한 링크가 있는 로고 이미지를 표시하는 스크립트를 만드는 방법을 설명합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/logo 아래의 logo.jsp 파일을 엽니다.

  2. 다음 코드는 사이트 홈 페이지에 대한 링크를 만들고 로고 이미지에 대한 참조를 추가합니다. logo.jsp에 코드 복사:

    code language-xml 
    <%@include file="/libs/foundation/global.jsp"%><%
%><%@ page import="com.day.text.Text,
                   com.day.cq.wcm.foundation.Image,
                   com.day.cq.commons.Doctype" %><%
    /* obtain the path for home */
    long absParent = currentStyle.get("absParent", 2L);
    String home = Text.getAbsoluteParent(currentPage.getPath(), (int) absParent);
    /* obtain the image */
    Resource res = currentStyle.getDefiningResource("imageReference");
    if (res == null) {
        res = currentStyle.getDefiningResource("image");
    }
    /* if no image use text link, otherwise draw the image */
    %>
<a href="<%= home %>.html"><%
    if (res == null) {
        %>Home<%
    } else {
        Image img = new Image(res);
        img.setItemName(Image.NN_FILE, "image");
        img.setItemName(Image.PN_REFERENCE, "imageReference");
        img.setSelector("img");
        img.setDoctype(Doctype.fromRequest(request));
        img.setAlt("Home");
        img.draw(out);
    }
    %></a>

  3. 변경 사항을 저장합니다.

로고 디자인 대화 상자 만들기 creating-the-logo-design-dialog

디자인 모드에서 로고 구성 요소를 구성하는 대화 상자를 만듭니다. 디자인 모드 대화 상자 노드의 이름은 design_dialog이어야 합니다.

  1. 로고 구성 요소 아래에 대화 상자 노드를 만듭니다.

    1. /apps/mywebsite/components/logo 노드를 마우스 오른쪽 단추로 클릭하고 만들기 > 대화 상자 만들기 ​를 클릭합니다.

    2. 다음 속성 값을 입력한 다음 [확인]을 클릭합니다.

      • 레이블: design_dialog

      • 제목: Logo (Design)

  2. design_dialog 분기에서 tab1 노드를 마우스 오른쪽 버튼으로 클릭하고 삭제를 클릭합니다. 모두 저장을 클릭합니다.

  3. design_dialog/items/items노드 아래에서 cq:Widget 형식의 img 노드를 만듭니다. 다음 속성을 추가한 다음 모두 저장을 클릭합니다.

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
    이름 유형 값
    fileNameParameter 문자열 ./imageName
    fileReferenceParameter 문자열 ./imageReference
    이름 문자열 ./image
    제목 문자열 이미지
    xtype 문자열 html5smartimage

    chlimage_1-47

로고 렌더링 스크립트 만들기 creating-the-logo-render-script

로고 이미지를 검색하고 페이지에 작성하는 스크립트를 만듭니다.

  1. 로고 구성 요소 노드를 마우스 오른쪽 버튼으로 클릭하고 만들기 > 파일 만들기 를 클릭하여 img.GET.java라는 스크립트 파일을 만듭니다.
  2. 파일을 열고 다음 코드를 파일에 복사한 다음 모두 저장을 클릭합니다.
package apps.mywebsite.components.logo;

import java.io.IOException;
import java.io.InputStream;

import javax.jcr.RepositoryException;
import javax.jcr.Property;
import javax.servlet.http.HttpServletResponse;

import com.day.cq.wcm.foundation.Image;
import com.day.cq.wcm.commons.RequestHelper;
import com.day.cq.wcm.commons.WCMUtils;
import com.day.cq.wcm.commons.AbstractImageServlet;
import com.day.cq.commons.SlingRepositoryException;
import com.day.image.Layer;
import org.apache.commons.io.IOUtils;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ValueMap;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;

/**
 * Renders an image
 */
public class img_GET extends AbstractImageServlet {

    protected Layer createLayer(ImageContext c)
            throws RepositoryException, IOException {
        /* do not create the layer yet. handle everything later */
        return null;
    }

    protected void writeLayer(SlingHttpServletRequest req,
                              SlingHttpServletResponse resp,
                              ImageContext c, Layer layer)
            throws IOException, RepositoryException {

        Image image = new Image(c.resource);
        image.setItemName(Image.NN_FILE, "image");
        image.setItemName(Image.PN_REFERENCE, "imageReference");
        if (!image.hasContent()) {
            resp.sendError(HttpServletResponse.SC_NOT_FOUND);
            return;
        }
        /* get pure layer */
        layer = image.getLayer(false, false, false);

        /* do not re-encode layer, just spool */
        Property data = image.getData();
        InputStream in = data.getStream();
        resp.setContentLength((int) data.getLength());
        String contentType = image.getMimeType();
        if (contentType.equals("application/octet-stream")) {
            contentType=c.requestImageType;
        }
        resp.setContentType(contentType);
        IOUtils.copy(in, resp.getOutputStream());
        in.close();

        resp.flushBuffer();
    }
}

Contentpage 구성 요소에 로고 구성 요소 추가 adding-the-logo-component-to-the-contentpage-component

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage file 아래의 left.jsp을(를) 열고 다음 코드 행을 찾습니다.

    code language-xml 
    <div>logo</div>

  2. 해당 코드를 다음 코드 줄로 바꿉니다.

    code language-xml 
    <cq:include path="logo" resourceType="mywebsite/components/logo" />

  3. 변경 사항을 저장합니다.

  4. 브라우저에서 제품 페이지를 다시 로드합니다. 로고는 현재 기본 링크만 표시하지만 다음과 같이 표시됩니다.

    chlimage_1-48

페이지에서 로고 이미지 설정 setting-the-logo-image-in-a-page

이 섹션에서는 디자인 모드 대화 상자를 사용하여 이미지를 로고로 설정하는 방법에 대해 설명합니다.

  1. 브라우저에서 제품 페이지를 연 상태에서 Sidekick 하단의 디자인 단추를 클릭하여 디자인 모드로 전환합니다.

    오른쪽 사각형으로 표시된 디자인 단추

  2. 로고 표시줄의 디자인에서 편집 을 클릭하여 대화 상자를 통해 로고 구성 요소의 설정을 편집합니다.

  3. 대화 상자에서 이미지 탭의 패널을 클릭하고 mywebsite.zip 파일에서 추출한 logo.png 이미지를 찾은 다음 확인 을 클릭합니다.

    chlimage_1-49

  4. 편집 모드로 돌아가려면 Sidekick 제목 표시줄에서 삼각형을 클릭합니다.

    chlimage_1-3

  5. CRXDE Lite에서 다음 노드로 이동하여 저장된 속성 값을 확인합니다.

    /etc/designs/mywebsite/jcr:content/contentpage/logo

이동 경로 구성 요소 포함 including-the-breadcrumb-component

이 섹션에서는 기초 구성 요소 중 하나인 탐색 표시(트레일) 구성 요소를 포함합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage(으)로 이동하여 center.jsp 파일을 열고 다음 항목을 바꿉니다.

    code language-java 
    <div>trail</div>

    포함:

    code language-xml 
    <cq:include path="trail" resourceType="foundation/components/breadcrumb" />

  2. 변경 사항을 저장합니다.

  3. 브라우저에서 제품 1 페이지를 다시 로드합니다. 트레일 구성 요소는 다음과 같습니다.

    chlimage_1-50

제목 구성 요소 포함 including-the-title-component

이 섹션에서는 기초 구성 요소 중 하나인 제목 구성 요소를 포함합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage(으)로 이동하여 center.jsp 파일을 열고 다음 항목을 바꿉니다.

    code language-xml 
    <div>title</div>

    포함:

    code language-xml 
    <cq:include path="title" resourceType="foundation/components/title" />

  2. 변경 사항을 저장합니다.

  3. 브라우저에서 제품 페이지를 다시 로드합니다. 제목 구성 요소는 다음과 같습니다.

    chlimage_1-51

    참고: 편집 모드에서 다른 제목 및 유형/크기를 설정할 수 있습니다.

단락 시스템 구성 요소 포함 including-the-paragraph-system-component

단락 시스템(parsys)은 단락 목록을 관리하기 때문에 웹 사이트에서 중요한 부분입니다. 이를 통해 작성자는 페이지에 단락 구성 요소를 추가할 수 있으며 구조를 제공합니다.

parsys 구성 요소(foundation 구성 요소 중 하나)를 contentpage 구성 요소에 추가합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage(으)로 이동하여 center.jsp 파일을 열고 다음 코드 행을 찾습니다.

    code language-xml 
    <div>parsys</div>

  2. 해당 코드 행을 다음 코드로 바꾼 다음 변경 사항을 저장합니다.

    code language-xml 
    <cq:include path="par" resourceType="foundation/components/parsys" />

  3. 브라우저에서 제품 페이지를 새로 고칩니다. 이제 parsys 구성 요소가 있으며 이는 다음과 같이 표시됩니다.

    chlimage_1-52

이미지 구성 요소 만들기 creating-the-image-component

단락 시스템에 이미지를 표시하는 구성 요소를 만듭니다. 시간을 절약하기 위해 이미지 구성 요소는 일부 속성 변경 사항과 함께 로고 구성 요소의 사본으로 만들어집니다.

NOTE
Adobe Experience Manager은 더 많은 기능을 갖춘 이미지 구성 요소(/libs/foundation/components/image)를 제공합니다.

이미지 구성 요소 만들기 creating-the-image-component-1

  1. /apps/mywebsite/components/logo 노드를 마우스 오른쪽 단추로 클릭하고 복사를 클릭합니다.

  2. /apps/mywebsite/components 노드를 마우스 오른쪽 단추로 클릭하고 붙여넣기를 클릭합니다.

  3. Copy of logo 노드를 마우스 오른쪽 단추로 클릭하고 이름 바꾸기를 클릭한 다음 기존 텍스트를 삭제하고 image을(를) 입력합니다.

  4. image 구성 요소 노드를 선택하고 다음 속성 값을 변경합니다.

    • jcr:title: 내 이미지 구성 요소입니다.
    • jcr:description: 내 이미지 구성 요소입니다.

  5. 다음 속성 값을 사용하여 image 노드에 속성을 추가하십시오.

    • 이름: componentGroup
    • 유형: 문자열
    • 값: 내 웹 사이트

  6. image 노드 아래에서 design_dialog 노드의 이름을 dialog(으)로 바꿉니다.

  7. logo.jsp 이름을 image.jsp.(으)로 바꾸기

  8. img.GET.java를 열고 패키지를 apps.mywebsite.components.image(으)로 변경합니다.

chlimage_1-53

이미지 스크립트 만들기 creating-the-image-script

이 섹션에서는 이미지 스크립트를 만드는 방법을 설명합니다.

  1. /apps/mywebsite/components/image/ image.jsp 열기

  2. 기존 코드를 다음 코드로 바꾼 다음 변경 사항을 저장합니다.

    code language-xml 
    <%@include file="/libs/foundation/global.jsp"%><%
%><%@ page import="com.day.cq.commons.Doctype,
                    com.day.cq.wcm.foundation.Image,
                    com.day.cq.wcm.api.components.DropTarget,
                    com.day.cq.wcm.api.components.EditConfig,
                    com.day.cq.wcm.commons.WCMUtils" %><%
 /* global.jsp provides access to the current resource through the resource object */
        Image img = new Image(resource);
        img.setItemName(Image.NN_FILE, "image");
        img.setItemName(Image.PN_REFERENCE, "imageReference");
        img.setSelector("img");
        img.setDoctype(Doctype.fromRequest(request));
        img.setAlt("Home");
        img.draw(out); %>

  3. 변경 사항을 저장합니다.

이미지 cq:editConfig 노드 만들기 creating-the-image-cq-editconfig-node

cq:editConfig 노드 유형을 사용하면 속성을 편집할 때 구성 요소의 특정 동작을 구성할 수 있습니다.

이 섹션에서는 cq:editConfig 노드를 사용하여 콘텐츠 파인더의 자산을 이미지 구성 요소로 끌 수 있습니다.

  1. CRXDE Lite 시 /apps/mywebsite/components/image 노드 아래에 다음과 같이 노드를 만듭니다.

    • 이름: cq:editConfig.
    • 유형: cq:EditConfig.

  2. cq:editConfig 노드 아래에 다음과 같이 노드를 만듭니다.

    • 이름: cq:dropTargets
    • 유형: cq:DropTargetConfig.

  3. cq:dropTargets 노드 아래에서 다음과 같이 노드를 만듭니다.

    • 이름: 이미지
    • 유형: nt:unstructured.

  4. CRXDE에서 속성을 다음과 같이 설정합니다.

이름
유형
값
동의
문자열
image/(gif
그룹
문자열
미디어
propertyName
문자열
./imageReference

chlimage_1-54

아이콘 추가 adding-the-icon

이 섹션에서는 Sidekick에 나열될 때 이미지 구성 요소 옆에 표시되는 아이콘을 추가합니다.

  1. CRXDE Lite에서 /libs/foundation/components/image/icon.png 파일을 마우스 오른쪽 단추로 클릭하고 복사 ​를 선택합니다.
  2. /apps/mywebsite/components/image 노드를 마우스 오른쪽 단추로 클릭하고 붙여넣기 ​를 클릭한 다음 모두 저장 ​을 클릭합니다.

이미지 구성 요소 사용 using-the-image-component

이 섹션에서는 제품 페이지를 보고 이미지 구성 요소를 단락 시스템에 추가합니다.

  1. 브라우저에서 제품 페이지를 다시 로드합니다.

  2. Sidekick에서 디자인 모드 아이콘을 클릭합니다.

  3. 편집(Edit) 단추를 눌러 파트의 설계(Design) 대화상자를 편집합니다.

  4. 대화 상자에 허용된 구성 요소 목록이 표시됩니다. 내 웹 사이트 ​로 이동하여 내 이미지 구성 요소 ​를 선택하고 확인 ​을 클릭합니다.

  5. 편집 모드로 돌아갑니다.

  6. parsys 프레임을 두 번 클릭합니다(구성 요소 또는 자산을 여기로 드래그하십시오). 새 구성 요소 삽입 및 Sidekick 선택기는 다음과 같습니다.

    chlimage_1-4

도구 모음 구성 요소 포함 including-the-toolbar-component

이 단원에서는 기초 구성 요소 중 하나인 도구 모음 구성 요소를 포함합니다.

편집 모드와 디자인 모드에는 몇 가지 옵션이 있습니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage(으)로 이동하여 body.jsp 파일을 열고 다음 코드를 찾습니다.

    code language-java 
    <div class="toolbar">toolbar</div>

  2. 해당 코드를 다음 코드로 바꾸고 변경 사항을 저장합니다.

    code language-java 
    <cq:include path="toolbar" resourceType="foundation/components/toolbar"/>

  3. AEM 웹 사이트 페이지의 폴더 트리에서 웹 사이트/내 웹 사이트/영어를 선택한 다음 새로 만들기 > 새 페이지를 클릭합니다. 다음 속성 값을 지정하고 [만들기]를 클릭합니다.

    • 제목: 도구 모음
    • 내 웹 사이트 컨텐츠 페이지 템플릿 선택

  4. 페이지 목록에서 도구 모음 페이지를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다. 탐색에서 숨기기를 선택하고 확인을 클릭합니다.

    탐색 숨기기 옵션을 사용하면 topnav 및 listchildren과 같은 탐색 구성 요소에 페이지가 표시되지 않습니다.

  5. 도구 모음에서 다음 페이지를 만듭니다.

    • 연락처
    • 피드백
    • 로그인
    • 검색

  6. 브라우저에서 제품 페이지를 다시 로드합니다. 이는 다음과 같습니다.

    chlimage_1-55

검색 구성 요소 만들기 creating-the-search-component

이 섹션에서는 웹 사이트에서 컨텐츠를 검색하는 구성 요소를 만듭니다. 이 검색 구성 요소는 모든 페이지의 단락 시스템(예: 특수 검색 결과 페이지)에 배치할 수 있습니다.

완료되면 검색 입력란은 영어 페이지에서 다음과 같이 표시됩니다.

chlimage_1-56

검색 구성 요소 만들기 creating-the-search-component-1

  1. CRXDE Lite에서 /apps/mywebsite/components을(를) 마우스 오른쪽 단추로 클릭하고 만들기 ​를 선택한 다음 구성 요소 만들기 ​를 선택합니다.

  2. 대화 상자를 사용하여 구성 요소를 구성합니다.

    1. 첫 번째 패널에서 다음 속성 값을 지정합니다.

      • 레이블: 검색
      • 제목: 내 검색 구성 요소
      • 설명: 내 검색 구성 요소입니다
      • 그룹: 내 웹 사이트

    2. 다음 을 클릭한 후 다음 을 다시 클릭합니다.

    3. [허용된 부모] 패널에서 + 단추를 클릭하고 */parsys을(를) 입력합니다.

    4. 다음 을 클릭한 다음 확인 을 클릭합니다.

  3. 모두 저장을 클릭합니다.

  4. 다음 노드를 복사하여 apps/mywebsite/components/search 노드에 붙여넣습니다.

    • /libs/foundation/components/search/dialog

    • "/libs/foundation/components/search/i18n

    • /libs/foundation/components/search/icon.png

  5. 모두 저장을 클릭합니다.

검색 스크립트 만들기 creating-the-search-script

이 섹션에서는 검색 스크립트를 만드는 방법을 설명합니다.

  1. /apps/mywebsite/components/search/search.jsp 파일을 엽니다.

  2. search.jsp에 다음 코드를 복사합니다.

    code language-java 
    <%@ page import="com.day.cq.wcm.foundation.Search,com.day.cq.tagging.TagManager" %>
<%@include file="/libs/foundation/global.jsp" %><%
%><cq:setContentBundle/><%
    Search search = new Search(slingRequest);

    String searchIn = (String) properties.get("searchIn");
    String requestSearchPath = request.getParameter("path");
    if (searchIn != null) {
        /* only allow the "path" request parameter to be used if it
         is within the searchIn path configured */
        if (requestSearchPath != null && requestSearchPath.startsWith(searchIn)) {
            search.setSearchIn(requestSearchPath);
        } else {
            search.setSearchIn(searchIn);
        }
    } else if (requestSearchPath != null) {
        search.setSearchIn(requestSearchPath);
    }

    pageContext.setAttribute("search", search);
    TagManager tm = resourceResolver.adaptTo(TagManager.class);
%><c:set var="trends" value="${search.trends}"/><%
%><center>
  <form action="${currentPage.path}.html">
    <input size="41" maxlength="2048" name="q" value="${fn:escapeXml(search.query)}"/>
    <input value="<fmt:message key="searchButtonText"/>" type="submit" />
  </form>
</center>
<br/>
<c:set var="result" value="${search.result}"/>
<c:choose>
  <c:when test="${empty result && empty search.query}">
  </c:when>
  <c:when test="${empty result.hits}">
    <c:if test="${result.spellcheck != null}">
      <p><fmt:message key="spellcheckText"/> <a href="<c:url value="${currentPage.path}.html"><c:param name="q" value="${result.spellcheck}"/></c:url>"><b><c:out value="${result.spellcheck}"/></b></a></p>
    </c:if>
    <fmt:message key="noResultsText">
      <fmt:param value="${fn:escapeXml(search.query)}"/>
    </fmt:message>
  </c:when>
  <c:otherwise>
    <p class="searchmeta">Results ${result.startIndex + 1} - ${result.startIndex + fn:length(result.hits)} of ${result.totalMatches} for <b>${fn:escapeXml(search.query)}</b>. (${result.executionTime} seconds)</p>
   <br/>

  <div class="searchresults">
    <div class="results">
      <c:forEach var="hit" items="${result.hits}" varStatus="status">
        <div class="hit">
        <a href="${hit.URL}">${hit.title}</a>
        <div class="excerpt">${hit.excerpt}</div>
       <div class="hiturl"> ${hit.URL}<c:if test="${!empty hit.properties['cq:lastModified']}"> - <c:catch><fmt:formatDate value="${hit.properties['cq:lastModified'].time}" dateStyle="medium"/></c:catch></c:if> - <a href="${hit.similarURL}"><fmt:message key="similarPagesText"/></a>
        </div></div>
      </c:forEach>
    </div>
      <br/>

     <div class="searchRight">
          <c:if test="${fn:length(trends.queries) > 0}">
              <p><fmt:message key="searchTrendsText"/></p>
              <div class="searchTrends">
                  <c:forEach var="query" items="${trends.queries}">
                      <a href="<c:url value="${currentPage.path}.html"><c:param name="q" value="${query.query}"/></c:url>"><span style="font-size:${query.size}px"><c:out value="${query.query}"/></code></a>
                  </c:forEach>
              </div>
          </c:if>
          <c:if test="${result.facets.languages.containsHit}">
              <p>Languages</p>
              <c:forEach var="bucket" items="${result.facets.languages.buckets}">
                  <c:set var="bucketValue" value="${bucket.value}"/>
                  <c:set var="label" value='<%= new java.util.Locale((String) pageContext.getAttribute("bucketValue")).getDisplayLanguage(request.getLocale()) %>'/>
                  <c:choose>
                      <c:when test="${param.language != null}">${label} (${bucket.count}) - <a href="<cq:requestURL><cq:removeParam name="language"/></cq:requestURL>">remove filter</a></c:when>
                      <c:otherwise><a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a></c:otherwise>
                  </c:choose><br/>
              </c:forEach>
          </c:if>
          <c:if test="${result.facets.tags.containsHit}">
              <p>Tags</p>
              <c:forEach var="bucket" items="${result.facets.tags.buckets}">
                  <c:set var="bucketValue" value="${bucket.value}"/>
                  <c:set var="tag" value="<%= tm.resolve((String) pageContext.getAttribute("bucketValue")) %>"/>
                  <c:if test="${tag != null}">
                      <c:set var="label" value="${tag.title}"/>
                      <c:choose>
                          <c:when test="<%= request.getParameter("tag") != null && java.util.Arrays.asList(request.getParameterValues("tag")).contains(pageContext.getAttribute("bucketValue")) %>">${label} (${bucket.count}) - <a href="<cq:requestURL><cq:removeParam name="tag" value="${bucket.value}"/></cq:requestURL>">remove filter</a></c:when>
                          <c:otherwise><a title="filter results" href="<cq:requestURL><cq:addParam name="tag" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a></c:otherwise>
                      </c:choose><br/>
                  </c:if>
              </c:forEach>
          </c:if>
          <c:if test="${result.facets.mimeTypes.containsHit}">
              <jsp:useBean id="fileTypes" class="com.day.cq.wcm.foundation.FileTypes"/>
              <p>File types</p>
              <c:forEach var="bucket" items="${result.facets.mimeTypes.buckets}">
                  <c:set var="bucketValue" value="${bucket.value}"/>
                  <c:set var="label" value="${fileTypes[bucket.value]}"/>
                  <c:choose>
                      <c:when test="<%= request.getParameter("mimeType") != null && java.util.Arrays.asList(request.getParameterValues("mimeType")).contains(pageContext.getAttribute("bucketValue")) %>">${label} (${bucket.count}) - <a href="<cq:requestURL><cq:removeParam name="mimeType" value="${bucket.value}"/></cq:requestURL>">remove filter</a></c:when>
                      <c:otherwise><a title="filter results" href="<cq:requestURL><cq:addParam name="mimeType" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a></c:otherwise>
                  </c:choose><br/>
              </c:forEach>
          </c:if>
          <c:if test="${result.facets.lastModified.containsHit}">
              <p>Last Modified</p>
              <c:forEach var="bucket" items="${result.facets.lastModified.buckets}">
                  <c:choose>
                      <c:when test="${param.from == bucket.from && param.to == bucket.to}">${bucket.value} (${bucket.count}) - <a href="<cq:requestURL><cq:removeParam name="from"/><cq:removeParam name="to"/></cq:requestURL>">remove filter</a></c:when>
                      <c:otherwise><a title="filter results" href="<cq:requestURL><cq:removeParam name="from"/><cq:removeParam name="to"/><c:if test="${bucket.from != null}"><cq:addParam name="from" value="${bucket.from}"/></c:if><c:if test="${bucket.to != null}"><cq:addParam name="to" value="${bucket.to}"/></c:if></cq:requestURL>">${bucket.value} (${bucket.count})</a></c:otherwise>
                  </c:choose><br/>
              </c:forEach>
          </c:if>

      <c:if test="${fn:length(search.relatedQueries) > 0}">

       <br/><br/><div class="related">
        <fmt:message key="relatedSearchesText"/>
        <c:forEach var="rq" items="${search.relatedQueries}">
            <a href="${currentPage.path}.html?q=${rq}"><c:out value="${rq}"/></a>
        </c:forEach></div>
      </c:if>
      </div>

      <c:if test="${fn:length(result.resultPages) > 1}">
        <div class="pagination">
            <fmt:message key="resultPagesText"/>
        <c:if test="${result.previousPage != null}">
          <a href="${result.previousPage.URL}"><fmt:message key="previousText"/></a>
        </c:if>
        <c:forEach var="page" items="${result.resultPages}">
          <c:choose>
            <c:when test="${page.currentPage}">${page.index + 1}</c:when>
            <c:otherwise>
              <a href="${page.URL}">${page.index + 1}</a>
            </c:otherwise>
          </c:choose>
        </c:forEach>
        <c:if test="${result.nextPage != null}">
          <a href="${result.nextPage.URL}"><fmt:message key="nextText"/></a>
        </c:if>
        </div>
      </c:if>
      </div>

  </c:otherwise>
</c:choose>

  3. 변경 사항을 저장합니다.

Contentpage 구성 요소에 검색 상자 포함 including-a-search-box-in-the-contentpage-component

콘텐츠 페이지의 왼쪽 섹션에 검색 입력 상자를 포함하려면 다음과 같이 진행합니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage 아래의 left.jsp 파일을 열고 다음 코드(2행)를 찾습니다.

    code language-xml 
    %><div class="left">

  2. 해당 줄에 이전 코드를 삽입합니다.

    code language-java 
    %><%@ page import="com.day.text.Text"%><%
%><% String docroot = currentDesign.getPath();
String home = Text.getAbsoluteParent(currentPage.getPath(), 2);%><%

  3. 다음 코드 행을 찾습니다.

    code language-xml 
    <div>search</div>

  4. 해당 코드를 다음 코드로 바꾸고 변경 사항을 저장합니다.

    code language-java 
    <div class="form_1">
     <form class="geo" action="<%= home %>/toolbar/search.html" id="form" >
          <p>
               <input class="geo" type="text" name="q"><br>
               <a href="<%= home %>/toolbar/search.html" class="link_1">advanced search</a>
          </p>
     </form>
</div>

  5. 브라우저에서 제품 페이지를 다시 로드합니다. 검색 구성 요소는 다음과 같습니다.

    chlimage_1-57

검색 페이지에 검색 구성 요소 포함 including-the-search-component-in-the-search-page

이 섹션에서는 검색 구성 요소를 단락 시스템에 추가합니다.

  1. 브라우저에서 검색 페이지를 엽니다.

  2. Sidekick에서 디자인 모드 아이콘을 클릭합니다.

  3. 검색 제목 아래의 조각 블록 디자인에서 편집 을 클릭합니다.

  4. 대화 상자에서 내 웹 사이트 그룹으로 스크롤하고 내 검색 구성 요소 ​를 선택한 다음 확인 ​을 클릭합니다.

  5. Sidekick 시 삼각형을 클릭하여 편집 모드로 돌아갑니다.

  6. Sidekick에서 내 검색 구성 요소를 parsys 프레임으로 드래그합니다. 이는 다음과 같습니다.

    chlimage_1-58

  7. 제품 페이지로 이동합니다. 입력란에서 고객을 검색하고 Enter 키를 누릅니다. 검색 페이지로 리디렉션됩니다. 미리 보기 모드로 전환: 출력은 다음과 유사한 형식입니다.

    chlimage_1-59

Iparsys 구성 요소 포함 including-the-iparsys-component

이 섹션에서는 기초 구성 요소 중 하나인 상속 단락 시스템(iparsys) 구성 요소를 포함합니다. 이 구성 요소를 사용하면 상위 페이지에 단락 구조를 만들고 하위 페이지에 단락이 상속되도록 할 수 있습니다.

이 구성 요소의 경우 편집 모드와 디자인 모드 모두에서 여러 매개 변수를 설정할 수 있습니다.

  1. CRXDE Lite에서 /apps/mywebsite/components/contentpage(으)로 이동하여 right.jsp 파일을 열고 다음 항목을 바꿉니다.

    code language-java 
    <div>iparsys</div>

    포함:

    code language-java 
    <cq:include path="rightpar" resourceType="foundation/components/iparsys" />

  2. 변경 사항을 저장합니다.

  3. 브라우저에서 ​ 제품 페이지를 다시 로드합니다. 전체 페이지는 다음과 같습니다.

    chlimage_1-5

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2