Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Gestionar un programa de recaudación de fondos entre pares significa estar al tanto de muchas personas. El Directorio es donde viven todas ellas.

Cada persona que ha enviado al menos un evento de recaudación de fondos aparece aquí. Desde una sola pantalla puedes ver quién está verificado, quién está más activo, quién se ha quedado callado y para qué causas está recaudando fondos cada embajador. Puedes verificar a alguien con un solo clic, enviarles un correo electrónico personal, añadir un embajador nuevo sin esperar una solicitud, o exportar toda la lista a una hoja de cálculo para tu CRM.

Si la Descripción general responde a "¿cómo va el programa en general?", el Directorio responde a "¿quiénes son las personas que lo dirigen?"

Cuándo usarlo

El Directorio es la pantalla a la que volverás una y otra vez durante la vida de tu programa. Aquí están las razones más comunes:

• Incorporación de nuevos embajadores: alguien acaba de registrarse. Busca su nombre, verifica su cuenta, envía el correo de bienvenida.
• Identificación de campeones: ordena por "Recaudado" descendente para encontrar a tus mejores colaboradores para reconocimiento personal.
• Reactivación de los inactivos: filtra por "Inactivo" y envía un recordatorio personal.
• Limpieza de primavera: elimina en bloque y anonimiza cuentas que nunca produjeron un evento de recaudación de fondos real.
• Alimentación de tu CRM: exporta filas seleccionadas o la lista completa como CSV.

Cómo llegar

Ve a Charitable » Embajadores » Directorio. La página se abre con todos los embajadores de tu sitio listados en orden de más nuevo a más activo. Los encabezados de columna para "Recaudado", "Donantes" y "Última actividad" se pueden hacer clic para ordenar la lista.

Las Cuatro Vistas de Lista

Una sub-navegación encima de la tabla divide la lista de embajadores en cuatro ámbitos, cada uno con su propia insignia de recuento para que puedas ver de un vistazo cuántas personas hay en cada grupo.

Vista	Quién está en ella
Todo	Todos los embajadores, independientemente de su estado. La vista predeterminada.
Verificado	Embajadores que has marcado explícitamente como verificados. La insignia también aparece en sus páginas públicas.
No verificados	Embajadores que aún no han sido verificados, que es el estado predeterminado para los nuevos registros.
Inactivos	Embajadores sin actividad de recaudación de fondos en la ventana de umbral (90 días por defecto). Útil para encontrar personas a las que reactivar.

Las Columnas

Cada fila de la lista muestra las mismas ocho columnas, dándote suficiente contexto para actuar sin tener que abrir cada perfil individualmente.

Columna	Lo que muestra
Casilla de verificación	Para seleccionar filas en bloque.
Nombre	Avatar (Gravatar real si está registrado, iniciales de colores en caso contrario), nombre para mostrar y correo electrónico.
Recaudadores	Cuántos eventos de recaudación de fondos han enviado, desglosados por estado (por ejemplo, "3 publicados, 1 pendiente").
Verificado	Una marca de verificación verde si están verificados, un guion en caso contrario.
Recaudado	Dólares recaudados de por vida en todos sus eventos de recaudación de fondos.
Donantes	Número de donantes únicos en todos sus eventos de recaudación de fondos.
Última actividad	Acción más reciente del embajador (envío, donación recibida, etc.).
Acciones	Botones en línea: Ver perfil, Correo electrónico, Ver como, y más.

Búsqueda y filtrado

El cuadro de búsqueda encima de la tabla realiza una búsqueda de texto simple en el nombre visible, el correo electrónico y el user_login. Debajo hay una fila de filtros que puedes apilar para encontrar exactamente el grupo que buscas.

Filtro	Lo que hace
Mezcla de estados	Filtra por "ha publicado campañas de recaudación", "tiene envíos pendientes" o "no tiene campañas de recaudación en absoluto". Útil para trabajos de limpieza.
Reclutados	Filtra por embajadores que se unieron a través de un enlace de invitación, o aquellos que se registraron por su cuenta.
Se unió de / a	Filtro de rango de fechas en la fecha de user_registered del usuario de WP.
Campaña principal	Mostrar solo embajadores que recaudaron fondos para una causa específica. Se rellena previamente cuando haces clic en la subvista de Reclutas de una campaña desde otro lugar.

