Requiere:

• Charitable Pro 1.8.16+
• Charitable Ambassadors 3.0.0+

La primera vez que actives Charitable Ambassadors, verás una pantalla de Bienvenida que te preguntará cómo quieres empezar. Hay tres caminos, todos te llevan al mismo lugar (un programa peer-to-peer en funcionamiento), pero cada uno se adapta a un estilo de usuario diferente. Elige el que coincida con tu forma de configurar las cosas y tendrás las presentaciones en funcionamiento en pocos minutos.

Cuándo usarlo

• Configuración por primera vez: acabas de activar el plugin y quieres una guía a través de la configuración importante.
• Configuración de un segundo sitio: sabes lo que quieres; elige una plantilla para aplicar tu configuración habitual con un solo clic.
• Cambio de escenarios: el año pasado corriste un maratón, este año es una gala. Volver a ejecutar el asistente con la plantilla de Gala re-aplica la configuración correcta.
• Ayudar a un colega a empezar: indícales el asistente para que no tengan que aprender el árbol de configuración.

Encontrar el Asistente de Configuración de Embajadores

La pantalla de Configuración aparece automáticamente la primera vez que visitas cualquier página de administración de Embajadores después de la activación. Después de eso:

En tu Administrador de WordPress, ve a Charitable » Embajadores » General » Acciones de Configuración » Abrir Configuración

La pantalla de Configuración siempre está disponible: puedes volver a ejecutar cualquiera de los tres caminos cuando quieras, y volver a ejecutarla no eliminará la configuración que ya hayas personalizado.

Tres Caminos del Asistente

Camino 1 – Asistente

El Asistente te guía a través de cada configuración importante de Embajadores en un flujo guiado paso a paso. Ideal para personas que quieren ver y entender cada opción antes de hacer clic en Guardar.

Los pasos:

#	Paso	Lo que decides
1	Bienvenida	Introducción + elección de camino.
2	Tipos de campaña	Qué tipos de recaudación de fondos aceptarás: individual, equipo, miembro del equipo.
3	Aprobación y requisitos	Aprobación manual o automática. Si los embajadores necesitan registrar una cuenta. Si necesitan verificar su correo electrónico.
4	Flujo de inicio de sesión	Dónde aterrizan los embajadores cuando necesitan iniciar sesión. (Condicional: se omite si tu sitio ya tiene un flujo de inicio de sesión configurado).
5	Páginas	Crea una página /submit-campaign/ y una página /my-campaigns/ si aún no las tienes.
6	Compartir	Elige qué redes sociales muestra la cuadrícula de compartir en las páginas de recaudación de fondos.
7	Estilo de plantilla	Elige la representación legacy / enhanced / visual para las páginas de recaudación de fondos.
8	Color de marca	Establece tu color de acento principal (utilizado por las plantillas enhanced + visual). (Condicional: se omite si te quedas en las plantillas legacy).
9	Campaña de inicio	Opcionalmente, crea una campaña de borrador habilitada para peer-to-peer para tener algo con lo que probar el flujo de embajadores de inmediato.
10	Completar	Resumen de lo que se configuró, próximos pasos, salida.

Cada paso tiene un enlace "Leer más sobre este paso" en el encabezado que abre esta página de documentación anclada al nombre del paso. Cada paso también tiene un botón "Omitir" para que puedas avanzar más allá de cualquier cosa que prefieras configurar más tarde desde la Configuración.

Ruta 2 – Plantillas

Si sabes qué tipo de programa estás ejecutando – un maratón, una gala, una recaudación de fondos escolar – la ruta de Plantillas es la forma más rápida de aplicar un conjunto de configuraciones predeterminadas sensatas. Elige una plantilla y el asistente aplicará un conjunto curado de configuraciones, luego te llevará directamente a una versión simplificada del asistente para las opciones que la plantilla no puede predeterminar de forma segura (como tu color de marca y campaña de inicio).

Los seis escenarios:

