Documentación de Charitable

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

Shortcode de campañas

El shortcode [campaigns] te permite mostrar una colección de campañas dentro de tus publicaciones o páginas.

Parámetros

  • number: El número de campañas a mostrar. Establece esto en -1 para mostrar todas las campañas. El valor predeterminado es el número de publicaciones que muestras en las páginas del blog.
  • orderby: El orden en que se muestran las campañas. Las opciones incluyen post_date, popular y ending. A partir de la versión 1.4, también puedes usar cualquiera de las opciones que WP_Query acepta. El valor predeterminado es post_date.
  • order: Cambia la dirección en la que se ordenan las campañas. Acepta DESC o ASC. El valor predeterminado es DESC.
  • category: Muestra solo campañas dentro de ciertas categorías, identificadas por el slug de la categoría. Pasa varios slugs de categoría como una lista separada por comas para incluir más de una categoría.
  • tag: Muestra solo campañas con ciertas etiquetas, identificadas por el slug de la etiqueta. Pasa varios slugs de etiqueta como una lista separada por comas para incluir más de una etiqueta. Introducido en Charitable Pro.
  • creator: Muestra solo campañas creadas por un usuario determinado. Se debe pasar el ID de usuario del usuario.
  • exclude: Excluye campañas específicas por su ID. Pasa varios IDs como una lista separada por comas para excluir más de uno.
  • include_inactive: Incluye campañas que han expirado estableciendo esto en 1 o true. El valor predeterminado es false.
  • status: Filtra campañas por estado. Las opciones incluyen active (solo campañas activas), ended (solo campañas finalizadas) o all (todas las campañas independientemente del estado). Este parámetro tiene prioridad sobre include_inactive. Introducido en Charitable Pro.
  • columns: Elige en cuántas columnas quieres mostrar las campañas. Admite cualquier número entre 1 y 4. El valor predeterminado es 2.
  • button: Elige si quieres mostrar un botón de Donar (el valor predeterminado), un enlace de leer más (button="details") o nada en absoluto (button="0").
  • id: Muestra campañas específicas. Puedes proporcionar un solo número o varios IDs como una lista separada por comas.
  • parent_campaigns: Muestra solo campañas secundarias de los IDs de campaña principal especificados. Pasa varios IDs como una lista separada por comas. Introducido en Charitable Pro 1.8.5.
  • parent_only: Muestra solo campañas principales (campañas de nivel superior sin padre). Establécelo en 1 o true para habilitarlo. Este parámetro tiene prioridad sobre parent_campaigns. Introducido en Charitable Pro.
  • description_limit: Limita el número de palabras mostradas de la descripción de la campaña. Admite cualquier entero positivo. El valor predeterminado es 100. Introducido en Charitable Pro.
  • responsive: Escala las campañas a un diseño de una sola columna en pantallas pequeñas. Establece esto en 0 para desactivar el comportamiento adaptable, o especifica un punto de interrupción personalizado con un valor en px o em. El punto de interrupción predeterminado es 768px.
  • masonry: Muestra las campañas en un diseño de mampostería (como Pinterest). Establece esto en 1 para habilitar el diseño de mampostería. Predeterminado: 0.
  • pagination: Habilita o deshabilita la paginación para la lista de campañas. Establece en true para habilitar la paginación, false para deshabilitarla. Predeterminado: false. Introducido en Charitable Pro 1.8.6.1.
  • pagination_position: Controla dónde aparece la paginación en relación con la lista de campañas. Las opciones incluyen arriba, abajo o ambas. Predeterminado: abajo. Introducido en Charitable Pro 1.8.6.1.
  • pagination_prev_next: Controla si se muestran los enlaces Anterior/Siguiente en la paginación. Establece en true para mostrar estos enlaces, false para ocultarlos. Predeterminado: true. Introducido en Charitable Pro 1.8.6.1.
  • pagination_first_last: Controla si se muestran los enlaces Primera/Última página en la paginación. Establece en true para mostrar estos enlaces, false para ocultarlos. Predeterminado: true. Introducido en Charitable Pro 1.8.6.1.
  • pagination_mid_size: Controla cuántos números de página se muestran a cada lado de la página actual. Acepta cualquier entero positivo. Predeterminado: 2. Introducido en Charitable Pro 1.8.6.1.

Uso

Uso por defecto:

[campaigns]

Incluir campañas expiradas:

[campaigns include_inactive=1]

Mostrar 30 campañas:

[campaigns number=30]

Ordenar las campañas por la cantidad de dinero recaudado:

