Blog benéfico

Todo lo que necesitas saber sobre Charitable y nuestro equipo.

AWARE: Banner de la campaña 30 for 30

Un vistazo a la peculiar recaudación de fondos "30 for 30" de AWARE Whistler (Tutorial)

Última actualización el

  • Por

AWARE Whistler es una organización benéfica comprometida con la protección del medio ambiente natural de Whistler, Canadá. Este año marca su 30 aniversario como organización y celebra la ocasión lanzando la recaudación de fondos 30 for 30.

El objetivo de la recaudación de fondos "30 for 30" es recaudar 60.000 $, de los cuales 30.000 $ provendrán de empresas y 30.000 $ de donaciones individuales.

AWARE está utilizando el enfoque de recaudación de fondos basado en campañas de Charitable para impulsar esta campaña, con dos campañas de recaudación de fondos individuales configuradas: una para empresas y otra para individuos.

El desafío

Por supuesto, las campañas únicas como esta tienden a tener necesidades únicas, y la recaudación de fondos "30 for 30" no es una excepción.

Dado que una de las dos campañas de recaudación de fondos se centra específicamente en obtener donaciones de empresas, se necesita un campo "Nombre de la empresa" en el formulario de donación de esa campaña. Además, cuando se muestran los donantes en el sitio (usando el shortcode o widget de Donantes), debe mostrarse el nombre de la empresa, no el nombre de la persona que dona.

Afortunadamente, la flexibilidad de Charitable se adapta perfectamente a las necesidades de AWARE. Veamos cómo.

Paso 1. Añadir un campo "Nombre de la empresa"

Lo primero que necesitamos hacer es crear un nuevo campo de donación, utilizando la API de Campos de Donación.

Veamos el código necesario para lograrlo:

/**
 * STEP 1: Register the "Company Name" Donation Field.
 *
 * On the `init` hook, we create a new Donation Field. It has a
 * key of `company_name` (this is how we will reference it later),
 * and it's set up as a required field in the donation form, shown
 * after the `last_name` field.
 */
add_action( 'init', function() {
        /**
         * Add a "Company Name" field.
         */
        $field = new Charitable_Donation_Field(
            'company_name',
            [
                'label' => 'Company Name',
                'data_type' => 'user',
                'donation_form' => [
                    'show_after' => 'last_name',
                    'required' => true,
                ],
                'admin_form' => true,
                'show_in_meta' => true,
                'show_in_export' => true,
                'email_tag' => [
                    'description' => 'The company name',
                ],
            ]
        );

        /**
         * Register the field.
         */
        charitable()->donation_fields()->register_field( $field );
}, 100 );

Aquí hay un poco de código. En primer lugar, justo en la parte superior, estamos configurando una función para que se ejecute en el hook init. Este es el mejor hook para usar cada vez que desee registrar un nuevo campo de donación.

Dentro de nuestra función, creamos un nuevo Campo de Donación con el objeto Charitable_Donation_Field. Echemos un vistazo más de cerca a esa parte:

$field = new Charitable_Donation_Field(
     'company_name',
     [
         'label' => 'Company Name',
         'data_type' => 'user',
         'donation_form' => [
             'show_after' => 'last_name',
             'required' => true,
         ],
         'admin_form' => true,
         'show_in_meta' => true,
         'show_in_export' => true,
         'email_tag' => [
             'description' => 'The company name',
         ],
     ]
 );

Lo que estamos haciendo aquí es crear un campo con una clave company_name (la necesitaremos más adelante). Hemos establecido una etiqueta, la hemos definido como un campo de usuario y hemos establecido algunas reglas básicas sobre cómo debe aparecer en el formulario de donación: justo después del campo last_name y como campo obligatorio.

También lo hemos configurado para que se muestre en el formulario de donación del administrador, en los metadatos de la donación y en el archivo de exportación de donaciones. Incluso le hemos dicho a Charitable que cree una etiqueta de correo electrónico para él, para que podamos usarla en nuestros correos electrónicos de recibo de donaciones.

Finalmente, registramos este campo con la API de Campos de Donación:

charitable()->donation_fields()->register_field( $field );

Paso 2. Mostrar el campo "Nombre de la empresa" solo en una campaña

