Permita que seus usuários escolham entidades Drupal com o módulo Entity Browser

Nesta postagem do blog, mostrarei a você como permitir que os usuários do Drupal selecionem entidades usando o módulo "Navegador de entidades".

Este tutorial foi solicitado por um cliente OSTraining que está construindo um site de resenhas de livros. O cliente queria usar o Entity Browser para poder criar este recurso:

• O site tem dois tipos de conteúdo: Livros e Resenhas de Livros.
• Quando os usuários criam uma nova resenha de livro, eles podem usar uma visualização para pesquisar e selecionar o livro que estão resenhando. Por exemplo, se eles estiverem revisando "Guerra e Paz", eles podem pesquisar o nó "Guerra e Paz" existente.
• Quando a resenha do livro for publicada, o nó selecionado será incorporado à resenha do livro.

Esta solicitação do cliente pode ser alcançada com a ajuda do módulo Entity Browser. Este módulo fornece um navegador que os usuários do Drupal podem usar para incorporar nós em outras partes de seu site.

Este tutorial o guiará pelo exercício de criação de site e mostrará como usar o módulo Entity Browser.

Passo 1. Instale os módulos necessários

Para usar o Entity Browser, você deve instalar os seguintes módulos: Entity Browser e Chaos Tools.

Use seu método preferido para baixar e instalar esses módulos. Estou usando o Composer:

 composer install drupal/entity_browser

 composer install drupal/ctools

Isso colocará os módulos em sua instalação do Drupal. Após isso clique em Extend , procure por ambos os módulos, habilite-os e clique em Install .

Passo 2. Criar os termos de taxonomia

Neste exemplo, os livros são categorizados por gênero, portanto, precisaremos de um vocabulário chamado "Gênero do livro".

• Clique em Estrutura > Taxonomia > Adicionar vocabulário.
• Dê ao vocabulário um nome e uma descrição adequados.
• Clique em Salvar.

• Na guia Lista , clique em Adicionar termo.

Adicione os seguintes termos:

• Aventura
• Livro de receitas
• Drama
• Fantasia
• Horror

Etapa 3. Criar o tipo de conteúdo Livro

Em seguida, criaremos o tipo de conteúdo para nossos livros. Usaremos a taxonomia do gênero de livro que criamos na etapa anterior.

• Clique em Estrutura > Tipos de conteúdo > Adicionar tipo de conteúdo.
• Crie um tipo de conteúdo chamado Livro e adicione estes campos com suas configurações padrão:

• Clique em Adicionar campo novamente.
• Na lista suspensa em Referência , selecione Termo de taxonomia e dê a ele um rótulo adequado.
• Clique em Salvar e continuar.

• Deixe o número permitido de valores em 1 e clique em Salvar configurações de campo
• Role para baixo até a parte inferior da tela Editar e escolha o vocabulário que você deseja referenciar em seu tipo de conteúdo. Neste caso: Gênero do livro
• Clique em Salvar configurações

• Clique na guia Gerenciar exibição de formulário .
• Procure o campo Gênero do livro e altere seu widget para Caixas de seleção / botões de opção.
• Clique em Salvar.

Passo 4. Criar o conteúdo do livro

Agora é hora de criar de 5 a 10 livros e atribuir a cada um deles um gênero específico.

• Clique em Conteúdo > Adicionar conteúdo > Livro.

Passo #5. Criar uma visualização

Depois de criar algum conteúdo de exemplo, você está pronto para criar a visualização. Essa visualização será exibida no navegador da entidade para que você possa escolher um livro enquanto cria uma resenha de livro.

• Clique em Estrutura > Visualizações > Adicionar visualização.
• Crie uma visualização com o título Livros disponíveis.
• Mostrar conteúdo do tipo Livro.
• Deixe as configurações de página e bloco desmarcadas.
• Clique em Salvar e editar.

• Clique no botão Adicionar na seção DISPLAYS .
• Selecione Navegador de entidade.

• Clique em Reorganizar ao lado dos critérios SORT e remova o critério Content: authored on desc .
• Clique em Aplicar.
• Clique em ADICIONAR ao lado dos critérios de FILTRO e selecione o campo Gênero do livro .
• Clique em Adicionar e configure os critérios de filtro.

• Certifique-se de que o Vocabulário do gênero Livro esteja selecionado.
• Altere o tipo de seleção para suspenso.
• Clique em Aplicar e continue.

