Documentación de Charitable

Aprende a sacar el máximo partido a Charitable con instrucciones claras y paso a paso.

Recursos populares

Empieza aquí

Gestión de donantes

Donaciones recurrentes

Recaudación de fondos entre pares

Integraciones

Extensiones

Hooks y filtros en Embajadores

Nota importante: Esta documentación está en proceso y aún no cubre todos los filtros y ganchos de acción disponibles en Charitable Ambassadors. Si no ve un gancho o filtro que describa lo que necesita hacer, póngase en contacto a través de nuestra página de soporte y podremos ayudarle.

Filtros

Recaudación de fondos de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eCambia el título generado automáticamente para una nueva recaudación de fondos, cuando el título se establece para basarse dinámicamente en el nombre del creador de la campaña.u003c/pu003e

Valor de retorno

u003cpu003eString. El título de la recaudación de fondos.u003c/pu003e

Argumentos

  • $title (cadena)

    u003cpu003eEl título. Por defecto, será el nombre completo del creador de la campaña.u003c/pu003e

  • $data (matriz)

    u003cpu003eLos datos enviados.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_fundraiser_title', function( $title, $data ) {n    $first_name = array_key_exists( 'first_name', $data ) ? $data['first_name'] : '';n    $last_name  = array_key_exists( 'last_name', $data ) ? $data['last_name'] : '';n    $full_name   = trim( sprintf( '%s %s', $first_name, $last_name ) );nn    // Joe Blow's Fundraisern    return sprintf( u0022%s's Fundraiseru0022, $full_name );n}, 10, 2 );

Añadido en la versión 2.0.0

u003cpu003eElige si quieres mostrar el botón "Crear una nueva campaña" al final de la salida del shortcode [charitable_my_campaigns].u003c/pu003e

Valor de retorno

u003cpu003eBooleano. Verdadero si quieres mostrarlo, o falso si prefieres no hacerlo. Por defecto, esto devolverá verdadero.u003c/pu003e

Argumentos

  • $show (booleano)

    u003cpu003eSi se debe mostrar el botón.u003c/pu003e

Uso

// Do not show the button.nadd_filter( 'charitable_ambassadors_my_campaigns_show_campaign_creation_link', '__return_false' );

Texto del botón

Añadido en la versión 1.0.0

u003cpu003eCambia el texto del botón "Crear una campaña" al final de la salida del shortcode [charitable_my_campaigns].u003c/pu003e

Valor de retorno

u003cpu003eString. El texto a usar en el botón.u003c/pu003e

Argumentos

  • $text (cadena)

    u003cpu003eEl texto del botón.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_my_campaigns_button_text', function( $text ) {n    return 'Start a New Campaign';n} );

Página de éxito de envío de campaña

Añadido en la versión 1.0.0

u003cpu003eCambia la página a la que se redirigirá a los usuarios después de que envíen su campaña por primera vez. Ten en cuenta que si quieres redirigir a una página estática, puedes hacerlo sin código configurando la opción "Página de éxito de envío de campaña" en Charitable > Ajustes > Embajadores.u003c/pu003e

Valor de retorno

u003cpu003eString. Una URL a la que redirigir después de enviar una campaña por primera vez. Ten en cuenta que la redirección se realiza a través de una llamada a u003ccodeu003ewp_safe_redirect()u003c/codeu003e, por lo que la URL debe ser a un host permitido (ver u003ca href=u0022https://developer.wordpress.org/reference/functions/wp_safe_redirect/u0022u003ehttps://developer.wordpress.org/reference/functions/wp_safe_redirect/u003c/au003e).u003c/pu003e

Argumentos

  • $default (cadena)

    u003cpu003eLa URL a la que redirigir.u003c/pu003e

  • $argumentos (matriz)

    u003cpu003eUna matriz de argumentos. Por defecto, solo tendrá una propiedad u003ccodeu003ecampaign_idu003c/codeu003e con el ID de la campaña recién enviada.u003c/pu003e

Uso

// Redirect to the newly submitted campaign after submission.nadd_filter( 'charitable_permalink_campaign_submission_success_page', function( $url, $args = array() ) {n    if ( ! array_key_exists( 'campaign_id', $args ) ) {n        return $url;n    }nn    return get_permalink( $args['campaign_id'] );n}, 10, 2 );

URL de redirección del envío de campaña

Añadido en la versión 1.0.0

u003cpu003eCambia la URL a la que se redirige a los usuarios después de enviar, actualizar o guardar y previsualizar su campaña.u003c/pu003e u003cpu003eSi solo quieres cambiar la página a la que se redirige a los usuarios después de enviar su campaña por primera vez, usa en su lugar el filtro u003ca href=u0022https://www.wpcharitable.com/documentation/hooks-filters-in-ambassadors/#charitable_permalink_campaign_submission_success_pageu0022u003echaritable_permalink_campaign_submission_success_pageu003c/au003e.u003c/pu003e

Valor de retorno

u003cpu003eString. La URL a la que se redirigirá al usuario.u003c/pu003e

Argumentos

  • $url (cadena)

    u003cpu003eLa URL a la que se redirigirá al usuario.u003c/pu003e

  • $data (matriz)

    u003cpu003eLos datos enviados.u003c/pu003e

  • $campaign_id (int)

    u003cpu003eEl ID de la campaña.u003c/pu003e

  • $user_id (int)

    u003cpu003eEl ID del usuario.u003c/pu003e

Lista de campos del formulario de recaudación de fondos de embajadores benéficos

Añadido en la versión 2.1.0

u003cpu003eAñade o elimina campos del formulario de recaudación de fondos. u003c/pu003eu003cpu003eLa lista de campos es una lista de claves de campos que se incluyen en el formulario principal de la campaña, los cuales también deben incluirse en el formulario de recaudación de fondos. Los siguientes campos no se incluyen en el formulario de recaudación de fondos por defecto:u003c/pu003eu003cpu003e- u003ccodeu003edescriptionu003c/codeu003eu003cbru003e- u003ccodeu003ecategoriesu003c/codeu003eu003cbru003e- u003ccodeu003etagsu003c/codeu003eu003cbru003e- u003ccodeu003esuggested_donationsu003c/codeu003eu003cbru003e- u003ccodeu003eallow_custom_donationsu003c/codeu003eu003c/pu003e

Valor de retorno

matriz

Argumentos

  • $list (matriz)

    u003cpu003eLa lista de campos que se incluirán.u003c/pu003e

  • $form (Charitable_Ambassadors_Fundraiser_Form)

    u003cpu003eEl objeto del formulario de recaudación de fondos.u003c/pu003e

Uso

// Include the 'description' field in the Fundraiser form.nadd_filter( 'charitable_ambassadors_fundraiser_form_field_list', function( $fields ) {n    $fields[] = 'description';n    return $fields;n} );

Campos heredados de la recaudación de fondos de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eFiltra los campos que se heredan automáticamente de la campaña principal de la recaudación de fondos.u003c/pu003e

Valor de retorno

matriz

Argumentos

  • $campos (matriz)

    u003cpu003eLos campos heredados.u003c/pu003e

Uso

add_filter(n    'charitable_ambassadors_fundraiser_inherited_fields', n    function( $fields ) {n        $fields[] = 'my_custom_field';n        return $fields;n    }n);

Actualizar las fechas de finalización de la recaudación de fondos cuando cambie la fecha de finalización principal

Añadido en la versión 2.0.0

u003cpu003eEstablece si las fechas de finalización de las recaudaciones de fondos se actualizarán automáticamente cuando la campaña principal cambie su fecha de finalización.u003c/pu003e

Valor de retorno

u003cpu003eBooleano. Por defecto es true.u003c/pu003e

Argumentos

  • $should_update (booleano)

    u003cpu003eSi se debe actualizar automáticamente.u003c/pu003e

  • $campaign (Charitable_Campaign)

    u003cpu003eEl objeto de la campaña principal.u003c/pu003e

Columnas de exportación de donaciones del creador de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eFiltra las columnas que se incluyen en la exportación.u003c/pu003e

Valor de retorno

u003cpu003eArray. Las claves de las columnas a incluir.u003c/pu003e

Argumentos

  • $columns (matriz)

    u003cpu003eLas columnas a incluir.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_creator_donations_export_columns', function( $columns ) {n    // Only show the first name, last name, amount and donor comment.n    $included_columns = array(n        'first_name',n        'last_name',n        'amount',n        'donor_comment',n    );ntn    foreach ( $columns as $column =u003e $header ) {n        if ( ! in_array( $column, $included_columns ) ) {n            unset( $columns[ $column ] );n        }n    }ntn    return $columns;n} );

¿Todavía tienes preguntas? ¡Estamos aquí para ayudarte!

Enviar un ticket de soporte
Contáctanos

Última modificación:

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!

Mejora Pagos

💰 Acepta donaciones recurrentes con Windcave y Charitable

Un donante configura su donación una vez en la página de pago segura de Windcave, y Charitable factura cada renovación según lo programado. Por qué esto es importante:

🏦 Organizaciones con sede en Nueva Zelanda o Australia: donaciones mensuales en la pasarela con la que tu banco ya te ha configurado, sin un segundo procesador que incorporar.
⛪ Iglesias que reciben diezmos y ofrendas regulares: los miembros de la congregación establecen su propio calendario una vez, que es la forma más sencilla de lanzar donaciones recurrentes para la iglesia sin una plataforma separada.
🌏 Grupos con donantes en varias divisas: Windcave gestiona más de 20, por lo que un donante puede dar en la divisa que realmente posee.
📅 Fondos operativos en lugar de campañas puntuales: activa el modo Solo Recurrente y la opción única desaparece, por lo que cada donación a esa campaña es una suscripción.
🧾 Equipos sin desarrollador en plantilla: 3 conjuntos de credenciales pegados en una página de configuración, y sin código en ninguna parte.

Consulta nuestro anuncio aquí.

automatización actualizar

⚡ Creador Visual de Automatización: ¡Arrastrar y Soltar Sin Código!

Charitable Automation Connect 2.3.0 presenta el Generador de Automatización Visual, un lienzo a pantalla completa que presenta cada automatización como un flujo de tarjetas conectadas: un desencadenador, condiciones opcionales y una lista de acciones que se ejecutan en orden.

🧩 Muchas acciones, un desencadenador: Etiqueta a un donante, envía un correo electrónico, agrega una nota y activa una llamada webhook desde un solo evento, arrastrado en cualquier orden.

✉️ Actúa dentro de Charitable: Las nuevas acciones Enviar correo electrónico, Etiquetar donante y Agregar nota de donante se ejecutan sin necesidad de un servicio externo.

🔤 Etiquetas de combinación: Personaliza correos electrónicos y notas con campos en vivo como {first_name}, {total} y {campaign_name}.

🔁 Aplicar a donantes existentes: Ejecuta Etiquetar donante y Agregar nota de donante contra los donantes que ya tienes.

🖥️ Lienzo o Simple: Cambia de vista en cualquier momento, y las automatizaciones creadas antes de la 2.3.0 siguen funcionando sin cambios.

Lee más aquí.

Integración actualizado

📬 Presentamos Brevo para Charitable: Convierte donantes en suscriptores automáticamente

El momento en que un donante realiza una donación es cuando está más comprometido. Con la nueva integración de Brevo para Charitable, puedes convertir automáticamente a esos donantes únicos en suscriptores a largo plazo sin tocar una sola hoja de cálculo.

Simplemente recopila el consentimiento del donante directamente en tu formulario de donación y comienza tu serie de bienvenida de inmediato.

Novedades:

🔄 Sincronización automática de suscriptores: Los nuevos donantes que aceptan se añaden directamente a tu lista de contactos de Brevo tan pronto como se procesa su pago, sin necesidad de exportaciones manuales ni importaciones de CSV.

🎯 Control granular de consentimiento y opción de suscripción: Personaliza la etiqueta de tu casilla de verificación, elige si se marca por defecto o no, o activa la doble opción de suscripción de Brevo para mantener tu lista limpia y conforme.

📋 Mapeo de listas por campaña: Dirige a los donantes a tu lista de correo global o mapea campañas específicas a listas de Brevo dirigidas para adaptar tus mensajes de seguimiento.

⚡ Configuración en 5 minutos: Conéctate al instante pegando tu clave API de Brevo en la configuración de Newsletter, mapea tus campos de contacto y empieza a crear tu lista de correo en piloto automático.

¿Listo para hacer crecer tu lista de correo? Brevo ya está disponible a partir del plan Charitable Plus. ¡Conecta tu cuenta hoy mismo!

donaciones recurrentes actualizado

💳 Presentamos Actualizaciones de Tarjeta: ¡Soluciona Tarjetas Caducadas Sin Perder Suscripciones!

Las tarjetas de crédito caducadas o actualizadas son una de las mayores fugas silenciosas en la recaudación de fondos recurrente. Con las actualizaciones de tarjetas en la extensión de donaciones recurrentes, los donantes ahora pueden actualizar sus detalles de pago directamente, manteniendo intactas su suscripción, su calendario y su historial de donaciones.

Sin planes cancelados, sin historial perdido y sin dolores de cabeza administrativos para tu equipo.

Novedades:

⚡ Autoservicio en 30 Segundos: Los donantes obtienen un botón dedicado de “Actualizar Tarjeta” en su panel que abre el Portal de Clientes seguro y compatible con PCI de Stripe para actualizar los detalles de la tarjeta al instante.

🔒 Acceso Seguro y Delimitado: Delimitado exclusivamente a las actualizaciones de tarjetas por defecto, los donantes no pueden cancelar ni alterar accidentalmente sus planes desde el portal, manteniendo tus webhooks y datos sincronizados.

🤝 Soporte Asistido por Administrador: ¿Ayudando a un donante por teléfono? Abre su portal seguro de Stripe con un solo clic desde tu pantalla de administrador o genera un enlace de actualización de un solo uso para enviárselo por correo electrónico.

📋 Pista de Auditoría Automática: Cada actualización de método de pago se registra automáticamente con una marca de tiempo tanto en los registros generales del sistema como en el perfil del donante individual.

¡Listo para proteger tus ingresos recurrentes? Obtén el plan Plus o Pro y actualiza Donaciones Recurrentes a la versión 2.3.0+ y activa “Actualizar Método de Pago” en tu Configuración hoy mismo.

Integración constructor de páginas

¡Fans de Divi, regocíjense! ¡Módulo nativo de barra de progreso de campaña para Divi 5!

Con nuestro nuevo módulo nativo para Divi 5, puedes anclar tus micrositios con estadísticas de recaudación de fondos en tiempo real directamente en el lienzo visual. Así es como funciona y por qué vale la pena activarlo hoy.

Crea actualizaciones de campaña que sean VISUALES Y EN VIVO. También puedes:

📊 Barra de progreso de la campaña: Inserta una barra de progreso en vivo en cualquier diseño de Divi 5 y muestra el progreso de los objetivos en tiempo real.

🎨 Controles de estilo avanzados: Personaliza fácilmente el color de la barra y el seguimiento, la altura y el radio para que coincidan perfectamente con tu marca.

👁️ Listo para el constructor visual: Configura y previsualiza todo directamente en el lienzo de Divi como un módulo de primera clase.

🔁 Renderizado idéntico: El mismo motor exacto impulsa este módulo, lo que significa un diseño consistente sin soluciones alternativas heredadas.

✅ Lanzamientos más rápidos: Nunca salgas de la interfaz de Divi 5 para configurar códigos cortos o adivinar cómo se verán las etiquetas de tus objetivos.

Más información aquí.

Ver todos los anuncios