Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Cuando los embajadores envían recaudaciones de fondos en tu sitio, necesitas una forma de revisarlas antes de que se publiquen: comprueba que el título tenga sentido, que el objetivo sea razonable y que la imagen no esté fuera de marca.

La pestaña Moderación es el único lugar donde haces eso. Cada envío de recaudación de fondos fluye a través de una cola con cuatro vistas claras (Pendiente, Acción Requerida, Rechazado, Aprobado) y tres acciones que puedes tomar en cada una (Aprobar, Rechazar, Solicitar Cambios).

Es deliberadamente rápido. Puedes aprobar una fila en dos clics, rechazar con un motivo escrito en tres, o trabajar en veinte a la vez usando acciones masivas.

Y si cambias de opinión justo después de aprobar, tienes una ventana de 30 segundos para deshacerlo antes de que se envíe el correo electrónico del embajador.

Cuándo usarlo

• Revisión diaria de la cola – abre Moderación a primera hora, echa un vistazo al recuento de Pendientes y despeja el trabajo pendiente antes de que crezca.
• Después de un impulso de reclutamiento – llega una avalancha de nuevos envíos porque un embajador compartió su enlace de invitación. Aprueba masivamente los que parezcan limpios.
• Revisión de seguridad de marca – el título o la imagen de un envío no encajan con tu causa. Solicita cambios con una nota explicando qué arreglar.
• Control de spam – los envíos obvios de spam se rechazan directamente.

Dónde Encontrar la Moderación de Embajadores

En tu panel de administración de WordPress, ve a Charitable » Embajadores » Moderación

El número en la etiqueta de la pestaña (por ejemplo, Moderación 7) es el recuento de recaudaciones de fondos que actualmente esperan una decisión. Se actualiza a medida que trabajas en la cola, por lo que cuando llega a cero sabes que estás al día.

Aprobación Manual vs. Automática

La moderación solo importa si estás ejecutando la aprobación manual. Esa es la configuración predeterminada para instalaciones nuevas, pero es una sola opción que puedes cambiar:

Administrador de WordPress > Charitable > Embajadores > General > Aprobar Campañas Automáticamente

Configuración	Qué sucede	¿Quién lo usa?
DESACTIVADO (predeterminado)	Cada envío aterriza en Pendiente. Tú decides si se publica.	La mayoría de las organizaciones sin fines de lucro, especialmente cuando ejecutan recaudaciones de fondos bajo una marca o para una causa que es importante presentar con cuidado.
ACTIVADO	Los envíos se publican inmediatamente. La cola de Moderación todavía funciona para la revisión posterior y el registro de auditoría todavía registra quién hizo qué, pero no estás bloqueando la puerta principal.	Programas que priorizan la velocidad y confían en sus embajadores, o utilizan una herramienta de moderación comunitaria separada.

Puedes cambiar de modo en cualquier momento sin perder el historial.

Las Cuatro Vistas

Una sub-navegación en la parte superior de la pestaña Moderación divide la cola en cuatro listas:

Vista	Qué contiene	Acción típica
Pendiente	Envíos nuevos esperando tu primera decisión.	Aprobar, rechazar o solicitar cambios.
Acción requerida	Recaudaciones de fondos sobre las que solicitaste revisiones. Permanecen en borrador hasta que el embajador actualice y vuelva a enviar.	Revisar de nuevo una vez que el embajador vuelva a enviar.
Rechazado	Envíos que rechazaste. Permanecen aquí como registro de auditoría.	Normalmente nada, son históricos. Puedes anular el rechazo aprobando desde esta vista.
Aprobado	Todo lo que está actualmente en vivo.	Solo vista. Usa Deshacer aprobación dentro de los 30 segundos posteriores a la aprobación; después de eso, edita la recaudación de fondos directamente.

Cada vista tiene su propia insignia de recuento para que puedas ver de un vistazo dónde se encuentra el trabajo.

Aprobación de una única recaudación de fondos

El flujo de aprobación predeterminado son dos clics: pasa el ratón sobre la fila, haz clic en Aprobar, listo. La recaudación de fondos se publica, el registro de auditoría registra quién la aprobó y cuándo, y se envía un correo electrónico al embajador para informarle.

Si deseas aprobar sin enviar el correo electrónico (raro pero útil para importaciones de migración o recaudaciones de fondos de prueba), desmarca la casilla “Notificar al embajador” que aparece en la confirmación de aprobación. O establece el valor predeterminado global con un filtro (consulta la referencia del desarrollador a continuación).

Rechazo de una recaudación de fondos

