Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Cada recaudación de fondos de embajador en tu sitio tiene su propia página pública: la página en la que aterrizan sus donantes cuando hacen clic en el enlace para compartir. La subpestaña Página de recaudación de fondos es donde decides cómo se construye esa página: qué variante de diseño utiliza, si la ventana emergente para compartir está activada, dónde se sitúa el muro de donantes, si los comentarios están habilitados, qué sucede cuando el embajador olvida subir una imagen de héroe.

La configuración está organizada en una vista de dos columnas: controles a la izquierda, una vista previa SVG en vivo de la página resultante a la derecha. La vista previa se actualiza a medida que activas o desactivas la configuración, por lo que antes de ver una recaudación de fondos real, puedes ver la forma de la página que estás configurando.

Cuándo usarlo

• Elegir tu estilo visual: cambia del diseño Clásico predeterminado a Historia-Adelante, Revista o cualquiera de las ocho variantes.
• Ajustar la interfaz: oculta la navegación de publicaciones inyectada por el tema, los comentarios y los créditos del autor para que la página de recaudación de fondos se vea como la diseñaste, no como tu tema la envuelve.
• Marca: tu color de acento principal (establecido en Charitable > Configuración > Avanzado > Color principal del tema) se aplica al botón de llamada a la acción, la barra de progreso y el estado de desplazamiento de cada página de recaudación de fondos.
• Ajustar la ubicación: mueve el muro de donantes a la parte superior, ocúltalo por completo o déjalo en la parte inferior de la página.

Dónde encontrar la configuración de la página de recaudación de fondos

En tu administrador de WordPress, ve a Charitable » Embajadores » Plantillas » Página de recaudación de fondos.

Personalización de la página de recaudación de fondos

En la configuración de la página de recaudación de fondos, puedes hacer lo siguiente:

• Mostrar migas de pan del padre: Esto muestra de qué campaña principal forma parte esta página. Solo aparecerá si la página tiene una campaña principal.
• Mostrar ventana emergente para compartir: Esto muestra la ventana emergente en la página de recaudación de fondos para que los donantes la compartan fácilmente. Puedes elegir qué plataformas sociales se muestran aquí en la pestaña Varios.
• Mostrar sección de comentarios: Muestra una sección de comentarios debajo de la historia de la recaudación de fondos.
• Mostrar código QR en la página de recaudación de fondos: Muestra un código QR que enlaza a esta recaudación de fondos.
• Posición del muro de donantes: Elige dónde aparece el muro de donantes que muestra los donantes recientes.
• Imagen de héroe de respaldo: Si un embajador no ha subido una imagen destacada, puedes elegir ocultar la sección de héroe o usar la imagen destacada de la campaña principal.
• Limpiar la interfaz del tema: Esto anula el estilo de tu tema activo solo en las páginas de recaudación de fondos de embajadores. Por lo tanto, estas páginas se verán como las diseñaste.

Asegúrate de guardar tus cambios antes de salir de esta página.

Elegir una variante de diseño

Ocho variantes de diseño vienen con Ambassadors 3.0. Cada una reorganiza los mismos bloques de construcción (hero, historia, tarjeta de donación, muro de donantes, ventana emergente para compartir) en una forma diferente.

En la pestaña Caritativas » Plantillas, puedes elegir entre estos 8 diseños. Estos dictan cómo se ve/estiliza la página de recaudación de fondos en el frontend.

Variante	Cómo se ve
Clásico	Hero, historia a la izquierda, tarjeta de donación a la derecha. La opción segura por defecto.
Prioridad de la historia	Hero, luego historia, luego una banda de conversión. Lo mejor para causas emotivas.
Prioridad de las estadísticas	Lidera con progreso y estadísticas. Lo mejor para recaudaciones de fondos de día de carrera y eventos.
Prioridad de la donación	Tarjeta de donación en la parte superior, historia colapsada debajo. Lo mejor para recaudaciones de fondos de un solo uso y baja fricción.
Revista	Editorial – título grande sobre un hero cinematográfico. Lo mejor para organizaciones de marca.
Exhibición	Enfocado en la imagen con navegación de ancla fija. Lo mejor cuando tienes una gran fotografía de hero.
Póster de exhibición	Encabezado centrado con insignias superpuestas y donación en línea. Lo mejor para recaudaciones de fondos de eventos de alta energía.
Concentración	Dos columnas con mini widget de donación, tarjeta QR y hero con logo superpuesto. Lo mejor para eventos patrocinados o de marca. (Requiere Charitable Pro 1.8.13.1+ para el mini widget de donación.)

