Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Cada página de recaudación de fondos de embajador tiene una ventana emergente para compartir: una fila de iconos sociales que tus patrocinadores tocan para compartir la recaudación de fondos con su red. Redes para Compartir es donde eliges qué redes aparecen en esa ventana emergente y en qué orden. Diez redes vienen con Embajadores, y puedes habilitar cualquier combinación de ellas con un solo clic.

Es una configuración pequeña que tiene un gran impacto. La combinación correcta de redes –las que tu audiencia realmente usa– significa más compartidos, lo que significa más visibilidad para la recaudación de fondos, lo que significa más donaciones.

Cuándo usarlo

• Configuración inicial – activa las cuatro o cinco redes que te importan; desactiva el resto.
• Adaptación a tu audiencia – ¿audiencia internacional? Activa WhatsApp (muy popular a nivel mundial) y Threads. ¿K-12 / padres? Mantén Email y Facebook en primer plano.
• Alineación con las directrices de la marca – algunas organizaciones no quieren que sus recaudaciones de fondos se compartan en Reddit o X. Desactívalas.

Dónde encontrarlo

Ve a tu administrador de WordPress, abre Benéfico » Embajadores » Compartir

Es la única configuración en la subpestaña Compartir. (La subpestaña solía compartir espacio con otras configuraciones sociales; se separó en la versión 3.0 para mayor claridad).

Las Diez Redes

Red	Mejor para
Facebook	El clásico: sigue siendo la red de intercambio de mayor volumen en la mayoría de los programas con sede en EE. UU.
X (anteriormente Twitter)	Llega a una audiencia de periodistas y activistas. Bueno para campañas impulsadas por causas.
LinkedIn	Redes profesionales, corporativas y de exalumnos. Lo mejor para recaudación de fondos de estilo gala y corporativo.
Correo electrónico	Universal siempre activo. Abre el cliente de correo del usuario pre-rellenado.
Copiar enlace	“Solo dame la URL”. El icono más clicado en programas mobile-first.
WhatsApp	Masivo en EMEA, LATAM, India, Sudeste Asiático. A menudo, el mejor intercambio móvil a nivel mundial.
Pinterest	Mejor cuando las recaudaciones de fondos tienen imágenes destacadas potentes (galas, subastas de arte escolar).
Reddit	Útil para campañas impulsadas por causas con subreddits específicos de la comunidad.
Bluesky	Alternativa en crecimiento a X; bueno para incluir para audiencias tecnológicas / progresistas.
Threads	La red de texto de Meta; audiencia en crecimiento.

Cada red tiene un chip clicable en la cuadrícula de configuración. Haz clic para alternar; la cuadrícula se actualiza inmediatamente. El orden en que haces clic en ellos es el orden en que aparecen en la ventana emergente.

Cómo la Ventana Emergente Utiliza las Selecciones

En cada página de recaudación de fondos (y en la tarjeta de reclutamiento Mis Campañas, si está habilitada), la ventana emergente para compartir muestra un icono por cada red habilitada.

Cada icono abre una intención de compartir nativa (URL de enlace para compartir de Facebook, intención de tuitear de X, enlace profundo para enviar texto de WhatsApp) o, para Copiar enlace, copia la URL de la recaudación de fondos al portapapeles con una tooltip de confirmación.

Si activas los códigos QR para la página de recaudación de fondos (en Configuración de la página de recaudación de fondos), aparecerá una ficha QR junto a los iconos sociales; esta abre una ventana modal con un PNG descargable.

Anulaciones por recaudación de fondos

Las selecciones de Redes para Compartir son para todo el sitio por defecto; cada recaudación de fondos utiliza el mismo conjunto. Para anular esto por campaña (por ejemplo, una gala corporativa que solo debería mostrar LinkedIn + Email), usa el filtro charitable_ambassadors_share_networks_for_campaign:

add_filter( 'charitable_ambassadors_share_networks_for_campaign', function ( $networks, $campaign_id ) {
    if ( has_term( 'corporate', 'campaign_category', $campaign_id ) ) {
        return [ 'linkedin', 'email' ];
    }
    return $networks;
}, 10, 2 );

Mezclas Iniciales Recomendadas

Audiencia	Redes Sugeridas
Consumidor general EE. UU. / UE	Facebook, X, WhatsApp, Email, Copiar Enlace
Internacional / móvil primero	WhatsApp, Facebook, Threads, Email, Copiar Enlace
Corporativo / B2B / exalumnos	LinkedIn, X, Email, Copiar Enlace
Impulsado por la causa / activista	X, Bluesky, Reddit, Email, Copiar Enlace
Visual / eventos	Facebook, Pinterest, Instagram (vía Threads), Email, Copiar Enlace

En caso de duda, empieza con Facebook, X, WhatsApp, Email, Copiar Enlace; las cinco que funcionan para la audiencia más amplia.

Consejos