Plantilla	Cuándo elegirla	Qué configura
Maratón / Caminata	Recaudaciones de fondos para el día de la carrera con equipos.	Envíos individuales + de equipo + de miembro de equipo, aprobación manual, verificación por correo electrónico activada, diseño "stats-forward". Objetivo inicial $50K, duración 90 días.
Memorial / Homenaje	Recaudaciones de fondos individuales en honor a una persona.	Solo envíos individuales, aprobación manual, diseño "story-forward". Objetivo inicial $10K, duración 60 días.
Gala Anual / Evento	Equipos internos de confianza que organizan un evento anual.	Envíos de equipo + de miembro de equipo, aprobación automática (baja fricción), diseño "classic". Objetivo inicial $100K, duración 30 días.
Escuela / Educación	Escuelas K-12, AMPAS, recaudación de fondos en el aula.	Envíos de equipo + de miembro de equipo, aprobación manual, diseño "donate-first". Objetivo inicial $25K, duración 45 días.
Cumpleaños / Personal	Recaudaciones personales de corta duración.	Solo envíos individuales, aprobación automática, diseño de "revista". Objetivo inicial $1K, duración de 14 días.
Personalizado – Crear el mío	Ninguna de las anteriores encaja.	No aplica ninguna configuración preestablecida; te lleva al asistente normal.

Después de elegir una plantilla, el asistente avanza: los pasos de tipos de campaña, aprobación, uso compartido, estilo de plantilla y variante de diseño ya están establecidos, por lo que solo verás Páginas, Color de marca, Campaña de inicio y Completar.

Ruta 3 – Inicio Rápido

La ruta más rápida: un clic. Inicio Rápido aplica un paquete predeterminado genérico pero sensato (esencialmente lo mismo que elegir Personalizado y aceptar todos los valores predeterminados), crea tus páginas de Enviar Campaña + Mis Campañas, y te lleva a la Vista General listo para compartir un enlace de embajador.

Usa Inicio Rápido cuando:

• Estás explorando el plugin y quieres ver cómo funcionan los embajadores.
• Eres un desarrollador que está iterando en una personalización y necesitas una base reiniciable.
• Ya has diseñado tu propia configuración mediante filtros y no quieres que los valores predeterminados del asistente te molesten.

Puedes volver a ejecutar el Asistente normal en cualquier momento posterior para refinar las opciones que Inicio Rápido aplicó automáticamente.

Lo que hace realmente el Asistente

En las tres rutas, el asistente realiza el mismo tipo de cambios:

Superficie	Qué se modifica
Configuración	Claves de wp_options.charitable_settings > ambassadors > * para cada paso que completes.
Páginas	El paso Páginas crea /submit-campaign/ (con [charitable_submit_campaign]) y /my-campaigns/ (con [charitable_my_campaigns]) como borradores si aún no existen. Los publicas cuando estés listo.
Campaña de inicio	El paso de Inicio crea una campaña de borrador habilitada para peer-to-peer con una imagen de encabezado de marcador de posición opcional y texto de inicio.
Estado de incorporación	El progreso del asistente se almacena en wp_options.charitable_ambassadors_onboarding para que puedas continuar después de cerrar la página.

Nada es destructivo. Volver a ejecutar el asistente no borra la configuración existente: te muestra el valor actual y te permite mantenerlo o cambiarlo.

Restablecer datos de configuración

Si deseas empezar desde cero (por ejemplo, para probar el flujo de incorporación antes de un lanzamiento), usa el botón destructivo Restablecer datos de configuración en Administración de WordPress > Charitable > Embajadores > General > Acciones de configuración. Elimina solo los artefactos que crea el asistente (la opción de estado de incorporación, las páginas creadas automáticamente si aún son borradores vacíos, la campaña de inicio si aún es un borrador). No modifica la configuración.

El restablecimiento se confirma dos veces y se registra.

El panel "La configuración necesita atención"

Hasta que completes al menos una ruta, aparecerá un panel naranja en la Vista General que te pedirá que abras la Configuración:

Puedes descartar el panel por usuario: el descarte se almacena en meta de usuario y no afecta a otros administradores.

Consejos

