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 de 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. | venta_recurrente |
| 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. | etiqueta_muro_donante_tributo |
| DonorTrust | Suprime las insignias de DonorTrust en las páginas de homenaje, que tienen su propia atribución de donante. | suprimir_donortrust |
| Recibos en PDF | Una sección de homenaje formateada en el recibo PDF generado. Requiere PDF Receipts 1.1.3+. | sección_tributo_recibos_pdf |
| Conexión de Automatización | Registra eventos de homenaje (donación completada, campaña creada, homenajeado creado) para webhooks y automatizaciones. | eventos_conectar_automatización |
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 |
|---|---|
inicializar_tributos_benéficos | El contenedor del complemento está listo. El lugar más seguro para registrar extensiones. |
campaña_creada_tributos_benéficos | Se crea una campaña de homenaje. |
donación_vinculada_tributos_benéficos | Una donación se vincula a un homenajeado (evento de retrocompatibilidad). |
donación_completada_tributos_benéficos | Una donación de homenaje se completa (evento canónico, carga útil amplia). |
donación_reembolsada_tributos_benéficos | Se reembolsa una donación de homenaje. |
honorado_creado_tributos_benéficos | Se crea un registro de homenajeado. |
honorado_fusionado_tributos_benéficos | Se fusionan dos homenajeados. |
recordatorio_anual_enviado_tributos_benéficos | Se envía un recordatorio de donación anual. |
resumen_familiar_enviado_tributos_benéficos | Se envía un correo electrónico resumen familiar. |
fallo_envío_notificación_tributos_benéficos | 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 |
|---|---|---|
pestañas_admin_tributos_benéficos | matriz | Modifica la lista de pestañas de la página de administración. |
subpestañas_admin_tributos_benéficos | matriz | Modifica las subpestañas de configuración. |
plantillas_tributos_benéficos | matriz | Registra plantillas personalizadas de tributos. |
base_url_tributos_benéficos | tributo | Cambia el slug de reescritura para las URL de tributos y homenajeados. |
opciones_tipo_tributos_benéficos | matriz | Filtra los tipos de tributos disponibles, opcionalmente por campaña. |
longitud_máx_mensaje_tributos_benéficos | 500 | Límite de caracteres del mensaje del donante. |
ocultar_comentario_donante_tributos_benéficos | false | Oculta el campo del mensaje del donante. |
fallback_contexto_honorado_tributos_benéficos | contexto | Proporciona contexto del homenajeado para bloques sin un homenajeado explícito. |
edad_máx_token_desuscripción_tributos_benéficos | 30 días | Duración de los tokens de cancelación de suscripción. |
correo electrónico de recibo de tributos benéficos activado | verdadero | Muestra la sección de tributos en los correos de recibo. |
correo electrónico de recibo de tributos benéficos mostrar foto | verdadero | Incluye la foto del homenajeado en el recibo. |
correo electrónico de recibo de tributos benéficos mostrar mensaje | verdadero | Incluye el mensaje del donante en el recibo. |
correo electrónico de recibo de tributos benéficos mostrar tarjeta electrónica | verdadero | Reflejar el estilo de la tarjeta electrónica en el recibo. |
correo electrónico de recibo de tributos benéficos mostrar enlace de tributo | verdadero | Enlace a la página del tributo desde el recibo. |
enviar_notificación_tributo_benéfico | verdadero | Controlar la notificación estándar por donación. |
enviar_tarjeta_electrónica_tributo_benéfico | 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 |
|---|---|
abrir_asistente_tributos_benéficos | Inicializar la sesión del asistente. |
paso_asistente_tributos_benéficos | 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.phptemplates/emails/tribute-notification.php(y-plain.php)templates/emails/tribute-ecard.phptemplates/emails/family-digest.php(y-plain.php)blocks/<block>/render.phppara 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
- La experiencia de donación de homenaje: lo que ven los donantes
- Cómo crear una campaña de homenaje en Charitable
- Páginas y bloques de tributos
- Correos electrónicos, tarjetas electrónicas y recibos de tributos benéficos
- Registros de Homenajeados y el CRM
- Guía de Tributos Benéficos
Enlaces Útiles
🤝 Obtenga ayuda cuando la necesite
Conéctese con el Soporte al Cliente →
📑 Encuentre la guía que necesita
Explore el Centro de Documentación →
⬇️ Descarga estrategias probadas, ideas de campañas y herramientas de expertos
Obtén el Kit de Recaudación de Fondos →
💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →
¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →
¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro→
