Fragmentos de conteúdo do autor
No capítulo anterior, você criou cinco modelos de fragmento de conteúdo: pessoa, equipe, local, endereço e informações de contato. Este capítulo percorre as etapas para criar fragmentos de conteúdo com base nesses modelos. Também explica como criar políticas de pastas para limitar quais modelos de fragmento de conteúdo podem ser usados na pasta.
Pré-requisitos prerequisites
Este documento faz parte de um tutorial dividido em várias partes. Verifique se o capítulo anterior foi concluído antes de continuar com este capítulo.
Objetivos objectives
Neste capítulo, saiba como:
- Criar pastas e definir limites usando políticas de pastas
- Criar referências de fragmento diretamente do editor de Fragmento de conteúdo
- Use os tipos de dados Guia, Data e Objeto JSON
- Inserir referências de conteúdo e fragmento no editor de texto de várias linhas
- Adicionar várias referências de fragmento
- Aninhar fragmentos de conteúdo
Instalar conteúdo de amostra sample-content
Instale um pacote de AEM que contenha várias pastas e imagens de amostra usadas para acelerar o tutorial.
-
No AEM, navegue até Ferramentas > Implantação > Pacotes para acessar o Gerenciador de pacotes.
-
Carregue e instale o pacote (arquivo zip) baixado na etapa anterior.
Criar pastas e definir limites usando políticas de pastas
Na página inicial do AEM, selecione Assets > Arquivos > WKND Compartilhado > Inglês. Aqui você pode ver as várias categorias de Fragmento de conteúdo, incluindo Aventuras e Colaboradores.
Criar pastas create-folders
Navegue até a pasta Aventuras. Você pode ver que as pastas para Equipes e Locais já foram criadas para armazenar Fragmentos de conteúdo de Equipes e Locais.
Crie uma pasta para os Fragmentos de conteúdo dos instrutores que são baseados no Modelo de fragmento de conteúdo de pessoa.
-
Na página Aventuras, selecione Criar > Pasta no canto superior direito.
-
No modal Criar pasta exibido, digite "Professor" no campo Título. Observe o 's' no final. Os títulos das pastas que contêm muitos fragmentos devem ser plurais. Selecione Criar.
Agora você criou uma pasta para armazenar o Adventure Instructors.
Definir limites usando políticas de pasta
O AEM permite definir permissões e políticas para pastas de Fragmento de conteúdo. Ao usar as permissões, você pode conceder acesso a determinadas pastas apenas a determinados usuários (autores) ou grupos de autores. Com as políticas de pastas, é possível limitar os modelos de fragmento de conteúdo que os autores podem usar nessas pastas. Neste exemplo, vamos limitar uma pasta aos modelos de Pessoa e Informações de contato. Para configurar uma política de pasta:
-
Selecione a pasta Professor que você criou e selecione Propriedades na barra de navegação superior.
-
Selecione a guia Políticas e desmarque Herdado de /content/dam/wknd-shared. No campo Modelos de fragmento de conteúdo permitidos por caminho, selecione o ícone de pasta.
-
Na caixa de diálogo Selecionar caminho que é aberta, siga o caminho conf > WKND Compartilhado. O modelo de fragmento de conteúdo de pessoas, criado no capítulo anterior, contém uma referência ao modelo de fragmento de conteúdo de informações de contato. Os modelos de Informações de pessoa e contato devem ser permitidos na pasta Professores para criar um Fragmento de conteúdo do professor. Selecione Pessoa e Informações de contato e pressione Selecionar para fechar a caixa de diálogo.
-
Selecione Salvar e Fechar e OK na caixa de diálogo de êxito exibida.
-
Agora você configurou uma política de pasta para a pasta de instrutores. Navegue até a pasta Professor e selecione Criar > Fragmento do conteúdo. Os únicos modelos que agora você pode selecionar são Pessoa e Informações de contato.
Fragmentos de conteúdo de autor para professores
Navegue até a pasta Professor. Aqui, vamos criar uma pasta aninhada para armazenar as informações de contato dos instrutores.
Siga as etapas descritas na seção em criando pastas para criar uma pasta denominada "Informações de contato". A pasta aninhada herda as políticas de pasta da pasta principal. Você pode configurar políticas mais específicas para que a pasta recém-criada permita que apenas o modelo de Informações de contato seja usado.
Criar um fragmento do conteúdo do professor
Vamos criar quatro pessoas que podem ser adicionadas a uma equipe de professores de aventura.
-
Na pasta Professores, crie um Fragmento de conteúdo com base no Modelo de fragmento de conteúdo de pessoa e atribua a ele o título de "Jacob Wester".
O fragmento de conteúdo recém-criado tem a seguinte aparência:
-
Insira o seguinte conteúdo nos campos:
- Nome completo: Jacob Wester
- Biografia: Jacob Wester é um instrutor de caminhada há dez anos e amou cada minuto! Jacob é um buscador de aventura com um talento para escalar e mochila. Jacob é o vencedor de competições de escalada, incluindo a Batalha da Baía competição de pedregulhos. Jacob atualmente mora na Califórnia.
- Nível de experiência do professor: especialista
- Habilidades: escalada, surf, mochilas
- Detalhes do administrador: Jacob Wester tem coordenado aventuras de mochila por três anos.
-
No campo Imagem do Perfil, adicione uma referência de conteúdo a uma imagem. Navegue até WKND Compartilhado > Inglês > Colaboradores > jacob_wester.jpg para criar um caminho para a imagem.
Criar uma referência de fragmento por meio do editor de Fragmento de conteúdo fragment-reference-from-editor
O AEM permite criar uma referência de fragmento diretamente do editor de fragmentos de conteúdo. Vamos criar uma referência para as informações de contato do Jacob.
-
Selecione Novo fragmento do conteúdo abaixo do campo Informações de contato.
-
O modal Novo fragmento de conteúdo é aberto. Na guia Selecionar destino, siga o caminho Aventuras > Professor e marque a caixa de seleção ao lado da pasta Informações de contato. Selecione Avançar para prosseguir para a guia Propriedades.
-
Na guia Propriedades, digite "Informações de contato do Jacob Wester" no campo Título. Selecione Criar e pressione Abrir na caixa de diálogo êxito exibida.
Novos campos que permitem editar o fragmento de conteúdo das informações de contato são exibidos.
-
Insira o seguinte conteúdo nos campos:
- Telefone: 209-888-0000
- Email: jwester@wknd.com
Quando terminar, selecione Salvar. Agora você criou um fragmento de conteúdo das informações de contato.
-
Para voltar para o fragmento de conteúdo do professor, selecione Jacob Wester no canto superior esquerdo do editor.
O campo Informações de contato agora contém o caminho para o fragmento de informações de contato referenciado. Esta é uma referência de fragmento aninhado. O fragmento concluído do conteúdo do professor tem esta aparência:
-
Selecione Salvar e fechar para salvar o fragmento de conteúdo. Agora você tem um novo Fragmento do conteúdo do professor.
Criar fragmentos adicionais
Siga o mesmo processo descrito na seção anterior para criar mais três fragmentos de conteúdo de instrutores e três fragmentos de conteúdo de informações de contato para esses instrutores. Adicione o seguinte conteúdo nos fragmentos de Professores:
Stacey Roswells
Kumar Selvaraj
Ayo Ogunseinde
Deixe o campo Informações Adicionais vazio.
Adicione as seguintes informações nos fragmentos de Informações de contato:
Agora você está pronto para criar uma Equipe!
Criação de fragmentos de conteúdo para locais
Navegue até a pasta Locais. Aqui, você vê duas pastas aninhadas que já foram criadas: Parque Nacional de Yosemite e Yosemite Valley Lodge.
Ignore a pasta Yosemite Valley Lodge por enquanto. Retornamos a ela posteriormente nesta seção quando criamos um local que atua como Base Inicial para nossa equipe de instrutores.
Acesse a pasta Parque Nacional de Yosemite. Atualmente, contém apenas uma foto do Parque Nacional de Yosemite. Vamos criar um Fragmento de conteúdo usando o Modelo de fragmento de conteúdo de localização e intitulá-lo de "Parque Nacional de Yosemite".
Marcadores de posição de guias
O AEM permite usar espaços reservados para guias, a fim de agrupar diferentes tipos de conteúdo e facilitar a leitura e o gerenciamento dos fragmentos de conteúdo. No capítulo anterior, você adicionou espaços reservados para guias ao modelo de Localização. Como resultado, o Fragmento de Conteúdo de Local agora tem duas seções de guia: Detalhes de Local e Endereço de Local.
A guia Detalhes do Local contém os campos Nome, Descrição, Informações de Contato, Imagem do Local e Clima por Temporada, enquanto a guia Endereço do Local contém uma referência a um Fragmento de Conteúdo de Endereço. As guias deixam claro quais tipos de conteúdo devem ser preenchidos, de modo que a criação de conteúdo é mais fácil de gerenciar.
Tipo de dados Objeto JSON
O campo Tempo por Temporada é um tipo de dados Objeto JSON, o que significa que ele aceita dados no formato JSON. Esse tipo de dados é flexível e pode ser usado para qualquer dado que você queira incluir no seu conteúdo.
Você pode ver a descrição do campo criada no capítulo anterior, passando o mouse sobre o ícone de informações à direita do campo.
Nesse caso, precisamos fornecer o tempo médio para o local. Insira os seguintes dados:
{
"summer": "81 / 89°F",
"fall": "56 / 83°F",
"winter": "46 / 51°F",
"spring": "57 / 71°F"
}
O campo Tempo por Temporada agora deve ter esta aparência:
Adicionar conteúdo
Vamos adicionar o restante do conteúdo ao Fragmento do conteúdo de localização para consultar as informações com o GraphQL no próximo capítulo.
-
Na guia Detalhes do local, insira as seguintes informações nos campos:
- Nome: Parque Nacional de Yosemite
- Descrição: o Parque Nacional de Yosemite está localizado nas montanhas de Sierra Nevada, na Califórnia. É famosa por suas lindas cachoeiras, sequoias gigantes e vistas icônicas dos penhascos El Capitan e Half Dome. Caminhadas e acampamentos são as melhores maneiras de experimentar Yosemite. Numerosas trilhas oferecem oportunidades infinitas para aventura e exploração.
-
No campo Informações de contato, crie um Fragmento de conteúdo com base no modelo de Informações de contato e o nomeie como "Informações de contato do Parque Nacional de Yosemite". Siga o mesmo processo descrito na seção anterior sobre criando uma referência de fragmento a partir do editor e insira os seguintes dados nos campos:
- Telefone: 209-999-0000
- Email: yosemite@wknd.com
-
No campo Imagem do local, navegue até Aventuras > Locais > Parque Nacional de Yosemite > yosemite-national-park.jpeg para criar um caminho para a imagem.
Lembre-se de que, no capítulo anterior, você configurou a validação da imagem; portanto, as dimensões da imagem do Local devem ser inferiores a 2560 x 1800 e o tamanho do arquivo deve ser inferior a 3 MB.
-
Com todas as informações adicionadas, a guia Detalhes do local agora tem esta aparência:
-
Navegue até a guia Endereço do local. No campo Endereço, crie um Fragmento de conteúdo intitulado "Endereço do Parque Nacional de Yosemite" usando o Modelo de Fragmento de Conteúdo de Endereço que você criou no capítulo anterior. Siga o mesmo processo descrito na seção sobre criando uma referência de fragmento a partir do editor e insira os seguintes dados nos campos:
- Rua Endereço: 9010 Curry Village Drive
- Cidade: Yosemite Valley
- Estado: CA
- CEP: 95389
- País: Estados Unidos
-
A guia Endereço do local concluída do fragmento do Parque Nacional de Yosemite tem esta aparência:
-
Selecione Salvar e fechar.
Criar mais um fragmento
-
Navegue até a pasta Yosemite Valley Lodge. Crie um fragmento de conteúdo usando o modelo de fragmento de conteúdo de localização e o nomeie como "Yosemite Valley Lodge".
-
Na guia Detalhes do local, insira as seguintes informações nos campos:
- Nome: Yosemite Valley Lodge
- Descrição: o Yosemite Valley Lodge é um centro para reuniões de grupo e todos os tipos de atividades, como compras, refeições, pesca, caminhadas e muito mais.
-
No campo Informações de contato, crie um Fragmento de conteúdo com base no modelo de Informações de contato e o nomeie como "Informações de contato do Yosemite Valley Lodge". Siga o mesmo processo descrito na seção sobre criando uma referência de fragmento a partir do editor e insira os seguintes dados nos campos do novo Fragmento de conteúdo:
- Telefone: 209-992-0000
- Email: yosemitelodge@wknd.com
Salve o fragmento de conteúdo recém-criado.
-
Volte para Yosemite Valley Lodge e vá para a guia Endereço do local. No campo Endereço, crie um Fragmento de conteúdo intitulado "Endereço do Yosemite Valley Lodge" usando o Modelo de Fragmento de Conteúdo de Endereço que você criou no capítulo anterior. Siga o mesmo processo descrito na seção sobre criando uma referência de fragmento a partir do editor e insira os seguintes dados nos campos:
- Rua Endereço: 9006 Yosemite Lodge Drive
- Cidade: Parque Nacional de Yosemite
- Estado: CA
- CEP: 95389
- País: Estados Unidos
Salve o fragmento de conteúdo recém-criado.
-
Volte para Yosemite Valley Lodge e selecione Salvar e fechar. A pasta Yosemite Valley Lodge agora contém três fragmentos de conteúdo: Yosemite Valley Lodge, Yosemite Valley Lodge Contact Info e Yosemite Valley Lodge Address.
Criar um fragmento do conteúdo da equipe
Procure pastas para Equipes > Equipe do Yosemite. Você pode ver que a pasta Equipe do Yosemite atualmente contém apenas o logotipo da equipe.
Vamos criar um fragmento de conteúdo usando o Modelo de fragmento de conteúdo de equipe e atribuí-lo ao título de "Equipe do Yosemite".
Referências de conteúdo e fragmento no editor de texto de várias linhas
O AEM permite adicionar referências de conteúdo e fragmento diretamente no editor de texto multilinha e recuperá-las posteriormente usando consultas do GraphQL. Vamos adicionar referências de conteúdo e fragmento ao campo Descrição.
-
Primeiro, adicione o seguinte texto no campo Descrição: "A equipe de aventureiros profissionais e instrutores de caminhada trabalhando no Parque Nacional de Yosemite."
-
Para adicionar uma referência de conteúdo, selecione o ícone Inserir ativo na barra de ferramentas do editor de texto de várias linhas.
-
No modal exibido, selecione team-yosemite-logo.png e pressione Select.
A referência de conteúdo agora é adicionada ao campo Descrição.
Lembre-se, no capítulo anterior, você permitiu a adição de referências de fragmento ao campo Descrição. Vamos adicionar um aqui.
-
Selecione o ícone Inserir fragmento de conteúdo na barra de ferramentas do editor de texto de várias linhas.
-
Navegue até WKND Compartilhado > Inglês > Aventuras > Locais > Yosemite Valley Lodge > Yosemite Valley Lodge. Pressione Selecionar para inserir o fragmento de conteúdo.
O campo Descrição agora se parece com o seguinte:
Agora você adicionou as referências de conteúdo e fragmento diretamente no editor de texto de várias linhas.
Tipo de dados de Data e Hora
Vamos analisar os tipos de dados Data e hora. Selecione o ícone Calendário no lado direito do campo Data de Fundação da Equipe para abrir a exibição de calendário.
Datas passadas ou futuras podem ser definidas usando as setas para frente e para trás em ambos os lados do mês. Digamos que a equipe do Yosemite foi fundada em 24 de maio de 2016, então definiremos a data para então.
Adicionar várias referências de fragmento
Vamos adicionar Professores à referência do fragmento Membros da equipe.
-
Selecione Adicionar no campo Membros da Equipe.
-
No novo campo exibido, selecione o ícone de pasta para abrir a modal Selecionar caminho. Navegue pelas pastas até WKND Compartilhado > Inglês > Aventuras > Professor e marque a caixa de seleção ao lado de jacob-wester. Pressione Selecionar para salvar o caminho.
-
Selecione o botão Adicionar mais três vezes. Use os novos campos para adicionar os três professores restantes à equipe. O campo Membros da Equipe agora tem esta aparência:
-
Selecione Salvar e fechar para salvar o fragmento de conteúdo da equipe.
Adicionar referências de fragmento a um fragmento de conteúdo de aventura
Por fim, vamos adicionar os Fragmentos de conteúdo recém-criados a uma aventura.
-
Navegue até Aventuras > Embalagem do Yosemite e abra o Fragmento de conteúdo da embalagem do Yosemite. Na parte inferior do formulário, você pode ver os três campos criados no capítulo anterior: Local, Equipe do professor e Administrador.
-
Adicione a referência do fragmento no campo Local. O caminho do Local deve fazer referência ao Fragmento de Conteúdo do Parque Nacional de Yosemite que você criou:
/content/dam/wknd-shared/en/adventures/locations/yosemite-national-park/yosemite-national-park. -
Adicione a referência do fragmento no campo Equipe do professor. O caminho da Equipe deve fazer referência ao Fragmento de conteúdo da Equipe do Yosemite que você criou:
/content/dam/wknd-shared/en/adventures/teams/yosemite-team/yosemite-team. Esta é uma referência de fragmento aninhado. O fragmento de conteúdo da equipe contém uma referência ao modelo de Pessoa que faz referência aos modelos de Informações de contato e Endereço. Portanto, você tem fragmentos de conteúdo aninhados três níveis abaixo. -
Adicione a referência do fragmento no campo Administrador. Digamos que Jacob Wester seja um administrador do Yosemite Backpacking Adventure. O caminho deve levar ao Fragmento de conteúdo Jacob Wester e aparecer da seguinte maneira:
/content/dam/wknd-shared/en/adventures/instructors/jacob-wester. -
Agora você adicionou três referências de fragmento a um Fragmento de conteúdo de aventura. Os campos têm esta aparência:
-
Selecione Salvar e fechar para salvar seu conteúdo.
Parabéns.
Parabéns! Agora você criou fragmentos de conteúdo com base nos modelos avançados de fragmento de conteúdo criados no capítulo anterior. Você também criou uma política de pastas para limitar quais modelos de fragmento de conteúdo podem ser selecionados em uma pasta.
Próximas etapas
No próximo capítulo, você aprenderá a enviar consultas avançadas do GraphQL usando o IDE (Ambiente de Desenvolvimento Integrado) GraphiQL. Essas consultas nos permitem visualizar os dados criados neste capítulo e, eventualmente, adicionar essas consultas ao aplicativo WKND.