Documentación de Charitable

Aprende a sacar el máximo partido a Charitable con instrucciones claras y paso a paso.

Perfiles de creador en el complemento Embajadores

Los perfiles de creador otorgan a cada creador de campaña y recaudador de fondos una página pública compartible en /creator/tu-nombre/, que muestra su avatar, biografía, organización, enlaces sociales, campañas y totales de titulares. Los creadores gestionan su propio perfil desde el centro Mis campañas, y su identidad ahora viaja con ellos a cada página de recaudación de fondos.

Disponible en Charitable Ambassadors 3.3.0+ (requiere Charitable Pro 1.8.16 o posterior).

Características clave

  • Publica una página de perfil público para cada creador en /creator/<nombre>/, servida automáticamente sin necesidad de crear una página.
  • Permite a los creadores editar su propio perfil desde una nueva pestaña Perfil en el centro Mis campañas: nombre, biografía, organización, sitio web, seis redes sociales, foto y ubicación.
  • Muestra el avatar de un creador y una tarjeta flotante accesible (biografía, organización, enlaces sociales y un enlace a su perfil público) junto a su nombre en cada página de recaudación de fondos.
  • Elige exactamente qué estadísticas y secciones aparecen en la página pública, desde la biografía y los enlaces sociales hasta el total recaudado, el número de donantes y un código QR opcional.
  • Controla el uso compartido de la ubicación de forma responsable: solo ciudad, estado y país, nunca una dirección postal, con modos Desactivado, controlado por el creador y forzado.
  • Añade un botón Compartir (Copiar enlace, Compartir vía, Correo electrónico) para que los creadores puedan promocionar su perfil en un solo clic.
  • Incrusta el perfil de cualquier creador en cualquier lugar con el shortcode [charitable_creator_profile].

¿Por qué usar perfiles de creador?

Una recaudación de fondos suele ser una página única sin un hogar duradero para la persona que está detrás. Los perfiles de creador otorgan a tus seguidores más activos una identidad reconocible en tu sitio, para que los donantes puedan ver a quién están apoyando, explorar sus campañas y confiar en la persona que pide. Ese reconocimiento genera credibilidad, fomenta la recaudación de fondos repetida y convierte las campañas individuales en una relación continua.

Verlo en acción

Perfil de ONG: Paul Cannon con avatar, organización, ubicación, biografía y estadísticas de recaudación de fondos para la página

Requisitos

  • Charitable Ambassadors 3.3.0 o posterior
  • Charitable Pro 1.8.16 o posterior.
  • WordPress 5.0 o posterior, PHP 7.4 o posterior
  • Permalinks bonitos habilitados (Ajustes > Permalinks configurado en cualquier opción que no sea Simple), ya que la página pública utiliza una regla de reescritura

Empezar

Activación

  1. En el administrador de WordPress, ve a Charitable > Ambassadors > Plantillas > Mis campañas.
  2. Busca la sección Página pública del creador y activa Habilitar página pública del creador.
  3. Guarda tus ajustes. La página de cada creador ya está activa en /creator/<su-nombre-de-usuario>/.

Cuando la opción está desactivada, las páginas de creador devuelven un 404 y no se expone ningún contenido del perfil. Los archivos de autor no se ven afectados de ninguna manera.

Si las páginas devuelven un 404 después de habilitar la función, visita Ajustes > Permalinks una vez y guarda para vaciar las reglas de reescritura.

Cómo los creadores editan su perfil

Los creadores gestionan su propio perfil desde la pestaña Perfil dentro del centro Mis campañas (la página que aloja el shortcode [charitable_my_campaigns]). Desde allí, un creador conectado puede establecer:

  • Nombre y apellidos (se utilizan para construir el nombre de visualización)
  • Biografía
  • Organización
  • Sitio web m0s Twitter / X, Facebook, Instagram, LinkedIn, YouTube y TikTok
  • Foto de perfil
  • Ciudad, estado y pa0s, y cu0les de ellos compartir (cuando la ubicaci0n es controlada por el creador)

Los administradores pueden editar los mismos campos de perfil para cualquier creador desde el Directorio.

Formulario de perfil público con campos de nombre, cargador de fotos de perfil circular y enlaces sociales.

La P0gina P0blica del Creador