Los filtros se apilan, por lo que puedes combinar Verificados, Reclutados y un rango de fechas de unión para encontrar exactamente la cohorte que necesitas. Por ejemplo, "todos los embajadores que se unieron a través de Invitaciones este año y ya han sido verificados".

Actuar sobre una fila

Cada fila tiene botones de acción en línea en la columna Acciones para que puedas realizar las tareas más comunes sin abrir primero un perfil.

Acción	Lo que hace
Perfil	Abre la página completa del perfil del embajador.
Verificar / Desverificar	Conmutador de un clic. La insignia aparece inmediatamente en sus páginas públicas.
Enviar correo electrónico	Abre un modal donde puedes escribir un correo electrónico único con sustitución de etiquetas inteligentes.
Correo de bienvenida	Reenvía el correo electrónico de bienvenida con un inicio de sesión automático de un solo uso mediante un enlace mágico.
Ver como	Inicio de sesión con un clic como ese usuario para que puedas ver lo que ellos ven en /my-campaigns/ o en cualquier página del front-end. Establece una cookie de retorno para que puedas volver a tu sesión de administrador.

El perfil completo del embajador

Haz clic en el nombre de un embajador o en el botón de acción Perfil para abrir su perfil completo. El perfil es un panel de varias pestañas para un solo embajador, lo que te da una visión mucho más profunda que la lista sola.

• Resumen: la tarjeta de un vistazo con lo recaudado de por vida, lo recaudado en lo que va de año, el número de donantes, el número de donaciones, el estado de verificación y el número de reclutas.
• Campañas: cada campaña de recaudación que esta persona ha enviado, con estado, recaudado y objetivo.
• Donaciones: cada donación recibida en todas sus campañas de recaudación, con fecha, donante, importe y la campaña específica a la que se destinó.
• Datos del formulario: lo que rellenaron en el formulario de envío (nombre, ubicación, biografía, etc.), útil cuando necesitas comprobar un detalle sin tener que preguntarles.

Dos pestañas más, Registros y Notas, se incluirán en una versión futura. Los parciales ya están en disco y se pueden habilitar a través del filtro charitable_ambassadors_directory_profile_tabs. Consulta Pestañas del perfil del directorio para un recorrido completo de cada pestaña.

Acciones masivas

Marca las casillas de varias filas y elige una Acción Masiva en el desplegable encima de la tabla para actuar sobre todas a la vez. Las acciones masivas están limitadas a 50 filas por llamada por defecto para mantener la rapidez, así que para trabajos más grandes trabaja por lotes.

Acción	Úsalo cuando
Verificar / Desverificar	Inscribas a un grupo conocido de embajadores a la vez.
Reenviar correo de bienvenida	Unos pocos embajadores no recibieron el correo original, lo cual es común después de cambiar de proveedor SMTP.
Exportar seleccionados a CSV	Alimenta tu CRM, crea un informe personalizado o entrega una lista a un equipo de marketing.
Eliminar y Anonimizar	Eliminación de cuenta al estilo GDPR. Reemplaza los campos de identificación del usuario con datos anonimizados para que las donaciones históricas sigan siendo atribuibles pero su información personal desaparezca.

Añadir un embajador manualmente

A veces querrás añadir un embajador sin esperar a que envíe una recaudación de fondos: migrando desde otra plataforma, cumpliendo una solicitud personal de un donante importante que quiere recaudar fondos, o configurando una cuenta de prueba. Haz clic en Añadir Embajador en la parte superior derecha de la página.

El formulario tiene los mismos campos que el formulario de envío público. Guarda, y se crea una cuenta. Marca Enviar correo de bienvenida para enviar el mismo mensaje de bienvenida que recibe un registro automático, incluido un enlace mágico que les inicia sesión directamente en /my-campaigns/ para que no tengan que establecer una contraseña primero.

