Documentación de Charitable

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

How to Add a Custom Donation Field

Adding custom fields to your Charitable donation forms allows you to collect additional information from donors beyond the standard fields. Whether you need to gather referral codes, dedication messages, or specific donor details, you can easily add these fields using code snippets.

This guide will show you how to add custom fields in your donation forms.

In This Guide

Quick Start Example

Here’s a practical example to get you started. Check out this code snippet » Collect National ID.

This code snippet demonstrates how to add a National ID Number field to your donation form:

You can use that code snippet and customize it to suit your needs:

  • Replace every instance of ‘national_id_number’ with ‘your_field’.
  • Replace every instance of ‘National ID Number’ with the label for your field.

Now that you have an idea of code snippets, let’s show you how to add and customize code snippets.

How To Add A Code Snippet

If you are new to PHP or WordPress development, we recommend using the WPCode plugin to insert snippets safely and easily into your website. Charitable currently has over 130 snippets in the WPCode plugin library you can use. Visit our library here:

Charitable Code Snippet Library »

For those a little more familiar with WordPress development, you can use the snippets to create simple standalone plugins. Read the WordPress documentation about creating a plugin.

Alternatively, you could add the snippets directly to your theme or child theme’s functions.php file.

Please be aware of our recommendations and suggestions for safe practices using code snippets to avoid fatal errors and issues: Customizing Donation Forms With Code Snippets Using WPCode »

There are many other snippets that go beyond creating a text box on a donation form and extend into customizing your campaigns and donation forms even further. Feel free to explore the library either on WPCode‘s website or in the screen in the Charitable plugin.

Have an idea for a code snippet that doesn’t exist yet? Contact us and we’ll add it!

You may also be interested in WPCode documentation to learn more about how their plugin works and the additional features that you can assign to code snippets, including Charitable code snippets.

Get Fundraising Tips & Non-Profit Advice

Compartimos regularmente guías prácticas, estrategias probadas y consejos de expertos para ayudarte a recaudar más fondos y construir relaciones más sólidas con los donantes. Únete a miles de organizaciones sin fines de lucro que reciben nuestro mejor contenido directamente:

Sin relleno, solo consejos prácticos de personas que entienden los desafíos que enfrentas cada día.

FAQs: Adding Custom Fields to Charitable Donation Forms

What are custom fields and why would I need them? 

Custom fields allow you to collect additional information from donors beyond the standard name, email, and donation amount. Common uses include:

  • Collecting referral codes or promotional codes
  • Adding “In memory of” or dedication fields
  • Gathering feedback on how donors heard about your campaign
  • Including checkboxes for newsletter subscriptions
  • Adding company information for corporate donors

Do I need coding experience to add custom fields? 

No. While custom fields can be added through code, WPCode provides a user-friendly solution that doesn’t require any programming knowledge. You can install pre-built snippets with just a few clicks.

Will adding custom fields affect my donation conversion rates? 

This depends on implementation. Optional fields typically have minimal impact, while too many unnecessary required fields may possibly reduce conversions. We recommend:

  • Making additional fields optional when possible
  • Keeping forms concise and user-friendly
  • Testing different configurations to see what works for your audience

Is WPCode free to use? 

Yes! WPCode offers a free version that includes access to many code snippets. There’s also a premium version with additional features, but the free version is sufficient for most custom field needs.

Will custom fields work with my WordPress theme? 

Custom fields should work with any properly coded WordPress theme. However, you may need to add custom CSS to match your theme’s styling. If you experience display issues, contact our support team.

How do I install WPCode?

  1. Go to Charitable → Tools → Code Snippets
  2. If WPCode isn’t installed, you’ll see an installation prompt
  3. Click the install button to automatically install and activate WPCode
  4. Once activated, you’ll see available code snippets

I don’t see the Code Snippets tab. What’s wrong? 

This usually means:

  • Your Charitable version is outdated (update to 1.8.1.7+)
  • You don’t have admin permissions
  • There’s a plugin conflict (try deactivating other plugins temporarily)

How do I find the right code snippet for my needs? 