Haz clic en Rechazar en la fila. Se abre una ventana modal solicitando un motivo:

El motivo es obligatorio, incluso una nota corta como “El título no coincide con las directrices de nuestra marca” le da al embajador algo en lo que actuar. Después de enviar, suceden tres cosas:

1. La recaudación de fondos pasa a un estado personalizado charitable-rejected (para que sea claramente distinguible de los borradores y las publicaciones eliminadas).
2. El motivo se almacena en la recaudación de fondos para que cualquier moderador pueda verlo más tarde.
3. El embajador recibe el correo electrónico Creator Campaign Rejected con tu motivo citado en el cuerpo.

La recaudación de fondos desaparece de Pendiente y aparece en Rechazado.

Solicitar cambios

Usa Solicitar cambios cuando una recaudación de fondos esté *casi* lista, necesite un ajuste, pero no esté completamente mal. Haz clic en la acción y se abrirá una ventana modal similar pidiendo orientación:

La recaudación de fondos vuelve al estado de borrador. El embajador recibe el correo electrónico Creator Campaign Needs Revision con tus notas, edita la recaudación de fondos y la vuelve a enviar. Cuando la vuelve a enviar, aterriza de nuevo en Pendiente con el registro de cambios conservado.

Este es el camino más amable para una recaudación de fondos que está cerca de ser buena. Úsalo en lugar del rechazo siempre que prefieras que el embajador lo arregle en lugar de empezar de nuevo.

Acciones masivas

Cuando la cola esté ocupada, puedes hacer varias a la vez. Marca las casillas de las filas sobre las que deseas actuar, elige una acción del menú desplegable Acciones masivas encima de la tabla y aplica:

• Aprobar masivamente las publica todas a la vez, enviando el correo electrónico de aprobación a cada embajador.
• Rechazar masivamente abre una única ventana modal de rechazo donde el motivo que ingreses se aplica a cada fila seleccionada.
• Solicitar cambios masivamente hace lo mismo para las solicitudes de cambios.

Una acción masiva muestra un único aviso de confirmación en la parte superior de la página cuando se completa (“3 recaudaciones de fondos aprobadas”). El registro de auditoría todavía registra cada decisión individualmente.

Deshacer en 30 segundos

Justo después de aprobar una recaudación de fondos, aparece una pequeña pastilla "Deshacer" junto a la fila durante 30 segundos:

Haz clic en ella y la aprobación se revierte: la recaudación de fondos vuelve a "Pendiente", el registro de auditoría registra una entrada de "undo_approve" y el correo electrónico de aprobación no se envía (deliberadamente no enviamos el correo electrónico hasta que haya pasado la ventana de deshacer para las aprobaciones en línea, por lo que al deshacer dentro de la ventana, el embajador nunca sabrá que casi lo apruebas).

Después de 30 segundos, la pastilla desaparece. A partir de entonces, la única forma de volver atrás es anular la publicación manual de la recaudación de fondos a través del editor de WordPress estándar.

El Deshacer es por acción, no por fila. Si apruebas cinco recaudaciones de fondos seguidas, obtienes cinco pastillas de Deshacer separadas, cada una independiente.

El Registro de Auditoría

Cada acción (aprobar, rechazar, solicitar cambios, deshacer, reenviar) se registra en la propia recaudación de fondos en un registro de auditoría inmutable. Para verlo, haz clic en una sola fila en cualquier vista y desplázate hacia abajo:

Cada entrada muestra:

• Acción: aprobado / rechazado / cambios_solicitados / deshacer_aprobación / reenviado
• Moderador: qué administrador realizó la acción
• Marca de tiempo: cuándo ocurrió
• Motivo o notas: el texto que escribiste (rechazos y solicitudes de cambios)
• Indicador de notificación: si se envió el correo electrónico (para aprobaciones)

El registro es inmutable: no puedes editar ni eliminar entradas desde la interfaz de usuario. Es el registro al que puedes recurrir si un embajador pregunta "¿por qué se rechazó mi recaudación de fondos?" o "¿quién aprobó esto?".

El contador de Pendientes está en todas partes

La insignia del contador de la vista Pendiente potencia otros dos lugares en el administrador para que no tengas que vigilarla manualmente:

• La etiqueta de la pestaña Moderación en sí (Moderación 7).
• El KPI de Aprobaciones Pendientes en el panel de Resumen: este solo aparece cuando hay al menos una recaudación de fondos en espera.

Ambos tiran de la misma fuente única, por lo que siempre están sincronizados.

Editar recaudaciones de fondos aprobadas

