完全な機能を備えた Web サイトの作成(JSP)

注意

この記事では、JSP とクラシック UI を使用して Web サイトを作成する方法について説明します。アドビでは、AEM Sites の開発の手引きで詳しく説明しているように、Web サイトに最新の AEM テクノロジーを利用することをお勧めします。

このチュートリアルでは、Adobe Experience Manager(AEM)を使用して完全な機能を備えた Web サイトを作成できます。この Web サイトは汎用の Web サイトをベースとし、主に Web 開発者をターゲットとしています。開発はすべて、オーサー環境内でおこなわれます。

このチュートリアルでは、次の方法を説明します。

  1. AEM をインストールします。

  2. CRXDE Lite(開発環境)にアクセスします。

  3. CRXDE Lite でプロジェクトの構造を設定します。

  4. コンテンツページ作成の基礎として使用するテンプレート、コンポーネントおよびスクリプトを作成します。

  5. Web サイトのルートページを作成し、次にコンテンツページを作成します。

  6. ページで使用する以下のコンポーネントを作成します。

    • 上部ナビゲーション
    • リストの子
    • ロゴ
    • 画像
    • テキスト画像
    • 検索
  7. 様々な基盤コンポーネントを含めます。

すべての手順を実行後、ページは次のようになります。

chlimage_1-99

最終結果のダウンロード

演習をおこなわずにチュートリアルに従う場合は、website-1.0.zip をダウンロードします。このファイルは、このチュートリアルの結果を含む AEM コンテンツパッケージです。パッケージマネージャーを使用して、オーサーインスタンスにパッケージをインストールします。

メモ

このパッケージをインストールすると、このチュートリアルを使用して作成したオーサーインスタンス上のリソースが上書きされます。

Web サイトコンテンツパッケージ

ファイルを入手

Adobe Experience Manager のインストール

Webサイトを開発するためのAEMインスタンスをインストールするには、オーサーインスタンスとパブリッシュインスタンスを使用したデプロイメント環境の設定手順に従うか、一般的なインストールを実行します。一般的なインストールでは、AEM Quickstart JARファイルをダウンロードし、license.propertiesファイルをJARファイルと同じディレクトリに配置して、JARファイルをダブルクリックします。

AEM をインストールしたら、ようこそページで CRXDE Lite のリンクをクリックして CRXDE Lite 開発環境にアクセスします。

chlimage_1-100

メモ

デフォルトのポートを使用してローカルにインストールされるAEMオーサリングインスタンスのCRXDE LiteのURLはhttp://localhost:4502/crx/de/です。

CRXDE Lite でのプロジェクト構造の設定

CRXDE Lite を使用して、リポジトリ内に mywebsite アプリケーション構造を作成します。

  1. CRXDE Liteーの左側にあるツリーで、/apps​フォルダーを右クリックし、作成/フォルダーを作成​をクリックします。 フォルダーを作成​ダイアログで、フォルダー名に「mywebsite」と入力し、「OK」をクリックします。

  2. /apps/mywebsiteフォルダーを右クリックし、作成/フォルダーを作成​をクリックします。 フォルダーを作成​ダイアログで、フォルダー名に「components」と入力し、「OK」をクリックします。

  3. /apps/mywebsiteフォルダーを右クリックし、作成/フォルダーを作成​をクリックします。 フォルダーを作成​ダイアログで、フォルダー名に「templates」と入力し、「OK」をクリックします。

    ツリー内の構造は次のようになります。

    chlimage_1-101

  4. すべて保存」をクリックします。

デザインの設定

ここでは、デザイナーツールを使用してアプリケーションのデザインを作成します。デザインによって、Web サイトに CSS リソースおよび画像リソースが提供されます。

メモ

次のリンクをクリックしてmywebsite.zipをダウンロードします。アーカイブには、デザイン用のstatic.cssファイルと画像ファイルが含まれます。

サンプルの static.css ファイルおよび画像

