Requiere: 

• Charitable Pro 1.8.16+
• Tributos Benéficos 1.0.0+

Esta página es la referencia completa para Homenajes Benéficos: cada ajuste que puedes cambiar, cómo funciona con los otros complementos de Homenajes Benéficos y la superficie completa del desarrollador de hooks, acciones AJAX, endpoints REST y plantillas.

Si buscas cómo hacer una tarea específica, las guías enfocadas suelen ser un mejor punto de partida. Esta página es el mapa de todo.

Ajustes de Homenajes

Todos los ajustes se encuentran en Homenajes Benéficos » Homenajes » Ajustes, organizados en pestañas.

General

• Nivel de privacidad predeterminado – el nivel de privacidad aplicado a los homenajeados nuevos (público, aprobación familiar, miembros o enlace privado).
• Etiqueta de homenaje predeterminada – el texto utilizado cuando un tipo de homenaje no especifica el suyo propio.
• Patrón de formulario – el diseño predeterminado para los campos de homenaje en los formularios de donación.
• Línea de contexto del donante – el texto de ayuda que se muestra encima de los campos de homenaje.
• Texto de consentimiento GDPR – el texto de consentimiento que se muestra cuando un donante elige notificar a un ser querido.

Formulario de Donación

• Patrón de formulario – elige Bloques en línea (campos de homenaje en la sección de importe) o Bloques por pasos (campos de homenaje en su propio paso).
• Línea de contexto del donante – personaliza el texto de ayuda con tu propia voz.

Integraciones

Un interruptor para cada una de las cinco integraciones, para que puedas desactivar cualquiera de ellas. Consulta la sección Integraciones más abajo para ver qué hace cada una.

Correos electrónicos de Homenajes

• Habilita y configura la notificación de homenaje, incluyendo el nombre del remitente, el correo del remitente y los asuntos y cuerpos por tipo de homenaje.
• Configura la programación del resumen familiar (desactivado, semanal, quincenal o mensual), el día en que se envía y su asunto.

Tarjeta electrónica de Homenajes

• Habilita el formato más enriquecido de tarjeta electrónica y establece su titular, línea de atribución y color de acento.
• Establece el asunto, la ceja y el texto de cierre por tipo de homenaje.
• Enviar Tarjeta Electrónica de Prueba para previsualizar el resultado.

Campos personalizados

Un gestor impulsado por AJAX para definir tus propios campos en homenajeados y en campañas de homenaje. Los campos personalizados aparecen en los registros y están disponibles como etiquetas de correo electrónico.

Los ajustes se almacenan en la opción charitable_tributes_settings; las definiciones de campos personalizados en charitable_tributes_custom_fields.

Integraciones de Homenajes con otros complementos

Homenajes detecta cada complemento relacionado y añade comportamiento consciente de los homenajes. Si un complemento no está instalado, esa integración simplemente no hace nada. Cada una puede desactivarse en Ajustes > Integraciones.

Complemento	Lo que Homenajes añade	Configuración
Donaciones recurrentes	La opción anual de homenaje que convierte un regalo único en un regalo recurrente, con los detalles del homenaje conservados en cada renovación.	recurring_upsell
Muro de Donantes(núcleo)	Una etiqueta "En memoria de [Homenajeado]" añadida al nombre del donante en el muro de donantes principal de tu sitio.	donor_wall_tribute_tag
DonorTrust	Suprime las insignias de DonorTrust en las páginas de homenaje, que tienen su propia atribución de donante.	donortrust_suppress
Recibos en PDF	Una sección de homenaje formateada en el recibo PDF generado. Requiere PDF Receipts 1.1.3+.	pdf_receipts_tribute_section
Conexión de Automatización	Registra eventos de homenaje (donación completada, campaña creada, homenajeado creado) para webhooks y automatizaciones.	automation_connect_events

Privacidad y accesibilidad

• RGPD – Tributes participa en las herramientas de exportación y borrado de datos personales de WordPress, por lo que una solicitud de datos incluye información de homenaje y homenajeado vinculada a la persona.
• Consentimiento – las notificaciones familiares solo se envían cuando el donante confirma el consentimiento, y los resúmenes familiares requieren una opción de exclusión explícita.
• Accesibilidad – las superficies visibles para el donante están construidas según WCAG 2.1 AA.

---

Referencia del desarrollador para Homenajes

Acciones

Acción	Se dispara cuando
charitable_tributes_init	El contenedor del complemento está listo. El lugar más seguro para registrar extensiones.
charitable_tributes_campaign_created	Se crea una campaña de homenaje.
charitable_tributes_donation_linked	Una donación se vincula a un homenajeado (evento de retrocompatibilidad).
charitable_tributes_donation_completed	Una donación de homenaje se completa (evento canónico, carga útil amplia).
charitable_tributes_donation_refunded	Se reembolsa una donación de homenaje.
charitable_tributes_honoree_created	Se crea un registro de homenajeado.
charitable_tributes_honoree_merged	Se fusionan dos homenajeados.
charitable_tributes_annual_reminder_sent	Se envía un recordatorio de donación anual.
charitable_tributes_family_digest_sent	Se envía un correo electrónico resumen familiar.
charitable_tributes_notification_send_failed	Una notificación o tarjeta electrónica enviada lanza (payload: ID de donación + Throwable).

El payload de charitable_tributes_donation_completed :

add_action( 'charitable_tributes_donation_completed', function ( $donation_id, $data ) {
    // $data: donation_id, honoree_id, campaign_id, amount, currency,
    //        tribute_type, donor_id, donor_display
}, 10, 2 );