En Embajadores 3.0, las ediciones de recaudaciones de fondos ya aprobadas entran en vigor inmediatamente; no vuelven a pasar por Moderación. La razón es que un embajador que corrige un error tipográfico en su recaudación de fondos ya aprobada no debería tener que esperar de nuevo a tu equipo. Si la moderación de ediciones posteriores a la aprobación es importante para tu flujo de trabajo, está marcada para una versión futura.

Consejos

• Establece un SLA. Una recaudación de fondos pendiente es una recaudación de fondos que no recauda dinero. Intenta liquidar Pendientes en 24 horas.
• Usa "Solicitar cambios" generosamente. Es la acción más amigable para el embajador: demuestra que leíste la presentación y quieres ayudar, no solo poner barreras.
• Apóyate en las acciones masivas. Si el 80% de las presentaciones parecen limpias, márcalas todas y aprueba masivamente de una vez. Reserva la lenta revisión individual para los casos atípicos.
• Lee el campo de motivo como una plantilla. Cuando el mismo motivo de rechazo aparece tres veces, es una señal de que el formulario de envío necesita una mejor orientación inicial.

---

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan el flujo de trabajo de Moderación.

Estado de publicación personalizado

Las recaudaciones rechazadas pasan a un estado personalizado charitable-rejected registrado en includes/charitable-ambassadors-post-status.php. Es:

• Excluido del archivo de campañas en el front-end (is_archive_visible() = false).
• Excluido de wp_count_posts() para los recuentos visibles para el visitante.
• Incluido en las consultas de administración cuando se filtra la tabla de la lista de Moderación por Rechazados.

Para restaurar una recaudación rechazada, transiciónala de nuevo a draft o publish a través de la llamada estándar wp_update_post().

Almacenamiento del registro de auditoría

El registro de auditoría se encuentra en la clave de metadatos de publicación _charitable_ambassadors_moderation_log en cada recaudación. El valor es un array indexado; cada entrada es un array asociativo:

[
    'action'          => 'approved' | 'rejected' | 'changes_requested' | 'undo_approve' | 'resubmitted',
    'moderator_id'    => int,   // WP user ID
    'timestamp'       => int,   // Unix epoch
    'reason_or_notes' => string,
    'notified'        => bool,  // optional, only on approve entries
]

La clase Charitable_Ambassadors_Moderation_Log es la única API de lectura/escritura:

Charitable_Ambassadors_Moderation_Log::append( $campaign_id, $action, $moderator_id, $reason_or_notes, $extra = [] );
Charitable_Ambassadors_Moderation_Log::get( $campaign_id ); // array of entries, oldest first
Charitable_Ambassadors_Moderation_Log::render_html( $campaign_id ); // newest-first HTML for the expanded row

La migración de tablas personalizadas se pospone para una versión futura. Hasta entonces, el almacenamiento de metadatos de publicación es la fuente de verdad.

Metadatos de motivo/notas

El motivo de rechazo más reciente y las notas de solicitud de cambios se reflejan en claves de metadatos dedicadas para que los correos electrónicos y las anulaciones de plantillas puedan leerlos directamente:

Clave de metadatos	Sellado por
motivo_rechazo_embajadores_benéficos	do_reject()
notas_revision_necesaria_embajadores_benéficos	do_request_changes()

Estas claves se borran en la siguiente transición de estado fuera de charitable-rejected / borrador – así que una vez que una recaudación es aprobada, desaparecen.

Filtros

Filtro	Predeterminado	Propósito
notificar_aprobacion_por_defecto_moderacion_embajadores_beneficos	verdadero	Valor predeterminado de la casilla de verificación "notificar al embajador" en el flujo de aprobación en línea. Devuelve false para aprobaciones silenciosas por defecto.
embajadores_caritativos_omitir_campaña_creador_aprobada	false	Se utiliza internamente para suprimir el correo electrónico de aprobación durante una única llamada de aprobación. Generalmente no es para el código del sitio – utiliza el filtro default-notify anterior en su lugar.

Acciones

Acción	Argumentos	Se dispara cuando
transición_estado_publicación	$new_status, $old_status, $post	Estándar de WP. Ganchos de moderación con prioridad 20 para capturar las re-presentaciones de los embajadores y registrarlas.

Endpoints AJAX

Todo solo en wp_ajax_, nonce por fila, capacidad manage_charitable_settings:

