Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Mis Campañas es la página en la que aterriza cada embajador después de iniciar sesión: su panel personal para las recaudaciones que han creado. Es donde ven cuánto han recaudado, editan una recaudación, copian un enlace para compartir, reclutan nuevos embajadores (si Invitaciones está activado) y entran en modo de edición.

La página es renderizada por un único shortcode ([charitable_my_campaigns]) y estilizada por el mismo selector de plantillas que la Página de Recaudación – así que un sitio que ejecuta plantillas mejoradas obtiene un Mis Campañas mejorado; un sitio que ejecuta plantillas heredadas obtiene la vista heredada.

Cuándo usarlo

• Configuración del onboarding – el paso Páginas del Asistente de Configuración crea automáticamente una página /my-campaigns/. Visítala una vez para confirmar que el shortcode se ha renderizado.
• Ajuste del diseño – oculta la miniatura, oculta el botón de compartir, ordena por defecto por "más recaudado", etc. – todo sin tocar el código.
• Añadir a una página existente – si ya tienes una página de "Cuenta", inserta [charitable_my_campaigns] dentro de una sección existente.

Dónde encontrar Mis Campañas en Embajadores

En tu administrador de WordPress, ve a Charitable » Embajadores » Mis Campañas.

La subpestaña tiene dos mitades: una columna de configuración a la izquierda, una vista previa en vivo de la página visible para el visitante a la derecha. La vista previa se actualiza al activar/desactivar configuraciones, para que puedas ver el efecto sin cambiar de pestaña en el navegador.

La Configuración de Mis Campañas

Configuración	Predeterminado	Lo que controla
Mostrar Barra de Búsqueda	Activado	La entrada de búsqueda encima de la lista de campañas.
Mostrar Menú Desplegable de Ordenación	Activado	El menú desplegable de ordenación encima de la lista.
Orden de Ordenación Predeterminado	Más Reciente Primero	La ordenación inicial con la que carga la página. Opciones: Más Reciente Primero, Más Antiguo Primero, Más Recaudado, Más Cercano a la Meta, Finaliza Pronto. Se aplica incluso si el menú desplegable está oculto.
Mostrar Miniatura de Campaña	Activado	La imagen destacada en cada tarjeta de campaña.
Mostrar Barra de Progreso	Activado	La barra de progreso de recaudación en cada tarjeta.
Mostrar botón de compartir	Activado	El botón para compartir en cada tarjeta.
Mostrar código QR	Activado	Un enlace de "código QR" en cada fila que abre un PNG descargable de la URL de la recaudación. Solo se renderiza si el interruptor global Códigos QR está activado.

El panel de vista previa incluye un selector de estado Rellenado / Vacío para que puedas ver cómo se ve la página cuando un embajador tiene recaudaciones y cuando no.

El Shortcode

Toda la página es renderizada por:

[charitable_my_campaigns]

No toma atributos requeridos. Insértalo en cualquier página o publicación; muestra las recaudaciones del usuario actual, o un estado vacío si no tiene ninguna.

Los visitantes no registrados ven en su lugar un aviso de "Por favor, inicia sesión". El enlace de inicio de sesión respeta el flujo de inicio de sesión que hayas configurado (la pantalla de inicio de sesión integrada de Charitable por defecto).

Qué se Renderiza Cuándo

La representación del shortcode depende de la configuración de versión de la interfaz de usuario (Charitable > Embajadores > General > Versión de la interfaz de usuario):

Versión de la interfaz de usuario	Cómo se ve la página
Legado	La representación original de la versión 1.x. Lista simple, estilo mínimo.
Mejorado	La representación de la versión 3.0: cuadrícula de tarjetas, diseño moderno, menú para compartir, tarjeta de reclutamiento.
Visual	Igual que Mejorado para Mis Campañas; la diferencia solo está en las páginas de recaudación de fondos.

La subpestaña de configuración y la vista previa en vivo reflejan la versión de la interfaz de usuario en la que te encuentres. Si todavía estás en la versión anterior, verás un banner que te indica la actualización.

La tarjeta de reclutamiento

Si Invitaciones está habilitado y el usuario que ha iniciado sesión es elegible para reclutar, aparece una tarjeta "Reclutar Recaudadores" en la parte superior de la página, encima de la cuadrícula de sus campañas. La tarjeta tiene su URL de invitación personal, botones para compartir, una línea de estadísticas y un interruptor "Tus Reclutados".

Consulta Invitaciones – Reclutar Recaudadores con Enlaces Personales para obtener el resumen completo.

Acciones por Campaña

