Documentación de Charitable

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

Selector de Campañas

La función Selector de Campañas permite a los donantes elegir directamente desde cualquier formulario de donación a qué campaña se destinará su donación, creando una experiencia de donación multicanal fluida sin necesidad de navegar por páginas.

Tabla de Contenidos

Empezar

El Selector de Campañas transforma tus formularios de donación añadiendo un desplegable inteligente que permite a los donantes cambiar sin problemas entre campañas activas. Cuando un donante selecciona una campaña diferente, el formulario se actualiza dinámicamente a través de AJAX para mostrar los importes de donación, los campos del formulario y los mensajes específicos de la campaña apropiados.

Beneficios clave

  • Mejor experiencia para el donante: No es necesario navegar entre páginas de campañas.
  • Mayores tasas de conversión: Reduce la fricción en el proceso de donación.
  • Gestión inteligente de campañas: Excluye automáticamente las campañas finalizadas o completamente financiadas.
  • Experiencia personalizada: Recuerda la última selección de campaña del donante.
  • Compatibilidad universal: Diseñado para funcionar con todos los tipos de formularios y pasarelas de pago.

Requisitos

  • Charitable Pro: Versión 1.8.12 o superior
  • WordPress: Versión 6.2 o superior
  • PHP: Versión 7.4 o superior
  • Múltiples campañas activas: Al menos 2 campañas para que aparezca el selector

Habilitar el Selector de Campañas

  1. En Charitable Pro: Navega a Ajustes de Charitable → General → Formulario de Donación en tu administrador de WordPress
  2. Desplázate hasta la sección Selector de Campañas
  3. Marca Habilitar Selector de Campañas para activar la función
  4. Configura tus preferencias usando las opciones de abajo
  5. Haz clic en Guardar Cambios

Opciones de configuración

Ajustes Básicos

Etiqueta del Desplegable

  • Por defecto: “Elige una Campaña”
  • Propósito: Texto que se muestra encima del desplegable del selector de campañas
  • Ejemplo: “Selecciona la causa que te gustaría apoyar”

Texto de la Ayuda Emergente

  • Propósito: Texto de ayuda que se muestra cuando los donantes pasan el ratón por encima del icono de información
  • Ejemplo: “Elige qué campaña debe recibir tu donación”
  • Nota: Deja en blanco para ocultar el icono de ayuda emergente

Control de Visualización

Mostrar Selector de Campañas En

Elige dónde debe aparecer el selector de campañas:

  • Todas las Campañas (Por defecto): Muestra el selector en el formulario de donación de cada campaña
  • Solo Campañas Seleccionadas: Limita la visualización a campañas específicas

Campañas Seleccionadas para Visualización

Cuando se elige "Solo Campañas Seleccionadas": – Selecciona qué campañas deben mostrar el selector de campañas – Usa Ctrl/Cmd+Click para seleccionar varias campañas – Solo los donantes que vean estas campañas verán el selector

Nota: Campañas de Embajador

El Selector de Campañas puede no funcionar como se espera con las campañas de Embajador. El soporte nativo para campañas de Embajador está en la hoja de ruta para esta función.

Contenido del Desplegable

Origen del Desplegable

Controla qué campañas aparecen en el desplegable:

  • Todas las Campañas Activas (Predeterminado): Incluye automáticamente todas las campañas elegibles
  • Solo Campañas Seleccionadas: Elige manualmente qué campañas incluir

Campañas Seleccionadas para el Desplegable

Cuando se elige "Solo Campañas Seleccionadas": – Selecciona manualmente las campañas a incluir en el desplegable – Permite la selección curada de campañas – Útil para destacar campañas o causas específicas

Opciones de Organización

Agrupar por Categoría

  • Propósito: Organiza las campañas por sus categorías asignadas en el desplegable
  • Beneficio: Ayuda a los donantes a navegar por un gran número de campañas

Excluir Tipos de Campaña

Ajusta qué campañas aparecen excluyendo:

  • Campañas Finalizadas: Campañas cuya fecha de finalización ha pasado
  • Campañas Completamente Financiadas: Campañas que han alcanzado su objetivo

Memoria y Persistencia

Recordar Selección de Campaña

