Requisitos:
Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Antes de que tus embajadores empiecen a recaudar fondos, alguien tiene que decidir cómo se verán sus páginas. Para eso sirve la pestaña Plantillas.

La pestaña Plantillas es el único lugar donde se encuentran las cuatro decisiones más visuales en la configuración de tus Embajadores: qué familia de plantillas se representa (Legado, Mejorada o Visual), qué variante de diseño utiliza la familia Mejorada, tu color de acento principal y tu estilo de tarjeta.

La mayoría de los otros ajustes de visualización se encuentran en subpestañas más pequeñas como Página de Recaudación y Mis Campañas, pero Plantillas es la orientación. Es el lugar por donde empiezas cuando decides cómo debe ser la apariencia del programa.

Cuándo usarlo

Volverás a esta pestaña cada vez que algo sobre la apariencia de tu programa necesite cambiar. Las razones más comunes:

• Configuración inicial: decide si te quedas con las plantillas heredadas o pasas a las modernas Mejoradas o Visuales.
• Renovación de marca: actualiza tu color de acento, cambia el estilo de la tarjeta o elige una variante de diseño diferente.
• Implementación del modo Visual: cambia de Mejorado a Visual y elige qué campaña actúa como fuente de diseño para todas las páginas de recaudación.

Cómo llegar

Ve a Charitable » Embajadores » Plantillas.

Qué hay en la pestaña Plantillas

Tres grupos de ajustes van de arriba abajo. En la práctica, normalmente los trabajarás en orden: elige un estilo, luego refina la variante o la elección de plantilla, luego ajusta tu tema.

Grupo	Qué contiene
Estilo de Plantilla Frontend	Tres tarjetas: Legado, Mejorado, Visual. La decisión más importante de la pestaña.
Diseño / Plantilla	Un segundo selector que cambia según el estilo anterior. En Mejorado es el selector de Diseño de 8 variantes. En Visual es el autocompletado de Campaña de Plantilla de Recaudación. Oculto bajo Legado.
Tematización	El Color de Acento Principal y la opción de estilo de tarjeta.

Estilo de Plantilla Frontend

Este es el interruptor maestro para cómo se representan tus páginas de recaudación. Elige el que se ajuste a dónde te encuentras en la vida de tu programa.

Estilo	Qué se representa	Elige cuándo
Legado	Las plantillas y CSS originales 1.x, sin tocar.	Has personalizado plantillas o CSS en tu tema y no quieres que nada cambie.
Mejorado	Las plantillas 3.0 con barras de progreso, estadísticas de iconos, ventana emergente para compartir y búsqueda. El selector de variantes aparece debajo.	Quieres el aspecto moderno pero aún no has diseñado una plantilla de campaña personalizada.
Visual	Cada página de recaudación de fondos se genera a partir de un diseño del Generador de Campañas Visual que elijas. El selector de campañas de plantilla aparece a continuación.	Quieres el máximo control de marca o tienes un requisito de diseño impulsado por el patrocinador.

Puedes cambiar entre estilos en cualquier momento. Al volver a Legacy, no se pierde nada: tanto tu variante Mejorada guardada como el puntero de campaña-plantilla Visual se conservan. Para obtener la historia completa sobre el modo Visual, consulta Modo de Plantilla Visual.

Diseño / Plantilla (Contextual)

Lo que aparece en esta sección depende del estilo que hayas seleccionado arriba. No se mostrará en absoluto en Legacy, y cambia por completo entre Mejorado y Visual.

• En Legacy: nada se genera aquí.
• En Mejorado: el selector de Variantes de Diseño de 8 variantes. Elige Clásico, Enfocado en la Historia, Enfocado en Estadísticas, Donar Primero, Revista, Presentación, Póster de Presentación o Rally.
• En Visual: el autocompletado de Campaña de Plantilla de Recaudación de Fondos. Elige qué campaña en tu sitio actúa como fuente de diseño para todas las páginas de recaudación de fondos.

El selector de diseño también aparece en la subpestaña Página de Recaudación de Fondos. Son el mismo selector que comparte la misma configuración, así que elígelo desde la subpestaña que te resulte más natural.

Tematización

Dos configuraciones afectan a todas las páginas renderizadas por Embajadores en tu sitio. Establécelas una vez y se aplicarán automáticamente en todas partes.

