自定义网站控制台（经典UI）

将自定义列添加到网站（站点管理）控制台

可以扩展“网站管理”控制台以显示自定义列。 控制台基于JSON对象构建，该对象可通过创建实施ListInfoProvider接口的OSGI服务来扩展。 此类服务会修改发送到客户端以构建控制台的JSON对象。

此分步教程介绍如何通过实施ListInfoProvider界面在“网站管理”控制台中显示新列。 它包括以下步骤：

1. 创建OSGi服 务并将包含该服务的包部署到AEM服务器。
2. （可选）通过发出JSON调用来测试新服务，以请求用于构建控制台的JSON对象。
3. 通过扩展存 储库中控制台的节点结构来显示新列。

创建OSGI服务

ListInfoProvider接口定义了两种方法：

• updateListGlobalInfo，要更新列表的全局属性，
• updateListItemInfo，以更新单个列表项。

两种方法的参数包括：

• request，关联的Sling HTTP请求对象，
• info，要更新的JSON对象（分别为全局列表或当前列表项）
• resource, Sling资源。

以下实施示例：

• 为每个项目添加​星形​属性，如果页面名称以​e​开头，则该属性为true，否则为false。

• 添加​stiredCount​属性，该属性是列表的全局属性，包含有星号列表项的数量。

要创建OSGI服务，请执行以下操作：

1. 在CRXDE Lite中，创建包。
2. 添加下面的示例代码。
3. 构建包。

新服务已启动且正在运行。

package com.test;

import com.day.cq.commons.ListInfoProvider;
import com.day.cq.i18n.I18n;
import com.day.cq.wcm.api.Page;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;

@Component(metatype = false)
@Service(value = ListInfoProvider.class)
public class StarredListInfoProvider implements ListInfoProvider {

    private int count = 0;

    public void updateListGlobalInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        info.put("starredCount", count);
        count = 0; // reset for next execution
    }

    public void updateListItemInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        Page page = resource.adaptTo(Page.class);
        if (page != null) {
            // Consider starred if page name starts with 'e'
            boolean starred = page.getName().startsWith("e");
            if (starred) {
                count++;
            }
            I18n i18n = new I18n(request);
            info.put("starred", starred ? i18n.get("Yes") : i18n.get("No"));
        }
    }

}

测试新服务

当您打开网站管理控制台并浏览您的网站时，浏览器将发出ajax调用，以获取用于构建控制台的JSON对象。 例如，当您浏览/content/geometrixx文件夹时，会向AEM服务器发送以下请求以构建控制台：

http://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

要确保在部署包含新服务的包后，新服务正在运行：

1. 将您的浏览器指向以下URL:

   http://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

2. 响应应按如下方式显示新属性：

显示新列

最后一步是调整网站管理控制台的节点结构，以通过覆盖/libs/wcm/core/content/siteadmin来显示所有Geometrixx页面的新属性。 请按如下方式继续：

1. 在CRXDE Lite中，使用sling:Folder类型的节点创建节点结构/apps/wcm/core/content以反映结构/libs/wcm/core/content。

2. 复制节点/libs/wcm/core/content/siteadmin并将其粘贴到/apps/wcm/core/content下方。

3. 将节点/apps/wcm/core/content/siteadmin/grid/assets复制到/apps/wcm/core/content/siteadmin/grid/geometrixx并更改其属性：

   • 删除​pageText

   • 将​pathRegex​设置为/content/geometrixx(/.*)?

     这将使所有geometrixx网站的网格配置处于活动状态。

   • 将​storeProxySuffix​设置为.pages.json

   • 编辑​storeReaderFields​多值属性并添加starred值。

   • 要激活MSM功能，请将以下MSM参数添加到多字符串属性​storeReaderFields​中：

     • msm:isSource
     • msm:isInBlueprint
     • msm:isLiveCopy

4. 在/apps/wcm/core/content/siteadmin/grid/geometrixx/columns下添加starred节点（类型为​nt:unstructured），其属性如下：

   • dataIndex: starred 字符串类型
   • 标题: Starred 字符串类型
   • xtype: gridcolumn 字符串类型

5. （可选）删除您不希望在/apps/wcm/core/content/siteadmin/grid/geometrixx/columns中显示的列

6. /siteadmin 是默认指向的虚路 /libs/wcm/core/content/siteadmin径。

   要将此内容重定向到/apps/wcm/core/content/siteadmin上的siteadmin版本，请定义属性sling:vanityOrder的值大于/libs/wcm/core/content/siteadmin上定义的值。 默认值为300，因此任何更高的值都适合。

7. 转到网站管理控制台，然后导航到Geometrixx站点：

   http://localhost:4502/siteadmin#/content/geometrixx。

8. 提供了名为​Stared​的新列，该列显示如下自定义信息：

示例包

本教程的结果可在包共享上的自定义网站管理控制台包中找到。