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!

Nuevo plantillas

🤩 ¡Nuevas plantillas de campaña de Beacon con bloque "Héroe"!

Con las nuevas plantillas de campaña Beacon para Charitable Pro, puedes lanzar una impresionante página de recaudación de fondos de ancho completo que capta instantáneamente la atención del visitante por encima del pliegue.

Encabezado de la página de recaudación de fondos para Salvar el Parque Maple Grove con un widget de donación y una pequeña foto cuadrada de una miniatura de árbol iluminado por el sol a la izquierda.

🔦 Impacto por encima del pliegue: Lidera con una imagen principal de ancho completo, tu logotipo y tu objetivo con un widget de donación bloqueado justo encima del banner para que tu petición y tu impulso se registren al instante sin necesidad de desplazarse.

📐 Dos diseños flexibles: Elige entre un diseño estructurado de dos columnas para contar historias lado a lado y detalles de apoyo, o una vista limpia de una columna diseñada para narrativas ininterrumpidas de formato largo.

⚡ Campo principal todo en uno: Impulsado por el nuevo campo Campaign Hero, que reúne medios de fondo, barras de progreso en vivo, cantidades de donación personalizadas y pestañas de donaciones recurrentes en un solo bloque cohesivo que se puede insertar en cualquier diseño.

🎨 Coincidencia automática de temas: El banner principal y el widget de donación heredan automáticamente los colores de los botones y acentos de tu tema de campaña, asegurando que toda tu presentación se mantenga bellamente dentro de la marca sin tocar una línea de CSS.

Más información aquí.

Formulario de donación Función Nuevo

📝 Bloque de formulario de donación: Incrusta un formulario de donación funcional en cualquier lugar

Con el nuevo Bloque de formulario de donación para Charitable Pro, puedes colocar un formulario de donación completamente funcional directamente en cualquier página o publicación en el editor de bloques de WordPress. Sin redirecciones, sin recargas de página y sin fricción entre leer tu historia y hacer una contribución.

📝 Coloca formularios en cualquier lugar: Coloca un formulario funcional directamente en tu página de inicio, dentro de una publicación de blog basada en historias, en una página de destino dedicada o dentro de un anuncio de campaña.

🎯 Vinculación dinámica de campañas: Elige fácilmente una campaña específica desde la barra lateral del bloque o configúrala para que se vincule automáticamente a la campaña que se esté viendo actualmente.

📐 Vistas de formulario completas vs. mínimas: Cambia entre una vista de diseño completo o una vista mínima compacta para que encaje perfectamente en barras laterales, columnas estrechas o páginas de destino amplias.

🎨 Estilo sin código con ámbito: Personaliza la tipografía, el espaciado del contenedor, el radio del borde, los botones de cantidad y los colores de acento de forma independiente para cada instancia del formulario sin tocar una línea de CSS.

Más información aquí.

embajadores Nuevo

👤 Perfiles de creador: Ponga una cara a cada campaña P2P

Embajadores 3.3.0 ahora ofrece Perfiles de creador, dando a tus seguidores un hogar público permanente y compartible que convierte a los recaudadores de fondos puntuales en relaciones continuas.

👤 Páginas públicas de creador: Dale a cada recaudador de fondos una página de destino instantánea y limpia en /creator/their-name/ para mostrar su avatar personalizado, biografía y una cuadrícula navegable de sus campañas.

📊 Prueba de impacto: Aumenta la confianza de los donantes mostrando hitos en todo el sitio en el perfil, como la cantidad total de fondos recaudados y el número total de donantes.

💳 Tarjetas interactivas al pasar el ratón: Cuando los donantes pasen el ratón sobre el nombre de un creador en una página de campaña, una tarjeta compacta se expandirá con su biografía y perfiles sociales en el momento de la decisión.

📍 Compartir ubicación de forma responsable: Permite a los creadores mostrar de forma segura a los donantes locales dónde se encuentran utilizando solo detalles de ciudad, estado y país.

🛠️ Personalización autoservicio: Los recaudadores de fondos pueden actualizar sus propios perfiles y vincular hasta seis redes sociales directamente desde el centro Mis campañas, ahorrándote tiempo de administración.

¿Listo para empoderar a tus defensores? ¡Actualiza a Embajadores 3.3.0 y activa "Habilitar página pública de creador" hoy mismo!

Mejora Pagos

📱 Convierte a los que se desplazan en el móvil en donantes: Conoce la actualización Mollie de Charitable

¿Estás perdiendo seguidores móviles porque odian escribir números de tarjetas largos en sus teléfonos? La integración actualizada de Mollie de Charitable incluye:

⚡ Pago con billetera con un solo toque: Permite a los donantes completar sus donaciones al instante usando Apple Pay o Google Pay con un simple escaneo facial, huella digital o toque.

💰 Sin carga PCI adicional: Omite la compleja verificación de dominio y el cumplimiento de seguridad, ya que todas las transacciones de billetera se ejecutan de forma segura a través del pago alojado de Mollie.

🛠️ Enrutamiento de cancelación personalizado: Mantén la experiencia predecible enviando automáticamente a los donantes que se retiran a tu página de cancelación, o usa filtros de desarrollador para dirigirlos a una página personalizada.

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

embajadores mejorado Nuevo

Moderación y Pantallas de Directorio en Embajadores 3.0

Embajadores 3.0 tiene nuevas funcionalidades: pantallas de moderación y directorio… ahora puedes ver fácilmente quiénes están generando donaciones en tu red peer-to-peer – incluyendo a los creadores de campañas que podrían necesitar verificación – todo en un solo lugar. Genera informes, envía correos electrónicos directamente a embajadores y creadores de campañas, y más.

🚀 Ve cuándo los creadores de campañas y los embajadores han actualizado sus campañas, qué donantes/donaciones han aportado y más.

🎉 Añade manualmente embajadores y creadores de campañas, ¡y aprueba en un solo clic!

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