Modelos para criar páginas que são editáveis com o editor de páginas creating-page-templates
Você pode usar o Editor de modelos para criar modelos que seus autores de conteúdo podem usar para criar páginas que são editáveis com o Editor de páginas.
Visão geral overview
Quando um autor cria uma página, ele deve selecionar um modelo, que é usado como base para a nova página. O modelo define a estrutura da página resultante, qualquer conteúdo inicial e os componentes que podem ser usados ao editar a página no Editor de páginas.
Com o Editor de modelos, criar e manter modelos não é uma tarefa somente para desenvolvedores. Um tipo de usuário avançado, chamado de autor do modelo, pode criar modelos. Os desenvolvedores 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 envolver um desenvolvedor.
O Editor de Modelos permite que os autores de modelo:
- Adicione componentes ao modelo e posicione-os em uma grade responsiva.
- Pré-configurar os componentes.
- Defina quais componentes podem ser editados nas páginas criadas com o modelo.
Este documento explica como um autor do modelo pode usar 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 editáveis para obter mais informações.
Antes de começar before-you-start
Antes de começar, é importante considerar que a criação de um modelo requer colaboração. Por esse motivo, a Função é indicada para cada tarefa. Isso não afetará a maneira como você usa um modelo para criar uma página, mas afeta a maneira como uma página se relaciona com o modelo.
Funções roles
A criação de um novo modelo requer a 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
- Cria uma nova pasta de modelos requer direitos de
-
Desenvolvedor:
- Concentra-se nos detalhes técnicos/internos
- Precisa de experiência com o ambiente de desenvolvimento.
- Fornece ao autor do modelo as informações necessárias.
-
Autor do modelo:
-
Esse é um autor específico, membro do grupo
template-authors
- Isso atribui os privilégios e permissões necessários.
-
Pode configurar o uso de componentes e outros detalhes de alto nível que exigem:
- Algum conhecimento técnico
- Por exemplo, usar padrões ao definir caminhos.
- Informações técnicas do desenvolvedor.
- Algum conhecimento técnico
-
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.
Criação e gerenciamento de modelos creating-and-managing-templates
Ao criar um modelo editável, você:
-
Criar um novo modelo, inicialmente vazio
-
Definir propriedades adicionais para o modelo, se necessário
-
Editar o modelo para definir o:
- Estrutura - conteúdo predefinido que não pode ser alterado nas páginas criadas com o modelo.
- Conteúdo inicial - conteúdo predefinido que pode ser alterado nas páginas criadas com o modelo.
- Layout - para um intervalo de dispositivos.
- Estilos - defina os estilos a serem usados com o modelo e seus componentes.
-
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
Criação de uma pasta de modelo - Administrador creating-a-template-folder-admin
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.
Criação de um novo modelo - Autor do modelo creating-a-new-template-template-author
-
Abra o Console de Modelos e navegue até a pasta necessária.
note note NOTE 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.
note note NOTE 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.–> -
Conclua os Detalhes do modelo:
- Nome do modelo
- Descrição
-
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.
note note NOTE 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.
Definir propriedades do modelo - Autor do modelo defining-template-properties-template-author
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.
- Pode ser enviado
- Pode ser gerado com base no conteúdo do modelo
-
-
Título
- Um título usado para identificar o modelo, como no assistente de Criar página.
-
Descrição
- Uma descrição opcional para fornecer mais informações sobre o modelo e seu uso, que pode ser vista, por exemplo, no assistente Criar página.
Depois de criar o modelo, use o Console de Modelos para exibir ou editar as propriedades do modelo.
Imagem em miniatura do modelo template-thumbnail-image
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 carregar uma miniatura, selecione Carregar Imagem
- Para gerar uma miniatura, selecione Gerar visualização
-
Para ambos os métodos, uma visualização da miniatura será exibida.
- Se não for satisfatório, selecione Limpar para carregar outra imagem ou gerar novamente a miniatura.
-
Quando estiver satisfeito com a miniatura, selecione Salvar e fechar.
Ativar e permitir um modelo - Autor do modelo enabling-and-allowing-a-template-template-author
Para poder usar um modelo ao criar uma página é necessário:
- Ativar o modelo para disponibilizá-lo para o uso na criação de páginas.
- Permitir o modelo para especificar as ramificações de conteúdo nas quais o modelo pode ser usado.
Habilitar um modelo - Autor do modelo enabling-a-template-template-author
Um modelo pode ser habilitado ou desabilitado para torná-lo disponível ou indisponível no assistente de Criar Página.
Use o Console de Modelos para habilitar ou desabilitar um modelo.
Ativar um modelo - Autor allowing-a-template-author
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 são verificados e todos os modelos são recuperados.
note note NOTE Se a lista Modelos permitidos for deixada vazia, a se subirá a árvore 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.
Publicar um modelo - Autor do modelo publishing-a-template-template-author
À medida que o modelo for referenciado quando a página for renderizada, o modelo totalmente configurado deverá ser publicado, para estar disponível no ambiente de publicação.
Modelos do Publish usando o Console de Modelos.
Editar modelos - Autores do modelo editing-templates-template-authors
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.
O seletor de Modo na barra de ferramentas permite selecionar e editar o aspecto apropriado do modelo:
Enquanto 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:
Atributos do modelo template-attributes
Os seguintes atributos de um modelo podem ser editados:
Estrutura template-structure
Os componentes adicionados à estrutura 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 o Conteúdo inicial.
Conteúdo inicial template-initial-content
Quando um componente tiver sido desbloqueado, é possível definir o conteúdo inicial que é copiado para as páginas resultantes, criadas a partir do modelo. Esses componentes desbloqueados podem ser editados nas páginas resultantes.
Layout template-layout
Com o layout, é possível 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.
Políticas da página template-page-policies
As políticas de página podem conectar políticas de página predefinidas à página. Essas políticas da página definem as várias configurações de design.
Estilos template-styles
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 Sistema de Estilos para obter mais informações.
Editar um modelo - Estrutura - Autor do modelo editing-a-template-structure-template-author
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 o conteúdo inicial.
- As políticas de design dos componentes e página são definidas.
Você pode realizar várias ações no modo Estrutura do editor de modelo e vários recursos para ajudá-lo a:
Adicionar componentes add-components
Existem vários mecanismos para adicionar componentes ao modelo:
- No navegador de Componentes no painel lateral.
- Ao usar a opção Inserir componente, disponível na barra de ferramentas dos componentes já no modelo ou na caixa Arrastar componentes até aqui.
- 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:
- Uma borda
- Um marcador para mostrar o tipo de componente
- Um marcador para mostrar quando o componente foi desbloqueado
Ações do componente component-actions
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 edit-and-configure
Com essas duas ações você pode adicionar conteúdo aos seus componentes.
Estrutura de Borda indicadora border-to-indicate-structure
Ao trabalhar no modo Estrutura uma borda laranja indica o componente selecionado no momento. Uma linha pontilhada também indica o componente principal.
Política e propriedades (Geral) policy-and-properties-general
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.
- Do lado esquerdo da caixa de diálogo, em Política, você pode selecionar uma política existente.
- Do lado direito da caixa de diálogo, em Propriedades, você pode definir as propriedades específicas ao tipo de componente.
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.
Política policy
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, você pode 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 do menu suspenso Selecionar política. Forneça um novo título 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 da lista suspensa. Forneça um novo título 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 usam a política selecionada, você pode ver qual modelo usa a política selecionada na lista suspensa Selecionar política.
Propriedades properties
No cabeçalho Propriedades, é possível definir as configurações do componente. O cabeçalho tem duas guias:
- Principal
- Recursos
Principal main
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, selecione o botão Adicionar para adicionar outra configuração.
Para remover uma configuração, selecione o botão Excluir, localizado à direita da configuração.
Para remover uma configuração, clique no botão Excluir.
Recursos features
A guia Recursos permite habilitar ou desabilitar 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.
Política e propriedades (container de layout) policy-and-properties-layout-container
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 janela de configuração é dividida em duas, assim como no uso geral da janela.
Política policy-layout
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 properties-layout
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
- Componentes padrão
- Configurações responsivas
Componentes permitidos allowed-components
Na guia Componentes permitidos, você define quais componentes estão disponíveis para o container de layout.
- Os componentes são agrupados por seus grupos de componentes, que podem ser expandidos e recolhidos.
- Um grupo inteiro pode ser selecionado ou desmarcados, marcando ou desmarcando o nome do grupo.
- Um sinal de menos representa pelo menos um, mas não todos os itens em um grupo estão selecionados.
- Há uma pesquisa disponível para filtrar um componente por nome.
- As contagens listadas à direita do nome do grupo de componentes representam o número total de componentes selecionados nesses grupos, independentemente do filtro.
Componentes padrão default-components
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. Somente os componentes com zonas de lançamento estão disponíveis para essa configuração.
Selecione Adicionar mapeamento para adicionar um componente totalmente novo e um mapeamento de tipo MIME.
Selecione um componente na lista e selecione 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 responsive-settings
Na guia Configurações responsivas, é possível configurar o número de colunas na grade resultante do container de layout.
Desbloquear e bloquear componentes unlock-and-lock-components
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 é ajustada de acordo.
- Qualquer conteúdo já inserido não será mais exibido no modo Estrutura.
- O conteúdo já inserido é considerado conteúdo inicial e é visível apenas no modo Conteúdo inicial.
- 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 já tiver adicionado componentes/conteúdo ao container antes de desbloqueá-lo, eles não serão mais exibidos quando estiver no modo Estrutura, mas serão exibidos no modo Conteúdo inicial. 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 relationship-to-existing-pages
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.
Editar um modelo - Conteúdo inicial - Criação editing-a-template-initial-content-author
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.
-
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.
Editar um modelo - Layout - Autor do modelo editing-a-template-layout-template-author
É 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.
Editar um modelo - Política da página - Autor/desenvolvedor do modelo editing-a-template-page-policy-template-author-developer
A política da página, incluindo as bibliotecas obrigatórias do lado do cliente, é mantida na opção Política da página do menu Informações da página.
Para acessar a caixa de diálogo Política da página:
-
No Editor de modelo, selecione Informações da página na barra de ferramentas, em seguida Política da página para abrir a caixa de diálogo.
-
A caixa de diálogo Política da página é aberta e dividida em duas seções:
- A metade esquerda define as políticas da página
- A metade direita define as propriedades da página
Políticas da página page-policies
É 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. Forneça um novo título 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 da lista suspensa. Forneça um novo título 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 usam a política selecionada, você pode ver qual modelo usa a política selecionada na lista suspensa Selecionar política.
Propriedades da página page-properties
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.
Editar um modelo - Propriedades da página inicial - Criação editing-a-template-initial-page-properties-author
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.
Práticas recomendadas best-practices
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:
- Elas são aplicadas imediatamente às páginas resultantes.
- A publicação do modelo alterado ainda é necessária para que os visitantes vejam as alterações.
-
Alterações nas políticas de conteúdo e configurações de design:
- Elas se aplicam imediatamente às páginas resultantes.
- A publicação das alterações é necessária para que os visitantes vejam as alterações.
-
Alterações no conteúdo inicial:
- Elas se aplicam somente às páginas criadas após as alterações no modelo.
-
As alterações no layout dependem se o componente modificado faz parte de:
- Somente estrutura - aplicado imediatamente
- Possui conteúdo inicial - somente em páginas criadas após a alteração
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:
- Os componentes desbloqueados (que estavam bloqueados) não estão presentes nas páginas existentes.
- Bloquear os componentes (que eram editáveis) ocultará esse conteúdo para que não seja exibido nas páginas.
note note NOTE 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.
-
Publish seus modelos do console [Modelos.](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/sites/administering/templates-console.html?lang=pt-BR)