Personalização do console Sites (interface clássica) customizing-the-websites-console-classic-ui
Adicionar uma coluna personalizada ao console Sites (siteadmin) adding-a-custom-column-to-the-websites-siteadmin-console
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:
- Criação do serviço OSGI e implantar o pacote que o contém no servidor AEM.
- (opcional) Teste do novo serviço emitindo uma chamada JSON para solicitar o objeto JSON usado para criar o console.
- Exibição da nova coluna estendendo a estrutura do nó do console no repositório.
- o console Ativos digitais
- o console da Comunidade
Criação do serviço OSGI creating-the-osgi-service
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 está abaixo:
-
Adiciona um estrelado para cada item, que é
true
se o nome da página começar com um e, efalse
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:
- No CRXDE Lite, criar um pacote.
- Adicione o código de amostra abaixo.
- Crie o pacote.
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 existe no objeto de resposta. O valor é 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.
Testando o novo serviço testing-the-new-service
Quando você abre o console Administração de sites e navega pelo seu 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:
Exibição da Nova Coluna displaying-the-new-column
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 tiposling: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 torna a configuração de grade ativa para todos os sites do 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:
- msm:isSource
- msm:isInBlueprint
- msm:isLiveCopy
-
-
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
, defina a propriedadesling: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:
Pacote de exemplo sample-package
O resultado deste tutorial está disponível no Personalização do Console de administração de sites pacote no Compartilhamento de pacotes.