Botones de Redes Sociales Shariff
Proporciona botones de compartir en redes sociales respetuosos con la privacidad utilizando la biblioteca Shariff de heise online.
shariff
Instalar
composer require 'drupal/shariff:^2.0'
Overview
El módulo Shariff integra la biblioteca de botones de compartir Shariff, respetuosa con la privacidad y desarrollada por heise online, en Drupal. A diferencia de los botones tradicionales de compartir en redes sociales que rastrean a los usuarios cargando scripts de terceros, Shariff permite a los visitantes del sitio web compartir contenido en redes sociales sin comprometer su privacidad.
El módulo proporciona dos métodos principales para mostrar los botones de compartir: como un Block configurable que se puede colocar en cualquier región, o como un pseudo-field en tipos de contenido Node. Soporta 24 redes sociales y servicios incluyendo Twitter, Facebook, LinkedIn, WhatsApp, Telegram, Pinterest y más.
Shariff ofrece amplias opciones de personalización incluyendo múltiples temas de color (coloreado, gris, blanco), diferentes estilos de botones (estándar con texto, solo icono, icono con contador), orientación vertical u horizontal, y varias variantes de CSS. Se puede configurar un componente opcional de servidor backend para mostrar contadores de compartidos sin comprometer la privacidad del usuario.
El módulo también soporta la API Web Share moderna, permitiendo a los sitios ocultar automáticamente los botones Shariff cuando la funcionalidad de compartir nativa del navegador está disponible.
Features
- Botones de compartir en redes sociales respetuosos con la privacidad que no rastrean usuarios cargando scripts de terceros
- Soporte para 24 redes sociales: Twitter, Facebook, LinkedIn, Pinterest, VK, Xing, WhatsApp, AddThis, Telegram, Tumblr, Flattr, Diaspora, Reddit, StumbleUpon, Weibo, Flipboard, Pocket, Print, Tencent-Weibo, Qzone, Threema, E-Mail, Botón de Información y Buffer
- Mostrar botones de compartir como un Block configurable en cualquier región del Theme
- Mostrar botones de compartir como un pseudo-field en tipos de contenido Node a través de Manage Display
- Tres temas de color: Coloreado (colores de marca), Gris y Blanco
- Tres estilos de botones: Estándar (icono + texto + contador), Solo icono e Icono + Contador
- Orientación de botones horizontal o vertical
- Tres variantes de CSS: Completa (incluye Font Awesome), Mínima (para sitios que ya usan Font Awesome) y Ninguna (estilos personalizados)
- Integración opcional de URL de backend para mostrar contadores de compartidos sin rastreo de usuarios
- Anulación de configuración por Block para personalizar instancias individuales de Block
- Soporte de API Web Share para ocultar Shariff cuando el compartir nativo del navegador está disponible
- Detección automática de idioma con soporte para 22 idiomas
- Compartir por correo electrónico con asunto y cuerpo personalizables
- Atribución de Twitter (mención de @usuario en tweets)
- Especificación de URL de medios para Pinterest
- Soporte de código de seguimiento de referencia para analíticas
- Integración con Flattr con configuración de usuario y categoría
- Botón de información para mostrar la página de información de Shariff
Use Cases
Compartir social compatible con GDPR
Para sitios web que necesitan cumplir con GDPR u otras regulaciones de privacidad, Shariff proporciona botones de compartir en redes sociales que no cargan scripts de seguimiento de terceros. A diferencia de los botones estándar de Facebook o Twitter que rastrean visitantes entre sitios, los botones Shariff solo hacen solicitudes cuando los usuarios activamente hacen clic para compartir.
Compartir publicaciones de blog
Añadir el Block o pseudo-field Shariff a páginas de artículos para animar a los lectores a compartir contenido en sus redes sociales preferidas. Configura servicios relevantes para tu audiencia (por ejemplo, LinkedIn para contenido profesional, Pinterest para contenido visual) y usa el tema coloreado para botones de marca reconocibles.
Widget de compartir social en barra lateral
Colocar un Block Shariff en la región de la barra lateral con orientación vertical para crear un widget de compartir persistente que sigue a los usuarios mientras hacen scroll (cuando se combina con posicionamiento sticky en CSS). Usa el estilo de solo icono para ahorrar espacio.
Contadores de compartidos sin rastreo
Configura un servidor backend Shariff y configura la URL del Backend para mostrar contadores de compartidos en los botones. Esto muestra prueba social (cuántas veces se compartió el contenido) sin incrustar scripts de seguimiento de terceros que comprometen la privacidad del visitante.
Compartir optimizado para móviles
Habilita la opción 'Ocultar Block si la API Web Share está soportada' para ocultar automáticamente los botones Shariff en dispositivos móviles y navegadores que soportan compartir nativo. Los usuarios en navegadores soportados pueden usar la hoja de compartir incorporada de su dispositivo en su lugar.
Múltiples configuraciones de compartir
Crear múltiples Blocks Shariff con diferentes selecciones de servicios para diferentes tipos de páginas. Por ejemplo, un Block con Twitter y LinkedIn para contenido profesional, y otro con Pinterest y Facebook para contenido de estilo de vida. Cada Block puede anular la configuración predeterminada.
Tips
- Usa la tabla arrastrable en los ajustes para reordenar fácilmente qué servicios aparecen primero - coloca tus redes más populares al principio
- Si tu Theme ya incluye Font Awesome, selecciona la opción de CSS 'Mínima' para evitar cargar fuentes de iconos duplicadas
- Habilita el ocultamiento de la API Web Share para sitios amigables con móviles donde el compartir nativo proporciona una mejor experiencia
- Establece un Usuario Via de Twitter para ser @mencionado cuando los usuarios comparten tu contenido, ayudando a rastrear el engagement
- Usa códigos de seguimiento de referencia (como parámetros UTM) para rastrear el tráfico social en analíticas
- El pseudo-field es más simple de configurar que los Blocks para páginas de Node, pero los Blocks ofrecen más flexibilidad de ubicación
- Las etiquetas de Cache están correctamente configuradas - el Block se limpiará automáticamente cuando cambien los ajustes
- Para sitios conscientes de la privacidad, Shariff es una excelente elección ya que los botones no rastrean visitantes hasta que activamente hacen clic para compartir
Technical Details
Admin Pages 1
/admin/config/services/shariff
Configurar los ajustes predeterminados para los botones de compartir en redes sociales Shariff incluyendo servicios habilitados, apariencia y opciones de integración.
Hooks 4
hook_entity_extra_field_info
Define el pseudo-field 'Botones de compartir Shariff' para todos los tipos de contenido Node, permitiendo que los botones se muestren a través de Manage Display.
hook_node_view
Renderiza los botones Shariff cuando el pseudo-field shariff_field está habilitado en la visualización del Node. Se integra con el módulo Metatag si está disponible para la generación del título.
hook_library_info_alter
Actualiza dinámicamente las rutas de la biblioteca Shariff para soportar diferentes ubicaciones de instalación (libraries raíz, subcarpeta build, subcarpeta dist).
hook_theme_suggestions_block_alter
Añade 'block_shariff' como sugerencia de Theme para el Block Shariff.
Troubleshooting 6
Verificar que la biblioteca Shariff está correctamente instalada en la carpeta libraries. Comprobar el Informe de Estado en /admin/reports/status para el requisito 'Shariff Library'. Asegurar que los archivos existen en libraries/shariff/shariff.complete.js y los archivos CSS.
Si usas la opción de CSS 'Mínima', asegúrate de que Font Awesome está cargado por tu Theme u otro módulo. De lo contrario, cambia a la variante de CSS 'Completa' que incluye iconos Font Awesome.
Los contadores de compartidos requieren un servidor backend Shariff configurado. Establecer la URL del Backend en los ajustes para apuntar a tu instancia de backend. El backend debe ser accesible tanto desde el servidor como desde los navegadores de los clientes.
Por defecto, Shariff usa la URL canónica y el título de la página. Para Nodes, se integra con Metatag si está disponible. Puedes establecer URLs/títulos fijos en los ajustes, o asegurar que las etiquetas meta de URL canónica y og:url están configuradas correctamente.
Desmarcar 'Usar configuración predeterminada de Shariff' en la configuración del Block para revelar todas las opciones de personalización por Block. Cuando está marcado, el Block usa la configuración global de /admin/config/services/shariff.
El pseudo-field Shariff debe habilitarse a través de Manage Display para cada tipo de contenido. Ir a Estructura > Tipos de contenido > [Tipo] > Manage display y arrastrar el field 'Botones de compartir Shariff' a una región visible.
Security Notes 4
- Shariff está diseñado con la privacidad en mente - los botones no cargan scripts de terceros hasta que los usuarios hacen clic para compartir, previniendo el rastreo entre sitios
- Los valores de URL (backend, correo, medios, URLs de información) son saneados usando UrlHelper::stripDangerousProtocols para prevenir ataques XSS
- Todos los ajustes proporcionados por el usuario son escapados usando Html::escape antes de la salida
- El módulo usa la cobertura de seguridad de Drupal y sigue prácticas de codificación segura