Documentación de Charitable

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

Recursos populares

Empieza aquí

Gestión de donantes

Donaciones recurrentes

Recaudación de fondos entre pares

Integraciones

Extensiones

Imagen destacada de la campaña para campañas visuales

La opción Imagen destacada para campañas visuales te permite asignar una imagen en miniatura dedicada a cada campaña desde el creador de campañas. Esta imagen se utiliza como miniatura de la campaña en listas de campañas, códigos cortos y para compartir en redes sociales, y anula la primera foto en el diseño de tu campaña cuando se establece una. Está disponible a partir del plugin Charitable Pro 1.8.13+.

Tabla de Contenidos

Empezar

La Imagen Destacada es una configuración a nivel de campaña en el creador de campañas de Charitable Pro. Cuando estableces una imagen destacada para una campaña, esta se convierte en la imagen principal que se muestra cada vez que esa campaña aparece en cuadrículas, listas, códigos cortos (p. ej., [campaigns]) y cuando la campaña se comparte en plataformas sociales. Si no estableces una imagen destacada, Charitable recurre a la primera foto en el diseño de tu campaña (si la hay) o a la miniatura de la entrada de WordPress para campañas heredadas.

Beneficios clave

  • Un solo lugar para establecer la miniatura de la campaña — No es necesario depender del orden del diseño; establece una imagen que represente la campaña en todas partes.
  • Mejor control para compartir en redes sociales — Utiliza una imagen optimizada para redes sociales (p. ej., 1200 × 630 px) para que las publicaciones se vean consistentes.
  • Accesibilidad y SEO — Campo de texto alternativo dedicado para lectores de pantalla y motores de búsqueda.
  • Marca consistente — Misma imagen en bucles de campañas, códigos cortos e integraciones (p. ej., Divi, Elementor).

Requisitos

  • WordPress: 6.2 o superior
  • PHP: 7.4 o superior
  • Charitable Pro: 1.8.13 o superior

La opción Imagen Destacada solo está disponible para las campañas editadas en el creador de campañas (campañas no heredadas).

Dónde encontrarlo

  1. En el Administrador de WordPress, ve a Charitable → Campañas (o Creador de Campañas).
  2. Abre o crea una campaña en el creador de campañas.
  3. En la barra lateral izquierda, haz clic en Ajustes.
  4. En el submenú Ajustes, haz clic en Imagen Destacada (debajo de Opciones de Donación).

El panel Imagen Destacada aparece en el área de contenido principal.

Opciones de configuración

Carga de Imagen

  • Haz clic para cargar o seleccionar una imagen — Usa la zona de arrastre para abrir la Biblioteca de Medios o cargar una nueva imagen. También puedes usar Reemplazar en una vista previa existente para elegir una imagen diferente, o Eliminar / Eliminar Imagen para borrarla.
  • URL de la imagen — Se almacena la URL de la imagen seleccionada; el campo de carga puede estar oculto por diseño, pero se utiliza para guardar.
  • Cargar Imagen — Botón alternativo para abrir el selector de medios.

Dimensiones recomendadas

  • 1200 × 630 px — Recomendado para una visualización óptima en cuadrículas de campañas y para compartir en redes sociales (p. ej., Open Graph). Otros tamaños funcionan, pero pueden ser recortados o escalados dependiendo de tu tema y las plataformas sociales.

Texto alternativo

  • Propósito: Texto alternativo para lectores de pantalla y SEO.
  • Marcador de posición: “Describe esta imagen para accesibilidad.”
  • Comportamiento: Si dejas el texto alternativo vacío y la imagen proviene de la Biblioteca de medios, Charitable puede rellenarlo automáticamente con el texto alternativo del archivo adjunto cuando esté disponible.

Dónde se utiliza la imagen destacada