Cada tarjeta tiene una pequeña ilustración que previsualiza la forma de la variante. Haz clic en una tarjeta para seleccionarla; el panel de vista previa a la derecha se actualiza inmediatamente para mostrar cómo se vería tu página de recaudación de fondos con esa variante + el color de acento elegido.

Para una inmersión profunda en cada variante – cuándo elegirla, qué esperar en móvil, consideraciones del tema – consulta Variantes de Diseño.

La ranura personalizada

Si un tema anula la plantilla de recaudación de fondos mejorada a través de la ruta de anulación estándar (tu-tema/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php), aparece una novena tarjeta titulada Personalizada en el selector, etiquetada como “Renderizando actualmente”:

La tarjeta Personalizada es informativa – tu anulación de tema prevalece, independientemente de la variante incorporada seleccionada. La variante incorporada seleccionada permanece seleccionada para que se reanude si/cuando elimines la anulación. Elimina el archivo de anulación y la próxima carga de página volverá a la variante elegida.

La otra configuración

Debajo del selector de diseño, la subpestaña de configuración tiene una pila de interruptores y botones de radio:

Configuración	Predeterminado	Efecto
Mostrar miga de pan principal	Activado	Renderiza el enlace “parte de [campaña principal]” en la parte superior de las páginas de recaudación de fondos. Se oculta automáticamente cuando no hay una principal.
Mostrar ventana emergente para compartir	Activado	La ventana emergente para compartir (las redes provienen de Redes para compartir).
Mostrar sección de comentarios	Desactivado	Comentarios del núcleo de WP. Conecta wpDiscuz, Disqus, etc. a través de charitable_ambassadors_fundraiser_show_comments.
Mostrar código QR en la página de recaudación de fondos	Activado (instalaciones nuevas)	Interruptor maestro para QR en la página de recaudación de fondos.
Mostrar mosaico QR en la ventana emergente para compartir	Activado	Añade un mosaico QR a la ventana emergente para compartir, junto con Facebook / X / LinkedIn / Email. Requiere el maestro QR anterior.
Posición del muro de donantes	Lo que sucede en una página de recaudación de fondos real	Arriba, abajo u ocultar.
Imagen de héroe de respaldo	Destacado por el padre	Qué hacer cuando el embajador no ha subido una imagen: usar la destacada del padre, usar la predeterminada configurada por el padre u ocultar la imagen de héroe.
Tema Limpio Chrome	Activado	Suprime el contenedor de publicación única del tema activo: título de página duplicado, banda de autor/fecha, navegación anterior/siguiente, formulario de comentarios predeterminado. Solo modos mejorado y visual.

La vista previa en vivo

La columna de la derecha muestra una maqueta SVG de cómo se verá una recaudación de fondos con tu configuración actual:

La vista previa tiene en cuenta las variantes: elige "Story-Forward" y la vista previa se vuelve a renderizar para mostrar el flujo de la historia. El color de acento se toma de Caritativo » Configuración » Avanzado » Color primario del tema para que la vista previa coincida con lo que tu sitio renderiza realmente.

Una frase de estado encima de la vista previa narra el estado activo ("Diseño de revista, acento #1db954, héroe visible, ventana emergente de compartir activada"). La frase es accesible para lectores de pantalla.

¿Qué sucede en una página de recaudación de fondos real?

Una vez que hayas configurado la subpestaña, cada recaudación de fondos en tu sitio se renderiza con estas opciones. Dos capas pueden anular por recaudación de fondos:

