Ao criar uma página, você deve selecionar um modelo, que será usado como a base de criação da 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 do modelo:
O Editor de modelo permite que os autores do modelo:
Este documento explica como um autor de modelo pode usar o console e o editor de modelo 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áveis 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 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 pontos a seguir 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 for configurada, pode ser útil estar ciente de que o AEM agora oferece dois tipos básicos de modelo. Isso não afetará como você usa 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 o 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:
Admin:
Cria uma nova pasta de modelos requer direitos de admin
.
Tais 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 dos componentes e outros detalhes de alto nível, que requer:
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 estão listadas com a função responsável por levá-las.
O AEM agora oferece dois tipos básicos de modelos:
Podem ser criados e editados pelos autores de modelo usando o console e o editor de Modelo. O console Modelo é acessível na seção Geral do console Ferramentas.
Depois que a nova página for criada, uma conexão dinâmica será mantida entre a página e o modelo. Isso significa que as alterações à estrutura e/ou ao conteúdo do modelo serão refletidas em todas as páginas criadas com esse modelo. As alterações ao conteúdo desbloqueado (isto é inicial) não serão refletidas.
Use as políticas de conteúdo, que você pode definir no editor do modelo, para continuar com as propriedades de design. O modo 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 edição de modelos editáveis. Portanto, este documento foca exclusivamente nos modelos editáveis.
Ao usar um modelo para criar uma nova página, não há diferenças visíveis e nenhuma indicação entre os 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. Disponível na seção Geral do console Ferramentas.
É 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:
Ativar modelo para uso ao criar uma página
Ativar modelo para a página ou a ramificação obrigató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 qualquer informação que precise ser internacionalizada em um modelo. Para fins de internalização, o 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. Trata-se de uma tarefa de administrador e está descrita no documento Modelos de página - Editáveis.
Abra o console Modelos (em Ferramentas -> Geral) para navegar até a pasta necessária.
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, em seguida selecione Avançar.
Os tipos de modelo são layouts predefinidos e podem ser considerados modelos de um modelo. Eles são predefinidos pelos desenvolvedores ou pelo administrador do sistema. Encontre mais informações podem ser encontradas no documento do desenvolvedor Modelos de página - Editáveis.
Preencha os 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 modelo pode ter as seguintes propriedades:
Imagem
A imagem a ser usada como uma miniatura do modelo para auxiliar na seleção, como o assistente 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 será exibida uma visualização de miniatura.
Se não for satisfatório, clique ou toque em Limpar para fazer o upload de outra imagem ou para gerar a miniatura novamente.
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 habilitado ou desabilitado para torná-lo disponível ou indisponível no assistente Criar página.
Uma vez que um modelo estiver habilitado um aviso será exibido quando um autor de modelo começar a atualizar o modelo. Este aviso tem o objetivo de informar o usuário de que o modelo pode ser referenciado, de modo que todas as alterações podem afetar as páginas que fazem referência a ele.
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 os modelos recuperados.
Se a lista Modelos permitidos de 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.
Selecione Publicar na barra de ferramentas para concluir a ação.
Ao criar ou editar um modelo há vários aspectos que podem ser definidos. A edição 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 desejar que os autores da página possam adicionar e remover os componentes para páginas resultantes, é necessário adicionar um sistema de parágrafos ao modelo.
Quando os componentes estiverem bloqueados, você pode adicionar conteúdo, o qual não poderá ser editado pelos autores da página. É possível desbloquear componentes para permitir que você defina o conteúdo inicial.
No modo de estrutura, nenhum componente pai de um componente desbloqueado pode ser movido, recortado ou ser excluído.
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 é 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.
Nas 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.
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 habilitado, ativado um aviso será exibido. Este aviso tem o objetivo de informar o usuário de que o modelo pode ser referenciado, de modo que todas as alterações podem afetar as páginas que fazem referência a ele.
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 ou 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.
No modo Estrutura do editor de modelo:
Adicione componentes
Há vários mecanismos para adicionar componentes ao modelo:
No navegador Componentes no painel lateral.
Ao usar a opção Inserir componente (ícone +), 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.
Uma vez 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 ao criar a página.
Ações do componente
Execute ações nos componentes em uma vez que tiverem sido adicionadas 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 que o componente selecionado no momento. Uma linha pontilhada também indica o componente pai.
Por exemplo, no instantâneo abaixo do componente Texto é selecionado, dentro de um contêiner de layout (responsivegrid).
Política e propriedades (geral)
As políticas do conteúdo (ou design) definem as propriedades do design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínimas/máximas. Eles 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, de formatação e o estilo de parágrafo, entre outras.
Política
As políticas do conteúdo (ou design) definem as propriedades do design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínimas/máximas. Eles 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 no Modo Design dos modelos estáticos.
Propriedades
No cabeçalho Propriedades você pode definir as configurações do componente. O cabeçalho tem duas guias:
Principal
Na guia Principal, são definidas as configurações mais importantes do componente.
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
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, orientações de imagem permitidas e se os uploads estã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.
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 do contêiner porque isso permite definir os componentes que estarão disponíveis no contêiner.
A janela de configuração é dividida em dois, como na janela de uso geral.
Política
As políticas do conteúdo (ou design) definem as propriedades do design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínimas/máximas. Eles 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
No cabeçalho Propriedades você pode escolher quais componentes estarão disponíveis para o contêiner 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 contêiner de layout.
Componentes padrão
Na guia 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 do ativo, o AEM saiba com que componente associá-lo. Observe que apenas 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 tipo de mapeamento 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ê bloqueia/desbloqueia componentes para definir se o conteúdo estará disponível para a modificação no modo Conteúdo inicial.
Quando um componente é desbloqueado:
Um indicador de cadeado aberto é exibido na borda.
A barra de ferramentas do componente será ajustada adequadamente.
Todo o conteúdo já inserido não será mais mostrado 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 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.
O modo Conteúdo inicial é usado para o conteúdo definido que aparecerá quando uma página for inicialmente criada com base no modelo. O conteúdo inicial pode ser editado por 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 disponíveis para edição são marcados. Quando selecionados, apresentam 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 a preparar componentes e o layout de 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 intacto. 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 a caixa de diálogo Design da página:
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.
A caixa de diálogo 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 esse modelo. Digitando o nome de uma biblioteca no campo de texto da 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.
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 em Concluído.
Ao criar modelos você deve considerar:
O impacto das modificações no modelo depois que as páginas foram criadas a partir desse modelo.
Veja uma lista das diferentes operações possíveis nos modelos e como elas 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 de se o componente modificado for parte:
Tome cuidado especial ao:
Bloquear ou desbloquear componentes em modelos permitidos.
Isso pode ter efeitos colaterais, uma vez que as páginas já existentes podem estar usando o modelo. Geralmente:
O AEM dá avisos explícitos ao alterar o status de bloqueio de componentes nos modelos que não são mais rascunhos.
Criar suas próprias pastas para os modelos específicos de site.
Publicar os modelos a partir do console Modelos.