Cuando se establece, la imagen destacada se utiliza como miniatura de la campaña en:

  • Listas y cuadrículas de campañas — por ejemplo, el archivo de campañas y los códigos cortos como [campaigns].
  • Plantilla de bucle de campaña — La plantilla campaign-loop/thumbnail.php muestra la miniatura de la entrada de WordPress cuando se establece. Cuando la imagen destacada del creador de campañas se sincroniza con la miniatura de la entrada al guardar, aparece aquí.
  • Códigos cortos — Cualquier código corto que muestre miniaturas de campañas (por ejemplo, cuadrícula de campañas, bloque de campaña).
  • Compartir en redes sociales — Cuando tu tema o plugins utilizan la imagen destacada/miniatura de la campaña para Open Graph o etiquetas meta similares.
  • Constructores de páginas — Divi y otras integraciones que muestran imágenes de campañas utilizan la misma fuente de miniaturas (por ejemplo, .campaign-thumbnail, .campaign-featured-image img).

Si no se establece ninguna imagen destacada, Charitable recurre a la primera foto en el diseño de la campaña, o a la imagen destacada heredada de WordPress para campañas más antiguas.

Solución de problemas

La imagen destacada no se muestra en el frontend

  • Guarda la campaña — Haz clic en Guardar en el creador de campañas después de establecer o cambiar la imagen destacada.
  • Comprueba el tipo de campaña — La configuración se aplica a las campañas editadas en el creador de campañas. Las campañas heredadas utilizan la “Imagen destacada” estándar de WordPress en el editor.
  • Caché — Borra cualquier caché del sitio o de la página para que la miniatura actualizada sea visible.
  • Anulaciones de tema — Si tu tema anula charitable/campaign-loop/thumbnail.php, asegúrate de que utiliza la miniatura de la campaña (por ejemplo, get_post_thumbnail_id() o equivalente).

La imagen se ve recortada o de baja calidad

  • Utiliza una imagen de al menos 1200 × 630px para cuadrículas y compartir en redes sociales.
  • Sube una resolución suficientemente alta para los tamaños que utilizan tu tema y los códigos cortos (por ejemplo, “medium”, “large”).

El texto alternativo no se guarda

  • Asegúrate de hacer clic en Guardar después de editar la campaña. El texto alternativo se almacena con la configuración de la campaña y (cuando sea aplicable) se puede sincronizar desde el archivo adjunto de medios si se deja vacío.

Recursos para desarrolladores

Datos almacenados

  • Los datos de la imagen destacada se almacenan en los metadatos de la campaña campaign_settings_v2 bajo settings['featured-image']:
    • featured_image_id — ID del archivo adjunto de WordPress.
    • featured_image_url — URL de la imagen.
    • featured_image_alt — Texto alternativo.
  • Para mostrar en el bucle de campañas, el ID del archivo adjunto de la imagen destacada se puede sincronizar con el campo _thumbnail_id del post cuando se guarda la campaña (por ejemplo, a través del filtro charitable_campaign_builder_save_campaign_settings o la acción charitable_builder_save_campaign). Entonces get_post_thumbnail_id( $campaign_id ) y has_post_thumbnail( $campaign_id ) reflejarán la imagen destacada de la campaña.

Anulación de plantilla

  • Para personalizar la salida de la miniatura de la campaña, anula la plantilla en tu tema:
    • Copia wp-content/plugins/charitable-pro/templates/campaign-loop/thumbnail.php
    • a tu tema: your-theme/charitable/campaign-loop/thumbnail.php.

Hooks y filtros

  • Registro del panel de configuración — El panel de Imagen destacada se añade a la barra lateral de Configuración del creador de campañas a través de:
    • Filtro: charitable_builder_panels_settings_ (slug del panel: featured-image).
  • Ruta del archivo del panel — Filtro: charitable_builder_panels_settings_file (se utiliza para cargar la clase del panel Pro).
  • Visualización de miniaturas — Filtro: charitable_campaign_loop_thumbnail_size para cambiar el tamaño de la imagen utilizada en el bucle de campañas.
  • Forzar miniatura destacada — Filtro: charitable_campaign_loop_featured_thumbnail para forzar el uso de la imagen destacada/miniatura en contextos específicos.

