Requiere: 

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

Un regalo de homenaje tiene más significado cuando la familia está al tanto y cuando el recibo del donante refleja a quién honra el regalo. Homenajes gestiona ambas cosas: puede notificar a un ser querido automáticamente, enviar un resumen periódico a los contactos familiares y añadir una sección de homenaje a los recibos.

Todo el texto es suyo para controlarlo, configúrelo una vez en Benéficos » Homenajes » Configuración.

La tarjeta electrónica de notificación de homenaje

Cuando un donante elige notificar a un ser querido y confirma su consentimiento, Homenajes envía una notificación al completarse el regalo. Comparte que se hizo un regalo, de quién fue y el mensaje personal.

Hay dos formatos:

• La notificación estándar, un correo electrónico limpio con texto y marca.
• La tarjeta electrónica, un formato más rico con la foto del homenajeado, un borde estilizado, un color de acento y su línea de atribución. El donante opta por la tarjeta electrónica en el formulario; de lo contrario, se envía la notificación estándar. Solo se envía una de las dos por regalo.

Texto que usted controla, por tipo de homenaje

Los regalos conmemorativos deben leerse con cuidado, y los regalos de celebración deben sentirse alegres. Por lo tanto, el asunto, el titular, el subtítulo y el cierre se pueden configurar por tipo de homenaje, en Configuración > Tarjeta electrónica.

• Establezca una línea de asunto diferente para "En memoria de", "En honor de" y "En nombre de".
• Elija un color de acento para que coincida con el tono.
• Utilice el botón Enviar tarjeta electrónica de prueba para previsualizar exactamente lo que recibe un destinatario antes de que un donante active una.

El nombre del remitente, el correo electrónico del remitente, el asunto y el cuerpo de la notificación estándar se encuentran en Configuración > Correos electrónicos, también con texto por tipo de homenaje.

Reenvío y consentimiento

La notificación siempre está sujeta a consentimiento. Si el donante no confirmó que tiene permiso para contactar al destinatario, no se envía nada, incluso si se introdujo un correo electrónico. Puede reenviar una notificación en cualquier momento desde el informe de donaciones de homenaje y usar el envío de prueba para verificar su texto.

El resumen familiar

Para los homenajeados con contactos familiares que han optado por participar, Homenajes puede enviar un resumen familiar periódico, un resumen de los regalos hechos en nombre de su ser querido durante un período.

En Configuración > Correos electrónicos, elija la programación:

• Desactivado (el valor predeterminado), Semanal, Quincenal o Mensual.
• El día de la semana en que se envía el resumen.
• La línea de asunto.

El contenido del resumen respeta las opciones de privacidad, por lo que los regalos anónimos y solo para la familia se resumen de manera apropiada. Cada resumen incluye un enlace de cancelación de suscripción con un clic, y un contacto solo lo recibe si usted lo incluyó en el registro del homenajeado.

Secciones de homenaje en los recibos

Los detalles del homenaje fluyen directamente al recibo del donante, por lo que su registro refleja exactamente a quién honró el regalo.

• El correo electrónico de recibo de donación incluye una sección de homenaje con el nombre del homenajeado, el tipo de homenaje y el mensaje personal.
• Si utiliza el complemento Recibos PDF, el PDF generado incluye una sección de homenaje formateada y a juego.

La privacidad se respeta en todo momento. Las opciones anónimas y solo para familiares se respetan en el recibo, al igual que en cualquier otro lugar.

Etiquetas de correo electrónico

Sus correos electrónicos de homenaje y las secciones de recibo pueden utilizar etiquetas de combinación junto con las etiquetas estándar de Charitable:

• {honoree_name} – la persona homenajeada.
• {tribute_type} y {tribute_label} – la dedicatoria, como un slug y como una etiqueta legible.
• Etiquetas estándar de Charitable como {donor_name}, {donation_amount}, y {campaign_name}.
• Etiquetas de campos personalizados para cualquier campo personalizado de homenajeado o homenaje que haya definido.

Consejos

• Utilice Enviar tarjeta electrónica de prueba después de editar el texto. Es la forma más rápida de detectar un error tipográfico antes de que una familia real lo vea.
• Si las notificaciones no se envían, compruebe tres cosas: el correo electrónico del destinatario es válido, el donante confirmó el consentimiento y su sitio puede enviar correos electrónicos. Tributes utiliza el sistema de correo electrónico de Charitable, por lo que se recomienda encarecidamente un complemento SMTP para una entrega fiable.
• El resumen familiar está desactivado por defecto. Actívelo solo cuando tenga contactos familiares que hayan optado por participar.

---

Referencia del desarrollador

Clases e IDs de correo electrónico

Tributes registra sus correos electrónicos en el sistema de correo electrónico de Charitable, por lo que heredan el flujo de trabajo de envío con ID de donación y la interfaz de usuario de configuración de administración.

Correo electrónico	ID	Desencadenante
Notificación de homenaje	tribute_notification	Finalización de la donación, cuando hay un destinatario y consentimiento presentes y no se elige la tarjeta electrónica.
Tarjeta electrónica de homenaje	tribute_ecard	Finalización de la donación, cuando el donante optó por la tarjeta electrónica. Reemplaza la notificación.
Resumen familiar	(programado)	Una barrida de Action Scheduler en el horario configurado.

Filtros de bloqueo de envío

Ambos envíos pasan por filtros y la lista global de no suscripción, por lo que puede suprimir un envío mediante programación:

// Block the standard tribute notification for a specific donation.
add_filter( 'charitable_send_tribute_notification', function ( $send, $donation_id ) {
    return $send;
}, 10, 2 );

// Block the e-card.
add_filter( 'charitable_send_tribute_ecard', function ( $send, $donation_id ) {
    return $send;
}, 10, 2 );

Filtros de banda de recibo

La sección de homenaje en el correo electrónico del recibo está controlada por estos filtros:

Filtro	Predeterminado	Propósito
charitable_tributes_receipt_email_enabled	verdadero	Mostrar la sección de homenaje en el correo electrónico del recibo.
charitable_tributes_receipt_email_show_photo	verdadero	Incluir la foto del homenajeado.
charitable_tributes_receipt_email_show_message	verdadero	Incluir el mensaje del donante.
charitable_tributes_receipt_email_show_ecard	verdadero	Reflejar el estilo de la tarjeta electrónica.
charitable_tributes_receipt_email_show_tribute_link	verdadero	Enlace a la página del homenaje.

Plantillas

Anular estos en su tema usando el cargador de plantillas de Charitable:

• templates/emails/tribute-notification.php (y -plain.php)
• templates/emails/tribute-ecard.php
• templates/emails/family-digest.php (y -plain.php)

La vida útil del token de cancelación de suscripción se puede filtrar a través de charitable_tributes_unsubscribe_token_max_age (30 días por defecto). Consulte la Referencia del desarrollador para ver el hook de integración de recibos PDF.

Relacionado

• La Experiencia de Donación de Homenaje
• Registros de Homenajeados y el CRM
• Configuración, Integraciones y Referencia para desarrolladores
• Guía de Tributos Benéficos