Documentación de Charitable

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

Panel de Propietario

Requiere: Charitable Pro 1.8.16+ Charitable Ambassadors 3.6.0+

Esta página trata sobre Embajadores Benéficos, el complemento que convierte una campaña Benéfica en una campaña de persona a persona, donde tus seguidores crean sus propias páginas de recaudación de fondos y recaudan dinero en tu nombre. El panel del propietario es nuevo en Embajadores 3.6.0 y no existe en ninguna versión anterior, por lo que si no puedes encontrar las pantallas a continuación, actualiza primero el complemento.

El panel del propietario es una página de solo lectura en el front-end de tu sitio. Alguien inicia sesión y ve una campaña y todo lo que recauda fondos debajo de ella: cuánto ha entrado, cuántas personas se han registrado, cuántas han recaudado algo y los regalos más recientes.

Es para las personas que administran una parte de tu programa que no son administradores de WordPress y no deberían tener que convertirse en uno.

Para dar acceso a alguien, consulta Organizadores.

Las palabras en esta página

Embajadores anida campañas unas dentro de otras, y este panel es un informe sobre una porción de ese nido. Cuatro palabras hacen la mayor parte del trabajo aquí, y todas ellas se cubren en detalle en Conceptos de Persona a Persona.

  • Campaña. El llamamiento para el que todos están recaudando fondos, y el tema de un panel. Alguien con acceso a varios cambia entre ellos.
  • Participante. La página de recaudación de fondos de una persona, anidada debajo de la campaña. Esto es lo que crea un seguidor cuando se registra para recaudar dinero, y lo que clasifican los Principales Participantes.
  • Grupo. Un nivel intermedio opcional entre los dos, ya sea una campaña anidada debajo de la principal o un equipo cuyos miembros tienen cada uno su propia página. Una escuela que ejecuta campaña > clase > alumno tiene grupos. Una maratón que ejecuta campaña > corredor no la tiene, y Principales Grupos permanece oculto en lugar de aparecer vacío.
  • Propietario. Quienquiera que tenga permiso para ver el panel de una campaña. Esta es una lista con nombre por campaña, no un rol de WordPress ni autoría, por lo que incluso la persona que creó la campaña no ve nada hasta que se agrega a ella. Gestionas esa lista en Organizadores.

Cuándo usarlo

  • Un profesor quiere los números de su clase sin los de toda la escuela.
  • Un capitán de equipo quiere ver cuáles de sus corredores aún no han comenzado.
  • Un líder de capítulo informa una cifra semanal hacia arriba y actualmente te la pide.
  • Un miembro de la junta quiere observar un llamamiento sin una cuenta de administrador.

Configuración

Crea una página, dale el título que quieras y pon esto en ella:

[charitable_owner_dashboard]

Una página sirve a todos. No creas una página por campaña o por persona. Cada visitante ve solo las campañas a las que se les ha dado acceso, en la misma página.

Una página que contiene el shortcode del panel del propietario

Publícala, luego otorga acceso a alguien desde Organizadores.

La página se excluye del almacenamiento en caché de páginas automáticamente, porque lo que muestra difiere según el visitante. Si utilizas un plugin de caché, no necesitas añadir una exclusión manualmente.

Lo que ve alguien que no ha iniciado sesión

Un mensaje corto pidiéndoles que inicien sesión, y nada más. Sin nombres de campaña, sin cifras.

Lo que ve alguien que no tiene acceso

Un mensaje que indica que esta cuenta no está configurada para gestionar una campaña, y que deben ponerse en contacto con su administrador del programa. De nuevo, sin cifras.

Esto es deliberadamente un mensaje simple en lugar de un 404 o un formulario de inicio de sesión. Ambos leen como un sitio roto y generan tickets de soporte.

Cambiar entre campañas

Alguien con acceso a más de una campaña obtiene un selector en la parte superior. La página se recarga mostrando la campaña que eligió.

Alguien con acceso a exactamente una campaña no ve un selector, porque no hay nada que elegir.

Los cuatro números

Las fichas Recaudado, Registrado, Activo y Donantes

Cada tarjeta tiene un icono de ayuda junto a su etiqueta con la misma explicación.

Mosaico Qué cuenta
Recaudado Cada donación completada a esta campaña y a las páginas debajo de ella, incluyendo las donaciones realizadas directamente en esta página, no solo en las páginas de los participantes.
Registrados Páginas de recaudación de fondos que existen debajo de esta campaña. Una página cuenta si ha recaudado algo o no todavía.
Activo Participantes con al menos una donación completada. La diferencia entre esto y Registrados son las páginas que existen pero que aún no han recaudado nada.
Donantes Personas distintas, contadas una vez cada una. Alguien que donó a tres participantes cuenta una vez aquí, por lo que este número es menor que la suma de las donaciones de los participantes.