ファイルを入手

  1. AEM のようこそページで、「ツール」をクリックします(http://localhost:4502/libs/cq/core/content/welcome.html)。

    chlimage_1-102

  2. フォルダーツリーで、Designs​フォルダーを選択し、新規/新しいページ​をクリックします。 タイトルに「mywebsite」と入力し、「作成」をクリックします。

  3. mywebsite という項目がテーブルに表示されない場合は、ツリーまたはテーブルを更新します。

  4. http://localhost:4502にあ るURLへのWebDAVアクセスを使用して、ダウンロードしたmywebsite.zipファイ static.css ルから images フォルダーにサンプルファイルとフォルダーをコピー /etc/designs/mywebsite します。

    chlimage_1-103

contentpageテンプレート、コンポーネント、スクリプトの作成

ここでは、以下を作成します。

  • サンプル Web サイトのコンテンツページを作成する際に使用する contentpage テンプレート
  • コンテンツのページをレンダリングする際に使用する contentpage コンポーネント
  • contentpage スクリプト

contentpage テンプレートの作成

サイトの Web ページの基礎として使用するテンプレートを作成します。

テンプレートは、新しいページのデフォルトのコンテンツを定義するものです。複雑な Web サイトでは、複数のテンプレートを使用して、サイト内の様々なタイプのページを作成する場合があります。この演習では、すべてのページを 1 つの単純なテンプレートに基づいて作成します。

  1. CRXDE Liteーのフォルダーツリーで、/apps/mywebsite/templatesを右クリックし、作成/テンプレートを作成​をクリックします。

  2. テンプレートを作成ダイアログで、次の値を入力し、「次へ」をクリックします。

    • ラベル:contentpage
    • タイトル:My Website Content Page Template
    • 説明:This is my Website Content Page Template
    • リソースタイプ:mywebsite/components/contentpage

    「ランキング」プロパティにはデフォルト値を使用します。

    chlimage_1-104

    リソースタイプは、ページをレンダリングするコンポーネントを識別します。 この場合、contentpageテンプレートを使用して作成されたすべてのページがmywebsite/components/contentpageコンポーネントによってレンダリングされます。

  3. このテンプレートを使用できるページのパスを指定するには、プラスボタンをクリックし、表示されるテキストボックスに/content(/.*)?と入力します。 次に、「次へ」をクリックします。

    chlimage_1-105

    許可されているパスプロパティの値は、正規表現です。​式に一致するパスを持つページでテンプレートを使用できます。 この場合、正規表現は/contentフォルダーとすべてのサブページのパスに一致します。

    作成者が/contentの下にページを作成すると、使用可能なテンプレートのリストに​contentpage​テンプレートが表示されます。

  4. 許可された親​パネルおよび​許可されている子​パネルで「次へ」をクリックして、「OK」をクリックします。CRXDE Lite で、「すべて保存」をクリックします。

    chlimage_1-106

contentpage コンポーネントの作成

コンテンツを定義し、contentpage テンプレートを使用するコンポーネントを作成します。**​コンポーネントの場所は、contentpage テンプレートの「リソースタイプ」プロパティの値と一致する必要があります。

  1. CRXDE Liteで、/apps/mywebsite/componentsを右クリックし、作成/コンポーネント​をクリックします。

  2. コンポーネントを作成​ダイアログで、以下のプロパティ値を入力します。

    • ラベル:contentpage
    • タイトル:My Website Content Page Component
    • 説明:This is My Website Content Page Component

    chlimage_1-107

    新しいコンポーネントの場所は/apps/mywebsite/components/contentpageです。 このパスは、contentpageテンプレートのリソースタイプ(パスの最初の/apps/部分を除く)に対応します。

    この一致は、テンプレートをコンポーネントと結び付けるものなので、Web サイトを正常に機能させるために重要です。

  3. 「次へ」をクリックして、ダイアログの「許可されている子」パネルが表示されたら、「OK」をクリックします。CRXDE Liteで、「すべて保存」をクリックします。

    この時点で構造は次のようになります。

    chlimage_1-108

contentpage コンポーネントスクリプトの開発

contentpage.jsp スクリプトにコードを追加してページコンテンツを定義します。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpagecontentpage.jspファイルを開きます。 このファイルには、デフォルトで次のコードが含まれています。

    <%--
    
      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 のデフォルトコードの後に貼り付けます。

    <%@ 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. すべて保存」をクリックして変更を保存します。

Web サイトページおよびコンテンツページの作成

このセクションでは、次のページを作成し、すべてcontentpageテンプレートを使用します。私のWebサイト、英語、製品、サービス、お客様。

  1. AEM のようこそページ(http://localhost:4502/libs/cq/core/content/welcome.html)で、「Web サイト」をクリックします。

    chlimage_1-109

  2. フォルダーツリーで、Webサイト​フォルダーを選択し、新規/新しいページ​をクリックします。

  3. ページを作成​ウィンドウで、以下を入力します。

    • タイトル: My Website
    • 名前mywebsite
    • My Website Content Page Template」を選択します。

    chlimage_1-110

  4. 作成」をクリックします。フォルダーツリーで、/Websites/My Websiteページを選択し、新規/新しいページ​をクリックします。

  5. ページを作成​ダイアログで、以下のプロパティ値を入力して「作成」をクリックします。

    • タイトル:英語
    • 名前:en
    • My Website Content Page Template」を選択します。
  6. フォルダーツリーで、/Websites/My Website/Englishページを選択し、新規/新しいページ​をクリックします。

  7. ページを作成​ダイアログで、以下のプロパティ値を入力して「作成」をクリックします。

    • タイトル:製品
    • My Website Content Page Template」を選択します。
  8. フォルダーツリーで、/Websites/My Website/Englishページを選択し、新規/新しいページ​をクリックします。

  9. ページを作成​ダイアログで、以下のプロパティ値を入力して「作成」をクリックします。

    • タイトル:サービス
    • My Website Content Page Template」を選択します。
  10. フォルダーツリーで、/Websites/My Website/Englishページを選択し、新規/新しいページ​をクリックします。

  11. ページを作成​ダイアログで、以下のプロパティ値を入力して「作成」をクリックします。

    • タイトル:お客様
    • My Website Content Page Template」を選択します。

    構造は次のようになります。

    chlimage_1-111

  12. ページをmywebsiteデザインにリンクするには、「CRXDE Lite」で/content/mywebsite/en/jcr:contentノードを選択します。 「プロパティ」タブで、新しいプロパティに次の値を入力し、「追加」をクリックします。

    • 名前:cq:designPath
    • 種類:string
    • :/etc/designs/mywebsite

    chlimage_1-112

  13. 新しいWebブラウザーのタブまたはウィンドウで、http://localhost:4502/content/mywebsite/en/products.htmlを開いて、製品ページを表示します。

    chlimage_1-113

contentpage スクリプトの機能強化

ここでは、AEM 基盤コンポーネントのスクリプトを使用し、独自のスクリプトを作成することによって contentpage スクリプトの機能を強化する方法について説明します。

Products ページは次のようになります。

chlimage_1-4

基盤ページスクリプトの使用

この演習では、ページコンテンツコンポーネントを設定して、そのスーパータイプがAEM Pageコンポーネントになるようにします。コンポーネントはスーパータイプの機能を継承するので、ページコンテンツはページコンポーネントのスクリプトとプロパティを継承します。

例えば、自分のコンポーネントの JSP コード内で、スーパータイプコンポーネントによって提供されているスクリプトを、自分のコンポーネントに含まれているかのように参照できます。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageノードにプロパティを追加します。

    1. /apps/mywebsite/components/contentpageノードを選択します。

    2. 「プロパティ」タブの下部で、次のプロパティ値を入力し、「追加」をクリックします。

      • 名前:sling:resourceSuperType
      • 種類:string
      • :foundation/components/page
    3. すべて保存」をクリックします。

  2. /apps/mywebsite/components/contentpageの下のcontentpage.jspファイルを開き、既存のコードを次のコードで置き換えます。

    <%@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. ブラウザーで、Products​ページを再読み込みします。次のようになります。

    chlimage_1-5

    ページソースを開いて、head.jsp スクリプトと body.jsp スクリプトによって生成された JavaScript および HTML の要素を確認します。以下のスクリプトスニペットを指定すると、ページを開いたときにサイドキックが開きます。

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

独自のスクリプトの使用

ここでは、それぞれページ本体の一部を生成する複数のスクリプトを作成します。次に、pagecontent コンポーネントで body.jsp ファイルを作成して、AEM のページコンポーネントの body.jsp を上書きします。作成する body.jsp ファイルには、ページ本体の様々な部分を生成するスクリプトを含めます。

ヒント:​コンポーネントのスーパータイプ内のファイルと同じ名前で相対的な場所も同じファイルがコンポーネントに含まれている場合、これをオーバーレイと呼びます。**

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageの下にleft.jspファイルを作成します。

    1. ノード/apps/mywebsite/components/contentpageを右クリックし、「作成」を選択してから、「ファイルを作成」を選択します。
    2. ウィンドウで、「名前」に「left.jsp」と入力し、「OK」をクリックします。
  2. left.jsp ファイルを編集して、既存のコンテンツを削除し、以下のコードに置き換えます。

    <%@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」に「名前」と入力し、「OK」をクリックします。
  5. ファイルcenter.jspを編集して、既存のコンテンツを削除し、次のコードに置き換えます。

    <%@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名前​」に と入力して、「OK」をクリックします。
  8. right.jsp ファイルを編集して、既存のコンテンツを削除し、以下のコードに置き換えます。

    <%@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 ファイルを編集して、既存のコンテンツを削除し、以下のコードに置き換えます。

    <%@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. ブラウザーで、Products​ページを再読み込みします。次のようになります。

    chlimage_1-6

上部ナビゲーションコンポーネントの作成

ここでは、ナビゲーションを簡単にするために、Web サイトのすべての最上位ページへのリンクを表示するコンポーネントを作成します。このコンポーネントのコンテンツは、contentpage テンプレートを使用して作成されたすべてのページの上部に表示されます。

上部ナビゲーションコンポーネント(topnav)の最初のバージョンでは、ナビゲーション項目はテキストリンクのみです。2 番目のバージョンでは、画像ナビゲーションリンクと共に topnav を実装します。

上部ナビゲーションは次のようになります。

chlimage_1-114

上部ナビゲーションコンポーネントの作成

  1. CRXDE Liteで/apps/mywebsite/componentsを右クリックし、「作成」を選択してから、「コンポーネントを作成」を選択します。

  2. コンポーネントを作成​ウィンドウで、以下を入力します。

    • ラベル: topnav
    • タイトル: My Top Navigation Component
    • 説明: This is My Top Navigation Component
  3. 次へ」を数回クリックして最後のウィンドウに移動し、「OK」をクリックします。変更内容を保存します。

topnav にレンダリングスクリプトを追加して、子ページへのテキストリンクを生成します。

  1. CRXDE Liteで、/apps/mywebsite/components/topnavの下のtopnav.jspファイルを開きます。

  2. 以下のコードをコピー&ペーストして、ファイル内のコードを置き換えます。

    <%@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 コンポーネントに上部ナビゲーションを含める

contentpage コンポーネントに topnav を含めるには:

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageの下のbody.jspを開き、

    <div class="topnav">topnav</div>
    

    を次のように置き換えます。

    <cq:include path="topnav" resourceType="mywebsite/components/topnav" />
    
  2. 変更内容を保存します。

  3. ブラウザーで、Products​ページを再読み込みします。 上部のナビゲーションは次のように表示されます。

    chlimage_1-115

サブタイトルを含めたページの強化

ページ​コンポーネントは、ページのサブタイトルを指定できるプロパティを定義します。ページコンテンツに関する情報を提供するサブタイトルを追加します。

  1. ブラウザーで、Products​ページを開きます。

  2. サイドキックの「ページ」タブで、「ページのプロパティ」をクリックします。

  3. ダイアログの「基本」タブで、「詳細なタイトルと説明」を展開し、「サブタイトル」プロパティにwhat we doと入力します。「OK」をクリックします。

  4. 上記の手順を繰り返して、サービス​に関するサブタイトル​を​サービス​ページに追加します。

  5. 上記の手順を繰り返して、得た信頼を​顧客​ページに追加します。

    ヒント: CRXDE Lite で、/content/mywebsite/en/products/jcr:content ノードを選択して、サブタイトルプロパティが追加されていることを確認します。

ハイパーテキストの代わりに画像リンクを使用してナビゲーションを制御するように、topnav コンポーネントのレンダリングスクリプトを強化します。画像には、リンクターゲットのタイトルとサブタイトルが含まれます。

この演習では、Sling の要求処理を実証します。ページナビゲーションリンクに使用する画像を動的に生成するスクリプトを呼び出すように topnav.jsp スクリプトを変更します。この演習では、Sling で画像ソースファイルの URL を解析し、画像のレンダリングに使用するスクリプトを特定します。

例えば、Products ページへの画像リンクのソースは、http://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:resourceTypemywebsite/components/contentpageと判断します。

  4. Sling が、このコンポーネント内で、URL セレクター(navimage)およびファイル名拡張子(png)に最も一致するスクリプトを見つけます。

この演習では、Sling はこれらの URL を、ユーザーが作成する /apps/mywebsite/components/contentpage/navimage.png.java スクリプトと照合します。

  1. CRXDE Liteで、/apps/mywebsite/components/topnav.の下のtopnav.jspを開き、アンカー要素(14行目)のコンテンツを見つけます。

    <%=child.getTitle() %>
    
  2. アンカーのコンテンツを以下のコードに置き換えます。

    <img alt="<%= child.getTitle() %>" src="<%= child.getPath() %>.navimage.png">
    
  3. 変更内容を保存します。

  4. /apps/mywebsite/components/contentpage ノードを右クリックして、作成/ファイルを作成​をクリックします。

  5. ファイルを作成​ウィンドウで、「名前」にnavimage.png.javaと入力します。

    .javaファイル名拡張子は、Slingに対し、Apache Sling Scripting Java Supportを使用してスクリプトをコンパイルし、サーブレットを作成する必要があることを示します。

  6. 次のコードをnavimage.png.java.にコピーします。このコードは、AbstractImageServletクラスを拡張します。

    • AbstractImageServlet は、現在のリソースのプロパティを格納する ImageContext オブジェクトを作成します。
    • リソースの親ページは、ImageContext オブジェクトから抽出されます。その後、ページのタイトルとサブタイトルが取得されます。
    • ImageHelper は、サイトデザイン、ページタイトルおよびページサブタイトルの navimage_bg.jpg ファイルから画像を生成するために使用します。
    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. ブラウザーで、Products​ページを再読み込みします。上部ナビゲーションが次のように表示されます。

    screen_shot_2012-03-07at10047pm

リストの子コンポーネントの作成

ページ(製品ページなど)のタイトル、説明および日付を含むページリンクのリストを生成するリストの子(listchildren)コンポーネントを作成します。このリンクのターゲットは、現在のページの、またはコンポーネントのダイアログで指定されているルートページの子ページです。

chlimage_1-116

製品ページの作成

Products​ページの下に2つのページを作成します。2つの特定の製品を説明する各ページに、タイトル、説明、日付を設定します。

  1. Webサイト​ページのフォルダーツリーで、Websites/My Website/English/Products​項目を選択し、新規/新しいページ​をクリックします。

  2. ダイアログで、次のプロパティ値を入力し、「作成」をクリックします。

    • タイトル:製品1.
    • 名前:product1.
    • My Website Content Page Template」を選択します。
  3. 以下のプロパティ値を使用して、Products の下にもう 1 つのページを作成します。

    • タイトル:製品2
    • 名前:product2
    • My Website Content Page Template」を選択します。
  4. CRXDE Lite で、Product 1 ページの説明と日付を設定します。

    1. /content/mywebsite/en/products/product1/jcr:contentノードを選択します。

    2. プロパティ」タブで、以下の値を入力します。

      • 名前jcr:description
      • String
      • : This is a description of the Product 1!.
    3. 追加」をクリックします。

    4. プロパティ」タブで、以下の値を使用してもう 1 つのプロパティを作成します。

      • 名前:日付
      • 種類:string
      • :02/14/2008
      • 追加」をクリックします。
    5. すべて保存」をクリックします。

  5. CRXDE Lite で、Product 2 ページの説明と日付を設定します。

    1. /content/mywebsite/en/products/product2/jcr:contentノードを選択します。

    2. プロパティ」タブで、以下の値を入力します。

      • 名前:jcr:description
      • 種類:string
      • :これは製品2の説明です。
    3. 追加」をクリックします。

    4. 同じテキストボックスで、前の値を以下の値に置き換えます。

      • 名前:日付
      • 種類:string
      • :05/11/2012
      • 追加」をクリックします。
    5. すべて保存」をクリックします。

リストの子コンポーネントの作成

listchildren コンポーネントを作成するには:

  1. CRXDE Liteで/apps/mywebsite/componentsを右クリックし、「作成」を選択してから、「コンポーネントを作成」を選択します。

  2. ダイアログで、次のプロパティ値を入力し、「次へ」をクリックします。

    • ラベル:listchildren.
    • タイトル:My Listchildrenコンポーネント。
    • 説明:これはMy Listchildrenコンポーネントです。
  3. 引き続き「次へ」をクリックして、「許可されている子」パネルが表示されたら、「OK」をクリックします。

リストの子スクリプトの作成

listchildren コンポーネントのスクリプトを開発します。

  1. CRXDE Liteで、/apps/mywebsite/components/listchildrenの下のlistchildren.jspファイルを開きます。

  2. デフォルトのコードを以下のコードに置き換えます。

    <%@include file="/libs/foundation/global.jsp"%><%
    %><%@ page import="java.util.Iterator,
             com.day.cq.wcm.api.PageFilter"%><%
         /* Create a new 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 %></span><br>
                 <%= child.getProperties().get("jcr:description","") %><br>
                 </div><%
             }
         }
     %>
    
  3. 変更内容を保存します。

リストの子ダイアログの作成

listchildren コンポーネントのプロパティを設定する際に使用するダイアログを作成します。

  1. listchildren コンポーネントの下に dialog ノードを作成します。

    1. CRXDE Liteで、/apps/mywebsite/components/listchildrenノードを右クリックし、作成/ダイアログを作成​をクリックします。

    2. ダイアログで、以下のプロパティ値を入力して「OK」をクリックします。

      • ラベル: dialog
      • タイトル: Edit ComponentOK」をクリックします。

    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-117

  4. tab1​ノードを選択し、作成/ノードを作成​をクリックし、次のプロパティ値を入力して、「OK」をクリックします。

    • 名前:items
    • タイプ:cq:WidgetCollection

    screen_shot_2012-03-07at51018pm

  5. 以下のプロパティ値を使用して、items ノードの下にノードを作成します。

    • 名前:リストロ
    • タイプ:cq:Widget

    screen_shot_2012-03-07at51031pm

  6. リストルートノードのプロパティを追加して、テキストフィールドとして設定します。次の表に示す各行は、1つのプロパティを表しています。終了したら、「すべて保存」をクリックします。

    名前 タイプ
    fieldLabel 文字列 リストルートのパス
    name 文字列 。/listroot
    xtype 文字列 textfield

    screen_shot_2012-03-07at51433pm

contentpage コンポーネントにリストの子を含める

contentpage コンポーネントに listchildren コンポーネントを含めるには、次の手順を実行します。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageの下のleft.jspファイルを開き、次のコードを見つけます(4行目)。

    <div>newslist</div>
    
  2. このコードを以下のコードに置き換えます。

    <cq:include path="newslist" resourceType="mywebsite/components/listchildren" />
    
  3. 変更内容を保存します。

ページでのリストの子の表示

このコンポーネントの完全な動作は、Products ページを表示して確認できます。

  • 親ページ(「リストルートのパス」)が定義されていないとき。
  • 親ページ(「リストルートのパス」)が定義されているとき。
  1. ブラウザーで、Products​ページを再読み込みします。listchildrenコンポーネントは次のように表示されます。

    chlimage_1-118

  2. chlimage_1-119

  3. 「リストルートのパス」に、次のように入力します。/content/mywebsite/en.「OK」をクリックします。 ページ上のlistchildrenコンポーネントは次のようになります。

    chlimage_1-120

ロゴコンポーネントの作成

会社のロゴを表示し、サイトのホームページへのリンクを提供するコンポーネントを作成します。このコンポーネントにはデザインモードのダイアログが含まれており、プロパティ値はサイトデザイン(/etc/designs/mywebsite)に格納されます。

  • このデザインを使用するページに追加されるコンポーネントのすべてのインスタンスにプロパティ値が適用されます。
  • プロパティの設定には、このデザインを使用するページ上にあるコンポーネントのどのインスタンスでも使用できます。

デザインモードのダイアログには、画像とリンクパスを設定するためのプロパティが含まれています。ロゴコンポーネントは、Web サイトのすべてのページの左上に配置されます。

次のようになります。

chlimage_1-121

メモ

Adobe Experience Managerは、より完全な機能を持つロゴコンポーネント(/libs/foundation/components/logo)を提供します。

ロゴコンポーネントノードの作成

ロゴコンポーネントを作成するには、次の手順を実行します。

  1. CRXDE Lite で、/apps/mywebsite/components を右クリックして、作成コンポーネントを作成​をクリックします。

  2. コンポーネントを作成ダイアログで、以下のプロパティ値を入力して「次へ」をクリックします。

    • ラベル: logo.
    • タイトル: My Logo Component.
    • 説明: This is My Logo Component.
  3. 「次へ」を数回クリックしてダイアログの最後のパネルを表示し、「OK」をクリックします。

ロゴスクリプトの作成

ここでは、ホームページへのリンクを含むロゴイメージを表示するスクリプトの作成方法について説明します。

  1. CRXDE Liteで、/apps/mywebsite/components/logoの下のlogo.jspファイルを開きます。

  2. 以下のコードでは、サイトのホームページへのリンクが作成され、ロゴイメージへの参照が追加されます。このコードを logo.jsp にコピーします。

    <%@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. 変更内容を保存します。

ロゴデザインダイアログの作成

デザインモードでロゴコンポーネントを設定するためのダイアログを作成します。デザインモードのダイアログには、design_dialog という名前を付ける必要があります。

  1. logo コンポーネントの下に dialog ノードを作成します。

    1. /apps/mywebsite/components/logoノードを右クリックし、作成/ダイアログを作成​をクリックします。

    2. 次のプロパティ値を入力し、「OK」をクリックします。

      • ラベル design_dialog
      • タイトル Logo (Design)
  2. design_dialogブランチのtab1ノードを右クリックし、「削除」(Delete)をクリックします。「すべて保存」をクリックします。

  3. design_dialog/items/itemsノードの下に、cq:Widget型のimgという名前の新しいノードを作成します。 次のプロパティを追加し、「すべて保存」をクリックします。

    名前 タイプ
    fileNameParameter 文字列 。/imageName
    fileReferenceParameter 文字列 。/imageReference
    name 文字列 。/画像
    title 文字列 画像
    xtype 文字列 html5smartimage

    chlimage_1-122

ロゴレンダリングスクリプトの作成

ロゴイメージを取得してページに書き込むスクリプトを作成します。

  1. logoコンポーネントノードを右クリックし、作成/ファイルを作成​をクリックして、img.data.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 {
        /* don't 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 コンポーネントへのロゴコンポーネントの追加

  1. CRXDE Liteで、/apps/mywebsite/components/contentpage fileの下のleft.jspを開き、次のコード行を探します。

    <div>logo</div>
    
  2. このコードを以下のコード行に置き換えます。

    <cq:include path="logo" resourceType="mywebsite/components/logo" />
    
  3. 変更内容を保存します。

  4. ブラウザーで、Products​ページを再読み込みします。ロゴは次のように表示されますが、現在は基になるリンクのみが表示されます。

    chlimage_1-123

ページでのロゴイメージの設定

ここでは、デザインモードのダイアログを使用して画像をロゴとして設定する方法について説明します。

  1. ブラウザーで​Products​ページを開き、サイドキックの下部にある「Design」ボタンをクリックして、Design​モードに入ります。

  2. ロゴのデザインバーで、編集​をクリックし、ダイアログを使用してロゴコンポーネントの設定を編集します。

  3. ダイアログで、「画像」タブのパネルをクリックし、mywebsite.zipファイルから抽出したlogo.png画像を参照して、「OK」をクリックします。

    chlimage_1-124

  4. サイドキックのタイトルバーの三角形をクリックして、編集​モードに戻ります。

    chlimage_1-7

  5. CRXDE Lite で、以下のノードに移動して、格納されているプロパティ値を確認します。

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

パンくずコンポーネントを含める

ここでは、基盤コンポーネントの 1 つであるパンくず(trail)コンポーネントを含めます。

  1. CRXDE Liteで/apps/mywebsite/components/contentpageを参照し、ファイルcenter.jspを開いて次の場所に置き換えます。

    <div>trail</div>
    

    を次のように置き換えます。

    <cq:include path="trail" resourceType="foundation/components/breadcrumb" />
    
  2. 変更内容を保存します。

  3. ブラウザーで、Products 1 ページを再読み込みします。trail コンポーネントは次のようになります。

    chlimage_1-125

タイトルコンポーネントを含める

ここでは、基盤コンポーネントの 1 つであるタイトルコンポーネントを含めます。

  1. CRXDE Liteで/apps/mywebsite/components/contentpageを参照し、ファイルcenter.jspを開いて次の場所に置き換えます。

    <div>title</div>
    

    を次のように置き換えます。

    <cq:include path="title" resourceType="foundation/components/title" />
    
  2. 変更内容を保存します。

  3. ブラウザーで、Products​ページを再読み込みします。タイトルコンポーネントは次のようになります。

    chlimage_1-126

メモ

編集​モードで、別のタイトルとタイプ/サイズを設定できます。

段落システムコンポーネントを含める

段落システム(parsys)は、段落のリストを管理するので、Web サイトの重要部分です。これを使用すると、作成者は段落コンポーネントをページに追加し、構造を指定できます。

parsys コンポーネント(基盤コンポーネントの 1 つ)を、contentpage コンポーネントに追加します。

  1. CRXDE Liteで/apps/mywebsite/components/contentpageを参照し、ファイルcenter.jspを開いて、次のコード行を探します。

    <div>parsys</div>
    
  2. このコード行を以下のコードに置き換えて、変更内容を保存します。

    <cq:include path="par" resourceType="foundation/components/parsys" />
    
  3. ブラウザーで、Products​ページを更新します。parsysコンポーネントが追加され、次のように表示されます。

    chlimage_1-127

画像コンポーネントの作成

段落システムに画像を表示するコンポーネントを作成します。時間を節約するために、この画像コンポーネントは、ロゴコンポーネントをコピーし、一部のプロパティを変更して作成します。

メモ

Adobe Experience Managerは、よりフル機能の画像コンポーネント( /libs/foundation/components/image )を提供します。

画像コンポーネントの作成

  1. /apps/mywebsite/components/logoノードを右クリックし、「コピー」をクリックします。

  2. /apps/mywebsite/componentsノードを右クリックし、「貼り付け」をクリックします。

  3. Copy of logoノードを右クリックし、「名前を変更」をクリックし、既存のテキストを削除して「image」と入力します。

  4. image コンポーネントノードを選択して、以下のプロパティ値を変更します。

    • jcr:title: My Image Component
    • jcr:description:これは私の画像コンポーネントです
  5. 以下のプロパティ値を使用して、image ノードにプロパティを追加します。

    • 名前:componentGroup
    • 種類:string
    • :MyWebsite
  6. imageノードの下で、design_dialogノードの名前をdialogに変更します。

  7. logo.jspimage.jsp.に変更します。

  8. img.GET.java を開いて、パッケージを apps.mywebsite.components.image に変更します。

chlimage_1-128

画像スクリプトの作成

ここでは、画像スクリプトを作成する方法について説明します。

  1. 次を開きます:/apps/mywebsite/components/image/ image.jsp

  2. 既存のコードを以下のコードに置き換えて、変更内容を保存します。

    <%@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 ノードの作成

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
グループ 文字列 media
propertyName 文字列 。/imageReference

chlimage_1-129

アイコンの追加

ここでは、画像コンポーネントをサイドキックに表示したときに横に表示されるアイコンを追加します。

  1. CRXDE Liteで、ファイル/libs/foundation/components/image/icon.pngを右クリックし、「コピー」を選択します。
  2. ノード/apps/mywebsite/components/imageを右クリックし、「貼り付け」をクリックしてから、「すべて保存」をクリックします。

画像コンポーネントの使用

ここでは、Products ページを表示して、段落システムに画像コンポーネントを追加します。

  1. ブラウザーで、Products​ページを再読み込みします。

  2. サイドキックで、デザインモード​アイコンをクリックします。

  3. 編集」ボタンをクリックして、parのデザインダイアログを編集します。

  4. ダイアログには、許可されているコンポーネント​のリストが表示されます。MyWebsite​に移動し、My Image Component​を選択して、「OK」をクリックします。

  5. 編集モード​に戻ります。

  6. parsys フレーム(コンポーネントまたはアセットをここにドラッグします)をダブルクリックします。新規コンポーネントを挿入​および​サイドキック​のセレクターは以下のように表示されます。

    chlimage_1-8

ツールバーコンポーネントを含める

ここでは、基盤コンポーネントの 1 つであるツールバーコンポーネントを含めます。

編集モードとデザインモードで、複数のオプションがあります。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageに移動し、body.jspファイルを開いて、次のコードを探します。

    <div class="toolbar">toolbar</div>
    
  2. このコードを以下のコードに置き換えて、変更内容を保存します。

    <cq:include path="toolbar" resourceType="foundation/components/toolbar"/>
    
  3. AEM Webサイトページのフォルダーツリーで、Websites/My Website/Englishを選択し、新規/新しいページ​をクリックします。 次のプロパティ値を指定し、「作成」をクリックします。

    • タイトル:ツールバー
    • My Website Content Page Template」を選択します。
  4. ページのリストで、ツールバー​ページを右クリックし、プロパティ​をクリックします。「ナビゲーション内で非表示にする」を選択し、「OK」をクリックします。

    ナビゲーション内で非表示」オプションを使用すると、topnavやlistchildrenなどのナビゲーションコンポーネントにページが表示されなくなります。

  5. Toolbar​の下に、次のページを作成します。

    • Contacts
    • Feedback
    • ログイン
    • 検索
  6. ブラウザーで、Products​ページを再読み込みします。次のようになります。

    chlimage_1-130

検索コンポーネントの作成

ここでは、Web サイトでコンテンツを検索するコンポーネントを作成します。この検索コンポーネントは、任意のページ(特殊な検索結果ページなど)の段落システムに配置できます。

検索入力ボックスは、English ページに以下のように表示されます。

chlimage_1-131

検索コンポーネントの作成

  1. CRXDE Liteで/apps/mywebsite/componentsを右クリックし、「作成」を選択してから、「コンポーネントを作成」を選択します。

  2. ダイアログを使用してコンポーネントを設定します。

    1. 最初のパネルで、以下のプロパティ値を指定します。

      • ラベル:検索
      • タイトル:検索コンポーネント
      • 説明:これは、マイ検索コンポーネントです
      • グループ:MyWebsite
    2. 次へ」をクリックし、もう一度「次へ」をクリックします。

    3. 許可されている親​パネルで、+​ボタンをクリックし、*/parsysと入力します。

    4. 次へ」をクリックし、「OK」をクリックします。

  3. すべて保存」をクリックします。

  4. 次のノードをコピーして、apps/mywebsite/components/searchノードに貼り付けます。

    • /libs/foundation/components/search/dialog
    • " /libs/foundation/components/search/i18n
    • /libs/foundation/components/search/icon.png
  5. すべて保存」をクリックします。

検索スクリプトの作成

ここでは、検索スクリプトを作成する方法について説明します。

  1. /apps/mywebsite/components/search/search.jspファイルを開きます。

  2. 以下のコードを search.jsp にコピーします。

    <%@ 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}"/></span></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 コンポーネントに検索ボックスを含める

contentpage の左側のセクションに検索入力ボックスを含めるには、以下の手順を実行します。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageの下のleft.jspファイルを開き、次のコードを探します(2行目)。

    %><div class="left">
    
  2. この行の​前に、以下のコードを挿入します。

    %><%@ page import="com.day.text.Text"%><%
    %><% String docroot = currentDesign.getPath(); 
    String home = Text.getAbsoluteParent(currentPage.getPath(), 2);%><%
    
  3. 以下のコード行を見つけます。

    <div>search</div>
    
  4. このコードを以下のコードに置き換えて、変更内容を保存します。

    <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. ブラウザーで、Products​ページを再読み込みします。検索コンポーネントは次のようになります。

    chlimage_1-132

Search ページに検索コンポーネントを含める

ここでは、検索コンポーネントを段落システムに含めます。

  1. ブラウザーで、検索​ページを開きます。

  2. サイドキックで、デザイン​モードアイコンをクリックします。

  3. 「Design of par」ブロック(検索タイトルの下)で、「編集」をクリックします。

  4. ダイアログで、「My Websites」グループまで下にスクロールし、「My Search Component」を選択して、「OK」をクリックします。

  5. サイドキックで、三角形をクリックして​編集​モードに戻ります。

  6. My Search​コンポーネントをサイドキックからparsysフレームにドラッグします。次のようになります。

    chlimage_1-133

  7. 製品​ページに移動します。入力ボックスで顧客を検索し、Enter​キーを押します。検索​ページにリダイレクトされます。プレビュー​モードに切り替えます。出力は、次のような形式になります。

    chlimage_1-134

iparsys コンポーネントを含める

ここでは、基盤コンポーネントの 1 つである継承の段落システム(iparsys)コンポーネントを含めます。このコンポーネントを使用すると、親ページで段落の構造を作成し、子ページに段落を継承させることができます。

このコンポーネントでは、編集モードとデザインモードの両方で複数のパラメーターを設定できます。

  1. CRXDE Liteで、/apps/mywebsite/components/contentpageに移動し、right.jspファイルを開いて次の場所に置き換えます。

    <div>iparsys</div>
    

    を次のように置き換えます。

    <cq:include path="rightpar" resourceType="foundation/components/iparsys" />
    
  2. 変更内容を保存します。

  3. ブラウザーで、Products​ページを再読み込みします。ページ全体は次のようになります。

    chlimage_1-9

このページ