Requiere: 

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

Algunos de los regalos más significativos que su organización sin fines de lucro recibirá jamás se hacen en nombre de alguien. Un donante dona en memoria de un padre, en honor a la recuperación de un amigo o en nombre de una pareja que celebra un hito.  Tributos Benéficos captura esa intención directamente en el formulario de donación, y luego hace algo que la mayoría de los complementos de donación no pueden: recuerda a la persona homenajeada.

Cada homenajeado se convierte en un registro real en su panel de control, con totales acumulados, los donantes que contribuyeron y la familia a la que puede mantener informada. Todo funciona dentro de WordPress, junto con los formularios e informes que ya utiliza, sin suscripción separada ni tarifas por donación.

Esta guía es el punto de partida. Explica la idea principal, le ayuda a instalarse y le ofrece un recorrido por el panel de control de Tributos para que sepa dónde se encuentra todo. A partir de aquí, puede seguir los enlaces a las páginas de ayuda más detalladas.

La idea principal que debe comprender primero: tributos frente a homenajeados

Casi todo en este complemento tiene sentido una vez que comprende la diferencia entre un tributo y un homenajeado.

• Un tributo es la dedicatoria que un donante añade a un regalo, como "En Memoria De". Pertenece a una donación individual.
• Un homenajeado es la persona que está siendo honrada. Tributos almacena cada homenajeado como su propio registro.

Por lo tanto, cuando diez personas donan en memoria de la misma persona, no obtiene diez donaciones desconectadas. Obtiene un homenajeado con la imagen completa: el total recaudado en su nombre, cada donante que contribuyó, los mensajes dejados para ellos y los contactos familiares que usted elija mantener. Esto es lo que diferencia a Tributos Benéficos de una simple casilla de verificación "¿es un tributo? sí/no".

Lo que puede hacer con Tributos

• Añada una opción de tributo a cualquier formulario de donación, con "En Memoria De", "En Honor De", "En Nombre De" y sus propios tipos de tributo personalizados.
• Conserve registros de homenajeados con fotos, fechas, totales, historial de donantes y contactos familiares.
• Lance una campaña de tributos dedicada en menos de dos minutos con el asistente de configuración guiada.
• Notifique automáticamente a un ser querido con una tarjeta electrónica de tributo cuando se realice un regalo.
• Cree hermosas páginas de memoriales y tributos con seis bloques dedicados.
• Convierta un tributo único en un regalo anual en una fecha que el donante elija.
• Incluya una sección de tributos en los recibos de donación y recibos en PDF.
• Rastree todo con un informe de Donaciones de Tributos y una Tabla de Clasificación de Homenajeados.

Requisitos

• WordPress 6.2 o posterior
• PHP 8.0 o posterior
• Charitable con una licencia activa de Charitable Pro (se recomienda la última versión)
• Donaciones Recurrentes de Charitable, para regalos de tributos anuales (opcional)
• Recibos en PDF de Charitable, para la sección de tributos en recibos en PDF (opcional)

Instalación y activación de Tributos

Tributos se instala como cualquier otro complemento de Charitable.

1. En su administrador de WordPress, vaya a Charitable » Complementos.
2. Busca Tributes y haz clic en Install, luego en Activate. Si descargaste el complemento como un ZIP, también puedes instalarlo desde Plugins » Add New » Upload Plugin.
3. Una vez activo, aparece un nuevo menú Tributes debajo de Charitable en la barra lateral de tu administrador.

Eso es todo lo que se requiere para empezar. El complemento viene con configuraciones predeterminadas sensatas, por lo que puedes crear tu primera campaña de tributo de inmediato y ajustar la configuración más tarde.

Un recorrido por el panel de Tributes

Abre WordPress Admin » Charitable » Tributes y aterrizarás en un panel con pestañas. Aquí te explicamos para qué sirve cada pestaña.