Configuración	Predeterminado	Efecto
Color de Acento Principal	(hereda el tema)	Usado por las barras de progreso, los botones principales, los estados de pasar el ratón por encima y los resaltados de estado seleccionado en los modos Mejorado y Visual. Se establece a través del selector de color de WordPress.
Estilo de Tarjeta	Redondeado (sombra sutil)	Tres opciones: Plano (sin borde, sin sombra), Redondeado (sombra sutil), Con Borde (borde de 1px, sin sombra). Se aplica a las tarjetas de Mis Campañas y a la tarjeta de donación de recaudación de fondos.

Para una mirada más profunda a la tematización, incluyendo la variable CSS --cap-accent, la cadena de anulación de tema y el manejo del modo oscuro, consulta Tematización.

Cómo se Relaciona la Pestaña de Plantillas con las Otras Subpestañas

La pestaña Plantillas es la orientación. Las configuraciones más pesadas por función viven en sus propias subpestañas dedicadas. Aquí está el mapa para que sepas a dónde ir para qué.

Preocupación de la configuración	Vive en
Qué familia de plantillas	Pestaña Plantillas (esta página).
Variante de diseño Mejorado	Pestaña Plantillas o la subpestaña Página de Recaudación de Fondos.
Campaña de plantilla Visual	Pestaña de plantillas.
Comportamiento de la página de recaudación de fondos (compartir, migas de pan, muro de donantes, cromo)	Subpestaña de Página de recaudación de fondos.
Comportamiento de la página Mis campañas (buscar, ordenar, miniatura, compartir)	Subpestaña de Mis campañas.
Selecciones de red de la ventana emergente para compartir	Redes para compartir.
Renderizado de códigos QR en cada superficie	Códigos QR.

La mayoría de la gente dedica la mayor parte de su tiempo a ajustar plantillas en esta pestaña de Plantillas, además de la subpestaña de Página de recaudación de fondos. El resto son pequeños interruptores de encendido/apagado que configurarás una vez y olvidarás.

Consejos que vale la pena tener en cuenta

Algunas cosas que te ahorrarán tiempo cuando estés ajustando la apariencia de tu programa.

• Elige Mejorada a menos que tengas una razón para quedarte en Heredada. Las plantillas Mejoradas renderizan el mismo contenido que las heredadas, solo que con un estilo moderno. Puedes volver atrás instantáneamente si algo no se ve bien.
• Actualiza a Visual cuando lleguen requisitos estrictos de marca. La mayoría de los sitios funcionan bien con Mejorada y una variante de diseño. Visual es el movimiento correcto cuando un patrocinador o las directrices de marca requieren un control a nivel de píxel sobre el diseño de la página de recaudación de fondos.
• Establece tu color de acento ahora, incluso si te quedas en Heredada por el momento. Tanto Mejorada como Visual lo captan automáticamente. Establecerlo una vez significa que un cambio de estilo futuro ya tendrá tu color de marca incorporado.
• Usa las previsualizaciones en vivo en las subpestañas antes de confirmar. Tanto las subpestañas de Página de recaudación de fondos como las de Mis campañas tienen previsualizaciones SVG en vivo para que puedas ver tus cambios antes de cambiar de pestaña en el navegador para comprobar el front-end.

Referencia del desarrollador

El resto de esta página es para desarrolladores que personalizan el comportamiento de la pestaña Plantillas.

Almacenamiento de configuración

charitable_settings > ambassadors > ambassadors_ui_version          # 'legacy' | 'enhanced' | 'visual'
charitable_settings > ambassadors > p2p_template_campaign_id        # int (0 = none)
charitable_settings > ambassadors > ambassadors_enhanced_layout_variant
charitable_settings > ambassadors > theme_primary_color             # hex string
charitable_settings > ambassadors > theme_card_style                # 'flat' | 'rounded' | 'bordered'

Ayudantes

charitable_ambassadors_ui_version();                                // 'legacy' | 'enhanced' | 'visual'
charitable_ambassadors_should_use_p2p_template( $fundraiser_id );   // bool
charitable_ambassadors_fundraiser_template_is_theme_overridden();   // bool

Filtros