Exportación

El botón Exportar CSV en la parte superior de la página exporta la vista filtrada actualmente, cualesquiera filas a las que hayas reducido con cualquier orden de clasificación que esté activo. Si has filtrado a "todos los embajadores no verificados que se unieron este trimestre", eso es exactamente lo que se exporta. Para un desglose completo de lo que hay en cada columna, consulta Exportaciones CSV.

Eliminar y anonimizar

Hay dos formas de eliminar a un embajador de tu programa, dependiendo de si necesitas conservar los datos históricos o borrarlos por completo.

Ruta	Qué sucede
Anonimizar (recomendado, compatible con GDPR)	El inicio de sesión del usuario, el correo electrónico, el nombre de visualización, el nombre y apellidos, y los metadatos de PII conocidos se reemplazan con valores anonimizados. Sus recaudaciones de fondos e historial de donaciones permanecen intactos, pero la persona ya no es identificable.
Eliminación permanente	Se elimina el usuario de WP. Sus recaudaciones de fondos se reasignan a un usuario centinela llamado "Embajador Anónimo" para que las donaciones históricas no pierdan su registro principal.

Ambos caminos pasan por Charitable_Ambassadors_Directory_Delete. El nombre y correo electrónico del usuario centinela se pueden personalizar a través de los filtros charitable_ambassadors_directory_sentinel_email y charitable_ambassadors_directory_sentinel_display_name.

Consejos que vale la pena tener en cuenta

Algunos hábitos que hacen que la gestión del Directorio sea mucho más fluida una vez que tu programa está en marcha.

• Realiza una pasada de limpieza mensual. Filtra por Inactivos con cero recaudaciones de fondos, luego elimina y anonimiza masivamente. Mantiene la lista precisa y tus datos ordenados.
• Consider the Verified badge as something that means something. No verifiques automáticamente cada registro. Reserva la insignia para embajadores que hayas verificado realmente: persona real, causa real, intención real de recaudar fondos. Tiene más peso cuando se usa con cuidado.
• Usa Ver como antes de responder a las solicitudes de soporte. Cuando un embajador informa de una pantalla confusa, haz clic en Ver como para ver exactamente lo que está viendo. Supera cinco minutos de idas y venidas de "¿qué muestra tu pantalla?" cada vez.
• Si las estadísticas parecen desactualizadas, recalcularlas. La acción Recalcular estadísticas en el menú de la fila vuelve a ejecutar los agregados de por vida para un solo usuario. También hay un botón de recalcular para todo el sitio en la página de herramientas. Ambos son útiles después de una importación masiva de donaciones.

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan el Directorio.

Almacenamiento

Las filas de embajadores son usuarios estándar de WordPress. El Directorio no añade tablas personalizadas. El criterio "es un embajador" es "tiene al menos una recaudación de fondos publicada, O tiene la marca de metadatos de usuario _charitable_ambassadors_directory_added_manually establecida por el formulario Añadir."

Las estadísticas por usuario (recaudado de por vida, número de donantes, última actividad) se calculan sobre la marcha a partir de las tablas de donaciones y campañas, con los resultados almacenados en caché brevemente por solicitud.

Indicador de Verificación

user_meta key: _charitable_ambassadors_verified
value:        '1' = verified, '' (empty) = not verified

Constante: Charitable_Ambassadors_Directory_Data::VERIFIED_META.

Filtros