Por defecto, cuando configuras un campo de donación, aparecerá en el formulario de donación de todas las campañas. Sin embargo, para la campaña "30 for 30", AWARE solo quiere que el campo aparezca en el formulario de donación de la recaudación de fondos para empresas.

Así es como lo logramos:

/**
 * STEP 2: Only show the field on a specific campaign.
 *
 * We only want the field to show up on a single campaign's
 * form, so we *remove* it from all other campaigns' donation
 * forms.
 */
add_filter( 'charitable_donation_form_user_fields', function( $fields, Charitable_Donation_Form $form ) {
    /**
     * Check the campaign ID of the donation form being
     * shown. If it isn't the one where we want the field,
     * remove the field using the unset() function.
     */
    if ( 123 != $form->get_campaign()->ID ) {
        unset( $fields['company_name'] );
    }

    return $fields;
}, 10, 2 );

La forma en que resolvemos este problema es eliminando el campo company_name cuando no estamos mostrando el formulario de donación de la campaña empresarial. Toda la magia ocurre aquí:

if ( 123 != $form->get_campaign()->ID ) {
     unset( $fields['company_name'] );
 }

En este caso, imaginamos que la campaña de Negocios tiene un ID de 123. Así que, cuando miramos los campos de un formulario en particular, comprobamos el ID de la campaña del formulario y, si no es 123, usamos la función unset() para deshacernos de nuestro campo, refiriéndonos a él por la clave de company_name, que establecimos en el Paso 1.

Paso 3. Personaliza el nombre del donante en el shortcode o widget de Donantes

Ahora que hemos añadido nuestro campo de Nombre de Empresa, todo lo que queda es usar eso en lugar del nombre y apellido del donante al mostrar donaciones a la campaña de Negocios.

Veamos el código:

/**
 * STEP 3: Use the company name for the donor name.
 *
 * When showing the donor name for a particular donation,
 * check if the donation was to the campaign with our
 * Company Name field. If it was, show the Company Name
 * instead of the individual's name.
 */
add_filter( 'charitable_donor_loop_donor_name', function( $name, $args ) {
    /**
     * Get the Donor object from the argument array.
     */
    $donor = $args['donor'];

    /**
     * Check if there is a Donation object associated
     * with this Donor.
     */
    $donation = $donor->get_donation();

    if ( ! $donation ) {
        return $name;
    }

    /**
     * Get the campaign that received the donation.
     */
    $campaign_id = current( $donation->get_campaign_donations() )->campaign_id;

    /**
     * If this was a donation to our campaign,
     * let's change the donor name.
     */
    if ( 123 == $campaign_id ) {
        $name = $donation->get( 'company_name' );
    }

    return $name;
}, 15, 2 );

En primer lugar, observa que esto está configurado como una función llamada en el hook charitable_donor_loop_donor_name. Usamos este hook ya que se muestra siempre que se muestra una lista de donantes con el widget de Donantes o el shortcode.

Dentro de la función, primero obtenemos el objeto Charitable_Donor del parámetro $args. Luego obtenemos el objeto Charitable_Donation a través del método $donor->get_donation():

/**
 * Check if there is a Donation object associated
 * with this Donor.
 */
$donation = $donor->get_donation();

if ( ! $donation ) {
    return $name;
}

Puede que te preguntes por qué comprobamos si $donation está establecido. La razón es que a veces, Charitable_Donor no está configurado con una donación específica. Un ejemplo es cuando el widget/shortcode de Donantes está configurado para agrupar múltiples donaciones del mismo donante en una; en ese caso, no se llama a ningún objeto Charitable_Donation, y simplemente mostraremos el nombre del donante.

Por lo tanto, una advertencia importante de este enfoque es que solo funcionará si el widget/shortcode de Donantes está configurado para mostrar cada donación individualmente, en lugar de agrupar múltiples donaciones de la misma persona.

A continuación, usamos el objeto Charitable_Donation para averiguar a qué campaña se donó y comprobamos si es nuestra campaña de Negocios (la que tiene un ID de 123):

/**
 * Get the campaign that received the donation.
 */
$campaign_id = current( $donation->get_campaign_donations() )->campaign_id;

