Documentación de Charitable

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

Hooks y filtros en Recibos Anuales

Al igual que todas las extensiones de Charitable, Recibos Anuales de Charitable está diseñada para ser fácil de usar para los desarrolladores, con hooks y filtros que te ayudarán a personalizarla según tus necesidades.

Extensión de pago

Recibos Anuales de Charitable es un plugin premium. Consíguelo hoy mismo con uno de nuestros paquetes de plugins.

Filtros

charitable_dompdf_options

Añadido en la versión 1.0.0

Cambia el array de opciones que se pasa a Dompdf al generar el PDF. Para ver todas las opciones disponibles, consulta:
https://github.com/dompdf/dompdf/blob/master/src/Options.php#L6-L286

Valor de retorno

Un array que representa un conjunto de opciones.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

charitable_pdf_mode

Añadido en la versión 1.0.0

Esto te permite cambiar el modo en el que se cargará el PDF. Por defecto, se descargará automáticamente, pero puedes cambiarlo para que se muestre en línea.

Valor de retorno

download o inline.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

Uso

add_filter( 'charitable_pdf_mode', function() {
    return 'inline';
} );

charitable_pdf_download_annual_receipt

Añadido en la versión 1.0.0

Usa tu propia clase para generar el PDF. La clase debe implementar la interfaz \Charitable\Packages\Pdf\Interfaces\ClientInterface.

Valor de retorno

Un objeto que implementa la interfaz \Charitable\Packages\Pdf\Interfaces\ClientInterface.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

charitable_annual_receipts_languages_directory

Añadido en la versión 1.0.0

Modifica el directorio donde se almacenan las traducciones de extensiones.

Valor de retorno

Una cadena que representa la ruta al directorio de idiomas, relativa al directorio wp-content/plugins.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

charitable_annual_receipts_languages_directory

Añadido en la versión 1.0.0

Modifica el directorio donde se almacenan las traducciones de extensiones.

Valor de retorno

Una cadena que representa la ruta al directorio de idiomas, relativa al directorio wp-content/plugins.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

charitable_annual_receipts_languages_directory

Añadido en la versión 1.0.0

Modifica el directorio donde se almacenan las traducciones de extensiones.

Valor de retorno

Una cadena que representa la ruta al directorio de idiomas, relativa al directorio wp-content/plugins.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

charitable_annual_receipts_theme_template_path

Añadido en la versión 1.0.0

Cambia el directorio donde se almacenan los archivos de plantilla, relativo al tema/tema hijo.

Valor de retorno

Un string que representa la ruta al directorio de plantillas, relativo a la carpeta del tema.

Argumentos

  • $mode (cadena)

    El modo. Por defecto es download.

Acción

charitable_annual_receipts_start

Añadido en la versión 1.0.0

Hook que se dispara cuando el plugin se carga por primera vez.

Valor de retorno

Vacío

Argumentos

  • $view_args (matriz)

    Argumentos pasados a la plantilla.

charitable_before_annual_receipt

Añadido en la versión 1.0.0

Haz algo antes de que se muestre el recibo anual.

Valor de retorno

Vacío

Argumentos

  • $view_args (matriz)

    Argumentos pasados a la plantilla.

charitable_after_annual_receipt

Añadido en la versión 1.0.0

Haz algo después de que se muestre el recibo anual.

Valor de retorno

Vacío

Argumentos

  • $view_args (matriz)

    Argumentos pasados a la plantilla.

charitable_annual_receipts_pdf_styles

Añadido en la versión 1.0.0

Añade estilos personalizados a la versión PDF del recibo anual.

Valor de retorno

Vacío

Argumentos

  • $view_args (matriz)

    Argumentos pasados a la plantilla.

Uso

add_action( 'charitable_annual_receipts_pdf_styles', function() {
    echo "color: #444;";
} );

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

Ú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!

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

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!