Entendendo os Links Contextuais no Drupal 7

No Drupal 7, alguns módulos provêem links contextuais (contextual links) que permitem, ao usuário com privilégios, executar tarefas que são relacionadas a uma determinada área do site sem precisar navegar até ela. Esses links contextuais são representados por um ícone em forma de "engrenagem" que, normalmente, fica no canto superior direito do seu contexto.

Para configurar um bloco, por exemplo, naturalmente você precisaria navegar até Administração > Construção do site > Blocos > Escolher o bloco > Clicar no link de edição. Usando os links contextuais, você pode fazê-lo diretamente na exibição do mesmo. Neste caso, o contexto é o próprio bloco; os links que estarão disponíveis serão relacionados a ele.

Links contextuais do bloco de Navegação

A instalação Standard do Drupal 7 já mantém o módulo Contextual Links (do núcleo) habilitado por padrão, mas você pode desativar se desejar. Você também pode definir quais papéis de usuário terão permissão para visualizar tais links.

Habilitando o módulo Contextual Links

Para ativar ou desativar o módulo Contextual links:

  • Navegue até a administração de módulos, em Administração > Módulos (Administer > Modules).
  • Na seção de módulos do núcleo, habilite/desabilite o módulo Contextual Links
  • Clique em Salvar configurações.

Para configurar as permissões para diferentes papéis de usuários:

  • Navegue até a página de Permissões, em Administração > Pessoas > Permissões (Administer > People > Permissions).
  • Você pode habilitar ou desabilitar, para cada papel, a permissão Usar links contextuais (Use contextual links).
  • Clique em Salvar configurações.

Vale lembrar que os usuários não poderão ver os links relativos à tarefas as quais não podem executar.

Se a renderização padrão do seu site não tiver sido alterada pelo tema ou algum módulo, a exibição da chamada (teaser) do conteúdo, por exemplo, deverá apresentar os links contextuais. Mas se você estiver criando seu próprio tema, deverá ficar atendo aos elementos de renderização encontrados nos templates originais do núcleo do Drupal.

$title_suffix é onde esses recursos normalmente são inseridos. Essa variável estará disponível nos templates de node, bloco e outros. Além disso, para que os links contextuais sejam posicionados corretamente no elemento, certifique-se de que a variável $classes seja mantida no template.


No próximo artigo eu vou mostrar algumas formas de criar links contextuais personalizados.

Curtiu? Não deixe de comentar e compartilhar ;)

Fonte: https://www.drupal.org/documentation/modules/contextual