Documentación de Charitable

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

Personalizar formularios de donación con fragmentos de código usando WPCode

A menudo, los creadores de campañas benéficas quieren personalizar sus formularios de donación. La personalización más común es agregar un campo adicional al formulario, como un campo de texto para introducir un código específico o una dirección de correo electrónico alternativa. Otras veces, es una casilla de verificación para confirmar si el donante desea ser informado de servicios adicionales.

Es posible agregar campos personalizados a un formulario de donación, y esto se puede hacer a través de fragmentos de código fáciles de modificar que se pueden agregar al archivo functions.php o a un plugin dedicado. Pero para aquellos que no son desarrolladores o no se sienten cómodos con el código, existe un método más fácil y rápido para agregar y activar fragmentos de código en Charitable usando WPCode.

Requisitos previos

Asegúrate de estar usando Charitable versión 1.8.1.7 o superior.

En esta guía

Instalación de WPCode

El primer paso es instalar WPCode en sí. Puedes instalar y activar la versión gratuita al igual que con cualquier otro plugin de WordPress. Sin embargo, Charitable tiene un proceso integrado más sencillo.

Ve a "Herramientas" y luego haz clic en la pestaña "Fragmentos de código".

Si aún no has instalado WPCode, deberías ver una indicación que te permitirá instalar y activar el plugin allí mismo.

Activación de fragmentos de código

Una vez que esto sea exitoso, la misma pestaña se poblará con fragmentos de código. Cada cuadro en la página contiene el título, una breve descripción, un enlace a la ubicación del fragmento en WPCode y un botón de instalación.

Por ejemplo, si estuvieras buscando agregar un cuadro de texto personalizado a un formulario de donación, busca "cuadro de texto" en el cuadro de búsqueda y la página se actualizará con los resultados que coincidan con esa palabra clave. Puedes localizar un script de ejemplo y hacer clic en instalar, y ese script se copiará y agregará automáticamente a tu biblioteca de fragmentos de WPCode.

Personalización de fragmentos de código para Charitable

A menudo, los fragmentos de código instalados tienen comentarios y documentación en su interior, por lo que puedes personalizar el fragmento. Por ejemplo, si quisiera un área de texto para que un donante comparta cómo se enteró de la campaña, este fragmento "Agregar cuadro de texto al formulario de donación" fragmento podría modificarse como se muestra aquí:

/**
 * Collect a textarea field in the donation form.
 *
 * This snippet only works in Charitable 1.5 or above.
 *
 */
function wpchar_charitable_register_new_textarea_field() {
    /**
     * Define a new textarea field.
     */
	
	if ( ! class_exists("Charitable_Donation_Field" ) ) {
		return;
	};
		
    $field_1 = new Charitable_Donation_Field( 'textarea_example', array(
        'label' => __( 'How did you learn about this campaign?', 'charitable' ),
        'data_type' => 'user',
        'donation_form' => array(
            'type' => 'textarea',
			'show_after' => 'phone', // adjust to where you want this to show up
                        'required'   => false,
             ),
        'admin_form' => false,
        'show_in_meta' => false,
        'show_in_export' => false,
        'email_tag' => array(
            'description' => __( 'How did you learn...' , 'charitable' ),
        ),
    ) );

    /**
     * Register the textarea fields.
     */
	charitable()->donation_fields()->register_field( $field_1 );

}

add_action( 'init', 'wpchar_charitable_register_new_textarea_field' );

Hay muchos otros fragmentos que van más allá de la creación de un cuadro de texto en un formulario de donación y se extienden a la personalización de tus campañas y formularios de donación aún más. Siéntete libre de explorar la biblioteca en el sitio web de WPCode o en la pantalla del plugin Charitable.

¿Tienes una idea para un fragmento de código que aún no existe? ¡Contáctanos y lo agregaremos!

También te puede interesar la documentación de WPCode para obtener más información sobre cómo funciona su plugin y las funciones adicionales que puedes asignar a los fragmentos de código, incluidos los fragmentos de código de Charitable.

Recibe consejos sobre recaudación de fondos y asesoramiento para organizaciones sin ánimo de lucro

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.

Preguntas frecuentes: Añadir campos personalizados a formularios de donación de Charitable

¿Qué son los campos personalizados y por qué los necesitaría? 

Los campos personalizados te permiten recopilar información adicional de los donantes más allá del nombre, correo electrónico y monto de la donación estándar. Los usos comunes incluyen:

  • Recopilar códigos de referencia o códigos promocionales
  • Añadir campos de "En memoria de" o dedicatorias
  • Recopilar comentarios sobre cómo los donantes se enteraron de tu campaña
  • Incluir casillas de verificación para suscripciones al boletín
  • Añadir información de la empresa para donantes corporativos

¿Necesito experiencia en codificación para añadir campos personalizados? 