La p0gina se sirve autom0ticamente en /creator/<name>/, donde <name> es el slug de usuario de WordPress del creador. La base predeterminada creator se puede cambiar con un filtro (ver Recursos para desarrolladores). La p0gina puede incluir el avatar del creador, el formato de nombre elegido, la biograf0a, la organizaci0n, los enlaces sociales, un bot0n de Compartir, un c0digo QR opcional, una cuadr0cula de sus campa0as publicadas y totales de titulares.

Solo se cuentan y muestran las campa0as publicadas. Las campa0as privadas, borradores, pendientes y rechazadas nunca aparecen.

Enriquecimiento de la P0gina de Recaudaci0n de Fondos

En cada p0gina de recaudaci0n de fondos, el nombre del creador se enriquece con un peque0o avatar y una tarjeta accesible al pasar el rat0n y al enfocar. La tarjeta muestra la biograf0a del creador, la organizaci0n y los enlaces sociales, adem0s de un enlace a su perfil p0blico completo. Esto est0 activado por defecto y se puede ajustar o deshabilitar con filtros.

Encabezado de recaudación de fondos que muestra el perfil de Paul Cannon a la izquierda, una foto de una playa al atardecer en el centro y un panel de donaciones con barra de progreso a la derecha para 'Paws and Claws Rescue Drive'

Compartir Ubicaci0n

El intercambio de ubicaci0n se limita a ciudad, estado y pa0s. Nunca se recopila ni se muestra una direcci0n postal. Lo controlas en todo el sitio con dos configuraciones:

  • Modo de Compartir Ubicaci0n decide si la ubicaci0n est0 desactivada, controlada por el creador o forzada.
  • Permitir decide qu0 partes (ciudad, estado, pa0s) son elegibles en absoluto. Una parte desmarcada nunca se muestra, ni siquiera en modo forzado.

En el modo controlado por el creador, cada creador opta por las partes que desea mostrar desde su pesta0a de Perfil.

Uso

Shortcode

Usa el c0digo corto para incrustar un perfil de creador en cualquier p0gina o publicaci0n:

[charitable_creator_profile user_id="12"]

o

[charitable_creator_profile nicename="jane-doe"]

Sin atributos, el c0digo corto resuelve el creador para la solicitud actual /creator/<name>/, que es como se renderiza la p0gina autom0tica.

Parámetros del Shortcode

ParámetroTipoPredeterminadoDescripción
user_identero0El ID de usuario de WordPress del creador a mostrar. Tiene prioridad sobre nicename.
nicenamecadena""El slug de usuario del creador (nicename). Se usa cuando no se proporciona user_id.

Opciones de configuración

Todas las configuraciones a continuaci0n se encuentran en Charitable > Embajadores > Plantillas > Mis Campa0as.

Página de configuración del plugin Charitable que muestra la sección Página Pública del Creador con un interruptor y texto descriptivo para cada opción.

Visualizaci0n de la P0gina P0blica del Creador

ConfiguraciónTipoPredeterminadoDescripción
Habilitar P0gina P0blica del Creadorcasilla de verificaciónDesactivadoInterruptor principal. Cuando est0 desactivado, las p0ginas de creador devuelven un 404.
Mostrar Nombre del CreadorseleccionarNombre y ApellidosQué forma del nombre mostrar: Solo nombre, Solo apellido, Nombre y apellido, o Nombre de usuario. Siempre se muestra el nombre; esto solo elige la forma.
Mostrar biografíacasilla de verificaciónActivadoMostrar la biografía del creador.
Mostrar organizacióncasilla de verificaciónActivadoMostrar la organización del creador.
Mostrar enlaces socialescasilla de verificaciónActivadoMostrar los enlaces sociales del creador.
Mostrar botón de compartircasilla de verificaciónActivadoMostrar un botón de compartir (Copiar enlace, Compartir vía, Correo electrónico).
Mostrar campañascasilla de verificaciónActivadoMostrar la cuadrícula de campañas del creador.
Mostrar total recaudadocasilla de verificaciónActivadoMostrar el total recaudado por el creador.
Mostrar número de donantescasilla de verificaciónActivadoMostrar el número de donantes del creador.
Mostrar número de donacionescasilla de verificaciónActivadoMostrar el número de donaciones del creador.
Mostrar donación mediacasilla de verificaciónDesactivadoMostrar el importe medio de las donaciones del creador.
Mostrar número de recurrentes activoscasilla de verificaciónDesactivadoMostrar el número de donantes recurrentes activos del creador.
Mostrar código QRcasilla de verificaciónDesactivadoMostrar un código QR que enlaza a la página pública del creador, flotando en la esquina superior derecha.