1. Plantilla de modo visual – cuando se configura una campaña de plantilla de igual a igual, la campaign_settings_v2 de la plantilla se clona a la recaudación de fondos en tiempo de lectura. Consulta Modo de plantilla visual para ver el flujo completo.
2. Anulaciones de tema – tu tema puede reemplazar la plantilla completa a través de tu-tema/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php. La ranura "Personalizado" en el selector indica que esto está en efecto.

Si ninguna anulación está activa, la variante + los interruptores que elegiste aquí son lo que se renderiza.

Consejos

• Haz coincidir la variante con la causa. Las causas emocionales (memoriales, fondos de ayuda) se adaptan a "Story-Forward". Los eventos (maratones, galas) se adaptan a "Stats-Forward" o "Showcase Poster".
• Prueba "Donate-First" en campañas con mucho tráfico móvil. Cuando la mayor parte de tu tráfico proviene de un mensaje de texto compartido, la tarjeta de donación debe ser lo primero en la pantalla.
• Usa "Clean Theme Chrome" libremente. Los temas varían enormemente en cómo envuelven las publicaciones individuales; la supresión limpia automáticamente el 95% de las colisiones de diseño.
• No habilites los comentarios a menos que tengas la moderación controlada. Las páginas de recaudación de fondos se enlazan públicamente; los comentarios de spam las encuentran.

---

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan la página de recaudación de fondos.

Almacenamiento de ajustes

charitable_settings > ambassadors > ambassadors_enhanced_layout_variant   # 'classic' (default) | 'story-forward' | 'stats-forward' | 'donate-first' | 'magazine' | 'showcase' | 'showcase-poster' | 'rally'
charitable_settings > ambassadors > fundraiser_show_breadcrumb            # bool
charitable_settings > ambassadors > fundraiser_show_share                 # bool
charitable_settings > ambassadors > fundraiser_show_comments              # bool
charitable_settings > ambassadors > qr_codes_show_on_fundraiser_page      # bool
charitable_settings > ambassadors > qr_codes_show_on_share_popover        # bool
charitable_settings > ambassadors > fundraiser_donor_wall_position        # 'top' | 'bottom' | 'off'
charitable_settings > ambassadors > fundraiser_hero_image_fallback        # 'parent_featured' | 'ambassadors_default' | 'hide'
charitable_settings > ambassadors > fundraiser_clean_chrome               # bool

Slug de variante -> clase de cuerpo

Cada variante añade una clase de cuerpo a la página de recaudación de fondos en el front-end:

charitable-ambassadors-layout-classic
charitable-ambassadors-layout-story-forward
charitable-ambassadors-layout-stats-forward
charitable-ambassadors-layout-donate-first
charitable-ambassadors-layout-magazine
charitable-ambassadors-layout-showcase
charitable-ambassadors-layout-showcase-poster
charitable-ambassadors-layout-rally

Usa la clase para CSS dirigido sin bifurcar plantillas.

Plantilla

templates/campaign/fundraiser-page-enhanced.php   # default Enhanced + Visual template

Ruta de anulación de tema: tu-tema/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php. Una vez que el archivo de anulación exista, la ranura "Personalizado" aparece en el selector de administrador.

Los archivos de plantilla por variante se encuentran en templates/campaign/fundraiser-page-layouts/<slug>.php. El despachador en la plantilla principal elige el correcto según ambassadors_enhanced_layout_variant.

Filtros

Filtro	Predeterminado	Propósito
charitable_ambassadors_enhanced_layout_variant	valor de configuración	Anular la variante de diseño activa en el momento de la representación.
charitable_ambassadors_fundraiser_show_breadcrumb	valor de configuración	Forzar la aparición/desaparición de la ruta de navegación.
charitable_ambassadors_fundraiser_show_share	valor de configuración	Forzar la aparición/desaparición de la ventana emergente para compartir.
charitable_ambassadors_fundraiser_show_comments	valor de configuración	Forzar la aparición/desaparición de los comentarios. Conectar wpDiscuz / Disqus aquí.
charitable_ambassadors_fundraiser_donor_wall_position	valor de configuración	Forzar la posición del muro de donantes.
charitable_ambassadors_fundraiser_hero_image_fallback	valor de configuración	Forzar el comportamiento de reserva de la imagen principal.
charitable_ambassadors_fundraiser_clean_chrome	valor de configuración	Forzar la limpieza de la interfaz en activado/desactivado.
charitable_ambassadors_fundraiser_page_docs_url	esta página	Anular la URL de la documentación a la que enlaza la subpestaña.
charitable_ambassadors_render__args	argumentos por átomo	Control del lado del cliente por variante de átomos individuales (imagen principal, tarjeta de donación, compartir, muro de donantes).