Pestaña	Para qué sirve
Visión general	Tu pantalla de inicio. Cifras destacadas de la cantidad recaudada, donaciones, donantes y homenajeados, además de actividad reciente.
Directorio	Cada campaña de tributo en tu sitio, buscable y filtrable por tipo de tributo, plantilla, estado y rango de fechas.
Homenajeados	El directorio de homenajeados. Explora cada homenajeado, ve los totales de un vistazo y profundiza en cualquier registro.
Informes	Analíticas específicas de tributos, incluida la tabla de clasificación de homenajeados clasificada por cantidad recaudada o número de donaciones.
Plantillas	Los puntos de partida listos para usar que utiliza el asistente de configuración, como "En memoria de" y "En lugar de flores".
Configuración	Todo lo que puedes configurar: el formulario de donación, integraciones, correos electrónicos, tarjetas electrónicas y campos personalizados.

Para iniciar una nueva campaña de tributo desde cualquier lugar de esta área, haga clic en el botón Nueva campaña de tributo en la parte superior de la página. Esto abrirá el asistente de configuración descrito en Creación de campañas de tributo.

A dónde ir a continuación

Tributes es un complemento grande, por lo que la documentación se divide en guías enfocadas. Elige la que coincida con lo que quieres hacer:

• Creación de campañas de tributo – ejecuta el asistente de configuración, elige una plantilla y publica una página de tributo dedicada, o agrega la opción de tributo a una campaña que ya tengas.
• La experiencia de donación de tributos – exactamente lo que ven y eligen los donantes cuando hacen una donación de tributo.
• Registros de homenajeados y el CRM – el directorio de homenajeados, las páginas de detalles, los contactos familiares, los niveles de privacidad, la fusión y los informes.
• Correos electrónicos, tarjetas electrónicas y recibos de tributos – tarjetas electrónicas de notificación, el resumen familiar y las secciones de tributos en los recibos.
• Páginas y bloques de tributos – los seis bloques y el shortcode para crear páginas conmemorativas y de tributos.
• Configuración, integraciones y referencia para desarrolladores – cada configuración, las integraciones del complemento y la referencia completa de hooks, REST y plantillas.

Una primera ejecución típica

Si prefieres empezar directamente, este es el camino que toman la mayoría de las organizaciones:

1. Activa Tributes junto con Charitable Pro.
2. Haz clic en New Tribute Campaign y sigue el asistente para crear tu primera página de tributo dedicada, o activa la opción de tributo para una campaña existente.
3. Comparte la página o deja que los donantes encuentren tu formulario existente. Los donantes eligen un tipo de homenaje, nombran al homenajeado y añaden un mensaje personal.
4. Homenajes crea el registro del homenajeado y, si se nombró a un destinatario, notifica automáticamente a la familia.
5. Realiza un seguimiento de los totales, donantes y mensajes desde el panel de Homenajes.

---

Referencia del desarrollador

El resto de esta página es una breve orientación para desarrolladores. El hook completo, la referencia REST y de plantillas se encuentra en la página Configuración, Integraciones y Referencia para desarrolladores .

Arranque y versión

• Dominio de texto: charitable-tributes (las traducciones se cargan desde i18n/languages/).
• Constante de versión: CHARITABLE_TRIBUTES_VERSION.
• El complemento se inicia en la acción charitable_start de Charitable y dispara charitable_tributes_init una vez que su contenedor está listo, pasando el objeto contenedor. Este es el hook más seguro para adjuntar tus propios servicios.

add_action( 'charitable_tributes_init', function ( $container ) {
    // The addon is fully loaded. Register your extensions here.
} );

Tipos de publicación

Homenajes registra dos tipos de publicación personalizados y públicos:

Tipo de publicación	Propósito	Base de URL
campaña_homenaje	Una página dedicada de homenaje o memorial.	/homenaje/{slug}/
benefactor_caritativo	Un registro de homenajeado (una persona, mascota o causa que está siendo honrada).	/tribute/{slug}/ (filtrable)

La base de URL del homenajeado es filtrable:

add_filter( 'charitable_tributes_url_base', function () {
    return 'in-memory-of';
} );

Tablas personalizadas

Tres tablas personalizadas respaldan las funciones del CRM. Rara vez las consultas directamente, pero están documentadas en la Referencia para desarrolladores:

• wp_charitable_honoree_donations – una fila desnormalizada por regalo, vinculada a un homenajeado.
• wp_charitable_honoree_family_contacts – registros de contactos de familiares.
• wp_charitable_honoree_totals_cache – totales cacheados por homenajeado.