Use the search functionality in the Code Snippets tab. Search for terms like:

  • “text field” for additional text inputs
  • “checkbox” for opt-in options
  • “dropdown” for selection menus
  • “textarea” for longer text inputs

Can I modify the code snippets? 

Absolutely! Most snippets include comments and documentation to guide customization. You can change:

  • Field labels and descriptions
  • Field positioning on the form
  • Whether fields are required or optional
  • Field types (text, textarea, dropdown, etc.)

Where do custom field submissions appear? 

Custom field data appears in:

  • Donation details in your WordPress admin
  • Email notifications (if configured)
  • Export reports (if enabled in the snippet settings)

Can I add multiple custom fields to one form? 

Yes! You can install and activate multiple code snippets to add several custom fields to your donation forms.

¿Hay tutoriales en vídeo disponibles? 

¡Sí! Suscríbete al canal de YouTube de Charitable para obtener tutoriales paso a paso e historias de éxito.

Need support? Have a question? If you are a lite/free user of Charitable, you can reach out to our team on the WordPress.org support forums and our team will respond in a timely fashion. If you have an active license, feel free to reach out us directly for priority support.

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

GiveWP Migraciones Nuevo

Servicio de Migración "White Glove" para GiveWP

¿Estás pensando en cambiar tu plataforma de recaudación de fondos de GiveWP a Charitable, pero no quieres arriesgarte a perder tus datos ni a encargarte tú mismo de una configuración técnica compleja? El Servicio de Migración "White Glove" de Charitable incluye:

👥 Mapeo impecable de donantes: Transfiere de forma segura toda tu base de datos de colaboradores sin pérdida de datos.

📊 Historial financiero completo: Conserva meticulosamente cada transacción histórica para una presentación de informes continua y precisa.

🔄 Donaciones recurrentes sin interrupciones: Transfiere de forma segura las suscripciones activas sin interrumpir tus ingresos ni requerir que tus donantes actualicen su información.

💳 Cero interrupciones en la pasarela de pago: Sigue usando Stripe, PayPal o cualquier otro procesador compatible con GiveWP que ya te guste.

🚀 Configuración técnica experta: Relájate mientras nuestro equipo se encarga de la instalación y configuración de tus formularios. Además, los usuarios que cumplan los requisitos obtendrán un año completo de Charitable Pro gratis.

Visita esta página para obtener más información.

automatización Mejora

📢 Alerta de nueva función: ¡Automation Connect 2.0 ya está aquí! 🚀

¿Estás pensando en conectar tus datos de recaudación de fondos con herramientas como Mailchimp, Slack o Google Sheets, pero no quieres contratar a un desarrollador ni escribir código personalizado? El nuevo complemento de automatización de Charitable incluye:

⚡ 17 disparadores de eventos: Activa instantáneamente webhooks para el primer donativo de un donante, pagos de renovación o hitos de campaña alcanzados.

🎯 Lógica condicional inteligente: Utiliza una potente lógica AND/OR en 11 campos para enviar datos solo cuando cumplan tus criterios exactos, como las suscripciones al boletín.

📊 Control de carga útil personalizado: Selecciona entre más de 80 campos de datos limpios de metadatos de donantes, donaciones y campañas para que tus aplicaciones obtengan exactamente lo que necesitan.

🚀 Plantillas de plataforma preconstruidas: Evita la configuración desde cero con plantillas listas para usar para Zapier, Make.com, n8n, HubSpot y Slack.

🛡️ Herramientas de desarrollador fiables: Potencia tus flujos de trabajo con cargas útiles firmadas HMAC-SHA256, filtros completos de WordPress y registros de reintentos automáticos.

automatización Mejora

🔌 Charitable se une a Zapier: Conecta con más de 7000 aplicaciones y automatiza tu recaudación de fondos

¿Cansado de copiar manualmente los datos de las donaciones en hojas de contabilidad o de rastrear las nuevas suscripciones de donantes? Pon tus tareas administrativas en piloto automático. Charitable ya está oficialmente en Zapier, lo que te proporciona una forma potente y sin código para conectar tu recaudación de fondos directamente con el resto de tus herramientas favoritas.