No. Si bien los campos personalizados se pueden añadir mediante código, WPCode proporciona una solución fácil de usar que no requiere ningún conocimiento de programación. Puedes instalar fragmentos preconstruidos con solo unos pocos clics.

¿Afectará la adición de campos personalizados a mis tasas de conversión de donaciones? 

Esto depende de la implementación. Los campos opcionales suelen tener un impacto mínimo, mientras que demasiados campos obligatorios innecesarios pueden reducir las conversiones. Recomendamos:

  • Hacer que los campos adicionales sean opcionales siempre que sea posible
  • Mantener los formularios concisos y fáciles de usar
  • Probar diferentes configuraciones para ver qué funciona para su audiencia

¿Es WPCode gratuito? 

¡Sí! WPCode ofrece una versión gratuita que incluye acceso a muchos fragmentos de código. También hay una versión premium con funciones adicionales, pero la versión gratuita es suficiente para la mayoría de las necesidades de campos personalizados.

¿Funcionarán los campos personalizados con mi tema de WordPress? 

Los campos personalizados deberían funcionar con cualquier tema de WordPress codificado correctamente. Sin embargo, es posible que necesite agregar CSS personalizado para que coincida con el estilo de su tema. Si experimenta problemas de visualización, póngase en contacto con nuestro equipo de soporte.

¿Cómo instalo WPCode?

  1. Vaya a Benéfico → Herramientas → Fragmentos de código
  2. Si WPCode no está instalado, verá una indicación de instalación
  3. Haga clic en el botón de instalación para instalar y activar WPCode automáticamente
  4. Una vez activado, verá los fragmentos de código disponibles

No veo la pestaña Fragmentos de código. ¿Qué pasa? 

Esto generalmente significa:

  • Su versión de Benéfico está desactualizada (actualice a 1.8.1.7+)
  • No tiene permisos de administrador
  • Hay un conflicto de plugins (intente desactivar otros plugins temporalmente)

¿Cómo encuentro el fragmento de código adecuado para mis necesidades? 

Utilice la funcionalidad de búsqueda en la pestaña Fragmentos de código. Busque términos como:

  • “campo de texto” para entradas de texto adicionales
  • “casilla de verificación” para opciones de suscripción
  • “lista desplegable” para menús de selección
  • “área de texto” para entradas de texto más largas

¿Puedo modificar los fragmentos de código? 

¡Absolutamente! La mayoría de los fragmentos incluyen comentarios y documentación para guiar la personalización. Puede cambiar:

  • Etiquetas y descripciones de los campos
  • Posicionamiento de los campos en el formulario
  • Si los campos son obligatorios u opcionales
  • Tipos de campo (texto, área de texto, lista desplegable, etc.)

¿Dónde aparecen los envíos de campos personalizados? 

Los datos de los campos personalizados aparecen en:

  • Detalles de la donación en tu panel de administración de WordPress
  • Notificaciones por correo electrónico (si están configuradas)
  • Informes de exportación (si están habilitados en la configuración del fragmento de código)

¿Puedo añadir varios campos personalizados a un solo formulario? 

¡Sí! Puedes instalar y activar varios fragmentos de código para añadir varios campos personalizados a tus formularios de donación.

Mi campo personalizado no se muestra en el formulario de donación. ¿Qué está mal? 

Comprueba estos problemas comunes:

  • Asegúrate de que el fragmento de código esté activado en WPCode
  • Verifica que tu versión de Charitable cumpla con los requisitos
  • Borra cualquier plugin de caché
  • Comprueba si el campo está configurado para mostrarse en la ubicación correcta

El campo aparece pero se ve extraño o no coincide con mi tema. 

Normalmente es un problema de estilo. Es posible que necesites añadir CSS personalizado. Ponte en contacto con nuestro equipo de soporte para obtener ayuda con el estilo específico del tema.

¿Puedo eliminar un campo personalizado después de añadirlo? 

¡Sí! Simplemente desactiva o elimina el fragmento de código en WPCode. Ten en cuenta que los datos de los formularios enviados previamente permanecerán en tu base de datos.

Activé un fragmento pero está causando errores en mi sitio. 

Desactiva inmediatamente el fragmento en WPCode. Esto normalmente resuelve el problema. Si los problemas persisten:

  • Comprueba conflictos de plugins
  • Asegúrate de que tus versiones de WordPress y Charitable estén actualizadas
  • Contacta con soporte con mensajes de error específicos

¿Dónde puedo aprender más sobre WPCode? 

Visita la documentación de WPCode para explorar funciones avanzadas como la programación de fragmentos, la segmentación por dispositivo y la lógica condicional.

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

Necesitas soporte? Tienes alguna pregunta? Si eres un usuario lite/gratuito de Charitable, puedes contactar a nuestro equipo en los foros de soporte de WordPress.org y nuestro equipo responderá a tiempo. Si tienes una licencia activa, no dudes en contactarnos directamente para soporte prioritario.

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

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