• Menos es más. Cinco redes habilitadas se sienten bien seleccionadas. Diez se sienten abrumadoras y reducen los clics.
• Mantén siempre Copiar Enlace activado. Es la opción de menor fricción; el usuario elige dónde pegarlo.
• Añade WhatsApp si tienes alguna audiencia internacional. Supera a Facebook y Twitter en muchos países.
• Comprueba tu botón para compartir en el móvil. La opción nativa para compartir en móvil es un flujo diferente en iOS que en Android; la ventana emergente maneja ambos, pero verifica que las fichas se vean bien en anchos reducidos.

---

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan las redes para compartir.

Almacenamiento de configuración

charitable_settings > ambassadors_share_networks  # array of enabled slugs, e.g. ['facebook','x','whatsapp','email','copy']

Esta opción se encuentra en el nivel superior de charitable_settings, no dentro del sub-array ambassadors. Ten cuidado con esto al leer a través de filtros.

Leer con:

$enabled = charitable_get_option( 'ambassadors_share_networks', [ 'facebook', 'x', 'email', 'copy' ] );

Catálogo de Redes

El catálogo de 10 redes está en Charitable_Ambassadors_Settings::get_share_networks_catalog(). Cada entrada tiene:

'<slug>' => [
    'label' => 'Display name',
    'color' => 'Brand hex',
    'icon'  => 'inline SVG markup',
],

Filtra a través de charitable_ambassadors_share_networks_catalog para añadir redes personalizadas o reemplazar iconos:

add_filter( 'charitable_ambassadors_share_networks_catalog', function ( $catalog ) {
    $catalog['mastodon'] = [
        'label' => 'Mastodon',
        'color' => '#6364ff',
        'icon'  => '<svg ...>...</svg>',
    ];
    return $catalog;
} );

También necesitarás enseñar al renderizador de la ventana emergente cómo construir la URL para compartir de una red personalizada; usa el hook charitable_ambassadors_share_url_for_network:

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    if ( 'mastodon' === $slug ) {
        $title = wp_strip_all_tags( get_the_title( $fundraiser_id ) );
        return 'https://mastodon.social/share?text=' . rawurlencode( $title . ' ' . get_permalink( $fundraiser_id ) );
    }
    return $url;
}, 10, 3 );

Filtros

Filtro	Predeterminado	Propósito
embajadores_caritativos_compartir_catalogo_redes	array de 10	Añadir/eliminar/modificar redes en el catálogo.
embajadores_caritativos_compartir_redes_para_campaña	configuración del sitio	Anular la lista de habilitados por campaña. Recibe ($networks, $campaign_id).
embajadores_caritativos_compartir_url_red	calculado	Genera la URL para compartir una red + recaudación de fondos específica. Recibe ($url, $slug, $fundraiser_id).
embajadores_caritativos_compartir_posicion_popover	inferior	Posición del popover para compartir en relación con el botón de activación.
embajadores_caritativos_compartir_docs_url_redes	esta página	Anula la URL de la documentación a la que apunta el enlace en línea “¿Qué se comparte?”.

Acciones

Acción	Argumentos	Se dispara cuando
embajadores_caritativos_compartir_popover_antes	$campaign_id	Justo antes de que se renderice el popover para compartir.
embajadores_caritativos_compartir_popover_despues	$campaign_id	Justo después del popover para compartir.

Capacidades

Acceso a la configuración: manage_charitable_settings. La representación en el front-end no tiene puerta de capacidad.

Ejemplos de personalización

Restringir a LinkedIn + Email para una categoría específica de campaña:

add_filter( 'charitable_ambassadors_share_networks_for_campaign', function ( $networks, $campaign_id ) {
    if ( has_term( 'corporate', 'campaign_category', $campaign_id ) ) {
        return [ 'linkedin', 'email' ];
    }
    return $networks;
}, 10, 2 );

Añadir una red de Telegram:

add_filter( 'charitable_ambassadors_share_networks_catalog', function ( $catalog ) {
    $catalog['telegram'] = [
        'label' => 'Telegram',
        'color' => '#0088cc',
        'icon'  => file_get_contents( __DIR__ . '/telegram.svg' ),
    ];
    return $catalog;
} );

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    if ( 'telegram' === $slug ) {
        return 'https://t.me/share/url?url=' . rawurlencode( get_permalink( $fundraiser_id ) );
    }
    return $url;
}, 10, 3 );

Ocultar completamente el popover para compartir en una única recaudación de fondos:

add_filter( 'charitable_ambassadors_fundraiser_show_share', function ( $show ) {
    if ( is_singular( 'campaign' ) && (int) get_the_ID() === 123 ) {
        return false;
    }
    return $show;
} );

Usar una URL para compartir con etiquetas UTM personalizadas para análisis:

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    $base = add_query_arg( [ 'utm_source' => $slug, 'utm_medium' => 'share', 'utm_campaign' => 'p2p' ], get_permalink( $fundraiser_id ) );
    return str_replace( get_permalink( $fundraiser_id ), $base, $url );
}, 20, 3 );

Relacionado

• Página de recaudación de fondos: el interruptor maestro para determinar si se muestra el popover.
• Códigos QR: la ficha de código QR en el popover para compartir.
• Hooks y filtros en Embajadores: referencia completa.