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!

Formulario de donación Función Nuevo

📝 Bloque de formulario de donación: Incrusta un formulario de donación funcional en cualquier lugar

Con el nuevo Bloque de formulario de donación para Charitable Pro, puedes colocar un formulario de donación completamente funcional directamente en cualquier página o publicación en el editor de bloques de WordPress. Sin redirecciones, sin recargas de página y sin fricción entre leer tu historia y hacer una contribución.

📝 Coloca formularios en cualquier lugar: Coloca un formulario funcional directamente en tu página de inicio, dentro de una publicación de blog basada en historias, en una página de destino dedicada o dentro de un anuncio de campaña.

🎯 Vinculación dinámica de campañas: Elige fácilmente una campaña específica desde la barra lateral del bloque o configúrala para que se vincule automáticamente a la campaña que se esté viendo actualmente.

📐 Vistas de formulario completas vs. mínimas: Cambia entre una vista de diseño completo o una vista mínima compacta para que encaje perfectamente en barras laterales, columnas estrechas o páginas de destino amplias.

🎨 Estilo sin código con ámbito: Personaliza la tipografía, el espaciado del contenedor, el radio del borde, los botones de cantidad y los colores de acento de forma independiente para cada instancia del formulario sin tocar una línea de CSS.

Más información aquí.

embajadores Nuevo

👤 Perfiles de creador: Ponga una cara a cada campaña P2P

Embajadores 3.3.0 ahora ofrece Perfiles de creador, dando a tus seguidores un hogar público permanente y compartible que convierte a los recaudadores de fondos puntuales en relaciones continuas.

👤 Páginas públicas de creador: Dale a cada recaudador de fondos una página de destino instantánea y limpia en /creator/their-name/ para mostrar su avatar personalizado, biografía y una cuadrícula navegable de sus campañas.

📊 Prueba de impacto: Aumenta la confianza de los donantes mostrando hitos en todo el sitio en el perfil, como la cantidad total de fondos recaudados y el número total de donantes.

💳 Tarjetas interactivas al pasar el ratón: Cuando los donantes pasen el ratón sobre el nombre de un creador en una página de campaña, una tarjeta compacta se expandirá con su biografía y perfiles sociales en el momento de la decisión.

📍 Compartir ubicación de forma responsable: Permite a los creadores mostrar de forma segura a los donantes locales dónde se encuentran utilizando solo detalles de ciudad, estado y país.

🛠️ Personalización autoservicio: Los recaudadores de fondos pueden actualizar sus propios perfiles y vincular hasta seis redes sociales directamente desde el centro Mis campañas, ahorrándote tiempo de administración.

¿Listo para empoderar a tus defensores? ¡Actualiza a Embajadores 3.3.0 y activa "Habilitar página pública de creador" hoy mismo!

Mejora Pagos

📱 Convierte a los que se desplazan en el móvil en donantes: Conoce la actualización Mollie de Charitable

¿Estás perdiendo seguidores móviles porque odian escribir números de tarjetas largos en sus teléfonos? La integración actualizada de Mollie de Charitable incluye:

⚡ Pago con billetera con un solo toque: Permite a los donantes completar sus donaciones al instante usando Apple Pay o Google Pay con un simple escaneo facial, huella digital o toque.

💰 Sin carga PCI adicional: Omite la compleja verificación de dominio y el cumplimiento de seguridad, ya que todas las transacciones de billetera se ejecutan de forma segura a través del pago alojado de Mollie.

🛠️ Enrutamiento de cancelación personalizado: Mantén la experiencia predecible enviando automáticamente a los donantes que se retiran a tu página de cancelación, o usa filtros de desarrollador para dirigirlos a una página personalizada.

Visita esta página para obtener más información.

embajadores mejorado Nuevo

Moderación y Pantallas de Directorio en Embajadores 3.0

Embajadores 3.0 tiene nuevas funcionalidades: pantallas de moderación y directorio… ahora puedes ver fácilmente quiénes están generando donaciones en tu red peer-to-peer – incluyendo a los creadores de campañas que podrían necesitar verificación – todo en un solo lugar. Genera informes, envía correos electrónicos directamente a embajadores y creadores de campañas, y más.

🚀 Ve cuándo los creadores de campañas y los embajadores han actualizado sus campañas, qué donantes/donaciones han aportado y más.

🎉 Añade manualmente embajadores y creadores de campañas, ¡y aprueba en un solo clic!

Visita esta página para obtener más información.

Nuevo Pagos

⚡ Desbloquea Donaciones desde India: Conoce la Integración Nativa de Razorpay de Charitable

¿Intentas recaudar donaciones en India? La integración nativa de Razorpay de Charitable incluye:

⚡ Integración Instantánea de UPI: Acepta donaciones locales rápidas directamente en tu formulario a través de aplicaciones como PhonePe, Google Pay, Paytm y BHIM sin enviar a los donantes fuera de tu sitio.

📲 Códigos QR de Campaña Generados Automáticamente: Renderiza instantáneamente códigos QR escaneables que codifican un enlace directo de UPI directamente en tus páginas de campaña públicas y barras laterales para una experiencia de "escanear para donar" sin esfuerzo.

💰 Alcance Dual Local y Global: Destaca tus campañas en INR mientras aceptas sin problemas las principales monedas internacionales como USD, EUR, GBP y CAD para maximizar el apoyo global.

🔁 Donaciones Recurrentes sin Interrupciones: Se integra completamente con el complemento Charitable Recurring para gestionar suscripciones mensuales automáticas directamente a través de Razorpay sin código adicional.

↩️ Sincronización Automática Bidireccional: Mantén tus libros perfectamente limpios con la sincronización bidireccional de reembolsos: emite un reembolso dentro de WordPress o tu panel de Razorpay y ambos lados se actualizan automáticamente.

🔒 Seguridad Verificada por Webhook: Protege automáticamente tus registros de donaciones utilizando la verificación de webhook firmada con HMAC para asegurar que cada actualización de estado represente dinero real liquidado en el sistema.

Visita esta página para obtener más información.

Ver todos los anuncios