Filtro	Predeterminado	Propósito
charitable_ambassadors_settings_display_fields	computed (nombre de filtro heredado)	Modifica el conjunto de campos en la subpestaña Plantillas. El nombre del filtro se mantiene por compatibilidad retroactiva con sitios que agregaron campos a la antigua pestaña "Display".
charitable_ambassadors_visual_mode_is_available	calculado	Si el modo Visual es seleccionable en esta instalación (depende de la versión Pro).
charitable_ambassadors_rally_is_available	calculado	Si la tarjeta de variante de diseño Rally aparece en el selector (depende del Mini Widget de Donación de Pro).
charitable_ambassadors_ui_version_force	null	Fuerza una versión de UI específica independientemente de la configuración guardada. Útil para pruebas A/B.

Acciones

Acción	Argumentos	Se dispara cuando
charitable_ambassadors_ui_version_changed	$old, $new	La configuración de la versión de la interfaz de usuario se guardó con un valor diferente.
charitable_ambassadors_layout_variant_changed	$old, $new	La configuración de la variante de diseño Mejorado se guardó con un valor diferente.
charitable_ambassadors_p2p_template_campaign_changed	$old_id, $new_id	La configuración de la campaña de plantilla del modo Visual se guardó.

Plantillas

Cada estilo tiene su propio archivo o familia de plantillas:

Estilo	Ruta de la plantilla
Legado	templates/campaign/<filename>.php — sin cambios desde 1.x
Mejorado	templates/campaign/fundraiser-page-enhanced.php (+ parciales por variante)
Visual	Sustituye la campaign_settings_v2 de la plantilla de campaña en la renderización del recaudador de fondos en tiempo de ejecución

Ruta de anulación de tema para Mejorado y Visual: your-theme/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php.

Capacidades

El acceso a la configuración requiere manage_charitable_settings. La renderización en el frontend no tiene puerta de acceso de capacidades.

Ejemplos de personalización

Forzar Mejorado en instalaciones existentes que aún no han establecido un estilo:

add_filter( 'charitable_ambassadors_ui_version_force', function () {
    if ( ! get_option( 'charitable_settings' ) ) {
        return 'enhanced';
    }
    return null;
} );

Envía una notificación a tu CRM cada vez que cambie la versión de la interfaz de usuario:

add_action( 'charitable_ambassadors_ui_version_changed', function ( $old, $new ) {
    wp_remote_post( 'https://crm.example.com/hooks/charitable', [
        'body' => [ 'event' => 'ui_version_changed', 'from' => $old, 'to' => $new ],
    ] );
}, 10, 2 );

Forzar estilo de tarjeta con borde para un programa estricto de marca:

add_filter( 'pre_option_charitable_settings', function ( $value ) {
    if ( ! is_array( $value ) ) {
        return $value;
    }
    if ( isset( $value['ambassadors']['theme_card_style'] ) ) {
        $value['ambassadors']['theme_card_style'] = 'bordered';
    }
    return $value;
} );

Añadir una pancarta solo para administradores cuando el modo Visual esté activo:

add_action( 'admin_notices', function () {
    if ( 'visual' === charitable_ambassadors_ui_version() ) {
        echo '
Visual mode is active. Edit the template campaign to change every fundraiser page at once.
';
    }
} );

Conclusión

Eso cubre todo en la pestaña Plantillas. Ya sea que estés tomando una decisión rápida en tu primera instalación o ajustando una configuración Visual controlada por la marca, aquí es donde todo comienza. Elige tu estilo, selecciona un diseño, establece tu color de acento y todo lo demás sigue a partir de ahí.

Si tienes preguntas o necesitas ayuda para decidir qué estilo es el adecuado para tu programa, nuestro equipo de soporte estará encantado de ayudarte.

También te Puede Interesar Leer

Estos documentos cubren la configuración que se deriva de la pestaña Plantillas. Marca los más relevantes para la configuración de tu programa.

• Página de Recaudación de Fondos – las opciones de visualización por recaudador de fondos que se encuentran en la pestaña de al lado.
• Variantes de Diseño – una inmersión profunda en cada una de las ocho variantes Mejoradas.
• Modo de Plantilla Visual – cómo funciona la ruta de renderización Visual y cómo configurar tu plantilla de campaña.
• Tematización – color de acento, la variable CSS --cap-accent y la cadena completa de anulación de tema.
• Mis Campañas – configuración de visualización para la página del panel de control orientada al embajador.
• Hooks y filtros en Embajadores – la referencia completa para desarrolladores.