Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+
Cuando alguien hace clic en el enlace de invitación de un embajador, lo primero que ve es la página de destino de la invitación. Quieres que esta página tenga un aspecto fantástico y contenga toda la información correcta que un nuevo embajador necesitará saber. Es el momento de la primera impresión: quién les está invitando, a qué causa se les invita a apoyar y qué se les pide que hagan.
La página de destino es una de las pocas páginas que puedes diseñar por completo para que se ajuste a tu marca.
En esta guía, te mostraremos cómo configurar y personalizar la página.
Los detalles técnicos: Esta es la página que configurarás en tu sitio para que se renderice el shortcode [charitable_invite_landing]. El shortcode es el renderizador, pero la página circundante (hero, navegación, pie de página) es tu página normal de WordPress. El shortcode simplemente inserta la tarjeta del invitador y la causa donde la coloques.
Cuándo usarlo
- Configuración de invitaciones por primera vez: necesitas esta página antes de que la función pueda hacer algo.
- Refinamiento del mensaje: el texto predeterminado funciona, pero ajustarlo para tu audiencia hace que la página convierta mejor.
- Integración con el tema: quieres controlar el diseño (imagen principal, barra lateral, pie de página) sin perder la lógica del shortcode.
Dónde encontrar la configuración de la página de destino de invitaciones
La página de destino en sí es una página normal de WordPress. El shortcode que la potencia es:
[charitable_invite_landing]
Para configurar qué página considera Embajadores como la página de destino, ve a tu administrador de WordPress y dirígete a Benéfico » Embajadores » Invitaciones » Página de destino.
Creación de la página de destino de invitaciones
- Administrador de WordPress » Páginas » Añadir nueva.
- Título algo atractivo: "Únete a nuestro equipo", "Conviértete en recaudador de fondos", "Ayúdanos a alcanzar nuestra meta".
- Paste the shortcode into the page content:
[charitable_invite_landing] - Publicar.
- Ve a Benéfico » Embajadores » Invitaciones » Página de destino y selecciona esta página.
La página está ahora lista para recibir reclutas.
Qué aparece en tu página de destino
El shortcode renderiza tres cosas en orden:
| Sección | Qué contiene |
|---|---|
| Hero del invitador | Avatar (Gravatar real o iniciales de colores), nombre del invitador, una frase verbal como "Sarah te invitó a recaudar fondos". |
| Texto introductorio (opcional) | El texto enriquecido "Texto introductorio de la página de destino" que estableces en Invitaciones. Omítelo si no quieres uno. |
| Tarjeta de causa | La campaña principal que el recluta está invitado a apoyar: imagen principal, título, progreso de lo recaudado/meta, número de donantes. |
| CTA | Un botón "Conviértete en recaudador de fondos" que enlaza a tu página de envío de campañas, pre-rellenado con la causa a través de cap_campaign=<id>. |
Cuando el recluta llega a la página directamente (sin token, por ejemplo, al hacer clic en un enlace "Acerca de este programa"), ve una versión genérica con contenido de marcador de posición. El shortcode nunca se renderiza vacío, siempre tiene algo que mostrar.
Tres estados especiales
| Estado | Qué se representa |
|---|---|
| Normal (token válido de otra persona) | Héroe del invitador + tarjeta de causa + CTA "Conviértete en un recaudador de fondos". |
| Autoreclutamiento (el usuario hizo clic en su propio enlace de invitación mientras estaba conectado) | Una variante amigable de "no puedes reclutarte a ti mismo": el héroe recibe un mensaje de autoreclutamiento, la CTA se suprime. |
| Sin token (alguien visitó la URL de la página directamente) | Héroe genérico ("Conviértete en un recaudador de fondos") + una tarjeta de causa que muestra tu campaña principal más destacada, o una imagen de respaldo si no hay ninguna configurada. |
Anulaciones de tema
El shortcode se renderiza desde templates/invite/landing.php. Para personalizar el marcado o el diseño, cópialo en tu tema:
your-theme/charitable-pro/charitable-ambassadors/invite/landing.php
Dentro de la anulación, tienes acceso a:
| Variable | Tipo | Notas |
|---|---|---|
$inviter | WP_User | El invitador (falso en la ruta sin token). |
$inviter_name | cadena | Nombre para mostrar (o "Tu ONG" si está vacío). |
$avatar_html | cadena | El avatar del invitador: Gravatar real o iniciales de colores. |
$cause | WP_Post | La campaña principal (falso en la ruta sin token). |
$cause_data | matriz | Estadísticas de la causa: raised, goal, donor_count, percent. |
$intro_copy | cadena | La configuración "Texto introductorio de la página de destino" (texto enriquecido). |
$cta_url | cadena | La URL de "Conviértete en un recaudador de fondos" (con cap_campaign=NNN). |
$cta_label | cadena | La etiqueta del botón CTA (por defecto "Conviértete en un recaudador de fondos", se puede filtrar). |
$is_preview | booleano | Verdadero cuando un administrador está previsualizando sin un token. |
$is_self_recruit | booleano | Verdadero cuando el usuario conectado es el propio invitador. |
Personalizando la Copia
Las cosas que más se anulan en la página de destino son las etiquetas:
| Filtro | Predeterminado | Propósito |
|---|---|---|
charitable_ambassadors_invite_landing_cta_label | “Conviértete en un Recaudador de Fondos” | El texto del botón en la llamada a la acción. |
charitable_ambassadors_invite_landing_inviter_verb | “te invitó a recaudar fondos” | Se usa en la frase principal (“Sarah te invitó a recaudar fondos“). |
charitable_ambassadors_invite_landing_self_recruit_copy | “No puedes reclutarte a ti mismo…” | El cuerpo completo que se muestra cuando se activa el auto-reclutamiento. |
charitable_ambassadors_invite_landing_preview_notice | aviso de vista previa del administrador | El aviso que se muestra a los administradores cuando previsualizan la página sin un token. |
Para cambios de formato más largo (diseño diferente, secciones diferentes), haz una anulación de tema.
Clases del Cuerpo
La página recibe dos clases de cuerpo que puedes usar para CSS con ámbito:
charitable-ambassadors-invite-landing
charitable-ambassadors-invite-landing--{state} /* normal | self-recruit | preview */
Combina estas con el sistema de diseño de tu tema para que la página se vea como el resto de tu sitio sin bifurcar la plantilla.
Caché
La página de destino es dinámica – personalizada por token de invitador a través de cookies. Embajadores la marca como dinámica a través del filtro charitable_is_dynamic_page de Pro 1.8.15.2 para que los plugins de caché la omitan. Si tienes una versión anterior de Pro que no tiene ese filtro, el manejador de URL emite cabeceras de no caché en el paso de redirección – pero un plugin de caché aún podría almacenar en caché la página de destino en sí, lo que rompería la atribución. El administrador de Invitaciones muestra una advertencia de autocomprobación cuando se detecta este estado.
Consejos
- Mantén la página enfocada. Elimina la navegación no relacionada, los widgets de la barra lateral, las llamadas a la acción del pie de página. El trabajo de esta página es convertir a un recluta, no navegar por tu sitio.
- Añade un testimonio de una línea. “Sarah recaudó 4.200 $ el año pasado – únete a su equipo y superemos eso” funciona mejor que una solicitud genérica.
- Usa la Imagen de Respaldo de la Página de Destino. Cuando un padre no tiene una imagen destacada (raro pero sucede), la imagen de respaldo evita que la tarjeta de la causa se vea rota.
- Previsualiza sin un token. Como administrador, visita la URL de la página directamente. Verás la versión genérica – útil para confirmar el diseño sin configurar un recluta real.
Referencia del desarrollador
El resto de esta página es para que los desarrolladores personalicen la página de destino.
Shortcode
[charitable_invite_landing]
El shortcode se registra incondicionalmente incluso cuando Invitaciones está deshabilitado – por lo que una página que usa el shortcode muestra un aviso de vista previa solo para administradores en lugar de filtrar el texto literal de [charitable_invite_landing].
Ruta de la plantilla
templates/invite/landing.php # default
Ruta de anulación de tema: tu-tema/charitable-pro/charitable-ambassadors/invite/landing.php. El selector de plantilla utiliza el filtro estándar de Charitable charitable_locate_template.
Filtros
| Filtro | Predeterminado | Propósito |
|---|---|---|
charitable_ambassadors_invite_landing_cta_label | “Conviértete en un Recaudador de Fondos” | Etiqueta del botón. |
charitable_ambassadors_invite_landing_cta_url | URL de submit-campaign | La URL completa a la que enlaza la CTA. Recibe ($url, $cause_id). |
charitable_ambassadors_invite_landing_inviter_verb | “te invitó a recaudar fondos” | Frase verbal en la sección principal. |
charitable_ambassadors_invite_landing_self_recruit_copy | cadena calculada | Cuerpo de autorreclutamiento. |
charitable_ambassadors_invite_landing_preview_notice | calculado | Contenido del aviso de vista previa del administrador. |
copia_introductoria_pagina_destino_invitacion_embajadores_caritativos | valor de configuración | Filtrar la copia introductoria renderizada (después de wp_kses_post). |
identificador_causa_pagina_destino_invitacion_embajadores_caritativos | calculado | Anular la campaña principal que se muestra en la tarjeta de causa (por ejemplo, cuando el token no tiene campaña, elegir una causa destacada específica). |
identificador_imagen_reserva_pagina_destino_invitacion_embajadores_caritativos | valor de configuración | El ID del archivo adjunto de la imagen de reserva. |
clase_cuerpo_pagina_destino_invitacion_embajadores_caritativos | matriz | Modificar la matriz body_class aplicada a las páginas de destino. |
Acciones
| Acción | Argumentos | Se dispara cuando |
|---|---|---|
antes_pagina_destino_invitacion_embajadores_caritativos | $invitador, $causa, $contexto | Justo antes de que se renderice el marcado del shortcode. |
despues_pagina_destino_invitacion_embajadores_caritativos | $invitador, $causa, $contexto | Justo después. |
renderizado_pagina_destino_invitacion_embajadores_caritativos | $invitador, $causa, $contexto | El shortcode completó su renderizado. |
Clase del cuerpo
charitable-ambassadors-invite-landing se añade a body_class en cualquier página que contenga el shortcode. La variante de sufijo de estado (--normal, --self-recruit, --preview) se añade en tiempo de ejecución. Añadir a la matriz a través del filtro charitable_ambassadors_invite_landing_body_class.
Ayudante de detección
charitable_ambassadors_is_invite_landing_page( $post_id = null ); // bool
Útil al configurar el comportamiento condicional del tema (por ejemplo, ocultar la barra de búsqueda del sitio en la página de destino).
Capacidades
Lectura pública. Sin puerta de capacidad.
Ejemplos de personalización
Cambiar la etiqueta de la CTA:
add_filter( 'charitable_ambassadors_invite_landing_cta_label', function () {
return 'Sign up to fundraise';
} );
Personalizar el mensaje de autorreclutamiento:
add_filter( 'charitable_ambassadors_invite_landing_self_recruit_copy', function () {
return "Looks like you're already a fundraiser! Share your invite link with friends instead.";
} );
Inyectar un testimonio debajo de la tarjeta de causa:
add_action( 'charitable_ambassadors_invite_landing_after', function ( $inviter, $cause, $context ) {
if ( ! $cause ) {
return;
}
echo '<blockquote class="invite-testimonial"><p>"Joining as a fundraiser was the best decision I made this year." - Past Ambassador</p></blockquote>';
}, 10, 3 );
Ocultar la navegación del sitio en la página de destino:
add_filter( 'body_class', function ( $classes ) {
if ( charitable_ambassadors_is_invite_landing_page() ) {
$classes[] = 'no-nav';
}
return $classes;
} );
// ...then in your theme's CSS: body.no-nav .site-header { display: none; }
Anular la URL de la CTA para enlazar directamente a una página de envío específica:
add_filter( 'charitable_ambassadors_invite_landing_cta_url', function ( $url, $cause_id ) {
return add_query_arg( 'cap_campaign', $cause_id, home_url( '/sign-up-to-fundraise/' ) );
}, 10, 2 );
Relacionado
- Invitaciones – el documento principal de la característica.
- Cómo funciona la atribución: el flujo de clic a crédito del que forma parte esta página.
- Cómo se almacenan los datos de la invitación: la tabla personalizada entre bastidores.
- Enviar campaña: la página a la que enlaza la CTA.
- Hooks y filtros en Embajadores: referencia completa.
Enlaces Útiles
🤝 Obtenga ayuda cuando la necesite
Conéctese con el Soporte al Cliente →
📑 Encuentre la guía que necesita
Explore el Centro de Documentación →
⬇️ Descarga estrategias probadas, ideas de campañas y herramientas de expertos
Obtén el Kit de Recaudación de Fondos →
💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →
¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →
¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro→