Una quinta tarjeta, Días Restantes, aparece cuando la campaña tiene una fecha de finalización.

Solo cuentan las donaciones completadas. Se excluyen los pagos pendientes y fallidos, y también las donaciones en modo de prueba cuando tu sitio está configurado para excluirlas.

Los dos estados vacíos

  • Nadie se ha registrado todavía significa que no existen páginas de recaudación de fondos debajo de esta campaña en absoluto. Ese es un problema diferente al de personas que se registran y no recaudan, por lo que el panel indica cuál es.
  • Nada recaudado todavía significa que existen páginas pero no ha llegado ninguna donación completada.

Principales Participantes

Páginas individuales de recaudación de fondos debajo de esta campaña, clasificadas por dinero recaudado.

Principales Grupos

El nivel entre esta campaña y sus participantes, clasificado por dinero recaudado.

Esto solo aparece cuando tu campaña está organizada de esa manera. Necesita tres niveles: la campaña, un nivel intermedio, y luego los participantes. Una escuela con campaña > clase > alumno obtiene Principales Grupos. Una maratón con campaña > corredor no lo hace, porque no hay un nivel intermedio para clasificar, y la sección se oculta en lugar de mostrarse vacía.

El nivel intermedio puede ser cualquier tipo de agrupación que admita Embajadores: una campaña anidada bajo la principal, o un equipo cuyos miembros tengan su propia página de recaudación de fondos. Ambos se clasifican de la misma manera. La fila de un equipo totaliza cada donación a sus miembros, más cualquier donación realizada a la propia página del equipo.

Mirar dentro de una fila

Pasa el ratón por encima de un nombre en Principales Grupos o Principales Participantes, navega hasta él con el teclado o tócalo en un teléfono. Se abre un panel que muestra:

  • la cantidad recaudada
  • la fecha de la última donación
  • una tendencia de siete días
  • participación, para un grupo, o recuento de donantes, para un participante
El panel de detalles abierto en una fila de participante

Todo en el panel es de solo lectura. No hay nada que hacer clic dentro de él.

Encontrar quién no ha empezado

La diferencia entre Registrados y Activos son las personas que se inscribieron y no han recaudado nada. Ese número se puede hacer clic o tocar, y se expande en una lista que los nombra, cada uno enlazando a su página de recaudación.

La lista ampliada de participantes que no han recaudado nada

Se muestran los primeros 50 nombres. Las listas largas se desplazan dentro del panel.

Esta suele ser la utilidad más importante de la página: convierte un número en una lista de personas a las que alguien puede contactar realmente.

Donaciones Recientes

Las donaciones completadas más recientes en cualquier parte de esta campaña, incluidas las realizadas directamente a esta página.

Si los nombres de los donantes aparecen aquí se establece por campaña. Ver Configuración del panel abajo. Con los nombres desactivados, el panel solo muestra importes.

Más allá de tu campaña

Una tabla opcional que enumera cada campaña participante en el sitio y lo que ha recaudado. Nombres y totales, nada más: sin grupos, sin participantes, sin donantes.

La tabla Más allá de tu campaña que muestra otras campañas y sus totales

Está desactivado hasta que lo actives, por campaña. Una campaña se une solo cuando marcas la casilla en Configuración del panel de esa campaña. Hasta que al menos una campaña no haya optado por participar, la sección no aparece en absoluto.

Piensa en esto antes de activarlo. Cualquiera que pueda ver cualquier panel en tu sitio puede ver todas las campañas que han optado por participar. Si gestionas clientes o capítulos no relacionados en un mismo sitio y no deberían verse entre sí los totales, déjalo desactivado.

Configuración del panel en una campaña

Cada campaña tiene un cuadro de Configuración del panel en la barra lateral de su pantalla de edición.

El cuadro Configuración del panel en una pantalla de edición de campaña
Configuración Efecto
Mostrar nombres de donantes en el panel Desactivado muestra solo importes en Donaciones Recientes
Incluir en el marcador entre campañas Desactivado por defecto. Activado pone el nombre y el total de esta campaña delante de cualquiera que pueda ver cualquier panel en este sitio.

El cuadro también te indica si ninguna página tiene aún el shortcode del panel y enlaza a la pestaña Organizadores para conceder acceso. El acceso no se concede desde aquí.

La tarjeta en Mis Campañas

Alguien con acceso al panel y que visita Mis Campañas ve una tarjeta que enlaza a su panel, para que no tenga que enviarle la URL cada vez.

Encuentra la página buscando el shortcode. Si tienes más de una página candidata, o quieres que apunte a un lugar específico, un filtro establece la URL directamente. Consulta la referencia del desarrollador.