Clases CSS (administrador del creador de campañas)

  • Sección del panel: .charitable-panel-content-section-featured-image
  • Tarjeta de vista previa: .charitable-featured-image-card
  • Zona de colocación: .charitable-featured-image-dropzone
  • Acciones de superposición: .charitable-featured-image-overlay, .charitable-featured-image-overlay-replace, .charitable-featured-image-overlay-remove

Para obtener ayuda adicional con la configuración de Imagen destacada, visita nuestra documentación de soporte o ponte en contacto con nuestro equipo.

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

Enviar un ticket de soporte
Contáctanos

Ú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!

Mejora Pagos

💸 Presentamos las tarifas escalonadas para el alivio de comisiones: ¡Ajusta la petición a la donación!

El alivio de comisiones hace una pregunta corta a tus donantes al finalizar la compra: ¿te gustaría cubrir la comisión de procesamiento de esta donación? Hasta ahora, esa pregunta utilizaba una única tarifa para cada donación en una pasarela, por lo que una donación de 10 $ y una de 500 $ recibían la misma pregunta de porcentaje. El alivio de comisiones 1.3.0 te permite establecer tantas bandas de donación como desees, cada una con su propia tarifa. Por qué esto es importante:

  • 🪙 Más suave con las donaciones pequeñas: Una comisión de transacción fija supone una parte mucho mayor de una donación de 10 $ que de una de 500 $, por lo que las bandas te permiten pedir menos en la parte inferior.
  • 🎚️ Tantas bandas como necesites: Cada banda tiene su propio porcentaje y su propio importe fijo, y la banda superior continúa sin límite superior.
  • 🛑 Un techo opcional: Un campo de comisión máxima evita que se pida a ningún donante más de una cantidad que tú elijas, por muy grande que sea la donación.
  • 🔌 Configurar por pasarela de pago: Stripe puede funcionar con cuatro bandas, mientras que Windcave y Payfast se mantienen con una tarifa única, ya que las bandas pertenecen a una pasarela y no a todo tu sitio.
  • 🛡️ Nada cambia hasta que tú lo digas: Tus tarifas actuales se mantienen exactamente como están hasta que actives Usar tarifas escalonadas en Charitable » Settings » Advanced » Fee Relief.

Consulta nuestro anuncio aquí.

Donaciones Mejora

📊 ¡Tu panel de control Pro ahora puede comparar, exportar y calificar!

La mayoría de los paneles de control de recaudación de fondos solo te dicen cuánto has recaudado. Charitable Pro 1.8.19 reconstruye el panel de control y la Descripción general de informes en torno a las preguntas más difíciles: si algo está roto, si este período superó al anterior y qué cambio único marcaría la mayor diferencia hoy. Por qué esto es importante:

  • 📈 Cada cifra tiene una tendencia: Elige un período y las fichas y el gráfico se mueven juntos, con cada total mostrado frente al período anterior.
  • 🗓️ Gráficos que se mantienen legibles: Los rangos cortos agrupan las donaciones día a día, mientras que los rangos más largos agrupan por semana o mes, por lo que un año completo se lee como una curva en lugar de una línea plana.
  • 🔀 Compara cualquier 2 períodos: No solo los consecutivos, para que puedas preguntar cómo fue este diciembre en comparación con el diciembre pasado. Eso importa porque la recaudación de fondos es estacional.
  • 📤 Exporta el resumen completo: Envía la descripción general completa como CSV o PDF, lista para un paquete de junta directiva o un informe de financiador.
  • 🎯 Califica tu configuración gratis: Haz que tu configuración de recaudación de fondos sea calificada, para que el único cambio que valga la pena hacer a continuación sea el que puedas ver.

Consulta nuestro anuncio aquí.

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í.

Ver todos los anuncios