[campaigns orderby=popular]

Ordenar las campañas por cuánto tiempo les queda (se muestra primero la que termina antes):

[campaigns orderby=ending]

Mostrar solo campañas de la categoría “problemas medioambientales”:

[campaigns category=environmental-issues]

Mostrar solo campañas con etiquetas específicas:

[campaigns tag=urgent,featured]

Mostrar solo campañas del usuario con ID 33:

[campaigns creator=33]

Mostrar campañas en 3 columnas:

[campaigns columns=3]

Mostrar un enlace de “leer más” para las campañas:

[campaigns button="details"]

Mostrar solo las campañas con los ID 33 y 44:

[campaigns id=33,44]

Mostrar solo las campañas secundarias de la campaña principal con ID 30:

[campaigns parent_campaigns=30]

Mostrar solo campañas principales (campañas de nivel superior):

[campaigns parent_only=1]

Filtrar por estado de la campaña (mostrar solo campañas activas):

[campaigns status=active]

Filtrar por estado de la campaña (mostrar solo campañas finalizadas):

[campaigns status=ended]

Limitar la descripción de la campaña a 50 palabras:

[campaigns description_limit=50]

Desactivar el estilo adaptable:

[campaigns responsive=0]

Establecer un punto de interrupción personalizado de 600px para el estilo adaptable:

[campaigns responsive=600px]

Habilitar paginación (4 campañas por página):

[campaigns 
    number="4" 
    pagination="true" 
    pagination_position="bottom" 
    pagination_prev_next="true" 
    pagination_first_last="true" 
    pagination_mid_size="2"
]

Parámetros adicionales agregados por extensiones

Embajadores

Si estás utilizando la versión 2.0 o superior de Charitable Ambassadors, hay parámetros adicionales que puedes usar para filtrar qué campañas se muestran:

  • parent: Muestra solo las campañas secundarias de una campaña principal específica. Este es un alias de parent_campaigns cuando se usa Charitable Ambassadors. Pasa múltiples ID como una lista separada por comas.
  • fundraiser_type: Muestra solo campañas de recaudación de un tipo específico. Las opciones incluyen:
    • individual – Recaudaciones individuales para campañas existentes.
    • team – Recaudaciones de equipo para campañas existentes.
    • team-member – Campañas de miembros del equipo.
    • fundraiser – Cualquier campaña para una campaña existente o la organización.
    • personal – Cualquier campaña para una causa personal.
  • fundraiser_type_not: Excluye campañas de recaudación de fondos de un tipo específico. Pasa varios tipos como una lista separada por comas. Introducido en Charitable Ambassadors 2.1.0.
  • fundraise_button: Si se establece en false, el botón Recaudar fondos no se mostrará. Establécelo con el texto de tu botón preferido si deseas mostrar el botón. El valor predeterminado es false.
  • join_team_button: Si se establece en false, el botón Unirse al equipo no se mostrará. Establécelo con el texto de tu botón preferido si deseas mostrar el botón. El valor predeterminado es false.

Uso

Mostrar campañas que son hijas de la campaña principal con ID 30:

[campaigns parent=30]

Mostrar solo campañas de recaudación de fondos de equipo:

[campaigns fundraiser_type=team]

Mostrar solo campañas personales:

[campaigns fundraiser_type=personal]

Excluir recaudadores de fondos individuales:

[campaigns fundraiser_type_not=individual]

Mostrar los botones "Recaudar fondos" y "Unirse al equipo" en la cuadrícula de campañas:

[campaigns fundraise_button="Fundraise" join_team_button="Join Team"]

Geolocalización

Si tienes Geolocalización de campañas instalada, puedes mostrar campañas en un mapa de Google, con algunos parámetros adicionales:

  • map: Establécelo en 1 o true para mostrar las campañas en un mapa. El valor predeterminado es false.
  • width: Establece el ancho que deseas para tu mapa. Debe pasarse como un ancho CSS válido (400px, 100%, etc.). El valor predeterminado es 100%.
  • height: Establece la altura que deseas para tu mapa. Debe pasarse como una altura CSS válida. El valor predeterminado es 500px.
  • zoom: Establece el nivel de zoom inicial al que deseas que se muestre tu mapa. El valor predeterminado es auto, con el nivel de zoom basado en los marcadores que se han añadido al mapa.

Uso

Mostrar campañas en un mapa con un ancho de 900px, una altura de 600px y un nivel de zoom establecido en 5:

[campaigns map=1 width=900px height=600px zoom=5]

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

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

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