shares()

Função auxiliar que gera os links para compartilhamento do artigo atual em diferentes redes e serviços. Os links são gerados a partir do título e da URL do artigo em execução e podem utilizar diferentes modos de renderização dos ícones.

Parâmetros:
$args array Argumentos opcionais para configurar os links de compartilhamento:

• 'except' array Lista de redes que não devem ser exibidas. Os nomes devem ser informados em letras minúsculas.
• 'title' string Título ou conteúdo exibido antes dos links de compartilhamento. Por padrão, utiliza <strong>Compartilhar:</strong>.
• 'mode' string Define o modo de renderização dos ícones. Aceita icon, svg ou customized. Quando não informado, utiliza icon.
• 'icon_size' int Tamanho dos ícones. Padrão: 26.
• 'customized' array Ícones personalizados utilizados quando mode for customized. A chave deve corresponder ao nome da rede.

Retorno: string Código HTML contendo os links de compartilhamento.

<?= shares() ?>

<?= shares([
    'except' => [ 'linkedin', 'facebook', 'pocket', 'whatsapp' ],
]) ?>

<?= shares([
    'mode'      => 'svg',
    'icon_size' => 24
]) ?>

O modo icon utiliza um elemento <span> com os atributos icon e size, permitindo que os ícones sejam fornecidos por CSS ou JavaScript.

O modo svg utiliza a função icon() para carregar os arquivos SVG correspondentes às redes.

O modo customized permite fornecer o HTML de cada ícone manualmente através do argumento customized.

<?= shares([
    'mode' => 'customized',
    'customized' => [
        'WhatsApp' => '&lt;svg&gt;...&lt;/svg&gt;',
        'Telegram' => '&lt;span class="telegram"&gt;&lt;/span&gt;'
    ]
]) ?>

Cada link (elemento <a>) vem com atributo class e valores individuais: