建立自訂Cloud Service

預設Cloud Services集可使用自訂Cloud Service型別擴展。 這可讓您以結構化的方式將自訂標籤插入頁面中。 這主要是用於第三方分析提供者，例如Google Analytics、圖表節拍等。 Cloud Services會從父頁面繼承至子頁面，且能夠在任何層級中斷繼承。

注意

此建立新Cloud Service的逐步指南是使用Google Analytics的範例。 並非所有情況都適用於您的使用案例。

  1. 在CRXDE Lite中，建立新節點，位於 /apps：

    • 名稱: acs
    • 型別： nt:folder

  2. 在下建立新節點 /apps/acs：

    • 名稱: analytics
    • 型別： sling:Folder

  3. 在下建立2個新節點 /apps/acs/analytics：

    • 名稱：元件
    • 型別： sling:Folder

    和

    • 名稱：範本
    • 型別： sling:Folder

  4. 按一下右鍵 /apps/acs/analytics/components. 選取 建立…… 後面接著 建立元件…… 開啟的對話方塊可讓您指定：

    • 標籤： googleanalyticspage
    • 標題: Google Analytics Page
    • 超級類型: cq/cloudserviceconfigs/components/configpage
    • 群組： .hidden

  5. 按一下 下一個 兩次，並指定：

    • 允許的父項: acs/analytics/templates/googleanalytics

    按一下 下一個 兩次，然後按一下 確定.

  6. 將屬性新增至 googleanalyticspage：

    • 名稱: cq:defaultView
    • 值: html

  7. 建立名為的新檔案 content.jsp 在 /apps/acs/analytics/components/googleanalyticspage，包含下列內容：

    <%@page contentType="text/html"
            pageEncoding="utf-8"%><%
%><%@include file="/libs/foundation/global.jsp"%><div>

<div>
    <h3>Google Analytics Settings</h3>
    <ul>
        <li><div class="li-bullet"><strong>accountID: </strong><br><%= xssAPI.encodeForHTML(properties.get("accountID", "")) %></div></li>
    </ul>
</div>

  8. 在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/：

    • 名稱: dialog

    • 型別： cq:Dialog

    • 屬性:

      • 名稱: title
      • 型別： String
      • 值: Google Analytics Config
      • 名稱: xtype
      • 型別： String
      • 值: dialog

  9. 在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog：

    • 名稱: items

    • 型別： cq:Widget

    • 屬性:

      • 名稱: xtype
      • 型別： String
      • 值: tabpanel

  10. 在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items：

    • 名稱: items
    • 型別： cq:WidgetCollection

  11. 在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items/items：

    • 名稱：tab1

    • 型別： cq:Panel

    • 屬性:

      • 名稱: title
      • 型別： String
      • 值: Config

  12. 在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items/items/tab1：

    • 名稱：專案

    • 型別： nt:unstructured

    • 屬性:

      • 名稱: fieldLabel

      • 型別：字串

      • 值：帳戶ID

      • 名稱: fieldDescription

      • 型別： String

      • 值: The account ID assigned by Google. Usually in the form UA-NNNNNN-N

      • 名稱: name

      • 型別： String

      • 值: ./accountID

      • 名稱: validateOnBlur

      • 型別： String

      • 值: true

      • 名稱: xtype

      • 型別： String

      • 值: textfield

  13. 複製 /libs/cq/cloudserviceconfigs/components/configpage/body.jsp 至 /apps/acs/analytics/components/googleanalyticspage/body.jsp 和變更 libs 至 apps 第34行並將第79行的指令碼參考設為完整路徑。

  14. 在下建立新範本 /apps/acs/analytics/templates/：

    • 替換為 資源型別 = acs/analytics/components/googleanalyticspage
    • 替換為 標籤 = googleanalytics
    • 替換為 標題= Google Analytics Configuration
    • 替換為 allowedpath = /etc/cloudservices/googleanalytics(/.*)?
    • 替換為 allowedChildren = /apps/acs/analytics/templates/googleanalytics
    • 替換為 sling：resourceSuperType = cq/cloudserviceconfigs/templates/configpage （在範本節點上，而不是jcr：content節點）
    • 替換為 cq：designPath = /etc/designs/cloudservices/googleanalytics （在jcr：content上）

  15. 建立新元件： /apps/acs/analytics/components/googleanalytics.

    將下列內容新增至 googleanalytics.jsp：

    <%@page import="org.apache.sling.api.resource.Resource,
                org.apache.sling.api.resource.ValueMap,
                org.apache.sling.api.resource.ResourceUtil,
                com.day.cq.wcm.webservicesupport.Configuration,
                com.day.cq.wcm.webservicesupport.ConfigurationManager" %>
<%@include file="/libs/foundation/global.jsp" %><%

String[] services = pageProperties.getInherited("cq:cloudserviceconfigs", new String[]{});
ConfigurationManager cfgMgr = resource.getResourceResolver().adaptTo(ConfigurationManager.class);
if(cfgMgr != null) {
    String accountID = null;
    Configuration cfg = cfgMgr.getConfiguration("googleanalytics", services);
    if(cfg != null) {
        accountID = cfg.get("accountID", null);
    }

    if(accountID != null) {
    %>
<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', '<%= accountID %>']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script><%
    }
}
%>

    這應根據設定屬性輸出自訂標籤。

  16. 導覽至 http://localhost:4502/miscadmin#/etc/cloudservices 和建立新頁面：

    • 標題: Google Analytics
    • 名稱: googleanalytics

    返回CRXDE Lite中，並在 /etc/cloudservices/googleanalytics，將下列屬性新增至 jcr:content：

    • 名稱: componentReference
    • 型別： String
    • 值: acs/analytics/components/googleanalytics

  17. 導覽至新建立的「服務」頁面( http://localhost:4502/etc/cloudservices/googleanalytics.html)並按一下 + 若要建立新設定：

    • 父設定: /etc/cloudservices/googleanalytics
    • 標題: My First GA Config

    選擇 Google Analytics設定 並按一下 建立.

  18. 輸入 帳戶ID，例如 AA-11111111-1. 按一下​「確定」。

  19. 導覽至頁面，並在頁面屬性下新增新建立的設定。 Cloud Services 標籤。

  20. 頁面中將會新增自訂標籤。

本頁內容