site_tools/src/Plugin/Block/ShareLinksBlock.php

<?php

declare(strict_types=1);

namespace Drupal\site_tools\Plugin\Block;

use Drupal\Core\Block\Attribute\Block;
use Drupal\Core\Block\BlockBase;
use Drupal\Core\StringTranslation\TranslatableMarkup;

/**
 * Bloco para exibir links de compartilhamento de conteúdo.
 *
 * Este bloco coleta links de compartilhamento de outros módulos
 * através do hook_site_tools_share_links() e os exibe em um
 * container estilizado.
 */
#[Block(
  id: 'site_tools_share_links',
  admin_label: new TranslatableMarkup('Share Links'),
  category: new TranslatableMarkup('Site Tools'),
)]
class ShareLinksBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build(): array {
    $links = site_tools_collect_share_links();

    // Se não houver links, não renderiza o bloco.
    if (empty($links)) {
      return [];
    }

    return [
      '#theme' => 'site_tools_share_links',
      '#links' => $links,
      '#attributes' => [
        'class' => ['site-tools-share-links'],
      ],
      '#attached' => [
        'library' => ['site_tools/share_links'],
      ],
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function getCacheContexts(): array {
    // Cache varia por URL pois os links dependem do conteúdo atual.
    return array_merge(parent::getCacheContexts(), ['url.path']);
  }

  /**
   * {@inheritdoc}
   */
  public function getCacheTags(): array {
    // Permite que módulos invalidem o cache quando necessário.
    return array_merge(parent::getCacheTags(), ['site_tools_share_links']);
  }

}