Acción	Propósito
embajadores_caritativos_moderación_aprobar	Aprobar una sola recaudación. Devuelve el HTML de la fila re-renderizado más un nonce de deshacer de un solo uso.
embajadores_caritativos_moderación_rechazar	Rechazar con motivo. Devuelve el HTML de la fila renderizado de nuevo.
embajadores_caritativos_moderación_solicitar_cambios	Solicitar cambios con notas. Devuelve el HTML de la fila renderizado de nuevo.
embajadores_caritativos_moderación_desaprobar	Revertir una aprobación reciente. Requiere el nonce de un solo uso devuelto por la llamada de aprobación.

Controladores de Form-POST

URL	Usado por
admin-post.php?action=charitable_ambassadors_moderation_bulk	El formulario de Acciones Masivas en la parte superior de la tabla.
admin-post.php?action=charitable_ambassadors_moderation_single	El banner Aprobar / Rechazar / Solicitar Cambios en la página de vista previa de Embajadores. Misma lógica de negocio que los puntos finales AJAX; redirige a Moderación con un argumento de consulta de resultado.

Lógica de negocio reutilizable

La misma ruta de aprobación/rechazo/solicitud de cambios se utiliza en todas partes (AJAX, masiva, banner). Los métodos en Charitable_Ambassadors_Moderation son públicos y se pueden llamar desde tu propio código una vez que hayas manejado las comprobaciones de capacidad y nonce:

Charitable_Ambassadors_Moderation::get_instance()->do_approve( $campaign_id, $notify = true );
Charitable_Ambassadors_Moderation::get_instance()->do_reject( $campaign_id, $reason = '' );
Charitable_Ambassadors_Moderation::get_instance()->do_request_changes( $campaign_id, $notes = '' );

Fuente del recuento pendiente

La insignia de recuento Pendiente en todo el administrador (etiqueta de pestaña, mosaico KPI de Resumen, en cualquier otro lugar) se obtiene de un único ayudante para mantenerlos sincronizados:

Charitable_Ambassadors_Overview_Data::get_instance()->get_pending_approvals_count();

El valor es independiente del rango (siempre refleja "ahora mismo", no el rango de fechas activo del Resumen) y está en caché por la capa transitoria del Resumen. Guardar una aprobación o rechazo elimina la caché automáticamente a través de los ganchos existentes de la clase de datos del Resumen.

Capacidades

Puerta única: manage_charitable_settings. Otorgada a los Administradores por defecto. Añade la capacidad a otro rol para otorgar acceso a Moderación sin otorgar acceso completo a la configuración de Charitable.

Registro

Cada acción de moderación se escribe en Herramientas de Charitable > Registro a través de charitable_ambassadors_log(). Las entradas de registro estructuradas tienen claves ambassadors_event:

Evento	Cuándo
moderación_aprobada	Acción de aprobación confirmada.
moderación_rechazada	Acción de rechazo confirmada.
moderación_cambios_solicitados	Solicitud de cambios confirmada.

Ejemplos de personalización

Por defecto, aprobaciones silenciosas (sin correo electrónico):

add_filter( 'charitable_ambassadors_moderation_default_notify_on_approve', '__return_false' );

Notificar a un canal de Slack sobre cada rechazo:

add_action( 'transition_post_status', function ( $new, $old, $post ) {
    if ( 'charitable-rejected' !== $new ) {
        return;
    }
    if ( get_post_type( $post ) !== 'campaign' ) {
        return;
    }
    $reason = get_post_meta( $post->ID, '_charitable_ambassadors_rejection_reason', true );
    // ...post to Slack webhook with $post->post_title and $reason.
}, 30, 3 );

Leer el registro de auditoría de una recaudación de fondos:

$log = Charitable_Ambassadors_Moderation_Log::get( $campaign_id );
foreach ( $log as $entry ) {
    printf( "%s by user #%d at %sn", $entry['action'], $entry['moderator_id'], gmdate( 'c', $entry['timestamp'] ) );
}

Aprobar programáticamente una recaudación de fondos desde un flujo de trabajo externo (por ejemplo, un webhook de CRM):

if ( current_user_can( 'manage_charitable_settings' ) ) {
    Charitable_Ambassadors_Moderation::get_instance()->do_approve( $campaign_id, true );
}

Relacionado

• Análisis detallado de las acciones de moderación – el flujo Aprobar / Rechazar / Solicitar Cambios / Deshacer en detalle.
• Plantillas de correo electrónico – los tres correos electrónicos transaccionales que dispara Moderación.
• Panel de control – donde el recuento Pendiente aparece como un KPI.
• Enviar campaña – el formulario que los embajadores utilizan para enviar recaudaciones de fondos.
• Hooks y filtros en Embajadores – la referencia completa de filtros y acciones.