• Elige una plantilla si una encaja. Es más rápido que el asistente completo y te lleva al 80% de un sitio bien configurado.
• El paso de inicio es opcional pero recomendado. Tener una campaña habilitada para peer-to-peer el primer día significa que puedes probar el flujo del embajador tú mismo antes de compartir nada públicamente.
• El asistente no es “para siempre”. Vuelve a ejecutarlo cuando quieras cambiar de escenario (por ejemplo, cambiar de un evento de gala a un programa de maratón).
• Usa Inicio rápido en entornos de desarrollo. Es la forma más rápida de restablecer y empezar de nuevo mientras iteras.

---

Referencia del desarrollador

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

Almacenamiento

wp_option:  charitable_ambassadors_onboarding
shape:      {
              'completed_via'       => null | 'wizard' | 'template' | 'quick_start',
              'completed_at'        => null | int (epoch),
              'template_slug'       => null | string,
              'current_step'        => string (key),
              'completed_steps'     => string[],
              'panel_dismissed_by'  => int[] (user IDs),
            }

El estado se lee/escribe a través de Charitable_Ambassadors_Onboarding_State::get_instance().

Registro de pasos

Los 10 pasos maestros se definen en Charitable_Ambassadors_Onboarding_Steps::get_master_steps(). Cada uno tiene una función can_render utilizada para ramificación condicional. Dos pasos son condicionales de inmediato:

• login_setup – se omite si el sitio ya tiene un flujo de inicio de sesión no predeterminado configurado.
• brand_color – se omite si el sitio se mantiene en plantillas heredadas (no se utiliza color de acento).

Añade, elimina o reordena pasos a través del filtro charitable_ambassadors_onboarding_wizard_steps.

can_render por paso

La elegibilidad de renderizado de cada paso también se puede anular a través de un filtro por paso:

add_filter( 'charitable_ambassadors_onboarding_step_brand_color_can_render', '__return_false' );

Usa esto para ocultar pasos individuales sin modificar la lista maestra.

Registro de plantillas

Las 6 plantillas se definen en Charitable_Ambassadors_Onboarding_Templates::get_all(). Cada plantilla tiene:

• label, description (solo visualización)
• settings – el conjunto de configuraciones de ambassadors a aplicar
• starter – valores predeterminados para la campaña de inicio (título, descripción, objetivo, duración, donaciones sugeridas)

Añade o modifica plantillas a través del filtro charitable_ambassadors_onboarding_templates.

Filtros

Filtro	Predeterminado	Propósito
Pasos del asistente de incorporación de embajadores benéficos	array de 10	Añade, elimina o reordena pasos del asistente.
charitable_ambassadors_onboarding_step_<key>_can_render	verdadero	Puerta condicional por paso.
Plantillas de incorporación de embajadores benéficos	array de 6	Registra plantillas de escenarios adicionales.
Candidatos a plantillas visuales de incorporación de embajadores benéficos	calculado	Filtra la lista de campañas ofrecidas como campaña de plantilla en modo Visual en el paso Estilo de plantilla.
Argumentos de campaña de inicio de incorporación de embajadores benéficos	calculado	Modifica los argumentos de wp_insert_post utilizados para crear la campaña de inicio. Recibe $args, $template_slug, $data.
Valores predeterminados de campaña de inicio de incorporación de embajadores benéficos	calculado	Modifica los valores predeterminados de inicio (título, descripción, objetivo, etc.). Recibe $defaults, $slug.
Donaciones sugeridas de inicio de incorporación de embajadores benéficos	plantilla predeterminada	Anula las cantidades de donación sugeridas para el inicio. Recibe $amounts, $template_slug.
charitable_ambassadors_onboarding_should_show_panel	calculado	Forzar la activación o desactivación del panel "Configuración necesita atención".
Acento del panel de incorporación de embajadores benéficos	#E38632	Color de acento del panel de aviso.
charitable_ambassadors_onboarding_show_features / _show_resources	verdadero	Activa o desactiva las secciones de Funciones y Recursos en la barra lateral del asistente.
charitable_ambassadors_onboarding_features / _resources / _sidebar_features	calculado	Reemplaza el contenido de esas secciones.
Ilustración de la barra lateral de incorporación de embajadores benéficos	SVG	Reemplaza la ilustración de la barra lateral.
charitable_ambassadors_onboarding_sidebar_docs_url / _docs_label	URL de wpcharitable.com	Anula el enlace de documentación de la barra lateral.
URL de documentación de incorporación de embajadores benéficos	esta página	Anula la URL base de documentación a la que resuelven los enlaces "Leer más" de cada paso.
URL de documentación para el paso de incorporación de embajadores benéficos	calculado	Anulación de URL de documentación por paso. Recibe $url, $step_key.
Capacidad de incorporación de embajadores benéficos	gestionar_configuración_caritativa	Comprobación de permisos para todos los puntos de conexión AJAX de incorporación.
Valores predeterminados de inicio rápido de embajadores benéficos	calculado	Anula el conjunto de configuraciones que aplica Quick Start.
Metadatos de imagen de marcador de posición de incorporación de embajadores benéficos	matriz	Metadatos de la imagen de marcador de posición de encabezado utilizada por la campaña de inicio.
Icono de ruta de incorporación de embajadores benéficos	SVG por ruta	Reemplaza el icono por ruta en el selector de rutas. Recibe $svg, $slug.