Compartir Ubicaci0n

ConfiguraciónTipoPredeterminadoDescripción
Modo de compartir ubicaciónseleccionarDesactivadoDesactivado (nunca mostrar ubicación), Permitir al creador controlar, o Forzar (el creador no puede cambiar).
Permitircasillas de verificación múltiplesningunoQué partes pueden compartir los creadores: Ciudad, Provincia, País. Los elementos desmarcados nunca se muestran, ni siquiera en modo forzado.

Personalización

Anulación de plantilla

Copie la plantilla de perfil en su tema para personalizar el diseño de la página pública:

su_tema/charitable/charitable-ambassadors/creator/profile-page.php

Filtros y Funciones

Cada opción de visualización, la base de la URL, el formato del nombre y el tratamiento de la página de recaudación de fondos se pueden ajustar en el código. Consulte los Recursos para desarrolladores a continuación.

Solución de problemas

Las páginas de creador devuelven un 404

Confirme que Habilitar página pública de creador está activado. Luego visite Ajustes > Enlaces permanentes y guarde una vez para vaciar las reglas de reescritura. Confirme también que el creador tiene al menos una campaña publicada, ya que un perfil sin nada publicado no se resuelve.

La ubicación de un creador no se muestra

El modo de compartir ubicación debe estar configurado en Permitir al creador controlar o Forzar, y la parte relevante (ciudad, estado o país) debe estar marcada en Permitir. En el modo controlado por el creador, el creador también debe optar por esa parte desde su pestaña de Perfil.

Los enlaces sociales no aparecen

Confirme que Mostrar enlaces sociales está activado y que el creador ha introducido al menos un enlace en la pestaña Perfil.

La foto de perfil no se actualiza

La página pública utiliza la foto de perfil cargada por el creador (la metaetiqueta de usuario avatar). La imagen cargada debe pertenecer a los medios del propio creador. Si no se establece ninguna foto, el sitio recurre al avatar estándar.

Recursos para desarrolladores

Ganchos y filtros

  • charitable_ambassadors_creator_slug — Filtra la base de la URL para las páginas de creador. Por defecto creator.
  • charitable_ambassadors_creator_url — Filtra la URL completa del perfil público de un creador.
  • charitable_ambassadors_creator_name_format — Filtra el formato del nombre resuelto ( first, last, full, username).
  • charitable_ambassadors_creator_page_enabled — Filtra si la página pública está habilitada.
  • charitable_ambassadors_creator_page_show_{key} — Visibilidad por sección, donde {key} es bio, org, social, share, campaigns, raised, donors, donations, avg, recurring, o qr.
  • charitable_ambassadors_creator_location_mode — Filtra el modo de compartir ubicación.
  • charitable_ambassadors_creator_location_allow_{part} — Permiso de ubicación por parte, donde {part} es city, state, o country.
  • charitable_ambassadors_creator_social_fields — Añade o elimina campos sociales editables.
  • charitable_ambassadors_creator_avatar_meta_key — Filtra la clave de meta de usuario utilizada para la foto de perfil. Por defecto avatar.
  • charitable_ambassadors_creator_treatment — Habilita o deshabilita el avatar del creador y la tarjeta flotante en las páginas de recaudación de fondos.
  • charitable_ambassadors_creator_inline_avatar — Activa o desactiva el avatar en línea junto al nombre del creador en las páginas de recaudación de fondos.
  • charitable_ambassadors_creator_tooltip — Activa o desactiva la tarjeta de información al pasar el ratón y al enfocar en las páginas de recaudación de fondos.
  • charitable_ambassadors_creator_tooltip_show_{key} — Visibilidad por elemento dentro de la tarjeta de información.
  • charitable_ambassadors_directory_creator_profile_tabs — Filtra las pestañas que se muestran en el perfil del creador del Directorio de administradores.
  • charitable_ambassadors_creator_profile_saved — Acción que se ejecuta después de guardar un perfil de creador. Recibe el ID de usuario y la matriz de datos guardados.

