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

💸 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í.

Función Nuevo

🎟️ Presentamos Eventos Benéficos: ¡Vende entradas dentro de tus campañas!

La mayoría de las organizaciones sin ánimo de lucro venden entradas para eventos en una herramienta y recaudan donaciones en otra, lo que genera dos conjuntos de informes y una conciliación manual al final del año. Eventos Benéficos une ambas cosas, vendiendo entradas a través de los mismos formularios de donación y pasarelas de pago que ya utilizas en Charitable. Por qué esto es importante:

  • 🎟️ Cada entrada es una donación: Las ventas de entradas se procesan a través de la pasarela que ya utilizas y cuentan para el objetivo de la campaña, con todo gestionado en Charitable » Eventos.
  • 📱 Registro con código QR desde cualquier teléfono: Cada asistente recibe su propio código QR en el recibo, y los voluntarios escanean en la puerta a través de un enlace de registro que no necesita cuenta de WordPress.
  • 🧾 Recibos listos para la declaración de impuestos: Asigna a cada tipo de entrada un valor justo de mercado, y Charitable incluirá el importe correcto deducible de impuestos en cada recibo de donante.
  • 📋 Detalles del asistente al finalizar la compra: Pregunta a cada invitado por su elección de comida, talla de camiseta o necesidades de acceso, con un registro de asistente independiente creado para cada entrada.
  • 🗓️ Bloques y calendarios incluidos: Tres bloques de editor, además de la compatibilidad con Sugar Calendar y The Events Calendar, muestran tus eventos donde los colaboradores ya los buscan.

Consulta nuestro anuncio aquí.

ia Nuevo

🚀 ¡Libera el poder de la IA en Charitable!

Tu asistente de IA ahora puede crear, editar y administrar tus campañas de recaudación de fondos de Charitable directamente, solo con pedírselo. Con Charitable Pro añadiendo soporte de escritura para la API de Habilidades de WordPress, herramientas como ChatGPT, Claude y Cursor pueden manejar acciones administrativas completas de forma segura a través de MCP. Por qué esto es importante:

  • 🤖 Creación de campañas en lenguaje natural: Pídele a tu asistente un objetivo como “Configura una recaudación de fondos para el refugio con un objetivo de 5.000 $”, y creará un borrador de campaña real completo con niveles de donación sugeridos.
  • 🎨 Ajustes instantáneos del formulario de donación: Añade campos personalizados, cambia los colores de los botones o reordena elementos sin tener que entrar en la configuración del formulario.
  • 📝 Registro de donaciones sin conexión: Informa a tu asistente sobre donaciones en efectivo o cheque, y cruzará los correos electrónicos de los donantes y registrará las transacciones en tu historial.
  • 🛡️ Seguridad y control por defecto: El acceso de escritura permanece estrictamente desactivado hasta que se active en Charitable » Herramientas » AI MCP, manteniendo el informe de solo lectura seguro por defecto.
  • 📜 Registro de auditoría completo: Cada cambio realizado por un asistente de IA se rastrea en Charitable » Herramientas » Registros, por lo que siempre sabrás quién (o qué) actualizó tu sitio.

Consulta nuestro anuncio aquí.

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í.

Ver todos los anuncios