Feed de Donaciones

El Feed de Donaciones muestra una lista en vivo y desplazable de donaciones recientes en cualquier página o publicación, lo que te ayuda a generar transparencia, inspirar a los visitantes y crear prueba social para tus campañas. Está disponible en el plugin Charitable Pro 1.8.13+.

Disponible tanto como shortcode como bloque de Gutenberg, el Feed de Donaciones es totalmente personalizable: elige entre una vista de lista/tabla o una cuadrícula de tarjetas, controla exactamente qué información del donante se muestra, aplica temas de color y habilita la paginación AJAX, todo sin tocar una línea de código.

Tabla de Contenidos

Características clave
¿Por qué usar un Feed de Donaciones?
Casos de uso
Verlo en acción
Empezar
Métodos de uso
Referencia completa de parámetros
Ejemplos
Personalización
Filtros y ganchos de WordPress
Solución de problemas
Preguntas frecuentes
Recursos adicionales
Registro de Cambios

Características clave

En primer lugar, obtienes dos tipos de vistas: la vista de lista y la vista de tabla con encabezados de columna, y una cuadrícula de tarjetas adaptable, que se cambia con una sola configuración.

Vistas de lista de tarjetas de crédito en el feed de donaciones | Charitable

Otras características incluyen:

Opciones de visualización flexibles: Muestra u oculta avatares, nombre, apellido, monto de la donación, fecha, comentario, nombre de la campaña y ubicación del donante de forma independiente.
Filtrado inteligente: Filtra por campaña, rango de fechas (incluidas fechas personalizadas de inicio/fin), monto mínimo, búsqueda por nombre de donante o una lista específica de IDs de donación.
Agrupación de donantes: Opcionalmente, colapsa múltiples donaciones del mismo donante en una sola entrada que muestre su total, con una insignia de "Total".
Paginación AJAX: Páginas numeradas o un botón "Cargar más", ambos impulsados completamente por AJAX sin recargas de página.
Alternancia de encabezado de tabla: Opcionalmente, oculta la fila del encabezado de la columna en la vista de lista para una apariencia incrustada más limpia.
Temas de color: Siete controles de color independientes (primario/acento, monto, borde, fondo de fila alterno, fondo al pasar el ratón, encabezado, texto secundario).
Tamaño de fuente y alineación de tarjetas: Escalado del tamaño de fuente por bloque y alineación de tarjetas izquierda/centro/derecha para la cuadrícula de tarjetas.
Ubicación del donante: Muestra la ciudad, el estado y/o el país debajo del nombre del donante; cada campo se puede activar individualmente.
Soporte para donaciones anónimas: Las donaciones anónimas muestran un nombre y avatar de marcador de posición;include_anonymous controla si aparecen o no.
Ganchos de filtro para desarrolladores: Nueve apply_filters() ganchos a lo largo del pipeline de consulta, datos, visualización y salida para una personalización completa por parte de los desarrolladores.

¿Por qué usar un Feed de Donaciones?

Un Feed de Donaciones muestra a los visitantes que personas reales están donando, en este momento. Este tipo de prueba social puede aumentar significativamente las conversiones en las páginas de campañas y recaudación de fondos.

Transparencia: Permite a los patrocinadores ver el impacto de la comunidad que los rodea.
Prueba social: Ver un flujo de donaciones recientes anima a los visitantes indecisos a donar.
Reconocimiento: Los donantes aprecian saber que su contribución fue reconocida públicamente.
Participación: Un feed en vivo en una página de inicio o de campaña mantiene el contenido fresco y activo.
Confianza: La actividad visible de los donantes indica que su organización está activa y bien respaldada.

Casos de uso

Muestre las donaciones recientes en una página específica de la campaña para mostrar el impulso.
Incorpore un feed en todo el sitio en la página de inicio para celebrar a toda su comunidad de donantes.
Muestre un feed filtrado de donaciones por encima de una cierta cantidad para resaltar las donaciones importantes.
Utilice la vista de tarjetas en una barra lateral o área de widget para un efecto compacto de "muro de donantes".
Use donation_ids para seleccionar donaciones específicas para una exhibición curada.
Use groupby_donor para crear un rol de donantes simplificado que muestre totales en lugar de transacciones individuales.
Muestre el feed anonimizado (con show_first_name=0 show_last_name=0) para campañas que priorizan la privacidad.

Verlo en acción

Pronto se publicará un video aquí. ¡Vuelva a consultar en breve!

Empezar

Requisitos

Charitable Pro (versión 1.8.13 o posterior)
WordPress 6.2 o posterior
PHP 7.4 o posterior.

Activación

El shortcode y el bloque de Feed de Donaciones están disponibles automáticamente tan pronto como se activa Charitable Pro, sin necesidad de pasos adicionales. La etiqueta del shortcode es [charitable_donations_feed] y el bloque aparece en el editor de bloques en la categoría Widgets como Feed de Donaciones.

Métodos de uso

Shortcode

Agregue el shortcode a cualquier página, publicación, widget o archivo de plantilla:

[charitable_donations_feed]

Esto renderiza el feed con todas las configuraciones predeterminadas: vista de lista, las 10 donaciones más recientes, todos los campos mostrados.

