O console Administração de sites pode ser estendido para exibir colunas personalizadas. O console é construído com base em um objeto JSON que pode ser estendido por meio da criação de um serviço OSGI que implementa o ListInfoProvider
interface. Esse serviço modifica o objeto JSON enviado ao cliente para criar o console.
Este tutorial passo a passo explica como exibir uma nova coluna no console Administração de sites implementando o ListInfoProvider
interface. Ele consiste nas seguintes etapas:
Este tutorial também pode ser usado para estender os seguintes consoles de administração:
A variável ListInfoProvider
A interface do define dois métodos:
updateListGlobalInfo
, para atualizar as propriedades globais da lista,updateListItemInfo
, para atualizar um único item da lista.Os argumentos para ambos os métodos são:
request
, o objeto de solicitação HTTP do Sling associado,info
, o objeto JSON a ser atualizado, que é, respectivamente, a lista global ou o item de lista atual,resource
, um recurso do Sling.O exemplo de implementação abaixo:
Adiciona um estrelado para cada item, que é true
se o nome da página começar com um e, e false
caso contrário.
Adiciona um starsCount propriedade, que é global para a lista e contém o número de itens de lista com estrelas.
Para criar o serviço OSGI:
O novo serviço está em funcionamento.
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"));
}
}
}
Sua implementação deve decidir, com base na solicitação e/ou recurso fornecido, se deve adicionar as informações ao objeto JSON ou não.
Se o seu ListInfoProvider
A implementação define uma propriedade que já existe no objeto de resposta. O valor será substituído pelo valor fornecido.
Você pode usar classificação de serviço para gerenciar a ordem de execução de vários ListInfoProvider
implementações.
Ao abrir o console Administração de sites e navegar pelo site, o navegador emite uma chamada ajax para obter o objeto JSON usado para criar o console. Por exemplo, quando você navega até a variável /content/geometrixx
, a seguinte solicitação é enviada ao servidor AEM para criar o console:
https://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin
Para garantir que o novo serviço esteja em execução após a implantação do pacote que o contém:
Aponte seu navegador para o seguinte URL:
https://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin
A resposta deve exibir as novas propriedades da seguinte maneira:
A última etapa consiste em adaptar a estrutura dos nós do console Administração de sites para exibir a nova propriedade para todas as páginas do Geometrixx ao sobrepor /libs/wcm/core/content/siteadmin
. Proceda da seguinte forma:
No CRXDE Lite, crie a estrutura dos nós /apps/wcm/core/content
com nós do tipo sling:Folder
para refletir a estrutura /libs/wcm/core/content
.
Copiar o nó /libs/wcm/core/content/siteadmin
e cole-o abaixo /apps/wcm/core/content
.
Copiar o nó /apps/wcm/core/content/siteadmin/grid/assets
para /apps/wcm/core/content/siteadmin/grid/geometrixx
e altera suas propriedades:
Remover pageText
Definir pathRegex para /content/geometrixx(/.*)?
Isso tornará a configuração de grade ativa para todos os sites geometrixx.
Definir storeProxySuffix para .pages.json
Edite o storeReaderFields propriedade com vários valores e adicione a variável starred
valor.
Para ativar a funcionalidade MSM, adicione os seguintes parâmetros MSM à propriedade multi-String storeReaderFields:
Adicionar um starred
nó (do tipo nt:não estruturado) abaixo /apps/wcm/core/content/siteadmin/grid/geometrixx/columns
com as seguintes propriedades:
dataIndex: starred
do tipo String
cabeçalho: Starred
do tipo String
xtype: gridcolumn
do tipo String
(opcional) Solte as colunas que você não deseja exibir em /apps/wcm/core/content/siteadmin/grid/geometrixx/columns
/siteadmin
é um caminho personalizado que, como padrão, aponta para /libs/wcm/core/content/siteadmin
.
Para redirecionar para sua versão do siteadmin em /apps/wcm/core/content/siteadmin
definir a propriedade sling:vanityOrder
para ter um valor maior que o definido em /libs/wcm/core/content/siteadmin
. O valor padrão é 300, portanto, qualquer valor maior é adequado.
Vá para o console Administração de sites e navegue até o site do Geometrixx:
https://localhost:4502/siteadmin#/content/geometrixx.
A nova coluna chamada Starred O está disponível, exibindo informações personalizadas da seguinte maneira:
Se várias configurações de grade corresponderem ao caminho solicitado definido pelo pathRegex , a primeira será usada e não a mais específica, o que significa que a ordem das configurações é importante.
O resultado deste tutorial está disponível no Personalização do Console de administração de sites pacote no Compartilhamento de pacotes.