Controla cómo el selector recuerda las preferencias del donante:

  • Recordar por 7 Días (Predeterminado): Almacena la selección en el navegador durante una semana
  • Recordar por Esta Sesión: Almacena la selección hasta que se cierre el navegador/pestaña
  • No Recordar: Muestra siempre la selección predeterminada

Funciones avanzadas

Carga de Formularios AJAX

El Selector de Campañas utiliza tecnología AJAX para proporcionar un cambio de formulario sin interrupciones:

  • Actualizaciones Instantáneas: Los formularios se cargan sin recargar la página
  • Indicadores de Carga: Retroalimentación visual durante las transiciones de formulario
  • Compatibilidad con pasarelas de pago: Reinicializa automáticamente Stripe, PayPal y otras pasarelas
  • Preservación del estado del formulario: Mantiene la información del donante siempre que sea posible

Filtrado inteligente de campañas

La función filtra automáticamente las campañas según criterios inteligentes:

  • Excluye campañas P2P: Se ocultan las campañas de embajadores y entre pares
  • Filtrado por fecha: Respeta las fechas de inicio y fin de la campaña
  • Filtrado por objetivo: Puede excluir campañas con financiación completa
  • Comprobaciones de estado: Solo incluye campañas publicadas y activas

Comportamiento contextual

El selector adapta su comportamiento según el contexto:

  • Páginas específicas de campaña: Respeta el contexto de la campaña actual
  • Formularios incrustados: Funciona perfectamente con shortcodes y widgets
  • Formularios modales: Compatible con formularios de donación emergentes o superpuestos
  • Formularios de varios pasos: Mantiene la selección de campaña durante todo el proceso

Ejemplos de Implementación

Implementación básica

El selector de campañas aparece automáticamente cuando:

1. La función está habilitada en la configuración
2. Existen varias campañas elegibles
3. La página/formulario actual cumple los criterios de visualización

Personalización de la plantilla

Puedes sobrescribir la plantilla predeterminada copiando /wp-content/plugins/charitable-pro/templates/donation-form/campaign-selector.php al directorio /charitable/donation-form/ de tu tema activo.

Funciones útiles

// Check if campaign selector should display
if ( charitable_get_option( 'campaign_selector_enabled' ) ) {
    // Custom logic here
}

// Get campaigns that appear in selector
$campaigns = charitable_get_campaign_selector_campaigns();

// Check if current campaign/page should show selector
$should_display = charitable_campaign_selector_should_display( $campaign_id );

Solución de problemas

El selector de campañas no aparece

Posibles causas: 

– La función no está habilitada en la configuración

– Solo hay una campaña disponible

– La campaña actual está excluida en la configuración de visualización –

Todas las campañas finalizadas o con financiación completa

Soluciones: 

1. Verifica que la función esté habilitada en la configuración.

2. Asegúrate de que existan al menos 2 campañas elegibles

3. Comprueba la configuración de visualización de la campaña actual

4. Revisa la configuración de exclusión de campañas

Problemas de carga AJAX

Síntomas: 

– Los formularios no se actualizan al seleccionar campañas

– Errores de JavaScript en la consola del navegador

– El indicador de carga no desaparece

Soluciones: 

1. Borrar cachés del navegador y de plugins

2. Desactivar temporalmente plugins de JavaScript conflictivos

3. Comprobar si hay problemas de compatibilidad con el tema

4. Verificar que las versiones de WordPress y de los plugins cumplen los requisitos

Problemas con la pasarela de pago

Síntomas: 

– Los botones de pago no funcionan tras cambiar de campaña

– Errores de Stripe/PayPal tras la actualización del formulario

Soluciones: 

1. Asegurarse de que las pasarelas de pago están configuradas correctamente

2. Comprobar la compatibilidad de la pasarela con la carga AJAX

3. Borrar cachés de la pasarela de pago

4. Cambiar a un formulario de donación no modal con la opción de selector desactivada para ver si el problema persiste.

5. Contactar con soporte para problemas específicos de la pasarela

Consideraciones de rendimiento

Para sitios con muchas campañas: 

– Considerar el uso de "Solo campañas seleccionadas" para la fuente del desplegable

– Habilitar la agrupación por categorías para una mejor organización

– Monitorizar los tiempos de carga de la página con listas de campañas grandes

– Considerar soluciones de caché para sitios con mucho tráfico

Recursos para desarrolladores

Ganchos y filtros