Ejemplo básico con opciones comunes:

[charitable_donations_feed view="card" number="12" cards_per_row="4" orderby="amount"]

Filtrado a una campaña específica:

[charitable_donations_feed campaign="42" number="5" show_campaign="0"]

Uso en una plantilla PHP:

echo do_shortcode( '[charitable_donations_feed view="list" number="20" pagination="on"]' );

Bloque de WordPress Gutenberg

Bloque de feed de donaciones en WordPress

Abra el editor de bloques de WordPress en cualquier página o publicación.
Haga clic en el inseridor + y busque Feed de Donaciones.
Haga clic en el bloque para insertarlo. Una vista previa en vivo del lado del servidor se renderiza inmediatamente.
Abra la barra lateral de configuración del bloque (panel derecho) para configurar todas las opciones:
- Panel de Contenido - Tipo de vista, título, descripción, número de donaciones y tarjetas por fila (solo vista de tarjetas).
- Panel de Filtros - Campaña, ordenar por, orden, rango de fechas, cantidad mínima, búsqueda de nombre de donante e IDs de donación específicos.
- Panel de Campos de Visualización - Activar/desactivar la visibilidad de la cabecera de la tabla, avatar, nombre/apellido, cantidad, fecha, comentarios, nombre de la campaña, ubicación (con sub-opciones de ciudad/estado/país).
- Panel de Paginación - Habilitar paginación y elegir entre páginas numeradas o un botón de Cargar más.
- Panel de Estilo - Colores alternos de fila, tamaño de fuente y alineación de tarjetas.
- Panel de Colores - Siete selectores de color individuales para un control total del tema.

Ajustes del Bloque del Feed de Donaciones

La vista previa del bloque se actualiza en tiempo real a medida que cambia la configuración en la barra lateral.

Referencia completa de parámetros

Nota: Todos los parámetros booleanos aceptan 1 / 0, true / false, yes / no, o on / off.

Parámetros principales

ver

Tipo: String
Predeterminado: lista
Opciones: lista | tarjeta
Descripción: Controla la disposición general. lista muestra una tabla adaptable con encabezados de columna. tarjeta muestra una cuadrícula CSS de tarjetas de donación individuales.
Ejemplo: vista="card"

número

Tipo: Entero
Predeterminado: 10
Descripción: El número máximo de donaciones a mostrar por página. Cuando la paginación está habilitada, este es el número que se muestra por página.
Ejemplo: número="20"

tarjetas por fila

Tipo: Entero
Predeterminado: 3
Descripción: Solo se aplica cuando view="card". Establece el número de columnas en la cuadrícula de tarjetas. En pantallas de tableta (≤900px), la cuadrícula se colapsa automáticamente a 2 columnas; en móviles (≤480px) se colapsa a 1.
Ejemplo: tarjetas_por_fila="4"

alineación_tarjeta

Tipo: String
Predeterminado: izquierda
Opciones: izquierda | centro | derecha
Descripción: Solo se aplica cuando view="card". Alinea el texto y los elementos en línea dentro de cada tarjeta.
Ejemplo: alineación_tarjeta="center"

tamaño_fuente

Tipo: Entero
Predeterminado: 14
Descripción: Establece el tamaño de fuente base en píxeles para todo el texto dentro del feed. Los elementos secundarios dimensionados en unidades em se escalan proporcionalmente.
Ejemplo: tamaño_fuente="16"

Parámetros de filtro

campaña

Tipo: Cadena (ID numérico)
Predeterminado: (autodetectar)
Descripción: Filtra las donaciones a una sola campaña por su ID de publicación de WordPress. Cuando se usa en una página de campaña, la campaña se autodetecta y este parámetro se puede omitir. Pasa una cadena vacía para todas las campañas.
Ejemplo: campaña="42"

ordenar por

Tipo: String
Predeterminado: fecha
Opciones: date | amount | first_name | last_name | campaign_name
Descripción: El campo utilizado para ordenar los resultados de las donaciones.
Ejemplo: ordenar_por="amount"

pedido

Tipo: String
Predeterminado: DESC
Opciones: DESC | ASC
Descripción: Dirección de ordenación. DESC muestra los más nuevos/altos primero; ASC muestra los más antiguos/bajos primero.
Ejemplo: orden="ASC"

rango_de_fechas

Tipo: String
Predeterminado: todo_el_tiempo
Opciones: todo_el_tiempo | ultimos_7_dias | ultimos_30_dias | ultimo_ano | personalizado
Descripción: Limita los resultados a donaciones dentro de un período de tiempo. Usa personalizado con fecha_desde y fecha_hasta para especificar un rango exacto.
Ejemplo: rango_fecha="ultimos_30_dias"

fecha_desde

Tipo: Cadena (AAAA-MM-DD)
Predeterminado: (vacío)
Descripción: Fecha de inicio para un rango de fechas personalizado. Solo se usa cuando rango_fecha="personalizado".
Ejemplo: fecha_desde="2025-01-01"

fecha_hasta

Tipo: Cadena (AAAA-MM-DD)
Predeterminado: (vacío)
Descripción: Fecha de fin para un rango de fechas personalizado. Solo se usa cuando rango_fecha="personalizado".
Ejemplo: fecha_hasta="2025-12-31"

