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.

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

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

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.

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.

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.

| 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