Consejos

  • Mira tú mismo el panel antes de entregarlo. Añádete como organizador en una campaña y abre la página.
  • Comprueba si tu campaña tiene un nivel intermedio antes de prometer Grupos Principales a nadie.
  • Decide sobre la tabla entre campañas antes de invitar a la gente, no después.
  • Si los números parecen incorrectos, comprueba si tu sitio está configurado para excluir donaciones en modo de prueba. El panel sigue esa configuración.

Referencia del desarrollador

Shortcode

[charitable_owner_dashboard]

Acepta un atributo opcional, campaign, que fija la página a un ID de campaña. Un visitante sin acceso a esa campaña solo ve la suya, por lo que el atributo limita en lugar de conceder.

Plantillas

Plantilla Renderiza
templates/dashboard/owner-dashboard.php El shell
templates/dashboard/partials/tiles.php Los mosaicos numéricos
templates/dashboard/partials/leaderboards.php Grupos principales y Participantes principales
templates/dashboard/partials/scoreboard.php Más allá de tu campaña
templates/dashboard/partials/state-notice.php Los dos estados vacíos

Anula cualquiera de ellos desde tu tema en:

your-theme/charitable/charitable-ambassadors/dashboard/owner-dashboard.php

La ruta base se puede filtrar con charitable_ambassadors_theme_template_path.

Meta de publicación

Clave Contiene
_charitable_ambassadors_dashboard_owners Matriz de IDs de usuario con acceso
_charitable_ambassadors_dashboard_show_donor_names 1 o 0
_charitable_ambassadors_dashboard_on_scoreboard 1 para aparecer en la tabla entre campañas
_charitable_ambassadors_dashboard_generation Contador de generación de caché, incrementado cuando cambian las donaciones o la actividad

Filtros

Filtro Propósito
charitable_ambassadors_owner_dashboard_url Devuelve una URL para anular el destino de la tarjeta Mis campañas
charitable_ambassadors_force_owner_dashboard_page Tratar una página específica como la página del panel
charitable_ambassadors_dashboard_owner_ids Los IDs de propietario resueltos. Recibe ( $ids, $campaign_id )
charitable_ambassadors_dashboard_label Cualquiera de los sustantivos del panel. Recibe ( $default, $key )
charitable_ambassadors_dashboard_label_<key> Un sustantivo específico. Claves: board, group, groups, participant, participants, section
charitable_ambassadors_dashboard_activity_key Qué valor de Actividad mostrar como ficha
charitable_ambassadors_dashboard_activity_tile_label La etiqueta de esa ficha
charitable_ambassadors_dashboard_generation_campaign_id La campaña cuyo contador de generación se incrementa

Caché

Las cargas útiles se almacenan en caché por ámbito en una cap_dash_ transitoria con clave del contador de generación de la campaña, por lo que una donación o entrada de actividad invalida la carga útil en lugar de esperar a un tiempo de espera. La tabla entre campañas se almacena en caché por separado durante cinco minutos.

La página se registra como dinámica a través del marco charitable_is_dynamic_page de Charitable Pro, que es lo que la mantiene fuera de las cachés de páginas.

Autorización

Charitable_Ambassadors_Scope es la puerta de enlace. Su constructor es privado y se construye a través de Scope::for_owner( $user_id, $campaign_id ), que devuelve null cuando ese usuario no posee esa campaña. Cada consulta que ejecuta el panel se limita a los ID de campaña que ese ámbito resolvió, por lo que no hay ninguna ruta que lea fuera de él.

El desglose de detalles de fila reautoriza en cada solicitud en lugar de confiar en la página que renderizó el enlace.

Punto final AJAX

charitable_ambassadors_dashboard_not_started devuelve la lista ampliada de participantes que no han recaudado. Solo para usuarios registrados, nonce charitable_ambassadors_dashboard_row_detail, y vuelve a resolver el ámbito del espectador desde la sesión en lugar de desde la solicitud.

Ejemplos de personalización

Llamar al nivel intermedio “Clases” en lugar de “Grupos”

add_filter( 'charitable_ambassadors_dashboard_label_groups', function () {
    return 'Classes';
} );

add_filter( 'charitable_ambassadors_dashboard_label_group', function () {
    return 'Class';
} );

Apuntar la tarjeta Mis Campañas a una página específica

add_filter( 'charitable_ambassadors_owner_dashboard_url', function () {
    return home_url( '/program-dashboard/' );
} );

Mostrar un valor de Actividad como una quinta ficha

add_filter( 'charitable_ambassadors_dashboard_activity_key', function () {
    return 'miles_run';
} );

add_filter( 'charitable_ambassadors_dashboard_activity_tile_label', function () {
    return 'Miles Run';
} );

Relacionado

  • Organizadores – concesión y eliminación de acceso
  • Mis Campañas – dónde aparece la tarjeta de puntero
  • Actividad – el módulo detrás de la quinta ficha opcional
  • Resumen – la vista del lado del administrador en todas las campañas

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