importe_minimo

Tipo: Flotante
Predeterminado: 0
Descripción: Mostrar solo donaciones de este importe o superior. Útil para destacar contribuciones significativas. Establecer en 0 para incluir todos los importes.
Ejemplo: importe_minimo="25"

incluir_anonimos

Tipo: Booleano
Predeterminado: 1
Descripción: Si se incluyen o no las donaciones marcadas como anónimas. Cuando está habilitado, los donantes anónimos se muestran con un nombre de marcador de posición (“Anónimo”) y un avatar genérico.
Ejemplo: incluir_anonimos="0"

incluir_recurrentes

Tipo: Booleano
Predeterminado: 1
Descripción: Si se incluyen o no los pagos de donaciones recurrentes en el feed.
Ejemplo: incluir_recurrentes="0"

agrupar_por_donante

Tipo: Booleano
Predeterminado: 0
Descripción: Cuando está habilitado, agrupa múltiples donaciones del mismo donante en una sola entrada que muestra su total acumulado. Se muestra una insignia “Total” en las entradas agrupadas. Útil para crear un registro de donantes en lugar de un registro de transacciones.
Ejemplo: agrupar_por_donante="1"

buscar_donante

Tipo: String
Predeterminado: (vacío)
Descripción: Filtra los resultados a un donante específico por nombre (coincidencia parcial del nombre, apellido o nombre completo). Si se proporciona un valor numérico, se trata como un ID de donante para una coincidencia exacta.
Ejemplo: buscar_donante="Ana" o buscar_donante="42"

ids_donacion

Tipo: Cadena (enteros separados por comas)
Predeterminado: (vacío)
Descripción: Muestra solo los IDs de donación específicos listados. Esto anula todos los demás parámetros de filtro (campaña, rango de fechas, importe mínimo, etc.); solo aparecen las donaciones listadas.
Ejemplo: donations_ids="101,205,308"

Parámetros de visualización

mostrar_encabezado

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta la fila de encabezado de la columna (DONANTE, IMPORTE, FECHA DE DONACIÓN, COMENTARIO) en la vista de lista. No tiene ningún efecto en la vista de tarjeta.
Ejemplo: mostrar_encabezado="0"

mostrar_avatar

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta el avatar de Gravatar/perfil del donante. Los donantes anónimos muestran un avatar genérico de silueta.
Ejemplo: mostrar_avatar="0"

shownombre

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta el nombre del donante. Se puede usar de forma independiente de show_last_name para mostrar solo el nombre por motivos de privacidad.
Ejemplo: mostrar_nombre="0"

showapellido

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta el apellido del donante. Combínalo con show_first_name="0" para ocultar toda la información del nombre.
Ejemplo: mostrar_apellido="0"

mostrar_importe

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta el importe de la donación. Se formatea utilizando la configuración de moneda activa del sitio.
Ejemplo: mostrar_importe="0"

mostrar_fecha

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta la fecha de la donación. Se muestra como tiempo relativo (p. ej., «hace 3 días»), con la fecha/hora completa mostrada al pasar el cursor como información sobre herramientas.
Ejemplo: mostrar_fecha="0"

mostrar_comentario

Tipo: Booleano
Predeterminado: 1
Descripción: Muestra u oculta los comentarios del donante. Cuando un comentario excede comment_words, se trunca con un control «Leer más» (sin recarga de página).
Ejemplo: mostrar_comentario="0"

palabras_comentario

Tipo: Entero
Predeterminado: 20
Descripción: Número máximo de palabras a mostrar antes de truncar un comentario de donante con un enlace «Leer más». Solo se aplica cuando show_comment="1".
Ejemplo: palabras_comentario="30"

mostrar_campaña

Tipo: Booleano
Predeterminado: 0
Descripción: Muestra u oculta el nombre de la campaña para cada donación. Útil al mostrar un feed de todo el sitio que abarca varias campañas. La posición se controla mediante campaign_display.
Ejemplo: mostrar_campaña="1"

visualizacion_campaña

Tipo: String
Predeterminado: columna
Opciones: columna | en línea
Descripción: Solo se aplica cuando show_campaign="1" en la vista de lista. columna añade una columna de Campaña dedicada a la tabla. en línea muestra el nombre de la campaña debajo del nombre del donante en texto más pequeño.
Ejemplo: visualizacion_campaña="inline"

mostrar_ubicacion

Tipo: Booleano
Predeterminado: 0
Descripción: Mostrar u ocultar la ubicación principal de la dirección del donante (ciudad, estado y/o país) debajo de su nombre. La ubicación se extrae de la dirección principal del donante registrada. Utilice show_city, show_state, y show_country para controlar los componentes individuales.
Ejemplo: mostrar_ubicacion="1"

mostrar_ciudad

Tipo: Booleano
Predeterminado: 1
Descripción: Mostrar u ocultar la parte de la ciudad de la ubicación del donante. Solo se aplica cuando show_location="1".
Ejemplo: mostrar_ciudad="0"

mostrar_provincia