Funciones útiles

  • charitable_ambassadors_get_creator_slug() — Devuelve la base de URL saneada para las páginas de creadores.
  • charitable_ambassadors_get_creator_url( $user_id ) — Devuelve la URL del perfil público de un creador.
  • charitable_ambassadors_creator_public_name( $creator ) — Devuelve el nombre para mostrar del creador en el formato configurado.
  • charitable_ambassadors_creator_page_enabled() — Devuelve si la página pública está activada.
  • charitable_ambassadors_creator_location_mode() — Devuelve el modo actual de compartir ubicación.
  • charitable_ambassadors_creator_location_allows( $part ) — Devuelve si una parte de la ubicación está permitida.
  • charitable_ambassadors_creator_social_fields() — Devuelve las definiciones de campos sociales editables.

Recursos adicionales

  • [PLACEHOLDER: URL de la documentación de Mis Campañas]
  • [PLACEHOLDER: URL de la documentación general de Embajadores Benéficos]
  • [PLACEHOLDER: URL de la documentación de configuración de la Página de Recaudación de Fondos]

¿Todavía tienes preguntas? ¡Estamos aquí para ayudarte!

Última modificación:

Novedades en Benéfico

Ver las últimas actualizaciones
🔔 Suscríbete para recibir nuestras últimas actualizaciones
📧 Suscribirse a correos electrónicos

Suscripción por correo electrónico

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

Función Nuevo

🎟️ Presentamos Eventos Benéficos: ¡Vende entradas dentro de tus campañas!

La mayoría de las organizaciones sin ánimo de lucro venden entradas para eventos en una herramienta y recaudan donaciones en otra, lo que genera dos conjuntos de informes y una conciliación manual al final del año. Eventos Benéficos une ambas cosas, vendiendo entradas a través de los mismos formularios de donación y pasarelas de pago que ya utilizas en Charitable. Por qué esto es importante:

  • 🎟️ Cada entrada es una donación: Las ventas de entradas se procesan a través de la pasarela que ya utilizas y cuentan para el objetivo de la campaña, con todo gestionado en Charitable » Eventos.
  • 📱 Registro con código QR desde cualquier teléfono: Cada asistente recibe su propio código QR en el recibo, y los voluntarios escanean en la puerta a través de un enlace de registro que no necesita cuenta de WordPress.
  • 🧾 Recibos listos para la declaración de impuestos: Asigna a cada tipo de entrada un valor justo de mercado, y Charitable incluirá el importe correcto deducible de impuestos en cada recibo de donante.
  • 📋 Detalles del asistente al finalizar la compra: Pregunta a cada invitado por su elección de comida, talla de camiseta o necesidades de acceso, con un registro de asistente independiente creado para cada entrada.
  • 🗓️ Bloques y calendarios incluidos: Tres bloques de editor, además de la compatibilidad con Sugar Calendar y The Events Calendar, muestran tus eventos donde los colaboradores ya los buscan.

Consulta nuestro anuncio aquí.

ia Nuevo

🚀 ¡Libera el poder de la IA en Charitable!

Tu asistente de IA ahora puede crear, editar y administrar tus campañas de recaudación de fondos de Charitable directamente, solo con pedírselo. Con Charitable Pro añadiendo soporte de escritura para la API de Habilidades de WordPress, herramientas como ChatGPT, Claude y Cursor pueden manejar acciones administrativas completas de forma segura a través de MCP. Por qué esto es importante:

  • 🤖 Creación de campañas en lenguaje natural: Pídele a tu asistente un objetivo como “Configura una recaudación de fondos para el refugio con un objetivo de 5.000 $”, y creará un borrador de campaña real completo con niveles de donación sugeridos.
  • 🎨 Ajustes instantáneos del formulario de donación: Añade campos personalizados, cambia los colores de los botones o reordena elementos sin tener que entrar en la configuración del formulario.
  • 📝 Registro de donaciones sin conexión: Informa a tu asistente sobre donaciones en efectivo o cheque, y cruzará los correos electrónicos de los donantes y registrará las transacciones en tu historial.
  • 🛡️ Seguridad y control por defecto: El acceso de escritura permanece estrictamente desactivado hasta que se active en Charitable » Herramientas » AI MCP, manteniendo el informe de solo lectura seguro por defecto.
  • 📜 Registro de auditoría completo: Cada cambio realizado por un asistente de IA se rastrea en Charitable » Herramientas » Registros, por lo que siempre sabrás quién (o qué) actualizó tu sitio.