• Marque Expor este filtro aos visitantes, para permitir que eles o alterem.
• Certifique-se de que o Operador esteja selecionado como É um dos.
• Clique em Aplicar.

• Adicione o campo Título aos critérios SORT .
• Deixe a configuração padrão Sort crescente e clique em Aplicar.

Isso apresentará os livros na exibição em ordem alfabética. Você precisa inserir mais alguns campos para serem exibidos na visualização. No momento, há apenas o título do nó disponível.

• Clique no botão Adicionar na seção Campos .
• Procure o campo de capa do livro e clique em Adicionar e configurar campos.

• Selecione Estilo de imagem (Miniatura 100x100) e clique em Aplicar.
• Clique em Adicionar mais uma vez para adicionar o campo de formulário de seleção em massa do navegador de entidade .
• Clique em Adicionar e configurar campos.

• Clique em Aplicar.

O uso deste campo é obrigatório se você deseja usar o Entity Browser, portanto, preste atenção especial a isso.

• Altere o formato da visualização, por exemplo, para Grade.
• Clique em Aplicar duas vezes.

A configuração da visualização na IU do Views deve se parecer com a imagem abaixo. Clique em Salvar para salvar a Visualização.

Passo #6. Configurar o módulo Navegador de Entidade

Nesta etapa, escolheremos a configuração do módulo de chave neste tutorial: Entity Browser.

• Clique em Configuração > Navegadores de entidade

• Clique em Adicionar navegador de entidade.
• Dê a ele um rótulo adequado, por exemplo, Navegador de livros.
• Como plug-in de exibição, selecione iFrame.
• Clique em Avançar.

• Marque o navegador de entidade aberta automaticamente e clique em Avançar.

• Clique em Avançar mais duas vezes até chegar à página de configuração de Widgets .
• Clique na lista suspensa para selecionar o plug-in do widget Visualizar .
• Altere o rótulo do widget, por exemplo: “Escolha um livro”.
• Selecione a visualização que você configurou na Etapa #5.
• Clique em Concluir.

Passo #7. Criar o tipo de conteúdo Revisão de livros

Nosso site está quase completo. Antes de terminarmos, precisamos criar o tipo de conteúdo que os revisores de livros podem usar:

• Clique em Estrutura > Tipos de conteúdo > Adicionar tipo de conteúdo.
• Dê um nome a este tipo de conteúdo Revisão de livro.
• Adicione um novo campo, na seção Referência escolha Conteúdo.
• Dê a este campo um rótulo adequado, por exemplo, O livro.
• Clique em Salvar e continuar.
• Na opção Tipo de item para referência , selecione Conteúdo.
• Clique em Salvar configurações de campo.

• Clique em Salvar configurações.
• Clique na guia Gerenciar exibição de formulário para este tipo de conteúdo.
• Localize o campo de referência e altere seu widget para o navegador de entidade.
• Clique na roda dentada à direita e selecione Navegador de livros (ou como você chamou o navegador que acabou de criar na Etapa 6.
• Clique em Atualizar.
• Clique em Salvar.

Observe que você também tem a opção de exibir apenas o rótulo Entidade ou a entidade renderizada Completa . Você pode usar modos de visualização (por exemplo, Teaser) para apresentar a entidade neste novo tipo de conteúdo de resenha de livro .

Passo #8. Crie as resenhas de livros

Agora nosso site está quase pronto para uso. Vamos criar uma resenha do livro e ver se tudo está funcionando corretamente.

• Clique em Conteúdo > Adicionar conteúdo > Revisão de livro.
• Dê a este nó um título e textos de corpo apropriados.
• Role mais para baixo e você encontrará uma seção recolhida chamada THE BOOK (que é o nome do campo).
• Clique neste campo e você verá o Entity Browser onde você pode selecionar o livro que você está referenciando nesta resenha do livro.
• Além disso, há um filtro exposto na parte superior para que você possa selecionar livros pertencentes apenas a um gênero.
• Selecione um gênero e clique em Aplicar.

O navegador mostrará apenas livros desse gênero.

• Selecione um livro e clique em Selecionar entidades.

• Após incorporar a entidade, clique em Salvar e você verá a entidade Livro referenciada no nó Revisão de livros.

Este tutorial demonstrou o poder do módulo "Entity Browser" para Drupal 8. Espero que tenha gostado. Obrigado por ler!