Filtro	Predeterminado	Propósito
columnas_directorio_embajadores_benéficos	matriz de 8 columnas	Añadir o quitar columnas de la tabla de lista.
acciones_masivas_directorio_embajadores_benéficos	matriz de 5 acciones	Añadir o quitar acciones masivas del desplegable.
acciones_fila_directorio_embajadores_benéficos	matriz de metadatos de fila	Modificar los enlaces de acción de fila en línea. Recibe $row_meta, $user_id.
botones_acción_directorio_embajadores_benéficos	matriz de botones de acción	Modificar los botones de la columna Acciones. Recibe $buttons, $user_id.
argumentos_consulta_usuario_directorio_embajadores_benéficos	calculado	Modificar los argumentos de WP_User_Query antes de que se ejecute la lista. Útil para excluir roles específicos.
pestañas_perfil_directorio_embajadores_benéficos	matriz de 4 pestañas	Añadir o quitar pestañas de perfil. Los parciales de Registros y Notas existen pero no están habilitados por defecto.
campos_adicionales_datos_formulario_directorio_embajadores_benéficos	[]	Añadir campos adicionales a la pestaña de perfil Datos del formulario. Recibe [], $user_id.
capacidad_fila_masiva_directorio_embajadores_benéficos	50	Máximo de filas por llamada de acción masiva.
días_umbral_inactividad_directorio_embajadores_benéficos	90	Días de inactividad antes de que un usuario aparezca en la vista Inactivos.
título_bienvenida_directorio_embajadores_benéficos	24 * SEGUNDOS_EN_HORA	Duración del enlace mágico para el inicio de sesión automático del correo de bienvenida.
correo_centinela_directorio_embajadores_benéficos	anónimo@…	Correo electrónico centinela utilizado cuando una eliminación forzada reasigna las recaudaciones de fondos de un usuario eliminado.
nombre_a_mostrar_centinela_directorio_embajadores_benéficos	Embajador Anónimo	Nombre de visualización centinela.
anonimizar_nombre_a_mostrar_directorio_embajadores_benéficos	Embajador Anónimo	Nombre de visualización que recibe un usuario anonimizado.
patrón_correo_anonimizar_directorio_embajadores_benéficos	anonymous-%[email protected]	Patrón de correo electrónico (sprintf con ID de usuario) para usuarios anonimizados.
claves_meta_anonimizar_directorio_embajadores_benéficos	matriz de claves PII	Claves de meta de usuario borradas al anonimizar.
charitable_ambassadors_directory_csv_max_rows	10000	Límite de filas de exportación CSV.
charitable_ambassadors_directory_csv_cell	''	Proporciona un valor personalizado para una clave de columna desconocida durante la exportación CSV. Recibe ('', $col, $user).
etiquetas_inteligentes_enviar_correo_directorio_embajadores_benéficos	matriz de etiquetas	Añade sustituciones de etiquetas inteligentes al modal Enviar correo electrónico.
máximo_por_hora_enviar_correo_directorio_embajadores_benéficos	100	Límite de Envío de Correo por moderador por hora.
añadir_campos_directorio_embajadores_benéficos	calculado	Modificar los campos que se muestran en el formulario Añadir Embajador.

Acciones

Acción	Argumentos	Se dispara cuando
verificación_cambiada_directorio_embajadores_benéficos	$id_usuario, $es_verificado, $id_moderador	Una llamada de verificar o desverificar se confirma.
correo_enviado_directorio_embajadores_benéficos	$id_usuario, $asunto, $cuerpo, $id_moderador	Se envía un modal de Enviar correo electrónico.
embajador_añadido_directorio_embajadores_benéficos	$id_usuario, $datos_publicación	Se envía el formulario Añadir embajador.
antes_de_anonimizar_directorio_embajadores_benéficos	$user_id	Justo antes de que se ejecute la anonimización.
después_de_anonimizar_directorio_embajadores_benéficos	$user_id	Justo después de que se complete la anonimización.
directorio_embajadores_caritativos_antes_eliminacion_definitiva	$user_id	Justo antes de que se ejecute la eliminación permanente.
directorio_embajadores_caritativos_despues_eliminacion_definitiva	$user_id, $sentinel_id	Después de la eliminación permanente y la reasignación de publicaciones.

Endpoints AJAX

Todo en wp_ajax_ solamente, acción nonce charitable_ambassadors_directory, capacidad manage_charitable_settings:

Acción	Propósito
directorio_embajadores_caritativos_verificar_conmutador	Cambia el indicador de verificado de un usuario.
directorio_embajadores_caritativos_enviar_bienvenida	Reenvía el correo de bienvenida con un enlace mágico nuevo.
directorio_embajadores_caritativos_enviar_correo	Envía un correo electrónico único con sustitución de etiquetas inteligentes.
directorio_embajadores_caritativos_recalcular_estadisticas	Vuelve a ejecutar los agregados de por vida para un solo usuario.

