AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.
Ao criar uma página, você deve selecionar um modelo, que será usado como a base para criar a nova página. O modelo define a estrutura da página resultante, qualquer conteúdo inicial e os componentes que podem ser usados.
Com o Editor de modelos, criar e manter modelos não é mais uma tarefa somente para desenvolvedores. Um tipo de usuário avançado, chamado de autor de modelo, também pode ser envolvido. Os desenvolvedores ainda são necessários para configurar o ambiente, criar bibliotecas de clientes e criar os componentes a serem usados, mas uma vez que essas noções básicas estejam em vigor, o autor do modelo terá a flexibilidade de criar e configurar modelos sem um projeto de desenvolvimento.
O Console Modelos permite que os autores de modelo:
O Editor de modelos permite que os autores de modelo:
Este documento explica como uma autor do modelo O pode usar o console e o editor de modelos para criar e gerenciar modelos editáveis.
Para obter informações detalhadas sobre como os modelos editáveis funcionam a um nível técnico, consulte o documento do desenvolvedor Modelos de página - Editável para obter mais informações.
AEM 6.4.5.0 ou posterior é necessário para usar modelos editáveis com a variável Editor de SPA.
O Editor de modelos não oferece suporte para direcionamento diretamente no nível do modelo. As páginas criadas com base em um modelo editável podem ser direcionadas, mas os modelos em si não podem.
Páginas e modelos criados com o Console Modelos não se destinam a ser usados com a interface do usuário clássica e esse uso não é suportado.
Um administrador precisa configurar uma pasta de modelo no Navegador de configurações e aplicar permissões apropriadas antes que um autor de modelo possa criar um modelo nessa pasta.
É importante considerar os seguintes pontos antes de começar:
Criar um novo modelo requer colaboração. Por esse motivo, a Função é indicada para cada tarefa.
Dependendo de como sua instância está configurada, pode ser útil estar ciente de que AEM agora fornece dois tipos básicos de modelo. Isso não afeta a maneira como você usar um modelo para criar uma página, mas afeta o tipo de modelo que você pode criar e como uma página se relaciona com seu modelo.
A criação de um novo modelo usando o Console de modelos e o Editor de modelos exige a colaboração entre as seguintes funções:
Administrador:
admin
.Desenvolvedor:
Autor do modelo:
Esse é um autor específico, membro do grupo template-authors
Pode configurar o uso de componentes e outros detalhes de alto nível que exigem:
Algum conhecimento técnico
Informações técnicas do desenvolvedor.
Devido à natureza de algumas tarefas, como a criação de uma pasta, um ambiente de desenvolvimento é necessário, e isso requer conhecimento/experiência.
As tarefas detalhadas neste documento são listadas com a função responsável por executá-las.
AEM agora oferece dois tipos básicos de modelos:
Modelos editáveis
Modelos estáticos
Por definição, o console modelo e o editor de modelo permitem apenas a criação e edição de modelos editáveis. Portanto, este documento se concentra exclusivamente em modelos editáveis.
Ao usar um modelo para criar uma nova página não há diferença visível e nenhuma indicação entre modelos estáticos e editáveis. Para o autor da página, o processo é transparente.
Ao criar um novo modelo editável:
Use o console Modelo. Isso está disponível no Geral da seção Ferramentas console.
É possível criar uma pasta para os modelos se necessário
Criar um novo modelo, inicialmente vazio
Definir propriedades adicionais para o modelo, se necessário
Editar o modelo para definir o:
Ativar o modelo para uso ao criar uma página
Permitir o modelo para a página ou ramificação necessária do seu site
Publicar o modelo para disponibilizá-lo no ambiente de publicação
Os Modelos permitidos geralmente são predefinidos quando seu site for inicialmente configurado.
Nunca insira qualquer informação que precise ser internacionalizado em um modelo.
Uma pasta de modelo deve ser criada para que o projeto mantenha seus modelos específicos de projetos. Esta é uma tarefa de administrador e está descrita no documento Modelos de página - Editável.
Abra o Console Modelos (via Ferramentas -> Geral) e navegue até a pasta desejada.
Em uma instância padrão do AEM, a pasta global já existe no console modelo. Isso mantém modelos padrão e atua como um fallback se nenhuma política e/ou tipo de modelo for localizado na pasta atual.
É recomendável usar um pasta de modelo criada para o seu projeto.
Selecione Criar, em seguida Criar modelo para abrir o assistente.
Escolha uma Tipo de modelo, em seguida selecione Próximo.
Os tipos de modelos são layouts predefinidos e podem ser considerados modelos de um modelo. Eles são predefinidos pelos desenvolvedores ou pelo administrador do sistema. Mais informações podem ser encontradas no documento do desenvolvedor Modelos de página - Editável.
Complete o Detalhes do modelo:
Selecione Criar. Uma confirmação será exibida, selecione Abrir🔗 para começar a editar o modelo ou Concluído para retornar ao console do modelo.
Quando um modelo novo for criado, ele será marcado como Rascunho no console. Isso indica que ainda não está disponível para uso por autores da página.
Um template pode ter as seguintes propriedades:
Imagem
Imagem a ser usada como uma miniatura do modelo para auxiliar na seleção, como no assistente Criar página .
Título
Descrição
Para exibir e/ou editar as propriedades:
O status de um modelo (rascunho, ativado ou desativado) é exibido no console.
Para definir a miniatura do modelo:
Edite as propriedades do modelo.
Escolha se deseja fazer upload de uma miniatura ou gerá-la a partir do conteúdo do template.
Para ambos os métodos, uma visualização da miniatura será exibida.
Se não for satisfatório, clique ou toque em Limpar para carregar outra imagem ou gerar novamente a miniatura.
Quando estiver satisfeito com a miniatura, clique ou toque em Salvar e fechar.
Para poder usar um modelo ao criar uma página é necessário:
Um modelo pode ser ativado ou desativado para torná-lo disponível ou indisponível na variável Criar página assistente.
Quando um modelo estiver habilitado, um aviso será exibido quando um autor de modelo começar a atualizar o modelo. Isso serve para informar ao usuário que o modelo pode ser referenciado, de modo que qualquer alteração pode afetar as páginas que fazem referência ao modelo.
O status de um modelo (rascunho, ativado ou desativado) é exibido no console.
Um modelo pode ser disponibilizado ou indisponibilizado para determinadas ramificações de página.
Abra as Propriedades da página da página raiz da ramificação onde deseja que o modelo fique disponível.
Abra a guia Avançado.
Em Configurações do modelo use Adicionar campo para especificar os caminhos aos seus modelos.
O caminho pode ser explícito ou usar padrões. Por exemplo:
/conf/<your-folder>/settings/wcm/templates/.*
A ordem dos caminhos é irrelevante, todos os caminhos serão digitalizados e quaisquer modelos recuperados.
Se a variável Modelos permitidos for deixada em branco, a árvore será crescente até que um valor/lista seja encontrado.
Consulte Disponibilidade de modelos - os princípios para modelos permitidos permanecem inalterados.
Clique em Salvar para salvar as alterações nas propriedades da página.
Geralmente os modelos permitidos são predefinidos para todo o site quando configurado.
À medida que o modelo for referenciado quando a página for renderizada, o modelo totalmente configurado precisará ser publicado, para estar disponível no ambiente de publicação.
No console Modelos, selecione o modelo.
Selecione Publicar na barra de ferramentas para abrir o assistente.
Selecione as Políticas do conteúdo para ser publicado em tandem.
Selecionar Publicar na barra de ferramentas para concluir a ação.
Ao criar ou editar um modelo, há vários aspectos que você pode definir. A edição de modelos é semelhante à criação de página.
Os seguintes aspectos de um template podem ser editados:
Os componentes adicionados aqui não podem ser movidos/removidos das páginas resultantes pelos autores da página. Se você quiser que os autores da página possam adicionar e remover componentes às páginas resultantes, será necessário adicionar um sistema de parágrafo ao modelo.
Quando os componentes são bloqueados, é possível adicionar conteúdo, que não pode ser editado pelos autores da página. Você pode desbloquear componentes para permitir que você defina Conteúdo inicial.
No modo de estrutura, os componentes que são o pai de um componente desbloqueado não podem ser movidos, recortados ou excluídos.
Quando um componente tiver sido desbloqueado, é possível definir o conteúdo inicial que será copiado para páginas resultantes, criado a partir do modelo. Esses componentes desbloqueados podem ser editados nas páginas resultantes.
No modo de conteúdo inicial, bem como nas páginas resultantes, todos os componentes desbloqueados que tenham um pai acessível (isto é, componentes dentro de um contêiner de layout) podem ser excluídos.
Aqui você pode predefinir o layout do modelo para os formatos de dispositivo necessários. O modo Layout de criação do modelo tem a mesma funcionalidade que o modo Layout da criação de página.
Em políticas de página, você pode conectar políticas de página predefinidas à página. Essas políticas da página definem as várias configurações de design.
O sistema de estilos permite ao autor do modelo definir classes de estilo na política de conteúdo de um componente para que autores de conteúdo possam selecioná-las ao editarem o componente em uma página. Esses estilos podem ser variações visuais alternativas de um componente, tornando-o mais flexível.
Consulte a documentação do Style System para obter mais informações.
O seletor de Modo na barra de ferramentas permite selecionar e editar o aspecto apropriado do modelo:
Já a opção Política de página no menu Informações de página permite selecionar as políticas de página necessárias:
Se um autor começar a editar um modelo que já foi ativado, um aviso será exibido. Isso serve para informar ao usuário que o modelo pode ser referenciado, de modo que qualquer alteração pode afetar as páginas que fazem referência ao modelo.
Em Estrutura modo como você define os componentes e o conteúdo para o modelo, a política para o modelo e seus componentes.
Os componentes definidos na estrutura do modelo não podem ser movidos em uma página resultante nem excluídos de qualquer página resultante.
Se desejar que os autores da página possam adicionar e remover componentes, adicione um sistema de parágrafo ao modelo.
Os componentes podem ser desbloqueados e bloqueados novamente para permitir que você defina o conteúdo inicial.
As políticas de design dos componentes e página são definidas.
Em Estrutura modo do editor de modelos:
Adicionar componentes
Há vários mecanismos para adicionar componentes ao modelo:
Depois de adicionado, cada componente é marcado com:
Ao adicionar um componente de Título pronto ao modelo, ele conterá estrutura de texto padrão.
Se alterar e adicionar seu próprio texto, esse texto atualizado será usado quando uma página for criada a partir do modelo.
Se deixar o texto padrão (estrutura) como está, o título será padrão para o nome da página subsequente.
Embora não seja idêntico, adicionar componentes e ativos a um modelo tem muitas coisa em comum com as ações semelhantes quando criação de página.
Ações do componente
Execute ações nos componentes depois de adicioná-los ao modelo. Cada instância individual tem uma barra de ferramentas que permite acessar as ações disponíveis. A barra de ferramentas depende do tipo de componente.
Além disso, ela pode ser dependente das ações executadas como quando uma política foi associada ao componente, o ícone de configuração de design é disponibilizado.
Editar e configurar
Com essas duas ações você pode adicionar conteúdo aos seus componentes.
Borda para indicar estrutura
Ao trabalhar no Estrutura um modo borda laranja indica o componente selecionado no momento. Uma linha pontilhada também indica o componente principal.
Por exemplo, na captura de tela abaixo da variável Texto estiver selecionado, em um Contêiner de layout (responsivegrid).
Política e propriedades (Geral)
As políticas de conteúdo (ou design) definem as propriedades de design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínima/máxima. Elas são aplicáveis ao modelo (e às páginas criadas com o modelo).
Crie uma política de conteúdo ou selecione uma existente para um componente. Isso permite que definir os detalhes do design.
A janela de configuração é dividida em dois.
As propriedades disponíveis dependem do componente selecionado. Por exemplo, para um componente de texto, as propriedades definem as opções de copiar e colar, as opções de formatação e o estilo de parágrafo, entre outras opções.
Política
As políticas de conteúdo (ou design) definem as propriedades de design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínima/máxima. Elas são aplicáveis ao modelo (e às páginas criadas com o modelo).
Em Política é possível selecionar uma política existente para aplicar ao componente por meio da lista suspensa.
Uma nova política pode ser adicionada ao selecionar o botão adicionar ao lado da lista suspensa Selecionar política. Um novo título deve ser especificado no campo Título da política.
A política existente selecionada na lista suspensa Selecionar política pode ser copiada como uma nova política usando o botão copiar ao lado do menu suspenso. Um novo título deve ser especificado no campo Título da política. Por padrão, a política copiada será denominada Cópia de X, onde X é o título da política copiada.
É opcional uma descrição da política no campo Descrição da política.
Na seção Outros modelos que também utilizam a política selecionada, você pode ver qual modelo utiliza a política selecionada na lista suspensa Selecionar política.
Se vários componentes do mesmo tipo forem adicionados como conteúdo inicial, a mesma política se aplica a todos os componentes. Isso reflete a mesma restrição em Modo Design para modelos estáticos.
Propriedades
Em Propriedades é possível definir as configurações do componente. O cabeçalho tem duas guias:
Principal
No Principal , as configurações mais importantes do componente são definidas.
Por exemplo, para um componente de imagem, as larguras permitidas podem ser definidas junto com a ativação do carregamento lento.
Se uma configuração permitir várias configurações, clique ou toque no botão Adicionar para adicionar outra configuração.
Para remover uma configuração, clique ou toque no botão Excluir localizado à direita da configuração.
Para remover uma configuração, clique ou toque no botão Excluir.
Recursos
O Recursos permite ativar ou desativar recursos adicionais do componente.
Por exemplo, para um componente de imagem, você pode definir as proporções de corte, orientações de imagem permitidas e se os uploads são permitidos.
Observe que no AEM, as proporções de corte estão definidas como altura/largura. Isso difere da definição convencional de largura/altura e é feita por motivos de compatibilidade de legado. Os usuários da criação de página não estarão cientes de qualquer diferença desde que você defina o Nome claramente, uma vez que este é exibido na interface do usuário.
As políticas de conteúdo para componentes que implementam o editor de rich text só podem ser definidas para opções disponibilizadas pelo RTE, por meio das configurações da interface.
Política e propriedades (contêiner de layout)
As configurações de política e propriedades de um contêiner de layout são semelhantes ao uso geral, mas com algumas diferenças.
Configurar uma política é obrigatório para componentes de contêiner, pois permite definir componentes que estarão disponíveis no contêiner.
A janela de configuração é dividida em dois, assim como no uso geral da janela.
Política
As políticas de conteúdo (ou design) definem as propriedades de design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínima/máxima. Elas são aplicáveis ao modelo (e às páginas criadas com o modelo).
Em Política é possível selecionar uma política existente para aplicar ao componente por meio da lista suspensa. Isso funciona exatamente da mesma forma que a janela de uso geral.
Propriedades
Em Propriedades é possível escolher quais componentes estão disponíveis para o contêiner de layout e definir suas configurações. O cabeçalho tem três guias:
Componentes permitidos
No Componentes permitidos , defina quais componentes estão disponíveis para o contêiner de layout.
Componentes padrão
No Componentes padrão , você define quais componentes são associados automaticamente a determinados tipos de mídia, de modo que, quando um autor arrastar um ativo do navegador de ativos, AEM saiba com qual componente associá-lo. Observe que somente os componentes com zonas para soltar estão disponíveis para essa configuração.
Clique ou toque em Adicionar mapeamento para adicionar um componente totalmente novo e o mapeamento de tipo MIME.
Selecione um componente na lista e clique ou toque em Adicionar tipo para adicionar outro tipo MIME a um componente já mapeado. Clique no ícone Excluir para remover a um tipo MIME.
Configurações responsivas
Na guia Configurações responsivas, é possível configurar o número de colunas na grade resultante do container de layout.
Desbloquear/bloquear componentes
Você desbloqueia/bloqueia componentes para definir se o conteúdo está disponível para alteração em Conteúdo inicial modo.
Quando um componente é desbloqueado:
Um indicador de cadeado aberto é mostrado na borda.
A barra de ferramentas do componente será ajustada adequadamente.
Qualquer conteúdo já inserido não será mais exibido em Estrutura modo.
Os pais do componente desbloqueado não podem ser movidos, recortados ou excluídos.
Isso inclui desbloquear componentes de contêiner para que outros componentes possam ser adicionados, no modo Conteúdo inicial ou nas páginas resultantes. Se você já tiver adicionado componentes/conteúdo ao contêiner antes de desbloqueá-lo, eles não serão mais exibidos quando estiverem no modo Estrutura, mas serão exibidos no modo Conteúdo inicial. No modo Estrutura, apenas o componente do contêiner será mostrado com sua lista de Componentes permitidos.
Para economizar espaço, o contêiner de layout não é expandido para acomodar a lista de componentes permitidos. Em vez disso, o contêiner se torna uma lista rolável.
Os componentes configuráveis são mostrados com um ícone de Política, no qual você pode tocar ou clicar para editar a política e as propriedades desse componente.
Relação com páginas existentes
Se a estrutura for atualizada depois de criar as páginas baseadas no modelo, então essas páginas refletirão as alterações no modelo. Um aviso é exibido na barra de ferramentas para lembrá-lo desse fato, junto com caixas de diálogo de confirmação.
Conteúdo inicial O modo é usado para o conteúdo definido que será exibido quando uma página for criada pela primeira vez com base no modelo. O conteúdo inicial pode ser editado pelos autores da página.
Embora todo o conteúdo criado no modo Estrutura seja visível no Conteúdo inicial, somente os componentes que foram desbloqueados podem ser selecionados e editados.
O modo Conteúdo inicial pode ser visto como um modo de edição para páginas criadas com esse modelo. Sendo assim, as políticas não estão definidas no modo Conteúdo inicial, mas no modo Estrutura.
Os componentes desbloqueados que estão disponíveis para edição são marcados. Quando selecionados, têm uma borda azul:
Os componentes desbloqueados têm uma barra de ferramentas, permitindo editar e configurar o conteúdo:
Se um componente do contêiner foi desbloqueado (no modo estrutura), você pode adicionar novos componentes ao contêiner (no modo Conteúdo inicial). Os componentes adicionados no modo Conteúdo inicial podem ser movidos para ou excluído das páginas resultantes.
Você pode adicionar o componente utilizando a área Arraste componentes até aqui ou a opção Inserir novo componente na barra de ferramentas do contêiner apropriado.
Se o conteúdo inicial do modelo for atualizado depois que as páginas forem criadas com base no modelo, então essas páginas não serão afetadas por alterações no conteúdo inicial no modelo.
O conteúdo inicial destina-se à preparação de componentes e do layout da página que servem como ponto de partida para a criação do conteúdo. Não se destina a ser o conteúdo real que permaneceria como está. Por isso, o conteúdo inicial não pode ser traduzido.
É possível definir o layout do modelo para um intervalo de dispositivos. O Layout responsivo para modelos funciona como na criação de página.
As modificações no layout serão refletidas no modo Conteúdo inicial, mas nenhuma alteração será vista no modo Estrutura.
O design da página, incluindo as bibliotecas do lado do cliente e as políticas de página necessárias, é mantido na opção Design da página do menu Informações da página.
Para acessar o Design da página caixa de diálogo:
No Editor de modelos, selecione Informações da página na barra de ferramentas, em seguida Design da página para abrir a caixa de diálogo.
O Design da página é aberta e dividida em duas seções:
É possível aplicar uma política de conteúdo ao modelo ou às páginas resultantes. Isso define a política de conteúdo do sistema de parágrafo principal na página.
É possível selecionar uma política existente para a página na lista suspensa Selecionar política.
Uma nova política pode ser adicionada ao selecionar o botão adicionar ao lado da lista suspensa Selecionar política. Um novo título deve ser especificado no campo Título da política.
A política existente selecionada na lista suspensa Selecionar política pode ser copiada como uma nova política usando o botão copiar ao lado do menu suspenso. Um novo título deve ser especificado no campo Título da política. Por padrão, a política copiada será denominada Cópia de X, onde X é o título da política copiada.
Defina um título para a política no campo Título da política. É necessário que a política tenha um título para que possa ser facilmente selecionada na lista suspensa Selecionar política.
É opcional uma descrição da política no campo Descrição da política.
Na seção Outros modelos que também utilizam a política selecionada, você pode ver qual modelo utiliza a política selecionada na lista suspensa Selecionar política.
Usando as propriedades de página, é possível definir as bibliotecas do lado do cliente necessárias usando a caixa de diálogo Design da página. Essas bibliotecas do lado do cliente incluem folhas de estilo e o javascript a serem carregados com o modelo e as páginas criadas com esse modelo.
Especifique as bibliotecas do lado do cliente que deseja aplicar às páginas criadas com este modelo. Inserção do nome de uma biblioteca no campo de texto na Bibliotecas do lado do cliente seção.
Se as várias bibliotecas forem necessárias, clique no botão Adicionar para adicionar um campo de texto extra para o nome da biblioteca.
Adicione quantos campos de texto forem necessário para suas bibliotecas do lado do cliente.
Defina a posição relativa das bibliotecas conforme necessário, ao arrastar os campos usando a alça de arrastar.
Como o autor do modelo pode especificar a política de página no modelo, ele precisará obter detalhes das bibliotecas do lado do cliente apropriadas do desenvolvedor.
Usando a opção Propriedades da página inicial, é possível definir as propriedades de página iniciais a ser usadas ao criar páginas resultantes.
No editor de modelo, selecione Informações da página na barra de ferramentas, em seguida Propriedades da página inicial para abrir a caixa de diálogo.
Na caixa de diálogo, é possível definir as propriedades que deseja aplicar às páginas criadas com esse modelo.
Confirme suas definições com Concluído.
Ao criar modelos, você deve considerar:
O impacto das alterações no modelo depois que as páginas forem criadas a partir desse modelo.
Esta é uma lista das diferentes operações possíveis em modelos, juntamente com a forma como afetam as páginas criadas a partir delas:
Alterações na estrutura:
Alterações nas políticas de conteúdo e configurações de design:
Alterações no conteúdo inicial:
As alterações no layout dependem se o componente modificado fizer parte de:
Tome especial cuidado ao:
Bloquear ou desbloquear componentes em modelos ativados.
Isso pode ter efeitos colaterais, já que as páginas existentes já podem usá-lo. Normalmente:
AEM dá avisos explícitos ao alterar o status de bloqueio de componentes em modelos que não são mais rascunhos.
Criar suas próprias pastas para seus modelos específicos de site.
Publicar seus modelos do Modelos console.