Documentación de Charitable

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

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!

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

Donaciones Nuevo

👥 Presentamos la fusión de donantes: ¡Dos registros, un colaborador!

En algún lugar de su lista de donantes hay un colaborador que aparece dos veces, porque un año donó desde una dirección de trabajo y al siguiente desde una personal. Cada donación se registra y cada recibo se envía, pero un colaborador leal que ha donado durante años puede parecer dos personas que donaron la mitad. A partir del plugin Charitable Pro 1.8.19.1, puede encontrar esos registros y fusionarlos desde la pantalla de Donantes. Por qué esto es importante:

  • 🔍 Un enlace para encontrar duplicados donde ya trabaja: Vaya a Charitable » Donantes y se encontrará junto a Filtrar y Exportar, luego le dirá cuántos grupos de posibles duplicados ha encontrado.
  • 🧩 Agrupados por nombre, no por correo electrónico: Charitable compara el nombre y el apellido juntos e ignora las mayúsculas, los espacios y la puntuación, que es lo que detecta a la misma persona bajo dos direcciones diferentes.
  • 📊 Una vista previa antes de que algo cambie: Cada grupo muestra cada registro con su dirección de correo electrónico, el número de donaciones y el total acumulado, y la vista previa le muestra los totales combinados y el correo electrónico que se agregará.
  • ↩️ Cada fusión se puede deshacer: Nada se fusiona hasta que usted decida fusionarlo, y puede revertir cualquier fusión después, por lo que una suposición incorrecta no le cuesta nada.
  • 📥 Creado para la semana posterior a una importación: La migración de donantes desde otro plugin es de donde provienen la mayoría de los duplicados, y también es cuando son más difíciles de detectar, porque cada registro es nuevo para usted.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🔑 Presentamos Recaudadores sin Contraseña: ¡Regístrate solo con tu correo electrónico!

Los seguidores llegan queriendo ayudar, y luego el formulario les pide que inventen una contraseña para un sitio web que quizás solo visiten dos veces. Muchos de ellos se detienen ahí mismo. Las cuentas de recaudación de fondos sin contraseña, nuevas en Charitable Ambassadors 3.5.0, permiten a un seguidor iniciar una recaudación de fondos de persona a persona con solo una dirección de correo electrónico. Por qué esto es importante:

  • 🔑 Sin paso de contraseña para perderlos: Actívalo en Charitable » Ambassadors » Templates » Submit Form y el formulario de creación de recaudación de fondos solo pide un nombre, una dirección de correo electrónico y un título de página.
  • 👤 Sigue siendo una cuenta real de WordPress: Un clic en un correo electrónico confirma la dirección, los inicia y crea la cuenta, para que puedan volver más tarde a editar su historia, cambiar su foto y ver quién ha donado.
  • 🎚️ Tu decisión en cada campaña: Cada campaña de persona a persona puede seguir la configuración predeterminada del sitio o anularla, lo que importa cuando una campaña paga a los recaudadores de fondos a través de Stripe Connect y esas personas necesitan una contraseña.
  • 📋 Ver quién no ha hecho clic todavía: La pestaña Charitable » Ambassadors » Directory » Awaiting Sign-In enumera a todos los que aún esperan, con la campaña a la que se unieron y un botón de Reenviar, para que un error tipográfico o una carpeta de spam sea algo que puedas detectar y corregir.
  • 🛡️ Enlaces que un escáner no puede agotar: Abrir el enlace solo muestra una página, y tu recaudador de fondos inicia sesión cuando presiona el botón en él, por lo que los escáneres de correo electrónico corporativos nunca queman el enlace. Cada uno funciona una vez, expira por sí solo y se almacena solo como un hash.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🏃 ¡Presentamos Actividad: Muestra el progreso en más que solo dinero!

La mayoría de las recaudaciones de fondos entre pares se centran en más que el dinero. Una maratón de lectura se basa en los minutos leídos, una caminata en las millas recorridas y una colecta de alimentos en las comidas preparadas. La Actividad para Embajadores Benéficos permite que tus recaudadores de fondos muestren ese esfuerzo junto a los dólares que recaudan. Por qué esto es importante:

  • 🎯 Progreso en lo que realmente cuentas: Una barra de progreso muestra cada cosa que cuentas contra su propio objetivo, justo al lado del dinero recaudado.
  • 🏅 Hitos para las cosas de sí o no: Una insignia de hito marca los esfuerzos que simplemente están hechos o no hechos, sin un número que perseguir.
  • ✍️ Los recaudadores registran sus propios números: Tus donantes introducen sus totales desde sus propias páginas, para que el esfuerzo deje de vivir en una hoja de cálculo, un comentario o en ningún sitio.
  • 🤖 Algunos números se cuentan solos: Una etiqueta AUTOMÁTICA aparece donde el sitio ha calculado la cifra a partir de donaciones completadas, para que puedas ver de un vistazo lo que nadie ha escrito.
  • 🧩 Configúralo una vez, úsalo en cualquier lugar: Tú decides qué se cuenta una vez, luego eliges qué campañas lo cuentan. Disponible ahora en Embajadores Benéficos 3.4.7, sin complementos nuevos y sin desarrollador.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

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