Cada tarjeta de campaña tiene una fila de acciones en la parte inferior:

Acción	Lo que hace
Editar	Abre la campaña en el constructor visual de Charitable (o el editor apropiado para la versión de la interfaz de usuario de la campaña).
Compartir	Abre el menú para compartir con las mismas redes sociales que utiliza la página de recaudación de fondos.
Donaciones	Si el Informe de Donaciones del Creador está habilitado, enumera todas las donaciones a esta campaña.
Código QR	Abre una ventana modal con un PNG descargable de la URL del recaudador de fondos.
Recluta	(Solo campañas principales) Abre una ventana emergente con una URL de invitación específica de la campaña.

La visibilidad de cada acción depende de los interruptores de configuración: oculta el botón para compartir en todo el sitio y desaparecerá de cada tarjeta.

Informe de donaciones del creador de campañas

Una función de larga duración en Mis Campañas: los embajadores pueden ver y descargar un CSV de cada donación a su recaudador de fondos. La sección se encuentra en la parte inferior de la subpestaña de configuración de Mis Campañas (estaba en la subpestaña General en la versión 2.x, se trasladó aquí en la versión 3.0).

Configuración	Predeterminado	Lo que controla
Permitir exportación del historial de donaciones	Activado	Si el botón de acción Donaciones aparece en cada tarjeta.
Incluir detalles personales para donantes anónimos	Desactivado	Si los donantes anónimos se muestran con su nombre real en la exportación (úsalo solo si tu política de privacidad lo permite).
Incluir donaciones de campañas secundarias	Desactivado	Para campañas principales: acumula las donaciones a los recaudadores de fondos subyacentes en la exportación.

Anulaciones de tema

Toda la plantilla se puede anular desde tu tema:

your-theme/charitable-pro/charitable-ambassadors/my-campaigns.php

La plantilla predeterminada se encuentra en wp-content/plugins/charitable-ambassadors/templates/my-campaigns.php. Cópiala a tu tema para realizar cambios de diseño en todo el sitio que sobrevivan a las actualizaciones del plugin.

Consejos

• Mantén la búsqueda y el orden activados. Una vez que un embajador tenga más de 3-4 recaudadores de fondos, ambos controles serán útiles.
• Establece "Lo más recaudado" como predeterminado para programas establecidos. Los nuevos embajadores deberían ver primero su recaudador de fondos con mejor rendimiento, no el más antiguo.
• El estado vacío importa. Visita /my-campaigns/ como un usuario que tiene cero recaudaciones de fondos y confirma que el texto del estado vacío apunta claramente a tu página de envío.

---

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan Mis Campañas.

Shortcode

[charitable_my_campaigns]

Clase: Charitable_Ambassadors_My_Campaigns_Shortcode. La devolución de llamada de visualización devuelve el HTML renderizado directamente. La salida se puede filtrar a través de charitable_my_campaigns_shortcode_output:

add_filter( 'charitable_my_campaigns_shortcode_output', function ( $html, $args, $atts ) {
    return $html . '<p>Need help? Email [email protected]</p>';
}, 10, 3 );

Almacenamiento de ajustes

charitable_settings > ambassadors > my_campaigns_show_search
charitable_settings > ambassadors > my_campaigns_show_sort
charitable_settings > ambassadors > my_campaigns_default_sort
charitable_settings > ambassadors > my_campaigns_show_thumbnail
charitable_settings > ambassadors > my_campaigns_show_progress
charitable_settings > ambassadors > my_campaigns_show_share
charitable_settings > ambassadors > qr_codes_show_in_my_campaigns
charitable_settings > ambassadors > allow_creators_donation_export
charitable_settings > ambassadors > include_anonymous_donor_details
charitable_settings > ambassadors > creators_donation_export_include_child_campaigns

Leer con charitable_get_option( 'my_campaigns_default_sort', 'newest' ).

Versión de la interfaz de usuario

charitable_ambassadors_ui_version() devuelve 'legacy', 'enhanced' o 'visual'. El shortcode renderiza la plantilla apropiada según este valor. Fuerza el valor para pruebas:

add_filter( 'pre_option_charitable_settings', function ( $v ) {
    // ...inject ambassadors.ambassadors_ui_version into the option array.
} );

Filtros