/**
 * If this was a donation to our campaign,
 * let's change the donor name.
 */
if ( 123 == $campaign_id ) {
    $name = $donation->get( 'company_name' );
}

La última parte de esto simplemente comprueba que $campaign_id es 123. Si lo es, obtenemos el nombre de la empresa de la siguiente manera:

$donation->get( 'company_name' );

Ten en cuenta que company_name coincide con la clave del campo de donación que registramos en el paso 1.

¡Y con eso, hemos terminado!

La solución completa

Puedes ver todo el código reunido en un solo lugar en nuestra biblioteca de código de Github:

https://github.com/Charitable/library/blob/master/tutorials/new-donation-field-plus-customized-donor-name.php

Para verlo en acción – y si te gustaría mostrar tu apoyo al importante trabajo realizado por AWARE Whistler – visita la página 30 for 30 Fundraiser en su sitio web.

Palabra final

Si disfrutaste de este tutorial y te gustaría que escribiéramos uno sobre un tema diferente, ¡háznoslo saber! Puedes contactarnos por correo electrónico rellenando el formulario en nuestra página de Soporte, o dejando un comentario abajo.

Divulgación: Nuestro contenido es compatible con los lectores. Esto significa que si haces clic en algunos de nuestros enlaces, podemos ganar una comisión. Solo recomendamos productos que creemos que aportarán valor a nuestros lectores.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Recibe consejos y recursos gratuitos directamente en tu bandeja de entrada, junto con más de 60.000 personas.

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

Vídeo destacado:

Mira más vídeos en nuestro canal de YouTube.

Novedades en Benéfico

Ver las últimas actualizaciones
🔔 Suscríbete para recibir nuestras últimas actualizaciones
📧 Suscribirse a correos electrónicos

Suscripción por correo electrónico

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

embajadores Nuevo

🔑 Presentamos Recaudadores sin Contraseña: ¡Regístrate solo con tu correo electrónico!

Los seguidores llegan queriendo ayudar, y luego el formulario les pide que inventen una contraseña para un sitio web que quizás solo visiten dos veces. Muchos de ellos se detienen ahí mismo. Las cuentas de recaudación de fondos sin contraseña, nuevas en Charitable Ambassadors 3.5.0, permiten a un seguidor iniciar una recaudación de fondos de persona a persona con solo una dirección de correo electrónico. Por qué esto es importante:

  • 🔑 Sin paso de contraseña para perderlos: Actívalo en Charitable » Ambassadors » Templates » Submit Form y el formulario de creación de recaudación de fondos solo pide un nombre, una dirección de correo electrónico y un título de página.
  • 👤 Sigue siendo una cuenta real de WordPress: Un clic en un correo electrónico confirma la dirección, los inicia y crea la cuenta, para que puedan volver más tarde a editar su historia, cambiar su foto y ver quién ha donado.
  • 🎚️ Tu decisión en cada campaña: Cada campaña de persona a persona puede seguir la configuración predeterminada del sitio o anularla, lo que importa cuando una campaña paga a los recaudadores de fondos a través de Stripe Connect y esas personas necesitan una contraseña.
  • 📋 Ver quién no ha hecho clic todavía: La pestaña Charitable » Ambassadors » Directory » Awaiting Sign-In enumera a todos los que aún esperan, con la campaña a la que se unieron y un botón de Reenviar, para que un error tipográfico o una carpeta de spam sea algo que puedas detectar y corregir.
  • 🛡️ Enlaces que un escáner no puede agotar: Abrir el enlace solo muestra una página, y tu recaudador de fondos inicia sesión cuando presiona el botón en él, por lo que los escáneres de correo electrónico corporativos nunca queman el enlace. Cada uno funciona una vez, expira por sí solo y se almacena solo como un hash.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🏃 ¡Presentamos Actividad: Muestra el progreso en más que solo dinero!

