La clase Donante_Caritativo te permite acceder a información sobre un donante en particular.
Obtener una instancia de Donante_Caritativo
Se puede recuperar una instancia de Donante_Caritativo de diferentes maneras, dependiendo del contexto en el que necesites usarla.
Con un ID de donante
$donor_id = 123;
$donor = new Charitable_Donor( $donor_id );Con un ID de donante y un ID de donación
$donor_id = 123;
$donation_id = 456;
$donor = new Charitable_Donor( $donor_id, $donation_id );Con un objeto o ID de donación
// If you have a donation ID, first get the Charitable_Donation object.
$donation_id = 123;
$donation = charitable_get_donation( $donation_id );
// Get the Charitable_Donor object.
$donor = $donation->get_donor();Con un objeto Usuario_Caritativo
// If you have a user ID, first get the Charitable_User object.
$user_id = 123;
$user = charitable_get_user( $user_id );
// Now get the donor ID.
$donor_id = $user->get_donor_id();
// Instantiate the Charitable_Donor object with the donor ID.
$donor = new Charitable_Donor( $donor_id );Propiedades
user_id
El ID de usuario del donante. Para donantes no registrados, esto devolverá 0.
first_name
El nombre del donante.
last_name
El apellido del donante.
email
La dirección de correo electrónico del donante.
date_joined
La fecha en que el donante se convirtió por primera vez en donante. Esto se devolverá como una cadena de fecha y hora de MySQL.
date_erased
La fecha en formato de fecha y hora de MySQL en que se borró la información del donante. Esto solo se completará si hubo una solicitud de borrado de datos para la dirección de correo electrónico del donante.
contact_consent
Si el donante ha dado su consentimiento para ser contactado.
Métodos
obtener_usuario()
Esto devuelve el objeto Usuario_Caritativo asociado con este donante.
obtener_donacion()
Si instanció Donante_Caritativo con un ID de donación o con el método get_donor() de Donación_Caritativa, get_donation() devolverá la instancia de Donación_Caritativa.
De lo contrario, esto devolverá false.
obtener_donaciones()
Esto devolverá una matriz de todas las donaciones realizadas por el donante.
obtener_meta_donante( $clave = '' )
Devuelve los metadatos del donante almacenados para la donación en particular.
Parámetros$key
Si se establece, esto devolverá el valor de metadatos para la clave dada, o false si no existe dicho valor de metadatos. Si se deja vacío, esto devolverá una matriz de todos los metadatos del donante.
obtener_ultima_donacion()
Devuelve la donación más reciente del donante como una instancia de Donación_Caritativa, o null si no ha realizado ninguna donación.
obtener_nombre()
Devuelve el nombre del donante almacenado para la donación en particular.
obtener_correo_electronico()
Devuelve la dirección de correo electrónico del donante.
tiene_correo_electronico_valido()
Devuelve si la dirección de correo electrónico proporcionada por el donante es válida.
obtener_direccion()
Devuelve la dirección imprimible del donante.
Es un envoltorio para Charitable_User::get_address().
obtener_avatar( $tamano = 100 )
Devuelve el HTML para mostrar el avatar del donante. Por defecto, esto devolverá el Gravatar asociado a la dirección de correo electrónico del donante.
Es un envoltorio para Charitable_User::get_avatar().
Parámetros$size
Opcional. Establece el ancho y la altura del avatar a devolver. Por defecto, el avatar se devuelve con un ancho y una altura de 100 píxeles.
obtener_ubicacion()
Devuelve la ubicación del donante.
Si el objeto Charitable_Donor no se llamó con un $donation_id establecido, esto devuelve el resultado de Charitable_User::get_location(). De lo contrario, esto devolverá la ubicación proporcionada para la donación, basándose en la ciudad, el estado y/o el país.
obtener_cantidad( $id_campana = false )
Devuelve el importe de la donación.
Si se pasó un ID de donación al instanciar Charitable_Donor, esto devolverá el total donado con esta donación en particular. De lo contrario, esto devolverá el importe total jamás donado por el donante.
Parámetros$campaign_id
Opcional. Si se establece, esto solo devolverá el importe donado a la campaña dada.