// Filter available campaigns for selector
add_filter( 'charitable_campaign_selector_campaigns', 'custom_filter_campaigns' );

// Modify selector display conditions
add_filter( 'charitable_campaign_selector_should_display', 'custom_display_logic', 10, 2 );

// Customize AJAX response data
add_filter( 'charitable_campaign_selector_ajax_response', 'custom_ajax_data' );

Personalización CSS

Utilizar estas clases para estilos personalizados:

/* Main container */
.charitable-campaign-selector {}

/* Dropdown styling */
.charitable-campaign-selector select {}

/* Loading state */
.charitable-campaign-selector.loading {}

/* Tooltip styling */
.charitable-campaign-selector-tooltip {}

Para obtener ayuda adicional con la función Campaign Selector, visita nuestra documentación de soporte o contacta con nuestro equipo.

¿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 Recaudadores sin Contraseña: ¡Regístrate solo con tu correo electrónico!

Los seguidores llegan queriendo ayudar, y luego el formulario les pide que inventen una contraseña para un sitio web que quizás solo visiten dos veces. Muchos de ellos se detienen ahí mismo. Las cuentas de recaudación de fondos sin contraseña, nuevas en Charitable Ambassadors 3.5.0, permiten a un seguidor iniciar una recaudación de fondos de persona a persona con solo una dirección de correo electrónico. Por qué esto es importante:

  • 🔑 Sin paso de contraseña para perderlos: Actívalo en Charitable » Ambassadors » Templates » Submit Form y el formulario de creación de recaudación de fondos solo pide un nombre, una dirección de correo electrónico y un título de página.
  • 👤 Sigue siendo una cuenta real de WordPress: Un clic en un correo electrónico confirma la dirección, los inicia y crea la cuenta, para que puedan volver más tarde a editar su historia, cambiar su foto y ver quién ha donado.
  • 🎚️ Tu decisión en cada campaña: Cada campaña de persona a persona puede seguir la configuración predeterminada del sitio o anularla, lo que importa cuando una campaña paga a los recaudadores de fondos a través de Stripe Connect y esas personas necesitan una contraseña.
  • 📋 Ver quién no ha hecho clic todavía: La pestaña Charitable » Ambassadors » Directory » Awaiting Sign-In enumera a todos los que aún esperan, con la campaña a la que se unieron y un botón de Reenviar, para que un error tipográfico o una carpeta de spam sea algo que puedas detectar y corregir.
  • 🛡️ Enlaces que un escáner no puede agotar: Abrir el enlace solo muestra una página, y tu recaudador de fondos inicia sesión cuando presiona el botón en él, por lo que los escáneres de correo electrónico corporativos nunca queman el enlace. Cada uno funciona una vez, expira por sí solo y se almacena solo como un hash.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🏃 ¡Presentamos Actividad: Muestra el progreso en más que solo dinero!

La mayoría de las recaudaciones de fondos entre pares se centran en más que el dinero. Una maratón de lectura se basa en los minutos leídos, una caminata en las millas recorridas y una colecta de alimentos en las comidas preparadas. La Actividad para Embajadores Benéficos permite que tus recaudadores de fondos muestren ese esfuerzo junto a los dólares que recaudan. Por qué esto es importante:

  • 🎯 Progreso en lo que realmente cuentas: Una barra de progreso muestra cada cosa que cuentas contra su propio objetivo, justo al lado del dinero recaudado.
  • 🏅 Hitos para las cosas de sí o no: Una insignia de hito marca los esfuerzos que simplemente están hechos o no hechos, sin un número que perseguir.
  • ✍️ Los recaudadores registran sus propios números: Tus donantes introducen sus totales desde sus propias páginas, para que el esfuerzo deje de vivir en una hoja de cálculo, un comentario o en ningún sitio.
  • 🤖 Algunos números se cuentan solos: Una etiqueta AUTOMÁTICA aparece donde el sitio ha calculado la cifra a partir de donaciones completadas, para que puedas ver de un vistazo lo que nadie ha escrito.
  • 🧩 Configúralo una vez, úsalo en cualquier lugar: Tú decides qué se cuenta una vez, luego eliges qué campañas lo cuentan. Disponible ahora en Embajadores Benéficos 3.4.7, sin complementos nuevos y sin desarrollador.

Consulta nuestro anuncio aquí.

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