La mayoría de las recaudaciones de fondos entre pares se centran en más que el dinero. Una maratón de lectura se basa en los minutos leídos, una caminata en las millas recorridas y una colecta de alimentos en las comidas preparadas. La Actividad para Embajadores Benéficos permite que tus recaudadores de fondos muestren ese esfuerzo junto a los dólares que recaudan. Por qué esto es importante:

  • 🎯 Progreso en lo que realmente cuentas: Una barra de progreso muestra cada cosa que cuentas contra su propio objetivo, justo al lado del dinero recaudado.
  • 🏅 Hitos para las cosas de sí o no: Una insignia de hito marca los esfuerzos que simplemente están hechos o no hechos, sin un número que perseguir.
  • ✍️ Los recaudadores registran sus propios números: Tus donantes introducen sus totales desde sus propias páginas, para que el esfuerzo deje de vivir en una hoja de cálculo, un comentario o en ningún sitio.
  • 🤖 Algunos números se cuentan solos: Una etiqueta AUTOMÁTICA aparece donde el sitio ha calculado la cifra a partir de donaciones completadas, para que puedas ver de un vistazo lo que nadie ha escrito.
  • 🧩 Configúralo una vez, úsalo en cualquier lugar: Tú decides qué se cuenta una vez, luego eliges qué campañas lo cuentan. Disponible ahora en Embajadores Benéficos 3.4.7, sin complementos nuevos y sin desarrollador.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

Mejora Pagos

💸 Presentamos las tarifas escalonadas para el alivio de comisiones: ¡Ajusta la petición a la donación!

El alivio de comisiones hace una pregunta corta a tus donantes al finalizar la compra: ¿te gustaría cubrir la comisión de procesamiento de esta donación? Hasta ahora, esa pregunta utilizaba una única tarifa para cada donación en una pasarela, por lo que una donación de 10 $ y una de 500 $ recibían la misma pregunta de porcentaje. El alivio de comisiones 1.3.0 te permite establecer tantas bandas de donación como desees, cada una con su propia tarifa. Por qué esto es importante:

  • 🪙 Más suave con las donaciones pequeñas: Una comisión de transacción fija supone una parte mucho mayor de una donación de 10 $ que de una de 500 $, por lo que las bandas te permiten pedir menos en la parte inferior.
  • 🎚️ Tantas bandas como necesites: Cada banda tiene su propio porcentaje y su propio importe fijo, y la banda superior continúa sin límite superior.
  • 🛑 Un techo opcional: Un campo de comisión máxima evita que se pida a ningún donante más de una cantidad que tú elijas, por muy grande que sea la donación.
  • 🔌 Configurar por pasarela de pago: Stripe puede funcionar con cuatro bandas, mientras que Windcave y Payfast se mantienen con una tarifa única, ya que las bandas pertenecen a una pasarela y no a todo tu sitio.
  • 🛡️ Nada cambia hasta que tú lo digas: Tus tarifas actuales se mantienen exactamente como están hasta que actives Usar tarifas escalonadas en Charitable » Settings » Advanced » Fee Relief.

Consulta nuestro anuncio aquí.

Donaciones Mejora

📊 ¡Tu panel de control Pro ahora puede comparar, exportar y calificar!

La mayoría de los paneles de control de recaudación de fondos solo te dicen cuánto has recaudado. Charitable Pro 1.8.19 reconstruye el panel de control y la Descripción general de informes en torno a las preguntas más difíciles: si algo está roto, si este período superó al anterior y qué cambio único marcaría la mayor diferencia hoy. Por qué esto es importante:

  • 📈 Cada cifra tiene una tendencia: Elige un período y las fichas y el gráfico se mueven juntos, con cada total mostrado frente al período anterior.
  • 🗓️ Gráficos que se mantienen legibles: Los rangos cortos agrupan las donaciones día a día, mientras que los rangos más largos agrupan por semana o mes, por lo que un año completo se lee como una curva en lugar de una línea plana.
  • 🔀 Compara cualquier 2 períodos: No solo los consecutivos, para que puedas preguntar cómo fue este diciembre en comparación con el diciembre pasado. Eso importa porque la recaudación de fondos es estacional.
  • 📤 Exporta el resumen completo: Envía la descripción general completa como CSV o PDF, lista para un paquete de junta directiva o un informe de financiador.
  • 🎯 Califica tu configuración gratis: Haz que tu configuración de recaudación de fondos sea calificada, para que el único cambio que valga la pena hacer a continuación sea el que puedas ver.

Consulta nuestro anuncio aquí.