Consulta nuestro anuncio aquí.

Mejora Pagos

💰 Acepta donaciones recurrentes con Windcave y Charitable

Un donante configura su donación una vez en la página de pago segura de Windcave, y Charitable factura cada renovación según lo programado. Por qué esto es importante:

🏦 Organizaciones con sede en Nueva Zelanda o Australia: donaciones mensuales en la pasarela con la que tu banco ya te ha configurado, sin un segundo procesador que incorporar.
⛪ Iglesias que reciben diezmos y ofrendas regulares: los miembros de la congregación establecen su propio calendario una vez, que es la forma más sencilla de lanzar donaciones recurrentes para la iglesia sin una plataforma separada.
🌏 Grupos con donantes en varias divisas: Windcave gestiona más de 20, por lo que un donante puede dar en la divisa que realmente posee.
📅 Fondos operativos en lugar de campañas puntuales: activa el modo Solo Recurrente y la opción única desaparece, por lo que cada donación a esa campaña es una suscripción.
🧾 Equipos sin desarrollador en plantilla: 3 conjuntos de credenciales pegados en una página de configuración, y sin código en ninguna parte.

Consulta nuestro anuncio aquí.

automatización actualizar

⚡ Creador Visual de Automatización: ¡Arrastrar y Soltar Sin Código!

Charitable Automation Connect 2.3.0 presenta el Generador de Automatización Visual, un lienzo a pantalla completa que presenta cada automatización como un flujo de tarjetas conectadas: un desencadenador, condiciones opcionales y una lista de acciones que se ejecutan en orden.

🧩 Muchas acciones, un desencadenador: Etiqueta a un donante, envía un correo electrónico, agrega una nota y activa una llamada webhook desde un solo evento, arrastrado en cualquier orden.

✉️ Actúa dentro de Charitable: Las nuevas acciones Enviar correo electrónico, Etiquetar donante y Agregar nota de donante se ejecutan sin necesidad de un servicio externo.

🔤 Etiquetas de combinación: Personaliza correos electrónicos y notas con campos en vivo como {first_name}, {total} y {campaign_name}.

🔁 Aplicar a donantes existentes: Ejecuta Etiquetar donante y Agregar nota de donante contra los donantes que ya tienes.

🖥️ Lienzo o Simple: Cambia de vista en cualquier momento, y las automatizaciones creadas antes de la 2.3.0 siguen funcionando sin cambios.

Lee más aquí.

Integración actualizado

📬 Presentamos Brevo para Charitable: Convierte donantes en suscriptores automáticamente

El momento en que un donante realiza una donación es cuando está más comprometido. Con la nueva integración de Brevo para Charitable, puedes convertir automáticamente a esos donantes únicos en suscriptores a largo plazo sin tocar una sola hoja de cálculo.

Simplemente recopila el consentimiento del donante directamente en tu formulario de donación y comienza tu serie de bienvenida de inmediato.

Novedades:

🔄 Sincronización automática de suscriptores: Los nuevos donantes que aceptan se añaden directamente a tu lista de contactos de Brevo tan pronto como se procesa su pago, sin necesidad de exportaciones manuales ni importaciones de CSV.

🎯 Control granular de consentimiento y opción de suscripción: Personaliza la etiqueta de tu casilla de verificación, elige si se marca por defecto o no, o activa la doble opción de suscripción de Brevo para mantener tu lista limpia y conforme.

📋 Mapeo de listas por campaña: Dirige a los donantes a tu lista de correo global o mapea campañas específicas a listas de Brevo dirigidas para adaptar tus mensajes de seguimiento.

⚡ Configuración en 5 minutos: Conéctate al instante pegando tu clave API de Brevo en la configuración de Newsletter, mapea tus campos de contacto y empieza a crear tu lista de correo en piloto automático.

¿Listo para hacer crecer tu lista de correo? Brevo ya está disponible a partir del plan Charitable Plus. ¡Conecta tu cuenta hoy mismo!