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

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

1. Abre cualquier página o publicación en el editor de bloques de WordPress.
2. Haz clic en + para añadir un nuevo bloque y busca Mini Donation Widget.
3. Selecciona una campaña en el menú desplegable Campaña en el panel de configuración del bloque.
4. 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.php

---

Solució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 $args analizada.

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

⬇️ 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 →