Controladores de POST de formularios

URL	Propósito
admin-post.php?action=charitable_ambassadors_directory_bulk	Controlador de acciones masivas.
admin-post.php?action=charitable_ambassadors_directory_add_submit	Envío del formulario Añadir embajador.
admin-post.php?action=charitable_ambassadors_directory_manual_recalc	Botón de recalcular estadísticas en todo el sitio.

Inicio de sesión automático con Magic-Link

El correo electrónico de bienvenida contiene un enlace mágico de un solo uso que se consume en la prioridad init 5 a través de Charitable_Ambassadors_Directory::maybe_consume_magic_link(). La duración predeterminada es de 24 horas, se puede filtrar a través de charitable_ambassadors_directory_welcome_ttl.

Ver como

La acción Ver como cierra la sesión del moderador y la inicia como el usuario de destino, con una cookie de retorno que les permite volver a su sesión original con un solo clic. Impulsado por el plugin User Switching cuando está instalado. El Directorio conecta el botón Ver como a su ayudante switch_to_user_url().

Capacidades

Se requiere manage_charitable_settings para todas las operaciones administrativas y se otorga a los administradores por defecto.

Ejemplos de personalización

Añadir una columna "Teléfono" a la lista del Directorio:

add_filter( 'charitable_ambassadors_directory_list_columns', function ( $cols ) {
    $cols['phone'] = __( 'Phone', 'your-textdomain' );
    return $cols;
} );

Reducir el umbral de inactividad a 30 días:

add_filter( 'charitable_ambassadors_directory_inactive_threshold_days', function () {
    return 30;
} );

Reactivar las pestañas de registro y notas del perfil:

add_filter( 'charitable_ambassadors_directory_profile_tabs', function ( $tabs, $user_id ) {
    $tabs['logs']  = [ 'label' => 'Logs',  'count' => null ];
    $tabs['notes'] = [ 'label' => 'Notes', 'count' => null ];
    return $tabs;
}, 10, 2 );

Enviar una webhook a tu CRM cada vez que se verifique un embajador:

add_action( 'charitable_ambassadors_directory_verification_changed', function ( $user_id, $is_verified, $moderator_id ) {
    if ( ! $is_verified ) {
        return;
    }
    wp_remote_post( 'https://crm.example.com/hook', [
        'body' => [
            'user_id'      => $user_id,
            'verified_at'  => time(),
            'verified_by'  => $moderator_id,
        ],
    ] );
}, 10, 3 );

Extender la duración del enlace mágico del correo de bienvenida a 7 días:

add_filter( 'charitable_ambassadors_directory_welcome_ttl', function () {
    return 7 * DAY_IN_SECONDS;
} );

Conclusión

Eso cubre todo lo que el Directorio puede hacer por ti. Ya sea que estés incorporando un nuevo grupo de embajadores, buscando a alguien que necesite un empujón, preparando una exportación de CRM o realizando una limpieza trimestral, el Directorio es tu pantalla de referencia para gestionar a las personas de tu programa.

Si tienes preguntas o encuentras algo que no se cubre aquí, nuestro equipo de soporte estará encantado de ayudarte.

También te Puede Interesar Leer

Estos son los documentos de Embajadores más estrechamente relacionados con el Directorio. Marca como favoritos los que sean relevantes para la gestión de tu programa.

• Pestañas del Perfil del Directorio: un análisis en profundidad de las cuatro pestañas dentro de la página de perfil de cada embajador.
• Exportaciones CSV: el diccionario completo de columnas para cada punto de exportación, incluida la exportación de la lista del Directorio.
• Invitaciones: comprende qué embajadores llegaron a través de qué enlace de invitación.
• Panel de Resumen: el widget de Mejores Embajadores utiliza los mismos datos subyacentes.
• Hooks y filtros en Embajadores – la referencia completa para desarrolladores.