Acciones

Acción	Argumentos	Se dispara cuando
Artefacto de incorporación de embajadores benéficos creado	$type, $post_id	Un asistente creó una página o una campaña de inicio. $type es 'page' o 'campaign'.
Incorporación completa de embajadores benéficos	$via, $template_slug	Cualquiera de las tres rutas se completa. $via es 'wizard', 'template' o 'quick_start'.
Inicio rápido aplicado de incorporación de embajadores benéficos	–	Inicio rápido completado (además de _complete).
Panel de incorporación de embajadores benéficos descartado	$user_id	Un usuario descartó el panel de solicitud de Descripción general.

Endpoints AJAX

Todos en wp_ajax_ solamente, acción nonce charitable_ambassadors_onboarding, capacidad manage_charitable_settings (filtrable a través de charitable_ambassadors_onboarding_capability):

Acción	Propósito
Aplicar inicio rápido de incorporación de embajadores benéficos	Aplica el paquete de valores predeterminados de Inicio rápido.
Descartar panel de incorporación de embajadores benéficos	Descarta el panel "La configuración necesita atención" para el usuario actual.

(La navegación paso a paso utiliza el formulario POST estándar contra la propia URL del asistente con parámetros de subacción; no es AJAX.)

Ejemplos de personalización

Añadir una plantilla personalizada de "Crowdfunding":

add_filter( 'charitable_ambassadors_onboarding_templates', function ( $templates ) {
    $templates['crowdfunding'] = [
        'label'       => 'Crowdfunding launch',
        'description' => 'High-volume short-burst campaign with auto-approve.',
        'settings'    => [
            'campaign_recipients'    => [ 'individual' ],
            'auto_approve_campaigns' => 1,
            'ui_version'             => 'enhanced',
            'enhanced_layout_variant'=> 'magazine',
        ],
        'starter' => [
            'title'       => 'Help us launch',
            'description' => 'A short, intense campaign...',
            'goal'        => 20000,
            'length_days' => 30,
            'suggested_donations' => [ 10, 25, 50, 100 ],
            'terms'       => [],
        ],
    ];
    return $templates;
} );

Omitir el paso del flujo de inicio de sesión en cada instalación:

add_filter( 'charitable_ambassadors_onboarding_step_login_setup_can_render', '__return_false' );

Reemplazar el color de acento del panel de configuración para que coincida con su marca:

add_filter( 'charitable_ambassadors_onboarding_panel_accent', function () {
    return '#1e7e34';
} );

Relacionado

• Panel de descripción general: el panel de indicaciones se encuentra en la parte superior de Descripción general hasta que se completa la incorporación.
• Mostrar características: las opciones del paso de estilo de plantilla.
• Mis campañas: una de las dos páginas que crea el paso Páginas.
• Enviar campaña: la otra página que crea el paso Páginas.
• Hooks y filtros en Embajadores: referencia completa.