Filtros

Filtro	Predeterminado	Propósito
charitable_tributes_admin_tabs	matriz	Modifica la lista de pestañas de la página de administración.
charitable_tributes_admin_sub_tabs	matriz	Modifica las subpestañas de configuración.
charitable_tributes_templates	matriz	Registra plantillas personalizadas de tributos.
charitable_tributes_url_base	tribute	Cambia el slug de reescritura para las URL de tributos y homenajeados.
charitable_tributes_type_options	matriz	Filtra los tipos de tributos disponibles, opcionalmente por campaña.
charitable_tributes_message_max_length	500	Límite de caracteres del mensaje del donante.
charitable_tributes_hide_donor_comment	false	Oculta el campo del mensaje del donante.
charitable_tributes_honoree_context_fallback	context	Proporciona contexto del homenajeado para bloques sin un homenajeado explícito.
charitable_tributes_unsubscribe_token_max_age	30 días	Duración de los tokens de cancelación de suscripción.
charitable_tributes_receipt_email_enabled	verdadero	Muestra la sección de tributos en los correos de recibo.
charitable_tributes_receipt_email_show_photo	verdadero	Incluye la foto del homenajeado en el recibo.
charitable_tributes_receipt_email_show_message	verdadero	Incluye el mensaje del donante en el recibo.
charitable_tributes_receipt_email_show_ecard	verdadero	Reflejar el estilo de la tarjeta electrónica en el recibo.
charitable_tributes_receipt_email_show_tribute_link	verdadero	Enlace a la página del tributo desde el recibo.
charitable_send_tribute_notification	verdadero	Controlar la notificación estándar por donación.
charitable_send_tribute_ecard	verdadero	Controlar la tarjeta electrónica por donación.

Endpoints AJAX

Todos son wp_ajax_ solamente (sin acceso público), requieren un nonce y verifican la capacidad manage_charitable_settings.

Acción	Propósito
charitable_tributes_wizard_open	Inicializar la sesión del asistente.
charitable_tributes_wizard_step	Renderizar y manejar un paso del asistente.
charitable_tributes_wizard_set_campaign_status	Publicar o redactar la nueva campaña.
charitable_tributes_wizard_discard	Descartar la sesión del asistente.
charitable_tributes_save_honoree_notes	Guardar notas del administrador sobre un homenajeado.
charitable_tributes_save_custom_fields	Guardar definiciones de campos personalizados.
charitable_tributes_add_family_contact	Añadir un contacto familiar.
charitable_tributes_update_family_contact	Actualizar un contacto familiar.
charitable_tributes_delete_family_contact	Eliminar un contacto familiar.
charitable_tributes_honoree_merge	Fusionar dos homenajeados.
charitable_tributes_honoree_search	Buscar homenajeados por nombre.
charitable_tributes_dismiss_banner	Descartar el banner de bienvenida.
charitable_tributes_ecard_test_action	Enviar una tarjeta electrónica de prueba.

API REST

Puntos de acceso de solo lectura para sincronizar datos de tributos en un CRM externo o pila de informes.

Campañas de tributos – GET /wp-json/wp/v2/tribute_campaigns

Parámetro de consulta	Ejemplo	Filtra por
tipo_tributo	en-memoria-de	Tipo de tributo.
plantilla	en-amoroso-recuerdo	Plantilla utilizada.
honrado	123	ID del honrado.
fecha_desde / fecha_hasta	2026-01-01	Rango de fechas.

Cada respuesta incluye un objeto tribute_meta con honoree_id, template_id, total_raised, y donor_count.

Honrados – GET /wp-json/wp/v2/charitable-honorees

Parámetro de consulta	Ejemplo	Filtra por
plantilla	en-amoroso-recuerdo	Plantilla de tributo vinculada.
tiene_donaciones	1 o 0	Solo honrados con o sin donaciones.

Cada respuesta incluye un objeto tribute_meta con total_raised, donor_count, gift_count, last_donation_at, y linked_campaigns_count.

Esquema de base de datos

Tabla	Propósito
wp_charitable_donaciones_homenajeado	Una fila desnormalizada por regalo, vinculada a un honrado.
wp_charitable_contactos_familiares_homenajeado	Registros de contacto familiar.
wp_charitable_cache_totales_homenajeado	Totales por honrado cacheados.

Utiliza los repositorios en lugar de consultar directamente:

use Charitable\Pro\Tributes\Repositories\Repositories;

Repositories::honorees();
Repositories::honoree_donations();
Repositories::honoree_family_contacts();
Repositories::honoree_totals_cache();

Plantillas

Anula cualquiera de estos copiándolos en tu tema, siguiendo la convención del cargador de plantillas de Charitable:

• templates/single-tribute_campaign.php
• templates/emails/tribute-notification.php (y -plain.php)
• templates/emails/tribute-ecard.php
• templates/emails/family-digest.php (y -plain.php)
• blocks/<block>/render.php para cada uno de los seis bloques.

Eventos de Automation Connect

Cuando Automation Connect está activo, Tributes registra sus eventos a través del filtro charitable_automation_connect_events, exponiendo los eventos de donación de tributos completada, campaña de tributos creada y nuevo homenajeado para automatizaciones sin código.

Relacionado

• Guía de Tributos Benéficos
• Creación de Campañas de Homenaje
• Registros de Homenajeados y el CRM
• Correos electrónicos de tributos, tarjetas electrónicas y recibos