El Mini Widget de Donación es un formulario de donación compacto e incrustable que permite a los visitantes donar a una campaña específica directamente desde cualquier página o publicación. No se requiere una página de campaña completa.
Añádelo a tu página de inicio, una página de destino, una barra lateral o una publicación de blog y convierte cualquier contenido en una oportunidad de recaudación de fondos. Disponible en Charitable Pro 1.8.13.1+.
¿Aún no eres usuario de Charitable Pro? Regístrate hoy y obtén hasta un 50% de descuento en tu plan. Estamos seguros de que te encantará recaudar fondos con Charitable. Si, por cualquier motivo, Charitable no es adecuado para ti, te reembolsaremos tu compra con nuestra garantía de devolución de 14 días. Consigue Charitable Pro ahora »
Qué hay en esta guía
- Características clave
- ¿Por qué usar el Mini Widget de Donación?
- Verlo en acción
- Requisitos
- Empezar
- Opciones de configuración / Referencia de parámetros
- Ejemplo de shortcode
- Personalización
- Solución de problemas
- Recursos para desarrolladores
- Recursos adicionales
- Mantente conectado para más recursos para organizaciones sin fines de lucro
Características clave
El Mini Widget de Donación está diseñado para hacer que las donaciones sean rápidas, flexibles y sin fricciones. Ya sea que lo incrustes en tu página de inicio, una publicación de blog o una página de destino, cada característica está diseñada para reducir las barreras y mantener a los donantes enfocados en donar. Esto es lo que aporta a tus páginas de recaudación de fondos:
- Coloca un widget de donación en cualquier lugar usando un bloque de Gutenberg o un shortcode
- Muestra botones de cantidad de donación preestablecidos para donaciones únicas y mensuales
- Muestra declaraciones de impacto que se actualizan a medida que los donantes seleccionan diferentes cantidades
- Pestañas opcionales Mensual / Donar una vez cuando se usa con Charitable Recurring
- El botón CTA abre un modal o redirige a la página de donación de la campaña
- Entrada de cantidad "Otra" para donaciones personalizadas
- Establece un color de acento personalizado, ancho, alineación y título del widget
- Soporte de anulación de plantilla para control HTML completo
En conjunto, estas características te brindan una experiencia de donación completamente funcional en un paquete compacto e incrustable. No se requiere una página de campaña dedicada, ni navegación adicional, ni fricción innecesaria: solo una experiencia de donación limpia y enfocada que funciona donde tu audiencia ya está.
¿Por qué usar el Mini Widget de Donación?
La mayoría de los plugins de donación requieren que los donantes naveguen a una página de campaña dedicada antes de poder donar. El Mini Widget de Donación elimina esa barrera al incrustar una experiencia de donación completa exactamente donde tu audiencia ya está comprometida: en tu página de inicio, en una publicación de blog o junto a contenido atractivo. Mantiene el proceso de donación rápido, enfocado y sin fricciones.
Verlo en acción
Requisitos
- Charitable Pro 1.8.13.1 o posterior
- Para la pestaña recurrente Mensual/Donar una vez: el complemento Charitable Recurring debe estar activo
Empezar
Añadir el bloque
- Abre cualquier página o publicación en el editor de bloques de WordPress.
- Haz clic en + para añadir un nuevo bloque y busca Mini Donation Widget.
- Selecciona una campaña en el menú desplegable Campaña en el panel de configuración del bloque.
- Configura tus cantidades preferidas, modo CTA y opciones de estilo en la barra lateral.
Usando el Shortcode
Añade [charitable_mini_widget campaign_id="123"] a cualquier página, publicación, área de widget o plantilla que admita shortcodes. Reemplaza 123 con el ID de la publicación de tu campaña.
Opciones de configuración / Referencia de parámetros
Parámetros principales
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
id_campaña | entero | (obligatorio) | El ID de la publicación de la campaña a la que donar. |
cta_mode | cadena | redirect | Cómo se comporta el botón de donar. redirect envía al donante a la página de donación de la campaña;modal abre el formulario en una ventana emergente. |
cta_label | cadena | Dona ahora | La etiqueta de texto en el botón de donación. |
Parámetros de pestaña / recurrentes
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
recurrente | booleano | false | Establecer en true para mostrar las pestañas Mensual y Donar una vez. Requiere Charitable Recurring. |
etiqueta_mensual | cadena | Mensual | Etiqueta personalizada para la pestaña mensual. |
etiqueta_donar_una_vez | cadena | Donar una vez | Etiqueta personalizada para la pestaña de pago único. |
Parámetros de importe
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
importes_mensuales | cadena | 10,25,50,100 | Importes preestablecidos separados por comas para la pestaña mensual. |
predeterminado_mensual | cadena | 25 | El importe mensual preseleccionado. Debe estar en importes_mensuales. |
mostrar_otro_mensual | booleano | false | Mostrar un botón "Otro" que permita un importe mensual personalizado. |
importes_pago_unico | cadena | 25,50,100,250 | Importes preestablecidos separados por comas para la pestaña de pago único. |
predeterminado_pago_unico | cadena | 50 | El importe de pago único preseleccionado. Debe estar en importes_pago_unico. |
mostrar_otro_pago_unico | booleano | false | Mostrar un botón "Otro" que permita un importe de pago único personalizado. |
Parámetros de declaración de impacto
Las declaraciones de impacto por importe se actualizan dinámicamente a medida que los donantes hacen clic en diferentes botones de importe.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
impacto_mensual_{importe} | cadena | (vacío) | Texto de impacto que se muestra cuando se selecciona el importe mensual dado. Ejemplo: impacto_mensual_25="alimenta a una familia durante un mes" |
impacto_pago_unico_{importe} | cadena | (vacío) | Texto de impacto que se muestra cuando se selecciona el importe de pago único dado. Ejemplo: impacto_pago_unico_100="cubre material escolar para 10 niños" |
Parámetros de validación
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
min_amount | número | (ninguno) | Importe personalizado mínimo permitido cuando se habilita "Otro". |
max_amount | número | (ninguno) | Importe personalizado máximo permitido cuando se habilita "Otro". |
Parámetros de visualización
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
show_currency | booleano | false | Muestra el código de divisa ISO (p. ej., USD) junto a los importes preestablecidos. |
accent_color | cadena | (predeterminado del tema) | Color hexadecimal para los botones y el estilo de acento, p. ej., #e63946. |
widget_align | cadena | centro | Alineación del widget: izquierda, centro, o derecha. |
widget_width | cadena | (automático) | Valor CSS de ancho máximo para el contenedor del widget, p. ej., 400px o 100%. |
widget_title | cadena | (ninguno) | Encabezado opcional encima del widget. Usa {{campaign_title}} para insertar el nombre de la campaña dinámicamente. |
impact_align | cadena | (ninguno) | Alineación del texto para las declaraciones de impacto: izquierda, centro, o derecha. |
clase | cadena | (ninguno) | Clase(s) CSS adicionales añadidas al elemento contenedor del widget. |
Ejemplo de shortcode
[charitable_mini_widget
campaign_id="42"
cta_mode="modal"
recurring="true"
monthly_amounts="10,25,50,100"
monthly_default="25"
monthly_impact_10="provides clean water for a week"
monthly_impact_25="feeds a family for a month"
monthly_impact_50="sponsors a child's education"
monthly_impact_100="funds a medical checkup"
monthly_show_other="true"
onetime_amounts="25,50,100,250"
onetime_default="50"
widget_title="Support {{campaign_title}}"
accent_color="#e63946"
widget_width="420px"
widget_align="center"
]Personalización
Variable CSS
Anula el color de acento globalmente o por instancia usando la propiedad personalizada CSS:
.charitable-mini-widget {
--charitable-mini-widget-accent: #e63946;
}Anulación de plantilla
Para personalizar el HTML del widget, copia la plantilla a tu tema:
yourtheme/charitable-pro/shortcodes/mini-widget.phpSolución de problemas
El widget no aparece en el frontend
Confirma que el campaign_id está configurado y corresponde a una campaña publicada. Los editores verán un mensaje de error si el ID falta o es inválido; los visitantes no verán nada. Comprueba que Charitable Pro 1.8.13.1 o posterior esté activo.
La pestaña Mensual no se muestra
La pestaña de recurrentes solo aparece cuando el parámetro recurring se establece en true y el complemento Charitable Recurring está instalado y activo. Si Recurrente no está activo, el widget vuelve silenciosamente al modo de pago único.
Las declaraciones de impacto no se actualizan al hacer clic en un importe
Verifica que el importe en tus claves monthly_impact_{amount} o onetime_impact_{amount} coincida exactamente con el valor en monthly_amounts o onetime_amounts (incluida la precisión decimal). impact_50 y impact_50.00 se tratan como claves diferentes.
El widget muestra un cuadro de marcador de posición en Divi o WPBakery
Este es el comportamiento esperado en el modo de vista previa del constructor de páginas visual. El widget se muestra correctamente en el front-end publicado.
El botón CTA no abre un modal
Asegúrate de que cta_mode esté configurado como modal. El modo modal requiere la funcionalidad de botón de donación/modal de Charitable incluida en Charitable Pro.
Recursos para desarrolladores
Ganchos y filtros
charitable_mini_widget_shortcode_output: Filtra la salida HTML final del widget. Recibe la cadena HTML y la matriz$argsanalizada.
Clases CSS
| Clase | Elemento |
|---|---|
.charitable-mini-widget | Contenedor raíz |
.charitable-mini-widget__title | Título opcional del widget |
.charitable-mini-widget__tabs | Barra de pestañas Mensual/Donar una vez |
.charitable-mini-widget__tab--active | Pestaña actualmente activa |
.charitable-mini-widget__amounts | Grupo de botones de cantidad |
.charitable-mini-widget__amount--selected | Botón de cantidad actualmente seleccionado |
.charitable-mini-widget__amount--other | Botón de cantidad "Otra" |
.charitable-mini-widget__impact | Área de declaración de impacto |
.charitable-mini-widget__cta | Botón Donar |
Anulación de plantilla
Copia charitable-pro/shortcodes/mini-widget.php a yourtheme/charitable-pro/shortcodes/mini-widget.php para personalizar completamente el marcado del widget.
Recursos adicionales
- Botón de donación de campaña: botón de donación de un solo clic sin cantidades preestablecidas
- Charitable Recurring: requerido para las pestañas mensual/donar una vez
- Showcase de campaña: muestra múltiples campañas en una cuadrícula o carrusel
- Formularios de donación: formularios de donación en línea con todas las funciones
¿TodavÃa no eres usuario de Charitable Pro? RegÃstrate hoy y obtén hasta un 50% de descuento en tu plan. Estamos seguros de que te encantará recaudar fondos con Charitable. Si, por alguna razón, Charitable no es adecuado para ti, te reembolsaremos tu compra con nuestra garantÃa de devolución de dinero de 14 dÃas.
Mantente conectado para más recursos para organizaciones sin fines de lucro
Para más tutoriales y vídeos adaptados a organizaciones sin fines de lucro, suscríbete a nuestro canal de YouTube. Publicamos regularmente consejos de expertos, guías paso a paso sobre donaciones en línea, estrategias de recaudación de fondos y recursos prácticos para ayudar a tu organización a tener éxito.
🗞️ Recibe consejos semanales y guías exclusivas en tu bandeja de entrada
Únete a nuestro boletín →
🎥 Mira tutoriales paso a paso e historias de éxito
Suscríbete a nuestro canal de YouTube →
👩🏽💻 Conecta con nuestra comunidad y obtén información diaria sobre organizaciones sin fines de lucro
Síguenos en LinkedIn →
🥳 Reels divertidos e información sobre organizaciones sin fines de lucro
Síguenos en Instagram →
👀 Vídeos interesantes y divertidos para ayudarte a hacer crecer tu causa
Síguenos en TikTok→
🌎 Suscríbete y sigue para recibir consejos generales de recaudación de fondos
Obtén consejos de recaudación de fondos en TikTok →
Potentes recursos de recaudación de fondos
🤖 Usa Charitable con tu asistente de IA
⬇️ 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 →
🏎️ Prueba Charitable
Crea tu demostración de Charitable →
Comprende la terminología y la jerga de las organizaciones sin fines de lucro
Glosario de organizaciones sin fines de lucro→
% ¿Buscas ofertas y descuentos para organizaciones sin fines de lucro?
Las mejores ofertas y descuentos para organizaciones sin fines de lucro →