Filtro	Predeterminado	Propósito
charitable_my_campaigns_shortcode_output	HTML calculado	Filtra toda la salida del shortcode antes de devolverla. Recibe ($html, $args, $atts).
charitable_ambassadors_my_campaigns_default_sort	valor de configuración	Anula el ordenamiento predeterminado mediante programación.
charitable_ambassadors_my_campaigns_show_search	valor de configuración	Fuerza la visibilidad de la búsqueda activada/desactivada.
charitable_ambassadors_my_campaigns_show_sort	valor de configuración	Fuerza la visibilidad del menú desplegable de ordenamiento activada/desactivada.
charitable_ambassadors_my_campaigns_show_thumbnail	valor de configuración	Fuerza la visibilidad de la miniatura activada/desactivada.
charitable_ambassadors_my_campaigns_show_progress	valor de configuración	Fuerza la visibilidad de la barra de progreso activada/desactivada.
charitable_ambassadors_my_campaigns_show_share	valor de configuración	Fuerza la visibilidad del botón de compartir activada/desactivada.
charitable_ambassadors_my_campaigns_card_actions	matriz de acciones	Modifica las acciones en línea en cada tarjeta. (El mismo hook de acción se activa tanto para la página como para el flujo de tarjetas de reclutamiento).
charitable_my_campaigns_query_args	calculado	Modifica los argumentos de WP_Query utilizados para obtener las campañas del usuario actual.

Acciones

Acción	Argumentos	Se dispara cuando
charitable_ambassadors_my_campaigns_before_grid	$campaigns, $user_id	Justo antes de que se renderice la cuadrícula de campañas. La tarjeta de reclutamiento se monta aquí cuando las Invitaciones están habilitadas.
charitable_ambassadors_my_campaigns_after_grid	$campaigns, $user_id	Justo después de la cuadrícula. Úsalo para un bloque de pie de página adicional.
charitable_ambassadors_my_campaigns_card_actions	$campaign_id, $context	Dentro de la fila de acciones de cada tarjeta de campaña.

Plantilla

templates/my-campaigns.php                                           # Legacy
templates/my-campaigns-enhanced.php                                  # Enhanced + Visual

Ruta de anulación de tema: your-theme/charitable-pro/charitable-ambassadors/<filename>.php. El selector de plantillas utiliza los filtros estándar de Charitable charitable_template_name + charitable_locate_template.

Capacidades

El shortcode se muestra para cualquier usuario conectado. No hay una puerta de enlace de capacidad de administrador: si has iniciado sesión, ves tus propias recaudaciones de fondos. Para ocultar Mis Campañas de roles de usuario específicos, protege el shortcode en el momento de la visualización a través de charitable_my_campaigns_shortcode_output.

Ejemplos de personalización

Ordenar siempre por "Más recaudado", independientemente de la configuración:

add_filter( 'charitable_ambassadors_my_campaigns_default_sort', function () {
    return 'most_raised';
} );

Inyectar una llamada a la acción "Iniciar una nueva recaudación de fondos" en la parte superior de la cuadrícula:

add_action( 'charitable_ambassadors_my_campaigns_before_grid', function ( $campaigns, $user_id ) {
    $url = home_url( '/submit-campaign/' );
    echo '<p class="my-campaigns-cta"><a class="button" href="' . esc_url( $url ) . '">Start a new fundraiser</a></p>';
}, 10, 2 );

Ocultar el botón "Compartir" a los embajadores no verificados:

add_filter( 'charitable_ambassadors_my_campaigns_show_share', function ( $show ) {
    $user_id = get_current_user_id();
    if ( '1' !== get_user_meta( $user_id, '_charitable_ambassadors_verified', true ) ) {
        return false;
    }
    return $show;
} );

Añadir una acción personalizada en línea ("Enviar correo electrónico a los donantes") a cada tarjeta:

add_action( 'charitable_ambassadors_my_campaigns_card_actions', function ( $campaign_id, $context ) {
    $url = add_query_arg( 'campaign_id', $campaign_id, home_url( '/email-donors/' ) );
    echo '<a class="my-campaigns-action" href="' . esc_url( $url ) . '">Email donors</a>';
}, 10, 2 );

Filtrar las campañas mostradas para excluir charitable-rejected:

add_filter( 'charitable_my_campaigns_query_args', function ( $args ) {
    $args['post_status'] = [ 'publish', 'pending', 'draft' ]; // omit charitable-rejected
    return $args;
} );

Relacionado

• Enviar Campaña – el formulario de envío que los embajadores utilizan para crear una recaudación de fondos.
• Página de Recaudación de Fondos – el lado público de la recaudación de fondos de un embajador.
• Invitaciones – la tarjeta de reclutamiento que aparece en la parte superior de esta página.
• Códigos QR – la ventana modal del código QR por tarjeta.
• Hooks y filtros en Embajadores: referencia completa.