Tipo: Booleano
Predeterminado: 1
Descripción: Mostrar u ocultar la parte del estado/provincia de la ubicación del donante. Solo se aplica cuando show_location="1".
Ejemplo: mostrar_provincia="0"

mostrar_pais

Tipo: Booleano
Predeterminado: 1
Descripción: Mostrar u ocultar la parte del país de la ubicación del donante. Solo se aplica cuando show_location="1". Útil para organizaciones de un solo país donde el país es redundante.
Ejemplo: mostrar_pais="0"

Parámetros de paginación

paginación

Tipo: Booleano
Por defecto: 0 (desactivado)
Descripción: Habilita la paginación impulsada por AJAX. Cuando está habilitada, utilice pagination_type para elegir entre páginas numeradas y un botón de Cargar más.
Ejemplo: paginacion="1"

tipo_paginación

Tipo: String
Predeterminado: páginas
Opciones: páginas | load_more
Descripción: Solo se aplica cuando pagination="1". páginas muestra enlaces de página numerados con Anterior/Siguiente y un resumen de “Mostrando X a Y de Z donaciones”. load_more muestra un único botón que añade el siguiente lote de resultados debajo de la lista existente.
Ejemplo: tipo_paginacion="cargar_mas"

Parámetros de título y texto

título

Tipo: String
Predeterminado: (vacío)
Descripción: Encabezado opcional que se muestra encima del feed. Se renderiza como un elemento <h2> con la clase charitable-donations-feed-title.
Ejemplo: title="Donaciones recientes"

description

Tipo: String
Predeterminado: (vacío)
Descripción: Subtítulo opcional o texto introductorio que se muestra debajo del título y encima del feed.
Ejemplo: description="¡Gracias a todos los que han contribuido!"

clase_css

Tipo: String
Predeterminado: (vacío)
Descripción: Una o más clases CSS adicionales añadidas al contenedor más externo <div>. Úselo para aplicar estilos personalizados de su tema.
Ejemplo: clase_css="my-feed sidebar-feed"

Parámetros de estilo

filas_alternas

Tipo: Booleano
Por defecto: 1 (activado)
Descripción: Habilita colores de fondo de fila alternos en la vista de lista. El color de fondo alterno se controla mediante el parámetro color_bg_alt o la variable CSS.
Ejemplo: filas_alternas="0"

Parámetros de personalización de color

