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!

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

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