site_tools/README.md

Site Tools

Módulo Drupal com ferramentas utilitárias reutilizáveis para outros módulos do site.

Funcionalidades

• Menu de configuração "Local Modules": Fornece uma seção centralizada em /admin/config/local-modules para configurações de módulos desenvolvidos internamente.
• Bloco Share Links: Bloco de compartilhamento em redes sociais extensível via hooks.
• Condição de visibilidade "Usuário da página é o usuário logado": Restringe a exibição de qualquer bloco à situação em que o usuário autenticado é o mesmo da rota /user/{id}.

Sub-módulos

• site_tools_msc_2020: Widget de seleção em cascata (1–3 níveis) para o vocabulário MSC 2020, com carregamento eficiente dos 597 termos via loadTree() + consulta direta ao banco.
• site_tools_msc_2020_migrate: Migrations para importação do vocabulário MSC 2020 a partir de CSV.

Requisitos

• Drupal 10.3+ ou 11

Instalação

1. Coloque o módulo no diretório modules/custom/
2. Ative o módulo via Drush: drush en site_tools
3. Limpe o cache: drush cr

Uso

Outros módulos podem usar a seção "Local Modules" adicionando em seus arquivos .links.menu.yml:

meu_modulo.settings:
  title: 'Meu Módulo'
  description: 'Configurações do meu módulo'
  route_name: meu_modulo.settings
  parent: site_tools.admin_config
  weight: 10

E declarando a dependência em .info.yml:

dependencies:
  - site_tools

Bloco Share Links

O bloco Share Links funciona como um container que coleta e exibe links de compartilhamento fornecidos por outros módulos através de hooks.

Configuração

1. Acesse /admin/structure/block
2. Posicione o bloco "Share Links" na região desejada

Fornecendo Links

Implemente hook_site_tools_share_links() no seu módulo:

/**
 * Implements hook_site_tools_share_links().
 */
function meu_modulo_site_tools_share_links(): array {
  $current_url = \Drupal::request()->getUri();
  $encoded_url = urlencode($current_url);

  return [
    'facebook' => [
      'content' => [
        '#type' => 'link',
        '#title' => t('Facebook'),
        '#url' => \Drupal\Core\Url::fromUri(
          "https://www.facebook.com/sharer/sharer.php?u={$encoded_url}"
        ),
        '#attributes' => [
          'target' => '_blank',
          'rel' => 'noopener',
        ],
      ],
      'weight' => 0,
      'provider' => 'meu_modulo',
    ],
  ];
}

Alterando Links

Use hook_site_tools_share_links_alter() para modificar ou remover links:

/**
 * Implements hook_site_tools_share_links_alter().
 */
function meu_modulo_site_tools_share_links_alter(array &$links): void {
  unset($links['twitter']);
}

Documentação Completa

Consulte docs/share-links.md para documentação detalhada incluindo:

• Exemplos de integração com AddToAny
• Personalização do template Twig
• Classes CSS disponíveis
• Gerenciamento de cache

Condição de visibilidade: Usuário da página é o usuário logado

O plugin PageUserIsCurrentUser adiciona uma condição de visibilidade reutilizável a qualquer bloco do site.

Configuração

1. Acesse /admin/structure/block e edite o bloco desejado
2. Na aba Visibilidade, localize a seção "Usuário da página é o usuário logado"
3. Marque "Exibir apenas para o dono da página" e salve

Quando ativada, o bloco só é exibido se o usuário autenticado tiver o mesmo ID que o parâmetro {id} da rota /user/{id}. A opção "Negar a condição" inverte o comportamento (exibe para todos exceto o dono).

Sub-módulo: site_tools_msc_2020

Widget de campo (FieldWidget) para seleção hierárquica de termos do vocabulário MSC 2020 (Mathematics Subject Classification), com até 3 níveis em cascata via AJAX.

Configuração

1. Ative o sub-módulo: drush en site_tools_msc_2020
2. No formulário de exibição do campo (/admin/structure/types/manage/.../form-display), selecione o widget "MSC 2020 — Seleção em cascata"
3. Configure o Nível máximo (1, 2 ou 3) nas opções do widget

Níveis

Nível	Código	Exemplo
1	2 dígitos	03
2	3 caracteres	03B
3	5 caracteres	03B05

O valor armazenado é sempre o TID do nível mais profundo selecionado. Selecionar "— área geral —" em um nível armazena o TID do nível imediatamente superior.

Sub-módulo: site_tools_msc_2020_migrate

Migrations para importação do vocabulário MSC 2020 a partir de arquivos CSV.

Uso

drush en site_tools_msc_2020_migrate
drush migrate:import --group=msc_2020