Todos los parámetros de color aceptan cualquier valor de color CSS válido: hexadecimal (#3A81C1), rgb(), hsl(), o nombres de colores. Introduce una cadena vacía para usar el valor por defecto.

color_primario

Tipo: Cadena (color CSS)
Predeterminado: #3A81C1
Descripción: Color primario/de acento. Se utiliza para los fondos de los botones de paginación, los enlaces de campañas y el color del enlace "Leer más".
Ejemplo: color_primario="#e05c1a"

color_cantidad

Tipo: Cadena (color CSS)
Predeterminado: #2c7a2c
Descripción: Color del texto del importe de la donación (verde por defecto para transmitir un valor positivo).
Ejemplo: color_cantidad="#1a6e8e"

color_borde

Tipo: Cadena (color CSS)
Predeterminado: #d9d9d9
Descripción: Color de los divisores de fila, bordes de tarjeta y bordes de los botones de paginación.
Ejemplo: color_borde="#cccccc"

colorfondoalterno

Tipo: Cadena (color CSS)
Predeterminado: #f0f0f0
Descripción: Color de fondo de las filas alternas (vista de lista) o el fondo de la insignia agrupada.
Ejemplo: color_fondo_alterno="#f5f0e8"

colorfondohover

Tipo: Cadena (color CSS)
Predeterminado: #f5f5f5
Descripción: Color de fondo que se aplica al pasar el cursor sobre una fila (vista de lista) o una tarjeta (vista de tarjeta).
Ejemplo: color_fondo_hover="#eaf4fb"

colortextoencabezado

Tipo: Cadena (color CSS)
Predeterminado: #636364
Descripción: Color de las etiquetas de encabezado de columna (DONANTE, IMPORTE, etc.) y cualquier subetiqueta que utilice font-size: 11px.
Ejemplo: color_texto_encabezado="#444444"

colortextoinfo

Tipo: Cadena (color CSS)
Predeterminado: #797979
Descripción: Color del texto secundario: fechas relativas, ubicación del donante, nombre de la campaña en modo en línea y texto del comentario.
Ejemplo: color_text_info="#888888"

Ejemplos

Básico – Todos los valores predeterminados

[charitable_donations_feed]

Muestra las 10 donaciones más recientes de todas las campañas, vista de lista, todos los campos visibles, sin paginación.

Cuadrícula de tarjetas para una página de campaña

[charitable_donations_feed view="card" cards_per_row="3" card_alignment="center" number="9"]

Destacar a los donantes importantes

[charitable_donations_feed minimum_amount="100" orderby="amount" order="DESC" number="5" title="Our Champions" description="These donors have gone above and beyond."]

Amigable con anónimos mostrando solo el nombre

[charitable_donations_feed show_last_name="0" include_anonymous="1" show_comment="0" number="15"]

Lista de donaciones (totales agrupados)

[charitable_donations_feed groupby_donor="1" orderby="amount" number="20" show_date="0" show_comment="0" title="Our Donors"]

Agrupa todas las donaciones por persona en una sola entrada que muestra su total acumulado, ordenado de mayor a menor.

Cargar más paginación, últimos 30 días

[charitable_donations_feed pagination="1" pagination_type="load_more" number="10" date_range="last_30_days"]

Feed de campaña con ubicación

[charitable_donations_feed campaign="88" show_location="1" show_city="1" show_state="1" show_country="0" show_campaign="0"]

Selección curada de donaciones específicas

[charitable_donations_feed donation_ids="101,205,308,412" show_header="0" view="card" cards_per_row="4"]

Tema de color personalizado

[charitable_donations_feed color_primary="#c0392b" color_amount="#c0392b" color_border="#f0c0bb" color_bg_alt="#fdf5f5" color_bg_hover="#fce8e8"]

Personalización

Anulaciones de plantillas

El feed de donaciones utiliza dos archivos de plantilla que se pueden anular desde tu tema activo:

Ubicaciones de las plantillas del plugin:charitable-pro/templates/donations-feed/donations-feed-list.php (vista de lista) charitable-pro/templates/donations-feed/donations-feed-cards.php (vista de tarjetas)

Para anular, copia a tu tema:tu-tema/charitable/donations-feed/donations-feed-list.php tu-tema/charitable/donations-feed/donations-feed-cards.php

Variables disponibles dentro de las plantillas:

Variable	Tipo	Descripción
`$donaciones`	`matriz`	Matriz de matrices de datos de donaciones (ver abajo)
`$total_count`	`entero`	Número total de donaciones coincidentes (para cálculos de paginación)
`$args`	`matriz`	Argumentos normalizados de shortcode/bloque

Claves disponibles en cada matriz $donation :

Clave	Descripción
`donation_id`	ID de la entrada de WordPress de la donación
`donor_id`	ID del donante de Charitable
`nombre`	Nombre para mostrar (preformateado, respeta la configuración de anónimo)
`nombre_real_nombre`	Nombre (real, para visualización condicional)
`nombre_real_apellido`	Apellido (real, para visualización condicional)
`importe`	Importe de la donación (float)
`fecha`	Fecha de la donación en GMT (`Y-m-d H:i:s`)
`comentario`	Comentario del donante (texto sin formato)
`avatar_html`	HTML completo de `<img>` para el avatar del donante
`es_anonimo`	Booleano: si la donación es anónima
`es_agrupado`	Booleano: si esta es una entrada de total agrupado
`nombre_campaña`	Título de la campaña
`enlace_campaña`	URL a la página de la campaña
`ubicacion`	Matriz con claves `ciudad`, `provincia`, `pais`

Personalización CSS

La fuente utiliza clases BEM con espacios de nombres. Clases clave:

Contenedor:css .charitable-donations-feed /* contenedor exterior (todas las vistas) */ .charitable-donations-feed-list /* modificador de vista de lista */ .charitable-donations-feed-cards /* modificador de vista de tarjetas */ .charitable-donations-feed-alt-rows /* modificador de filas alternas (vista de lista) */

Vista de lista:css .charitable-donations-feed-table /* el elemento <table> */ .charitable-donations-feed-col-donor /* columna de donante th/td */ .charitable-donations-feed-col-amount /* columna de importe th/td */ .charitable-donations-feed-col-date /* columna de fecha th/td */ .charitable-donations-feed-col-campaign /* columna de campaña th/td */ .charitable-donations-feed-col-comment /* columna de comentario th/td */ .charitable-donations-feed-row /* cada <tr> */ .charitable-donations-feed-donor-info /* contenedor flex: avatar + nombre */ .charitable-donations-feed-donor-name /* texto del nombre del donante */ .charitable-donations-feed-donor-location /* línea ciudad/provincia/país */

Vista de tarjeta:css .charitable-donations-feed-cards-grid /* Contenedor de cuadrícula CSS */ .charitable-donations-feed-card /* Tarjeta individual */ .charitable-donations-feed-card-amount /* Importe principal en la tarjeta */ .charitable-donations-feed-card-donor /* Fila de donante en la tarjeta */ .charitable-donations-feed-card-date /* Fecha en la tarjeta */ .charitable-donations-feed-card-campaign /* Nombre de la campaña en la tarjeta */ .charitable-donations-feed-card-comment /* Bloque de comentarios en la tarjeta */

Ejemplo: añadir un acento de borde izquierdo a las tarjetas:css .charitable-donations-feed-card { border-left: 4px solid #3A81C1; }

Variables CSS

Todos los valores visuales predeterminados se controlan mediante propiedades personalizadas de CSS en el contenedor .charitable-donations-feed. Anúlelos globalmente o delimítelos a una instancia específica utilizando su id único.

Variable	Predeterminado	Controles
`--charitable-df-primary`	`#3A81C1`	Color de acento (enlaces, botones)
`--charitable-df-amount`	`#2c7a2c`	Texto del importe de la donación
`--charitable-df-border`	`#d9d9d9`	Divisores de fila, bordes de tarjeta
`--charitable-df-bg-alt`	`#f0f0f0`	Fondo alterno de fila
`--charitable-df-bg-hover`	`#f5f5f5`	Fondo al pasar el ratón por encima de la fila/tarjeta
`--charitable-df-text-header`	`#636364`	Etiquetas de encabezado de columna
`--charitable-df-text-info`	`#797979`	Texto secundario/meta
`--charitable-df-font-size`	`14px`	Tamaño de fuente base
`--charitable-df-cards-per-row`	`3`	Columnas de la cuadrícula de tarjetas

Ejemplo de anulación global:css .charitable-donations-feed { --charitable-df-primary: #c0392b; --charitable-df-amount: #c0392b; --charitable-df-border: #f0c0bb; }

Anulación específica de la instancia (use el campo Clase CSS personalizada del bloque o un contenedor único): “`css

my-homepage-feed {

--charitable-df-font-size: 16px;
--charitable-df-bg-alt: transparent;

} “`

Filtros y ganchos de WordPress

El feed de donaciones expone nueve ganchos de filtro para desarrolladores que necesiten personalizar la lógica de consulta, modificar los datos de las donaciones antes de renderizarlos o alterar el HTML de salida.

`charitable_donations_feed_query_args`

Filtra la matriz de argumentos normalizada inmediatamente después de que los atributos del shortcode/bloque se analizan y validan. Úselo para anular cualquier configuración mediante programación; por ejemplo, para forzar una campaña o una cantidad mínima en todas las instancias del feed.

Parámetros:

Parámetro	Tipo	Descripción
`$args`	`matriz`	La matriz de argumentos normalizada completa

Ejemplo:

// Always force-enable groupby_donor for all feeds.
add_filter( 'charitable_donations_feed_query_args', function( $args ) {
    $args['groupby_donor'] = true;
    return $args;
} );

`charitable_donations_feed_where_clauses`

Filtra la matriz de cláusulas WHERE de SQL antes de que se ejecute la consulta a la base de datos. Cada elemento de la matriz es un fragmento SQL completo (seguro, ya preparado). Úselo para agregar condiciones personalizadas; por ejemplo, para restringir los resultados a un segmento de donantes específico.

Parámetros:

Parámetro	Tipo	Descripción
`$where`	`matriz`	Matriz de cadenas de cláusulas WHERE de SQL
`$args`	`matriz`	La matriz de argumentos normalizada

Ejemplo:

// Exclude donations with a specific meta value.
add_filter( 'charitable_donations_feed_where_clauses', function( $where, $args ) {
    global $wpdb;
    $where[] = $wpdb->prepare(
        "d.donation_id NOT IN ( SELECT donation_id FROM {$wpdb->postmeta} WHERE meta_key = '_hide_from_feed' AND meta_value = '1' )"
    );
    return $where;
}, 10, 2 );

`charitable_donations_feed_donation_data`

Filtra la matriz de datos de una sola donación inmediatamente después de que se genera a partir de la fila de la base de datos. Úselo para agregar campos personalizados, modificar valores de visualización o adjuntar datos externos a cada entrada.

Parámetros:

Parámetro	Tipo	Descripción
`$data`	`matriz`	La matriz de datos de donación (ver variables de plantilla arriba)
`$row`	`object`	El objeto de fila de base de datos sin procesar

Ejemplo:

// Add a custom badge field based on donation amount.
add_filter( 'charitable_donations_feed_donation_data', function( $data, $row ) {
    $data['badge'] = $data['amount'] >= 500 ? 'Major Donor' : '';
    return $data;
}, 10, 2 );

`charitable_donations_feed_donations`

Filtra la matriz completa de datos de donaciones después de que se hayan procesado todas las filas. Úselo para volver a ordenar, eliminar duplicados o truncar el conjunto de resultados final antes de pasarlo a la plantilla.

Parámetros:

Parámetro	Tipo	Descripción
`$donaciones`	`matriz`	Matriz de todas las matrices de datos de donaciones para esta página
`$args`	`matriz`	La matriz de argumentos normalizada

Ejemplo:

// Shuffle the donations for a randomized display.
add_filter( 'charitable_donations_feed_donations', function( $donations, $args ) {
    if ( ! empty( $args['randomize'] ) ) {
        shuffle( $donations );
    }
    return $donations;
}, 10, 2 );

`donaciones_caritativas_feed_display_name`

Filtra la cadena del nombre para mostrar de un donante antes de que se incluya en la matriz de datos de donación. Úselo para personalizar cómo aparecen los nombres; por ejemplo, para usar iniciales, un nombre de usuario o un formato personalizado.

Parámetros:

Parámetro	Tipo	Descripción
`$name`	`cadena`	El nombre formateado para mostrar
`$donor_id`	`entero`	El ID de donante de Charitable
`$donation_id`	`entero`	El ID de publicación de donación de WordPress
`$anonymous`	`booleano`	Si la donación es anónima

Ejemplo:

// Show only first name + last initial.
add_filter( 'charitable_donations_feed_display_name', function( $name, $donor_id, $donation_id, $anonymous ) {
    if ( $anonymous ) {
        return $name;
    }
    $parts = explode( ' ', $name, 2 );
    if ( isset( $parts[1] ) ) {
        return $parts[0] . ' ' . substr( $parts[1], 0, 1 ) . '.';
    }
    return $name;
}, 10, 4 );

`donaciones_caritativas_feed_avatar_html`

Filtra la cadena HTML completa de <img> de un donante para su avatar. Úselo para insertar una imagen personalizada, agregar clases CSS o reemplazar el avatar con un elemento diferente por completo.

Parámetros:

Parámetro	Tipo	Descripción
`$html`	`cadena`	El HTML completo de `<img>`
`$donor_id`	`entero`	El ID de donante de Charitable
`$donation_id`	`entero`	El ID de publicación de donación de WordPress
`$size`	`entero`	Tamaño del avatar solicitado en píxeles

Ejemplo:

// Replace the avatar with a custom icon for VIP donors.
add_filter( 'charitable_donations_feed_avatar_html', function( $html, $donor_id, $donation_id, $size ) {
    if ( charitable_is_vip_donor( $donor_id ) ) {
        return '<img src="' . esc_url( get_stylesheet_directory_uri() . '/images/vip-badge.png' ) . '" width="' . $size . '" height="' . $size . '" class="charitable-donations-feed-avatar-img vip" alt="VIP Donor" />';
    }
    return $html;
}, 10, 4 );

`donaciones_caritativas_feed_donor_location`

Filtra la matriz de datos de ubicación de un donante antes de adjuntarla a la entrada de la donación. Úselo para anular los valores de ubicación, traducir códigos de país a nombres o agregar valores de respaldo.

Parámetros:

Parámetro	Tipo	Descripción
`$location`	`matriz`	Matriz con claves `ciudad`, `provincia`, `pais`
`$donor_id`	`entero`	El ID de donante de Charitable

Ejemplo:

// Convert country codes to full names using a lookup.
add_filter( 'charitable_donations_feed_donor_location', function( $location, $donor_id ) {
    $country_names = array( 'US' => 'United States', 'CA' => 'Canada', 'GB' => 'United Kingdom' );
    if ( isset( $country_names[ $location['country'] ] ) ) {
        $location['country'] = $country_names[ $location['country'] ];
    }
    return $location;
}, 10, 2 );

`donaciones_caritativas_feed_args`

Filtra la matriz de argumentos final inmediatamente antes de que se ejecute la consulta de la base de datos, después de todo el procesamiento de normalización y compatibilidad con versiones anteriores. Esta es la última oportunidad para modificar los argumentos antes de que afecten la consulta.

Parámetros:

Parámetro	Tipo	Descripción
`$args`	`matriz`	La matriz de argumentos completamente normalizada

Ejemplo:

// Programmatically restrict feeds on a specific page to the last 30 days.
add_filter( 'charitable_donations_feed_args', function( $args ) {
    if ( is_page( 'donate' ) && 'all_time' === $args['date_range'] ) {
        $args['date_range'] = 'last_30_days';
    }
    return $args;
} );

`donaciones_caritativas_feed_css_variables`

Filtra la cadena de variables CSS en línea inyectada en el atributo style del feed. Úselo para agregar propiedades personalizadas CSS adicionales o anular las existentes mediante programación.

Parámetros:

Parámetro	Tipo	Descripción
`$css_string`	`cadena`	Las declaraciones de variables CSS en línea (por ejemplo, `--charitable-df-primary: #c00;`)
`$args`	`matriz`	La matriz de argumentos normalizada

Ejemplo:

// Automatically match the primary color to the active campaign's accent color.
add_filter( 'charitable_donations_feed_css_variables', function( $css_string, $args ) {
    if ( ! empty( $args['campaign'] ) ) {
        $accent = get_post_meta( $args['campaign'], '_campaign_accent_color', true );
        if ( $accent ) {
            $css_string .= ' --charitable-df-primary: ' . sanitize_hex_color( $accent ) . ';';
        }
    }
    return $css_string;
}, 10, 2 );

Solución de problemas

El feed no muestra donaciones

Confirme que existe al menos una donación con Estado: Completada en su base de datos.
Compruebe que el parámetro campaign (si está establecido) coincide con un ID de publicación de campaña válido.
Si utiliza donation_ids, verifique que los IDs sean enteros separados por comas sin espacios.
Si utiliza minimum_amount, compruebe si alguna donación cumple el umbral.
Si utiliza un date_range="custom" personalizado, asegúrese de que date_from y date_to estén en formato YYYY-MM-DD.

Los nombres de los donantes se cortan en la vista de lista

Esto suele ser causado por una hoja de estilos del tema que anula la regla white-space: nowrap en la columna del donante. Agregue lo siguiente a su CSS del tema: .charitable-donations-feed-list .charitable-donations-feed-donor-info { width: max-content; }

La paginación no funciona

Asegúrese de que pagination="on" (o actívelo en la configuración del bloque).
Para el botón Cargar más, verifique que la acción charitable_donations_feed_ajax no esté bloqueada por un plugin de seguridad o firewall.
Compruebe la consola de su navegador en busca de errores de JavaScript que puedan indicar que el objeto JS charitable_donations_feed no está definido en la página.

La vista de tarjetas no respeta cards_per_row

Esta configuración se inyecta como una propiedad CSS personalizada (--charitable-df-cards-per-row). Si un tema tiene una regla grid-template-columns dirigida a .charitable-donations-feed-cards-grid, puede anular la variable. Inspeccione con las Herramientas de desarrollador del navegador y agregue una regla más específica si es necesario.

La ubicación está vacía aunque el donante tenga una dirección

La función de ubicación lee la dirección principal del donante de charitable_donormeta. Si el donante completó una donación sin introducir campos de dirección, la dirección estará vacía. Los campos de ubicación son opcionales en el formulario de donación por defecto.

Preguntas frecuentes

¿Puedo mostrar el feed de varias campañas específicas a la vez? No directamente: el parámetro campaign acepta un único ID de campaña. Utiliza donation_ids para seleccionar donaciones de varias campañas, u omite campaign por completo para mostrar todas las campañas y utiliza show_campaign="1" para mostrar el nombre de la campaña junto a cada entrada.

¿Muestra el Feed de Donaciones las donaciones en tiempo real sin actualizar la página? El feed no es una transmisión WebSocket en vivo: refleja el estado de la base de datos en el momento de cargar la página (o la solicitud de paginación). Para una experiencia "casi en tiempo real", utiliza una TTL de caché de página corta o deshabilita el almacenamiento en caché de la página en las páginas con el feed.

¿Puedo usar el Feed de Donaciones en un widget de barra lateral? Sí. Utiliza el widget de Shortcode (integrado en WordPress) o cualquier widget que admita shortcodes. La vista de tarjetas con cards_per_row="1" funciona bien en una barra lateral estrecha.

¿Funciona groupby_donor con el filtro de búsqueda de donantes? Sí. Cuando groupby_donor está habilitado, la búsqueda de donantes sigue filtrando por nombre/ID de donante, pero el importe mostrado es el total del donante en todas las donaciones coincidentes.

¿Puedo usar el shortcode dentro de un constructor de páginas (Elementor, Divi, WPBakery)? Sí. Charitable Pro incluye integraciones nativas para Elementor y Divi. Para WPBakery u otros constructores, utiliza un elemento/módulo de shortcode y pega el shortcode directamente.

¿Las donaciones anónimas mostrarán alguna información? Cuando include_anonymous="1" (el valor predeterminado), las donaciones anónimas aparecen con el nombre marcador de posición "Anónimo" y un avatar genérico de silueta. Todos los demás campos (importe, fecha, comentario) se muestran normalmente. Establece include_anonymous="0" para excluirlas por completo.

Recursos adicionales

Documentación del Ranking de Donantes – Característica relacionada: visualización clasificada de donantes con iconos de trofeo.
Sistema de Plantillas de Charitable – Cómo anular plantillas desde tu tema.
Personalización CSS de Charitable – Guía general para estilizar la salida de Charitable.

Registro de Cambios

Versi	Cambios
1.8.13	Lanzamiento inicial del shortcode y bloque de Gutenberg del Feed de Donaciones.

Documentación de Charitable

Recursos populares

Tabla de Contenidos

Características clave

¿Por qué usar un Feed de Donaciones?

Casos de uso

Verlo en acción

Empezar

Requisitos

Activación

Métodos de uso

Shortcode

Bloque de WordPress Gutenberg

Referencia completa de parámetros

Parámetros principales

ver

número

tarjetas por fila

alineación_tarjeta

tamaño_fuente

Parámetros de filtro

campaña

ordenar por

pedido

rango_de_fechas

fecha_desde

fecha_hasta

importe_minimo

incluir_anonimos

incluir_recurrentes

agrupar_por_donante

buscar_donante

ids_donacion

Parámetros de visualización

mostrar_encabezado

mostrar_avatar

shownombre

showapellido

mostrar_importe

mostrar_fecha

mostrar_comentario

palabras_comentario

mostrar_campaña

visualizacion_campaña

mostrar_ubicacion

mostrar_ciudad

mostrar_provincia

mostrar_pais

Parámetros de paginación

paginación

tipo_paginación

Parámetros de título y texto

título

description

clase_css

Parámetros de estilo

filas_alternas

Parámetros de personalización de color

color_primario

color_cantidad

color_borde

colorfondoalterno

colorfondohover

colortextoencabezado

colortextoinfo

Ejemplos

Básico – Todos los valores predeterminados

Cuadrícula de tarjetas para una página de campaña

Destacar a los donantes importantes

Amigable con anónimos mostrando solo el nombre

Lista de donaciones (totales agrupados)

Cargar más paginación, últimos 30 días

Feed de campaña con ubicación

Selección curada de donaciones específicas

Tema de color personalizado

Personalización

Anulaciones de plantillas

Personalización CSS

Variables CSS

`charitable_donations_feed_query_args`

`charitable_donations_feed_where_clauses`

`charitable_donations_feed_donation_data`

`charitable_donations_feed_donations`

`donaciones_caritativas_feed_display_name`

`donaciones_caritativas_feed_avatar_html`

`donaciones_caritativas_feed_donor_location`

`donaciones_caritativas_feed_args`

`donaciones_caritativas_feed_css_variables`