Cada donación, suscripción de donante e hito de campaña ahora puede activar un flujo de trabajo automatizado sin problemas.

Novedades:

♾️ Conecta con más de 7000 aplicaciones: Une tus campañas de Charitable con software cotidiano como Google Sheets, QuickBooks, Slack, Mailchimp, HubSpot, Notion, Airtable y miles más.

⚡ 12 potentes disparadores: Crea flujos de trabajo profundos utilizando disparadores de automatización inteligentes que cubren todo el ciclo de vida de la donación, incluyendo Nueva Donación, Nuevo Donante, Suscripción Cancelada y Objetivo de Campaña Alcanzado.

📋 Plantillas de acciones preconstruidas: Empieza en tres minutos o menos con nuestras combinaciones de plantillas prefabricadas, como registrar automáticamente nuevas donaciones directamente en una Hoja de Cálculo de Google o enviar correos electrónicos personalizados de bienvenida a donantes a través de Gmail.

🚫 No se necesita código: No se requieren webhooks complejos ni scripts PHP personalizados. Simplemente elige tu disparador, selecciona tu aplicación, mapea tus campos y deja que Zapier se encargue del trabajo pesado.

¿Listo para ahorrar horas de tiempo administrativo? ¡Consigue Charitable Pro con el complemento Automation Connect hoy mismo y lanza tu primer Zap!

Mejora Pagos

🚀 Presentamos PayPal Commerce: Una conexión, seis formas de donar

Los donantes esperan opciones de pago modernas y flexibles cuando apoyan una causa. Si no ven su método preferido en su formulario de donación, a menudo desaparecen sin decir nada. Con PayPal Commerce, estamos brindando una experiencia de pago completamente modernizada directamente a sus campañas.

Disfrute de una única integración que mejora sus formularios, hace que las donaciones sean fluidas y le ayuda a capturar cada donación.

Novedades:

🔌 Conexión con un clic: omita las complicadas claves API y los documentos para desarrolladores. Simplemente haga clic en "Conectar con PayPal", inicie sesión en su cuenta comercial y su formulario moderno estará activo en menos de cinco minutos.

💳 Seis formas de donar: brinde a sus seguidores acceso instantáneo al saldo de PayPal, Venmo (EE. UU.), financiación "Paga más tarde", las principales tarjetas de crédito/débito, Apple Pay (Safari) y Google Pay (Chrome), todo desde el mismo formulario.

🔄 Donaciones recurrentes flexibles: admite completamente las donaciones mensuales. Elija entre la API de suscripciones de PayPal (gestionada automáticamente por PayPal) o Vault + Cron (gestionada de forma segura en su sitio).

💬 Recuperación de errores amigable: no más alertas confusas del navegador. Si se rechaza un pago, los donantes ven mensajes sencillos y en línea que los guían sobre cómo solucionar el problema y completar su donación.

¿Listo para PayPal, modernizado? Actualice a Charitable Pro 1.8.15+ (o Charitable Lite 1.8.11+) y conecte su cuenta hoy mismo.

Campañas Nuevo

⏳ Cuenta atrás de la campaña: genere urgencia y aumente las donaciones

¡La urgencia es una de las herramientas más poderosas en la recaudación de fondos! Conozca Campaign Countdown, un temporizador en vivo y en tiempo real diseñado para convertir la procrastinación en generosidad inmediata.

animación de cuenta atrás de campaña

Novedades:

⏱️ Urgencia en vivo y en tiempo real: rastree bellamente días, horas, minutos y segundos hasta la fecha límite de su campaña con cuentas atrás visuales que se actualizan en vivo.

🎨 Adaptado a su estilo: elija entre mosaicos con borde "Boxed" o una pantalla "Inline" limpia y de una sola línea. Adapte su tema al instante con controles de fuente y color profundo.

🛠️ Colóquelo en cualquier lugar: inserte la cuenta atrás donde desee utilizando el campo Campaign Builder, un bloque Gutenberg dedicado o un simple shortcode.

🚨 Acciones inteligentes de caducidad: control total sobre el estado final: elija reemplazar automáticamente el temporizador con un mensaje personalizado, congelarlo en cero y más.