¿Quieres que la gestión de donaciones recurrentes sea más fácil para ti y tus donantes?
¡La nueva extensión Donaciones recurrentes 2.0 en Charitable es justo lo que necesitas! Esta potente función te permite aceptar, gestionar e informar sobre donaciones basadas en suscripciones sin esfuerzo.
Con la versión 2.0.0 de Charitable Pro y la extensión Donaciones recurrentes, puedes mejorar tus esfuerzos de recaudación de fondos incorporando donaciones recurrentes en cualquiera de tus campañas. Esta guía te guiará a través de las características clave, la configuración y las mejores prácticas para ayudarte a sacar el máximo provecho de las donaciones recurrentes.
Disponible en Charitable Pro 2.0.0+ (extensión Donaciones recurrentes).
¿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 »
Características clave
- Acepta donaciones recurrentes en cualquier campaña, con periodos y cantidades flexibles.
- El modo Solo recurrentes asegura que todas las donaciones sean suscripciones.
- El autoservicio del donante permite a los colaboradores gestionar y cancelar sus propias suscripciones.
- Notificaciones automatizadas para pagos fallidos.
- Herramientas de informes avanzados, incluidas tarjetas resumen de MRR (Ingresos recurrentes mensuales).
- Exporta datos de donaciones recurrentes a CSV.
- Compatible con las principales pasarelas como Stripe y PayPal.
¿Por qué usar donaciones recurrentes?
Los donantes recurrentes tienden a contribuir significativamente más con el tiempo que los donantes puntuales. Al aprovechar la extensión Donaciones recurrentes, puedes ofrecer a los colaboradores un camino fácil para la donación sostenida, predecir flujos de ingresos para tu organización y utilizar herramientas de informes completas para rastrear el crecimiento y la retención.
Verlo en acción
Requisitos
- Charitable Pro (cualquier plan que incluya la extensión Donaciones recurrentes)
- WordPress 5.9 o posterior
- PHP 7.4 o posterior.
- Una pasarela de pago compatible (Stripe o PayPal) para renovaciones automáticas
Empezar
Activación
- Inicia sesión en tu administrador de WordPress.
- Navega a Charitable » Extensiones.
- Busca Donaciones recurrentes y haz clic en Instalar y activar.
- Una vez activadas, nuevas opciones para donaciones recurrentes estarán disponibles en el Creador de Campañas.
Cómo usar las nuevas funciones de donaciones recurrentes
Habilitar donaciones recurrentes en una campaña
- Abre el Creador de Campañas para cualquier campaña
- Ve al panel de Configuración
- Expande la sección Donaciones recurrentes
- Selecciona un modo del menú desplegable (ver Opciones de modo a continuación)
- Configura el periodo, la cantidad y la duración según sea necesario
- Guarda o publica la campaña
Opciones de modo
| Modo | Comportamiento |
|---|---|
| Desactivado | No se presenta ninguna opción recurrente a los donantes |
| Simple | Los donantes ven una casilla de verificación para hacer su donación recurrente |
| Avanzado | Los donantes eligen entre una sola vez y recurrente con un selector de período |
| Solo recurrente | Todas las donaciones deben ser recurrentes; la opción de una sola vez está oculta |
Modo Solo recurrente (nuevo en 2.0.0): Seleccionar este modo elimina por completo la opción de donación única. Aparece un aviso en el formulario de donación: “Todas las donaciones a esta campaña son recurrentes”. Úselo para clubes de donaciones mensuales, fondos operativos o cualquier campaña diseñada en torno a donaciones sostenidas.
Configuración del período
Cuando la opción recurrente está habilitada, puede configurar:
- Modo de período: Fijo (definido por el administrador) o Variable (elegido por el donante)
- Período de donación: Diario, Semanal, Mensual, Trimestral, Semestral, Anual
- Duración de la donación: Número de pagos recurrentes (0 = ilimitado)
Panel del Donante
Los donantes pueden ver y administrar sus donaciones recurrentes desde el panel del donante o el shortcode [my_recurring_donations].
Cancelar Suscripción (nuevo en 2.0.0)
Aparece un enlace de Cancelar en la tabla de donaciones recurrentes para cualquier suscripción con un estado cancelable (activo, pendiente, en espera). Hacer clic en él presenta una solicitud de confirmación antes de que se procese la cancelación.
Después de la cancelación: – El estado de la suscripción se actualiza a Cancelado – Un aviso de éxito confirma la acción – El donante es redirigido de vuelta al panel del donante
Las suscripciones con un estado no cancelable (completado, expirado, ya cancelado) muestran un guion en la columna Cancelar.
Correos electrónicos
Correo electrónico de pago fallido (nuevo en 2.0.0)
Un correo electrónico automatizado enviado a los donantes cuando falla un pago recurrente. Se activa cuando el estado de una suscripción cambia a charitable-failed.
Para configurar:
- Vaya a Charitable » Configuración » Correos electrónicos
- Localice Pago fallido y haga clic para editar
- Habilite el correo electrónico, personalice el asunto y el cuerpo, y guarde
Etiquetas de combinación disponibles:
| Etiqueta de combinación | Descripción |
|---|---|
{nombre_primero_donante} | Nombre de pila del donante |
{donor_full_name} | Nombre completo del donante |
{campaign_name} | Título de la campaña |
[charitable_email show=recurring_summary] | Bloque de resumen de suscripción |
{nombre_sitio} | El nombre de tu sitio |
El correo electrónico se envía solo al donante, no al administrador. Para recibir copias de administrador, configura un correo electrónico de notificación por separado.
Correo electrónico de cancelación de donación recurrente
Se envía al donante cuando se cancela una suscripción, ya sea por el donante o por un administrador. Configurable en la misma pantalla de configuración de Correos electrónicos.
Informes
Tarjetas de resumen de MRR (novedad en la versión 2.0.0)
Ubicado en Charitable » Informes » Avanzado, selecciona Donaciones recurrentes en el menú desplegable del tipo de informe.
Aparecen cuatro tarjetas de resumen en la parte superior del informe:
| Tarjeta | Descripción |
|---|---|
| Suscripciones activas | Recuento de todas las donaciones recurrentes activas actualmente |
| Ingresos mensuales estimados (MRR) | Todas las suscripciones activas normalizadas a una cifra mensual |
| Nuevas en este período | Suscripciones creadas dentro del período de fechas seleccionado |
| Canceladas en este período | Suscripciones canceladas dentro del período de fechas seleccionado |
¿Cómo se calcula el MRR?
El importe de cada suscripción activa se multiplica por un factor de período para producir su equivalente mensual:
| Período | Factor mensual |
|---|---|
| Diario | ×30 |
| Semanal | ×4.333 |
| Mensual | ×1 |
| Trimestral | ×0.333 |
| Semestral | ×0.167 |
| Anual | ×0.083 |
Las suscripciones activas y el MRR son cifras globales que no cambian al ajustar el filtro de fecha. Las nuevas de este período y las canceladas de este período reflejan el rango de fechas seleccionado.
Exportar datos de donaciones recurrentes
Utilice el botón Exportar en la página de lista de administración de Donaciones Recurrentes (Caritativo » Donaciones Recurrentes) para descargar un CSV de los resultados filtrados.
Códigos cortos
[mis_donaciones_recurrentes]
Muestra las donaciones recurrentes del donante actual en una tabla. Diseñado para su uso en una página de panel de donante con sesión iniciada.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
id_campaña | entero | — | Limitar a donaciones para una campaña específica |
estado | cadena | todas | Filtrar por estado de la donación |
Personalización
Colores de las insignias de estado
Las insignias de estado se muestran como pequeñas pastillas de colores tanto en la tabla de lista de administración como en las tablas orientadas al donante.
| Estado | Color predeterminado |
|---|---|
| Activo | Verde (#008000) |
| Pendiente | Gris (#999) |
| Completado | Azul (#3fb8f5) |
| Fallido | Naranja (#f7a129) |
| Cancelado | Rojo (#ff0000) |
| En espera | Azul claro (#8bb0e7) |
| Expirado | Amarillo (#ffe14a) |
Anulaciones de plantillas
Para anular una plantilla de donaciones recurrentes, copia el archivo de la carpeta templates/ del plugin a tu tema, en la carpeta charitable/, y modifícalo según sea necesario.
Solución de problemas
El botón Cancelar no aparece en el panel del donante
El botón de cancelación solo se muestra para suscripciones con un estado cancelable (activo, pendiente, en espera). Si la suscripción ya está cancelada, completada o ha expirado, no se muestra ningún botón.
Además, algunas pasarelas de pago no admiten la cancelación programática. Para las pasarelas que no la admiten, es posible que el botón de cancelación no aparezca incluso para las suscripciones activas.
El correo electrónico de Pago Fallido no se envía
Confirma que el correo electrónico está habilitado en Charitable » Ajustes » Correos electrónicos. Verifica también que el estado de la suscripción se actualiza a charitable-failed cuando un pago falla, ya que el correo electrónico se activa en esa transición de estado.
El MRR parece ser inferior a lo esperado
El MRR solo incluye suscripciones activas. No se incluyen suscripciones pausadas, en espera o fallidas. La cifra es también una estimación basada en los periodos de facturación indicados, no en el historial de pagos real.
El modo Solo Recurrente muestra la opción de pago único
Borra la caché de tu navegador y cualquier plugin de caché de páginas. La opción de pago único se oculta mediante CSS y JavaScript en el constructor de campañas y el formulario de donación. Una capa de caché que sirva una página desactualizada puede mostrar un marcado obsoleto.
Recursos para desarrolladores
Ganchos y filtros
charitable_recurring_donation_modes– Filtra las opciones de modo de donación recurrente disponiblescharitable_send_recurring_payment_failed– Controla si se envía el correo electrónico de Pago Fallido para una donación específicacharitable_process_cancellation_{gateway}– Lógica de cancelación específica de la pasarela; devuelvetruepara confirmar el éxitocharitable_recurring_cancel_redirect– Filtra la URL de redirección después de que un donante cancele una suscripcióncharitable_recurring_my_recurring_donations_table_after_receipt– Acción para añadir columnas a la tabla de donaciones recurrentes visible para el donante
Funciones útiles
charitable_recurring_get_recurring_donation( $donation_id )– Devuelve un objetoCharitable_Recurring_Donationcharitable_recurring_get_valid_donation_statuses()– Devuelve una matriz de claves y etiquetas de estado válidas
Cálculo del MRR
// Access MRR data programmatically
$report = Charitable_Report_Advanced_Recurring::get_instance();
$mrr_data = $report->get_mrr_data( $start_date, $end_date );
// Returns: active_count, mrr, new_count, cancelled_countRecursos adicionales
- Publicación de anuncio de Donaciones Recurrentes
- Documentación del Panel del Donante
- Precios de Charitable Pro
/patrón cta