Acciones

Acción	Argumentos	Se dispara cuando
charitable_ambassadors_fundraiser_page_before_hero	$campaign_id	Justo antes de que se renderice el átomo principal.
charitable_ambassadors_fundraiser_page_after_hero	$campaign_id	Justo después de la imagen principal.
charitable_ambassadors_fundraiser_page_before_story	$campaign_id	Justo antes de la columna de la historia.
charitable_ambassadors_fundraiser_page_after_story	$campaign_id	Justo después de la columna de la historia.

(Cada variante también dispara sus propias acciones con ámbito de variante; consulta el archivo de plantilla de variante para obtener la lista exacta).

Puerta de versión Pro de Rally

La variante Rally requiere Charitable Pro 1.8.13.1+ para el Mini Widget de Donación. El selector oculta la tarjeta Rally en versiones Pro anteriores. La puerta está implementada por charitable_ambassadors_rally_is_available().

Detección de plantilla personalizada

Se detecta una anulación de plantilla con charitable_ambassadors_fundraiser_template_is_theme_overridden(). Cuando es verdadero:

1. La tarjeta Personalizada aparece en el selector.
2. La tarjeta se etiqueta como “Renderizando actualmente” en lugar de “Seleccionada”.
3. Todas las tarjetas integradas se convierten en is-overridden para que quede claro que no están activas.

Elimina el archivo de anulación y la próxima carga de página revertirá a la integrada elegida.

Capacidades

Acceso a la configuración: manage_charitable_settings. La representación en el front-end no tiene puerta de capacidad.

Ejemplos de personalización

Forzar la variante de donación primero para todos los usuarios no registrados (p. ej., para una prueba A/B solo para móviles):

add_filter( 'charitable_ambassadors_enhanced_layout_variant', function ( $variant ) {
    if ( ! is_user_logged_in() && wp_is_mobile() ) {
        return 'donate-first';
    }
    return $variant;
} );

Usar wpDiscuz en lugar de los comentarios principales de WP:

add_filter( 'charitable_ambassadors_fundraiser_show_comments', '__return_true' );
add_action( 'charitable_ambassadors_fundraiser_page_after_story', function ( $campaign_id ) {
    if ( function_exists( 'wpdiscuz' ) ) {
        echo do_shortcode( '[wpdiscuz_comments]' );
    }
} );

Usar siempre la imagen destacada del padre cuando un embajador no ha subido una:

add_filter( 'charitable_ambassadors_fundraiser_hero_image_fallback', function () {
    return 'parent_featured';
} );

Insertar una tira de logotipos de patrocinador justo debajo de cada sección principal:

add_action( 'charitable_ambassadors_fundraiser_page_after_hero', function ( $campaign_id ) {
    echo '<div class="sponsor-strip">' . do_shortcode( '[sponsors]' ) . '</div>';
} );

Ocultar la ventana emergente para compartir solo en las páginas de vista previa de las recaudaciones rechazadas:

add_filter( 'charitable_ambassadors_fundraiser_show_share', function ( $show ) {
    if ( is_singular( 'campaign' ) && 'charitable-rejected' === get_post_status() ) {
        return false;
    }
    return $show;
} );

Relacionado

• Variantes de diseño – análisis detallado de cada una de las 8 variantes.
• Temas – color de acento, --cap-accent, cadena de anulación de tema.
• Modo de plantilla visual – clonar el creador de una campaña de plantilla a cada recaudación.
• Redes para compartir – en qué redes se muestra la ventana emergente para compartir.
• Códigos QR – representación de códigos QR por superficie.
• Hooks y filtros en Embajadores: referencia completa.