Ao criar uma página, você deve selecionar um modelo, que é usado como base para a criação da nova página. O modelo define a estrutura da página resultante, todo 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 de Modelos permite que os autores de modelo:
O Editor de Modelos permite que os autores de modelo:
Este documento explica como um autor do modelo pode usar o console de modelos e o editor para criar e gerenciar modelos editáveis.
Para obter informações detalhadas sobre como os modelos editáveis funcionam em nível técnico, consulte o documento do desenvolvedor Modelos de página - Editável para obter mais informações.
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 de modelos não devem ser usados com a interface 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 iniciar:
A criação de um modelo requer colaboração. Por esta razão, a Função é indicado para cada tarefa.
Dependendo de como sua instância está configurada, o 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.
Criação de um template usando o Console de modelos e a variável Editor de modelo O requer colaboração entre as seguintes funções:
Administrador:
Cria uma nova pasta de modelos requer direitos de admin
.
Essas tarefas também podem ser realizadas por um desenvolvedor
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, é necessário um ambiente de desenvolvimento, o que requer conhecimento/experiência.
As tarefas detalhadas neste documento são listadas com a função responsável por executá-las.
O AEM agora oferece dois tipos básicos de modelos:
Pode ser criado e editado por autores de modelo usando o Modelo console e editor. A variável Modelo o console pode ser acessado na Geral seção do Ferramentas console.
Após a criação da nova página, uma conexão dinâmica é mantida entre a página e o modelo. Isso significa que as alterações na estrutura do modelo e/ou no conteúdo bloqueado serão refletidas em qualquer página criada com esse modelo. As alterações no conteúdo desbloqueado (ou seja, inicial) não serão refletidas.
Use políticas de conteúdo, que você pode definir no editor de modelo, para manter as propriedades de design. O modo de design no editor de páginas não é mais usado para modelos editáveis.
Modelos estáticos
Por definição, o console de modelo e o editor de modelo permitem apenas a criação e a edição de modelos editáveis. Portanto, este documento se concentra exclusivamente em modelos editáveis.
Ao usar um modelo para criar uma 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 modelo editável, você:
Use o console Modelo. Isso está disponível na seção Geral do console Ferramentas.
É possível criar uma pasta para os modelos se necessário
Criar um modelo, que está inicialmente vazio
Definir propriedades adicionais para o modelo, se necessário
Editar o modelo para definir o:
Habilitar 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 torná-lo disponível no ambiente de publicação
Os Modelos permitidos geralmente são predefinidos quando seu site for inicialmente configurado.
Nunca insira nenhuma informação que precise ser internacionalizado em um modelo. Para efeitos de internalização, a recursos de localização dos Componentes principais são recomendadas.
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 de 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.
É uma prática recomendada usar uma pasta de modelo criada para o seu projeto.
Selecione Criar, em seguida Criar modelo para abrir o assistente.
Escolha um Tipo de modelo e clique em Próximo.
Os tipos de modelo são layouts predefinidos de modelos e podem ser considerados como modelos para 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.
Conclua os Detalhes do modelo:
Selecione Criar. Uma confirmação for exibida, selecione Abertura para iniciar editar o modelo ou Concluído para retornar ao console 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 modelo pode ter as seguintes propriedades:
Imagem
Imagem a ser usada como miniatura do modelo para auxiliar na seleção, como no assistente de Criar página.
Título
Descrição
Para exibir e/ou editar as propriedades:
Os modelos são ferramentas eficientes para simplificar o fluxo de trabalho de criação de página. No entanto, usar modelos em excesso pode sobrecarregar os autores e tornar confusa a criação da página. Uma boa regra geral é manter o número de modelos abaixo de 100.
A Adobe não recomenda ter mais de 1000 modelos devido a possíveis impactos no desempenho.
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 modelo.
Para ambos os métodos, uma pré-visualização da miniatura será exibida.
Se não for satisfatório, clique em Limpar para carregar outra imagem ou gerar novamente a miniatura.
Quando estiver satisfeito com a miniatura, clique em Salvar e fechar.
Para poder usar um modelo ao criar uma página é necessário:
Um modelo pode ser habilitado ou desabilitado para torná-lo disponível ou indisponível no assistente de Criar Página.
Quando um modelo estiver ativado, um aviso será exibido quando um autor do modelo começar a atualizar mais o modelo. Isso é para informar ao usuário que o modelo pode ter sido referenciado, de modo que qualquer alteração pode afetar as páginas que lhe fazem referência.
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 para seu(s) modelo(s).
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 verificados e todos os modelos serão recuperados.
Se a variável Modelos permitidos for deixada vazia, a árvore será ascendente 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.
Selecione 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 modelo podem ser editados:
Os componentes adicionados aqui não podem ser movidos/removido das páginas resultantes pelos autores da página. Se quiser que os autores de página possam adicionar e remover componentes de páginas resultantes, será necessário adicionar um sistema de parágrafo ao modelo.
Quando os componentes estiverem bloqueados, é possível adicionar conteúdo, que não pode ser editado por autores da página. É possível desbloquear componentes para permitir definir Conteúdo inicial.
No modo estrutura, os componentes principais 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, e nas páginas resultantes, qualquer componente desbloqueado que tenha uma página principal acessível (ou seja, componentes dentro de um container de layout) pode ser excluído.
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, é possível 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.
A variável Modo o seletor na barra de ferramentas permite selecionar e editar o aspecto apropriado do modelo:
Embora a Política da página opção no Informações da página permite que você selecionar as políticas de página necessárias:
Se um autor começar a editar um modelo que já foi habilitado, um aviso será exibido. Isso é para informar ao usuário que o modelo pode ter sido referenciado, de modo que qualquer alteração pode afetar as páginas que lhe fazem referência.
No modo Estrutura você define os componentes e o conteúdo para o modelo, a política do 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 de 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 conteúdo inicial.
As políticas de design dos componentes e página são definidas.
Entrada Estrutura modo do editor de modelos:
Adicionar componentes
Existem vários mecanismos para adicionar componentes ao modelo:
No navegador de Componentes no painel lateral.
Ao usar o Inserir componente opção (+ ícone) disponível na barra de ferramentas dos componentes já no modelo ou no Arraste os componentes para cá caixa.
Ao arrastar um ativo (no navegador de Ativos no painel lateral) diretamente no modelo para gerar o componente adequado no local.
Após adicionado, cada componente é marcado com:
Ao adicionar um componente de Título pronto ao modelo, ele conterá estrutura de texto padrão.
Se você alterar isso 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 ao criar a página.
Ações do componente
Execute ações nos componentes uma vez que eles tenham sido adicionados 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 modo Estrutura uma borda laranja indica o componente selecionado no momento. Uma linha pontilhada também indica o componente principal.
Por exemplo, na captura de tela abaixo de Texto for selecionado, dentro de um Contêiner de layout (responvegrid).
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 ele).
Crie uma política de conteúdo ou selecione uma existente para um componente. Isso permite que você defina 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, de formatação e de 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 ele).
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 no Modo Design para modelos estáticos.
Propriedades
No cabeçalho Propriedades, é possível definir as configurações do componente. O cabeçalho tem duas guias:
Principal
Na guia Principal, as configurações mais importantes do componente são definidas.
Por exemplo, para um componente de imagem, as larguras permitidas podem ser definidas juntamente com a ativação de carregamento lento.
Se uma configuração permitir várias configurações, clique no link Adicionar para adicionar outra configuração.
Para remover uma configuração, clique no link Excluir localizado à direita da configuração.
Para remover uma configuração, clique no botão Excluir .
Recursos
A variável Recursos permite ativar ou desativar recursos adicionais do componente.
Por exemplo, para um componente de imagem, é possível definir as proporções de corte, as 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 legal. 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.
Políticas de conteúdo para componentes que implementam o editor de rich text O só pode ser definido para opções disponibilizadas pelo RTE por meio das configurações da interface do usuário. 🔗 🔗
Política e propriedades (contêiner de layout)
As configurações de política e propriedades de um container de layout são semelhantes ao uso geral, mas com algumas diferenças.
A configuração de uma política é obrigatória para componentes de contêiner, pois permite definir componentes que estarão disponíveis no contêiner.
A janela de configuração é dividida em duas, 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 ele).
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
No cabeçalho Propriedades, é posível escolher quais componentes estão disponíveis para o container de layout e definir suas configurações. O cabeçalho tem três guias:
Componentes permitidos
Na guia Componentes permitidos, você define quais componentes estão disponíveis para o container de layout.
Componentes padrão
Na guia Componentes padrão, você define quais componentes são associados automaticamente a determinados tipos de mídia para que, quando um autor arrastar um ativo do navegador de ativos, o 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 em Adicionar mapeamento para adicionar um componente totalmente novo e mapeamento de tipo MIME.
Selecione um componente na lista e clique 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 no modo Conteúdo inicial.
Quando um componente tiver sido desbloqueado:
Um indicador de cadeado aberto é mostrado na borda.
A barra de ferramentas do componente será ajustada de acordo.
Qualquer conteúdo já inserido não será mais exibido no modo Estrutura.
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 em Estrutura , mas são mostrados na Conteúdo inicial modo. No modo Estrutura, somente o componente de container será exibido com a 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 container 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.
O modo Conteúdo inicial é usado para definir o conteúdo que aparecerá quando uma página for criada pela primeira vez com base no modelo. O conteúdo inicial poderá ser posteriormente editado pelos autores de 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, eles 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 se destina à preparação de componentes e do layout da página que servem como ponto de partida para a criação do conteúdo. Ele não se destina a ser o conteúdo real que permaneceria como está. Por esse motivo, o conteúdo inicial não pode ser traduzido.
Se você precisar incluir texto traduzível no modelo, como em cabeçalhos ou rodapés, poderá usar os recursos de localização dos componentes principais.
É 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 diálogo:
No Editor de modelo, selecione Informações da página na barra de ferramentas, em seguida Design da página para abrir a caixa de diálogo.
A variável 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 seção Bibliotecas do lado do cliente.
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.
Embora o autor do modelo possa especificar a política de página no modelo, ele deve 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 tiverem sido criadas a partir dele.
Esta é uma lista das diferentes operações possíveis nos modelos, juntamente com como elas afetam as páginas criadas a partir deles:
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 faz parte de:
Tenha muito cuidado quando:
Bloquear ou desbloquear componentes em modelos habilitados.
Isso pode ter efeitos colaterais, pois as páginas podem já está usando-os. Normalmente:
O AEM emite 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 modelos específicos do site.
Publicar seus modelos a partir do console Modelos.